Skip to content
Development
Command

/edit

Edit an existing BPMN diagram, then re-layout, validate and lint

From plugin
bpmn
185 skills5 commands
> /plugin marketplace add architawr/claude-bpmn-skill
> /plugin install bpmn@bpmn-tools

Command definition

edit.md
description: Edit an existing BPMN diagram, then re-layout, validate and lint
argument-hint: <file.bpmn> — <change to make>

Use the **bpmn** skill to edit a BPMN diagram. Input (file plus the requested change): $ARGUMENTS

First `summarize` the file to understand it, apply the change to the semantics, then run `layout` → `validate` → `lint`. Report what changed and the result.

`layout` is **non-destructive by default**: on a file that already has a diagram it *preserves* the existing layout (including hand-tuned positions and Camunda multi-diagram sub-process pages) and only syncs it to your edit — pruning shapes for deleted elements and placing shapes for new ones. Only use `layout --rebuild` when the user explicitly wants the whole diagram re-laid-out from scratch.

@architawr
Ships withbpmn

A Claude Code 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…).

Stars on GitHub

Momentum

stars in total
18
Star history of architawr/claude-bpmn-skill on GitHub, a chart by star-history.com

Other commands on bpmn.

create

create

Command

Create a new BPMN 2.0 diagram from a text description

@architawr@architawrInstall Command
diff

diff

Command

Compare two BPMN files - what was added, removed, renamed, rewired

@architawr@architawrInstall Command
explain

explain

Command

Read a BPMN 2.0 .bpmn file and explain it in plain language

@architawr@architawrInstall Command
validate

validate

Command

Validate a BPMN file - structural checks plus control-flow lint

@architawr@architawrInstall Command

More commands from other plugins.

build
Auto-invoked

build

Command

Implement tasks incrementally — build, test, verify, commit. Add "auto" to run the whole plan in one approved pass.

@addyosmani@addyosmaniInstall Command