architawr/claude-bpmn-skill
5 stars · Last commit 2026-05-21
Claude Code plugin (Agent Skill) for BPMN 2.0 - read, explain, create & edit .bpmn process diagrams with clean auto-generated layout, validation, and control-flow linting (deadlocks, stuck tokens). Works with Camunda Modeler & bpmn.io.
README preview
# bpmn — Claude Code plugin for BPMN 2.0 A [Claude Code](https://code.claude.com/docs) plugin that lets Claude work with **BPMN 2.0** process diagrams (`.bpmn` XML): read and explain them in plain language, and create or edit them so they come out **valid and visually clean** in any modeler (Camunda Modeler, bpmn.io, Cawemo…). The model does the semantic reasoning (what the process means, what to change); a small bundled Node script does the deterministic mechanics — parsing, regenerating layout, validating, and linting control flow. ## What it can do - **Explain** a `.bpmn`: happy path, decision points, exception/timeout handling. - **Create / edit** processes from a description (you never hand-write diagram coordinates), with full layout coverage: collaborations (all pools + message flows), swimlanes, sub-process drill-down pages, and data objects/annotations. - **Edit non-destructively**: layout is **safe by default** — on a file that already has a diagram it preserves the layout (hand-tuned positions, Camunda multi-diagram sub-process pages) and only prunes shapes for deleted elements