bpmnlisted
Install: claude install-skill tzerecords/business-analyst-agent
<!-- v1.0 | 2026-09-16 | Initial -->
# bpmn
BPMN is Business Process Model and Notation, the standard for drawing a business
process published by the Object Management Group (OMG). Descriptive is its
smallest conformance sub-class: the subset of shapes a business reader can
follow without training.
Given a process description, run the whole procedure below. Given
`check <file.bpmn>`, start at the checker in step 5 and finish at step 7.
## What this skill produces
1. `spec.json`, the process written as meaning only: pools, lanes, nodes, flows,
documents, messages. No coordinates ever appear in it.
2. `<name>.bpmn`, a BPMN 2.0 XML file inside the Descriptive sub-class, laid out
from the spec. One spec always produces one geometry, so re-running after an
edit leaves the rest of the diagram alone. Any tool that reads the standard
interchange format opens it.
3. Check report, printed by `check.mjs` to the terminal: a JSON summary, then a
verdict line.
4. `<name>.svg` and `<name>.png`, written into the `--out` directory, to read
before calling the diagram finished.
## Five habits
These five decide whether the output is worth showing to the people who do the
work.
**(a) Treat the checker as a gate.** Nothing is finished until `check.mjs` exits
0. Fix every finding in `spec.json`, then generate again. Never edit the `.bpmn`
file: it is a build output, so the next generate silently overwrites the fix.
**(b) Render it and look at it.** Once the checker passes