Process Documentation
When to use
Use this to capture how a repeatable process actually runs so it can be trained, audited, or handed off, and whenever tribal knowledge needs to become a durable, followable SOP.
Not for: improving a broken process (use ops-process-optimization — document the current reality first, then optimize), or one-off tasks that will never repeat.
Method
- Frame the process. State its name, purpose, trigger (what starts it), and definition of done.
- Identify actors. List every role that touches the process; you will map them in the RACI.
- Map the steps. Walk it end to end. Per step capture action, actor, inputs, outputs, and decision points. Decision: document what happens today, not the idealized version — mark known deviations.
- Draw the flowchart. Render the sequence as a Mermaid
flowchart with decision diamonds for branches.
- Build the RACI. Per step assign Responsible, Accountable, Consulted, Informed — exactly one Accountable per step. Decision: two candidates for Accountable means the step is really two steps; split it.
- Write the SOP. Turn steps into numbered, imperative instructions with tools, timing, and quality checks.
- Add controls. Note exceptions, escalation paths, and where errors are caught.
Example
Process: new-hire laptop provisioning. Trigger: signed offer in HRIS. Done: employee logs in day 1.
flowchart TD
A[Offer signed] --> B[IT creates ticket]
B --> C{Standard role?}
C -->|Yes| D[Ship standard image]
C -->|No| E[Manager specs build]
E --> D
D --> F[Enroll in MDM]
F --> G[Verify login]
RACI step "Ship image": R=IT tech, A=IT lead, C=hiring manager, I=HR.
Pitfalls
- Documenting the ideal, not the actual. An SOP that doesn't match reality trains people to ignore it.
- Multiple Accountables per step. Diffused accountability means no one owns the outcome; enforce one A.
- Steps with no decision branches. Real processes fork; a purely linear diagram hides the exceptions that cause errors.
- No review cadence. Undated SOPs rot silently; stamp owner, version, and next review.
Output format
Overview: name | purpose | trigger | done-when | frequency
Flowchart: Mermaid flowchart TD
RACI: rows = steps, columns = roles (one A per row)
SOP: numbered steps | owner | tools | duration | quality check
Exceptions: escalation paths, error catches
Revision: owner | version | review cadence
1---2name: ops-process-doc3description: Document a repeatable process as a flowchart, a RACI matrix, and a followable standard operating procedure.4---56# Process Documentation78## When to use9Use this to capture how a repeatable process actually runs so it can be trained, audited, or handed off, and whenever tribal knowledge needs to become a durable, followable SOP.1011**Not for:** improving a broken process (use ops-process-optimization — document the current reality first, then optimize), or one-off tasks that will never repeat.1213## Method141. **Frame the process.** State its name, purpose, trigger (what starts it), and definition of done.152. **Identify actors.** List every role that touches the process; you will map them in the RACI.163. **Map the steps.** Walk it end to end. Per step capture action, actor, inputs, outputs, and decision points. *Decision:* document what happens *today*, not the idealized version — mark known deviations.174. **Draw the flowchart.** Render the sequence as a Mermaid `flowchart` with decision diamonds for branches.185. **Build the RACI.** Per step assign Responsible, Accountable, Consulted, Informed — exactly one Accountable per step. *Decision:* two candidates for Accountable means the step is really two steps; split it.196. **Write the SOP.** Turn steps into numbered, imperative instructions with tools, timing, and quality checks.207. **Add controls.** Note exceptions, escalation paths, and where errors are caught.2122## Example23**Process:** new-hire laptop provisioning. **Trigger:** signed offer in HRIS. **Done:** employee logs in day 1.24```mermaid25flowchart TD26 A[Offer signed] --> B[IT creates ticket]27 B --> C{Standard role?}28 C -->|Yes| D[Ship standard image]29 C -->|No| E[Manager specs build]30 E --> D31 D --> F[Enroll in MDM]32 F --> G[Verify login]33```34RACI step "Ship image": R=IT tech, A=IT lead, C=hiring manager, I=HR.3536## Pitfalls37- **Documenting the ideal, not the actual.** An SOP that doesn't match reality trains people to ignore it.38- **Multiple Accountables per step.** Diffused accountability means no one owns the outcome; enforce one A.39- **Steps with no decision branches.** Real processes fork; a purely linear diagram hides the exceptions that cause errors.40- **No review cadence.** Undated SOPs rot silently; stamp owner, version, and next review.4142## Output format43```44Overview: name | purpose | trigger | done-when | frequency45Flowchart: Mermaid flowchart TD46RACI: rows = steps, columns = roles (one A per row)47SOP: numbered steps | owner | tools | duration | quality check48Exceptions: escalation paths, error catches49Revision: owner | version | review cadence50```