Skip to main content
A Procedure is a canonical step sequence: the how-to document your team performs by. Each new capture either corroborates its steps or raises a proposal for you to review, so the written procedure and the way the work is actually done converge over time. Every procedure gets a short ID (PRC-107) that appears in lists, breadcrumbs, and URLs. Renaming a procedure never breaks its links; the ID is what resolves. Procedures stand on their own. Filing one under a skill is optional, and the same procedure can be linked into any number of guidebooks. The guidebook only points at it; the procedure owns all of its content.

Creating a procedure

There are three ways to create one:
  1. From the Procedures list: click New procedure, name it, and it opens ready for authoring. You can link it to guidebooks and add steps after.
  2. From a skill page: the skill’s Procedures section offers From a capture (seeds the steps from the capture’s extracted sequence) or Write it by hand.
  3. Extracted from a document: right-click a PDF in a guidebook’s References card and choose Extract procedure. A draft is generated from the document, steps, callouts, and outline structure included. See Guidebooks.
A procedure can be written before anything is recorded; authoring doesn’t wait on a capture to seed it.

The procedures list

The list at Procedures shows every procedure in the organization: short ID, title, its skill (if filed), and a {n} steps · {n} captures summary. Search matches titles and short IDs, so a pasted PRC-107 lands on the row. The All / Needs review toggle filters to procedures with open proposals; the Needs review badge counts pending proposals across the org.

Description

The Description is the how-to prose: context, safety framing, prerequisites, and any diagrams or media. It’s a full rich-text editor, and images pasted or dropped in belong to the procedure itself.

Steps

Steps are the heart of a procedure. Each step has a title, an optional description, and a kind: Callouts sit in the sequence but don’t consume a step number, so safety notices can be placed exactly where they matter without renumbering the work. Steps can be nested up to five levels deep with Indent / Outdent, reordered by dragging, and managed from a right-click context menu (Add step above, Add step below, Edit step, Delete step). Deleting a step offers an Undo. Step text supports limited inline markdown: **bold**, *italic*, __underline__, and links. How nested steps are numbered is an organization-wide setting (Settings → Procedure numbering): Outline (1. → a) → i), the default), Decimal (1 → 1.1 → 1.1.1), or Plain (flat 1. 2. 3.).

Sources

When a capture corroborates a step, the step gains a citation chip ({capture} · 3:42). Hovering previews the video frame at that timecode; clicking opens the capture viewer at that moment. Hand-written steps simply have no chip yet. Steps added or edited since the last publish carry a small NEW or EDITED marker so you can see what has drifted from the published standard. Publishing clears the markers.

Captures and proposals

Use Link capture to attach a recorded session. Its extracted steps are compared against the sequence: where they agree, the capture is added as a source on those steps; where they differ, each difference comes back as a proposal (add a step, reword a step, or remove a step) with the capture’s rationale and a citation. You Accept or Dismiss each proposal individually; a dismissed proposal won’t be raised by that capture again. Check for changes re-runs this alignment against every linked capture at any time.

Publishing and versions

The page you edit is always the draft. Clicking Publish snapshots the current sequence as an immutable revision (v1, v2, …), optionally with a version note, and further edits open on a new draft. The version chip in the header shows the latest published revision, or Draft if nothing has been published yet; a dot beside it means the draft has unpublished changes. Clicking the chip opens Revision history, where each revision lists who published it, when, its note, and its step and change counts. Opening a revision shows the sequence exactly as published, along with Changes in this version, the edit history that led to that publish. Snapshots are immutable; there is no unpublish, only publishing the next version. Procedures extracted from a document also show External history: the source document’s own revision table, read-only, as written.

Activity

The Activity feed records everything as readable sentences: steps moved or reworded, captures linked, checks run, and where an extracted draft came from. Publishes appear as dividers ({Name} published v3), splitting the feed into per-version chapters.

Deleting

Delete on the procedure page permanently deletes the procedure and removes it from any guidebooks. Linked captures and their extracted steps are not affected, and published versions stay available for audit. You must type the procedure’s short ID to confirm.