Immutable. This exact content is served forever at /api/v1/blob/34210ee1cbcc11a3.
---
name: okhp3-as-is-process-capture
description: Capture and normalise a current-state process description into a structured as-is process YAML with stable step identifiers. Use this skill when the user has a process that is already running and needs to document its current state before gap analysis or redesign; when they provide step lists, SOPs, or process notes that need to be structured; when they say "document what we do today", "capture the current process", or "baseline the process before we change it". Produces a structured as-is process artifact with normalised step IDs.
license: MIT
homepage: https://github.com/overkillhill/mermaid-diagram-bpmn/tree/main/skills/as-is-process-capture
repository: https://github.com/overkillhill/mermaid-diagram-bpmn
metadata:
bp_skill_version: "0.3.0"
status: core
version: "0.1.0"
author: OverKill Hill P³
project: "BP-SKILL: Business Process Agent Skill Suite"
category: process-analysis
standards_refs:
- "BPM CBOK v4 §4.2 (As-Is Process Modelling)"
- "BABOK v3 §10.14 (Document Analysis)"
- "ISO 9001:2015 §4.4 (Quality Management System and its processes)"
produces: "as-is-process.yaml"
consumes: "pir.yaml"
depends_on: ["process-intake-and-scope"]
tags: as-is-capture, current-state, baseline, process-documentation, step-normalisation, BPM-CBOK
triggers:
- document the current process
- baseline the process
- capture what we do today
- as-is process
- current state
- document existing steps
- process baseline
origin: okhp3/skillz
homepage: https://overkillhill.com
author-github: https://github.com/OKHP3
in_scope: "The named stage of the governed business-process documentation lifecycle and its stated input-output handoff."
out_of_scope: "Inventing process facts, bypassing required upstream artifacts, or publishing without authorization."
---
# okhp3-as-is-process-capture
**OverKill Hill P³** · [overkillhill.com](https://overkillhill.com) · [github.com/OKHP3](https://github.com/OKHP3)
## Purpose
Capture and normalise the current-state (as-is) process into a structured YAML artifact. The as-is record uses stable `act-NNN` step identifiers that persist across revisions, making gap analysis and change tracking tractable.
---
## When to use this skill
- User describes how a process runs today and wants it documented before redesign
- You need a baseline artifact before running `process-gap-and-exception-analysis`
- PIR exists but steps lack stable IDs — normalise them with `scripts/assign-step-ids.mjs`
- User imports existing process notes, SOPs, or procedure documents for structuring
## When NOT to use this skill
- No PIR exists — run `process-intake-and-scope` first to establish scope and boundaries
- User wants to design a future state only — skip to `future-state-and-change-strategy`
- Do not include aspirational or proposed changes in the as-is record
---
## Capture Workflow
### Step 1 — Import and triage
Identify the source: natural language description, bullet list, existing SOP document, or flowchart image. Determine if a PIR already exists. If not, run `process-intake-and-scope` first.
### Step 2 — Extract and sequence steps
Parse all process steps in the order they occur. Each step must have:
- A single imperative action statement (IEEE 29148)
- An identified actor or role
- Entry criteria (what triggers this step)
- Exit criteria (what signals completion)
### Step 3 — Assign stable IDs
Run `scripts/assign-step-ids.mjs` to assign `act-001`, `act-002`, … identifiers. IDs are:
- Sequential within each process
- Prefixed `act-` for activities, `gw-` for gateways, `evt-` for events
- Stable — once assigned, they do not change even if steps are reordered
### Step 4 — Identify current-state gaps
Flag steps that are:
- Undocumented ("we just know to do it")
- Person-dependent ("only Alice knows this part")
- Inconsistently executed ("sometimes we skip this")
- Missing a named actor
Tag these with `capture_quality: low | medium | high`.
### Step 5 — Record as-is metadata
Document:
- `captured_date` — when this baseline was recorded
- `capture_method` — interview | document-review | observation | workshop
- `process_version` — current version of the process if known (default `"1.0-baseline"`)
- `baseline_status` — `draft | reviewed | approved`
---
## Output Schema
The `as-is-process.yaml` contains:
- `process_id` — matches PIR `process_id`
- `baseline_status` — draft | reviewed | approved
- `captured_date`, `capture_method`, `process_version`
- `steps[]` — each with `id`, `description`, `actor_role_id`, `entry_criteria`, `exit_criteria`, `capture_quality`, `systems[]`, `notes`
- `identified_gaps[]` — steps or sections with low capture quality or person-dependency
- `open_questions[]` — unresolved items from the capture session
---
## Handoff Instruction
Pass `as-is-process.yaml` to `process-gap-and-exception-analysis` to identify deviations, exception paths, and improvement opportunities.
Also pass `pir.yaml` to `process-narrative-authoring` when the as-is record is reviewed and approved.
---
## References
Load on demand:
- `references/as-is-capture-rules.md` — step ID conventions, capture quality taxonomy, and baseline metadata rules
## Scripts
- `scripts/assign-step-ids.mjs` — normalises a step list into stable act-NNN / gw-NNN / evt-NNN identifiers
## Assets
- `assets/fixtures/as-is-process-example.yaml` — canonical as-is capture for purchase-approval baseline
## About
Built by [Jamie Hill](https://overkillhill.com) · [OverKill Hill P³](https://overkillhill.com)
Published at [github.com/OKHP3](https://github.com/OKHP3)
Part of the [OKHP3/skillz](https://github.com/OKHP3/skillz) Agent Skill library.
MIT License -- free to use, fork, and adapt. A nod to the source is appreciated.