← ClaudeAtlas

bpmnlisted

Draws a business process as a BPMN 2.0 Descriptive diagram from a written description, then checks notation and readability. Use when mapping or documenting a process. Not for execution engines.
tzerecords/business-analyst-agent · ★ 0 · AI & Automation · score 73
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