Skip to content
Development
Command

/diff

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

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

Command definition

diff.md
description: Compare two BPMN files - what was added, removed, renamed, rewired
argument-hint: <old.bpmn> <new.bpmn>

Use the **bpmn** skill to compare two BPMN files: $ARGUMENTS

Run `diff <a> <b>` to get the semantic + structural delta: flow elements added, removed, renamed, or retyped, and sequence flows whose source/target changed. Then explain the changes in plain business language - not raw IDs - grouped by what they mean for the process (new steps, removed paths, rerouted flow, relabeled activities). This is the tool for As-Is vs To-Be reviews and for showing exactly what an edit changed.

If only one path is given, ask for the second file. The order is `old new`, so "added" means present in the second file but not the first.

@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
edit

edit

Command

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

@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