BPMN 2.0 workflow tools: XML generation from natural language/markdown, and conversion to Draw.io format. Includes bundled bpmn2drawio Python tool.

version
4.4.0
GitHub stars
5

Install

/plugin install bpmn-plugin@troys-plugins

Run it inside Claude Code after adding the marketplace with /plugin marketplace add davistroy/claude-marketplace.

Contents

Discovered from source

Skills 2

BPMN 2.0 XML Generator

Overview

This skill transforms process descriptions into fully compliant BPMN 2.0 XML files. It operates in two modes:

ModeTriggerWorkflow
InteractiveNatural language description, no file providedStructured Q&A to gather requirements
Document ParsingMarkdown file path providedParse document structure, extract elements

The generated XML includes:

  • Complete process definitions with all BPMN elements
  • Proper namespace declarations for BPMN 2.0 compliance
  • Diagram Interchange (DI) data for visual rendering
  • Phase comments for PowerPoint generation compatibility
  • Layouts compatible with Draw.io, Camunda, Flowable, and bpmn.io

MODE DETECTION

Automatic Mode Selection

Determine the operating mode based on user input:

IF user provides a markdown file path (.md):
    → Document Parsing Mode
ELSE IF user provides a natural language description:
    → Interactive Mode

Document Parsing Mode Indicators

  • File path ending in .md
  • "convert this document", "parse this file"
  • "generate BPMN from [filename]"
  • Markdown content pasted directly

Interactive Mode Indicators

  • Brief process description without file
  • "create a BPMN for...", "model a process that..."
  • Questions about process design
  • No structured document provided

Preview Mode

Both modes support an optional --preview flag:

When --preview is specified:

  1. Generate the complete BPMN XML in memory
  2. Validate structure (namespace, elements, flows)
  3. Display summary:
    Preview: /bpmn-generator
    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
    Process: Order Fulfillment
    Source: Interactive mode
    
    Structure Summary:
      Pools: 1
      Lanes: 3 (Sales, Operations, Shipping)
      Tasks: 8 (5 user, 3 service)
      Gateways: 2 (1 exclusive, 1 parallel)
      Events: 2 (1 start, 1 end)
    
    Validation: PASSED
    Output file: order-fulfillment.bpmn
    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
    
    
  4. Confirm with AskUserQuestion before writing anything — a single question, header: "Save", options Save the file (recommended, states the output path) and Discard (exits without writing). Wait for the response.
  5. On Discard or a skipped question: exit without saving

PART 1: INTERACTIVE MODE

Use this mode when the user provides a natural language description without a structured document.

Interactive Question Framework

Purpose

Initial process descriptions are rarely sufficient for optimal BPMN generation. This mode uses a structured clarification process to gather complete requirements before generating XML.

Question Format

Every clarifying question is asked with the native AskUserQuestion tool — one question per call, 2–4 real options, the recommended one first and labelled (Recommended). Never hand-roll a lettered menu, and never add a "provide your own" or "skip" option: the harness supplies a free-text Other box and a Skip control on every question.

The canonical shape, the 22 ready-made question blocks, and the rules that govern them live in references/clarification-patterns.md (Question Format Template). Read it before asking the first question and instantiate its blocks rather than inventing new ones.

Auto-Accept Mode

Reached through the free-text Other box at any question — see Auto-Accept Mode Behavior in references/clarification-patterns.md, which owns the trigger, the recommended-answer rule, and the decisions-summary table rendered before XML generation.

Question Phases

Process questions in this specific order:

Phase 1: Process Scope (Questions 1-3)
  • Process name and identifier
  • Process trigger (start event type)
  • Process completion states (end event types)
Phase 2: Participants (Questions 4-5)
  • Single process vs. collaboration (multiple pools)
  • Lanes/roles within pools
Phase 3: Activities (Questions 6-10)
  • Main activities/tasks identification
  • Task types for each activity
  • Task descriptions/documentation (CRITICAL for PowerPoint generation)
  • Task sequencing and dependencies
  • Subprocess candidates
Phase 4: Flow Control (Questions 11-15)
  • Decision points requiring gateways
  • Gateway types (exclusive, parallel, inclusive, event-based)
  • Default flows
  • Loop/cycle detection
Phase 5: Events & Exceptions (Questions 16-19)
  • Intermediate events (timer, message, signal)
  • Boundary events on tasks
  • Error handling approach
  • Compensation requirements
Phase 6: Data & Integration (Questions 20-22)
  • Data objects needed
  • External system integrations
  • Message flows (for collaborations)
Phase 7: Optimization Review (Question 23)
  • Final review of proposed structure
  • Opportunity for adjustments

Session Control

There is no session-command interpreter. The native UI already provides what the old help/status/back/skip/quit REPL simulated: Skip is the skip command, closing the question is quit, and status is redundant when the interview is visible in the transcript. back has no native equivalent — if the user asks to revisit an earlier question in free text, re-ask it and overwrite the recorded decision.

Adaptive Questioning

Skip questions that don't apply:

  • Skip participant questions for simple single-pool processes
  • Skip data questions if no data dependencies mentioned
  • Skip error handling if process is straightforward
  • Always ask critical questions: start event, main tasks, end events

PART 2: DOCUMENT PARSING MODE

Use this mode when the user provides a markdown file containing a structured business process document.

Document Analysis Steps

Step 1: Identify Document Structure

Analyze the markdown document for structural elements that map to BPMN constructs. Key patterns: H1 = process name, H2/H3 "Phase/Step" = phase comments, numbered lists = tasks, role tables = lanes, conditional language = gateways, "begins when" = start events, "completes when" = end events. See ../references/markdown-parsing-guide.md for the complete document structure mapping table.

Step 2: Extract Process Metadata

From the document, extract:

process_name: [from H1 or title]
process_id: [sanitized process_name, e.g., "SocialMediaCommunityManagement"]
description: [from executive summary or overview section]
version: [from document metadata if present]
roles: [list of all mentioned roles/actors]
phases: [ordered list of phase names from section headings]

Step 3: Map Roles to Lanes

Use the lane mapping configuration in ../templates/lane-mapping.yaml to assign colors. Read references/bpmn-elements.md for the complete role-to-lane color mapping table (Sales, Legal, Finance, IT, Implementation, Training, Customer Success, Support, Customer).

Step 4: Parse Phases and Tasks

Phase Detection Patterns

Match headings like "## Step 1:", "### Phase 2:", or "## 1.1 Section" using H2-H4 with step/phase/stage keywords or numbered sections. See ../references/markdown-parsing-guide.md for regex patterns.

Task Type Inference

Use the task type selection table in references/bpmn-elements.md to map markdown language to BPMN task types. Common shortcuts: "reviews/approves" = userTask, "system/API" = serviceTask, "sends/notifies" = sendTask, "waits for/receives" = receiveTask, "subprocess" = subProcess.

Step 5: Extract Documentation

Critical: Every task MUST have a <bpmn:documentation> element. Extract from:

  1. Paragraph following task heading
  2. Bullet points under task name
  3. Table cell descriptions
  4. "Process Description:" sections

Combine multiple sources into comprehensive documentation:

<bpmn:userTask id="Activity_ReviewTriage" name="Review and Triage">
    <bpmn:documentation>
        Community Manager and Social Team Lead manually review inbound interactions
        to assess and categorize them. Triage criteria includes: Topic/Intent,
        Location Relevance, Urgency, Risk Level, and Sentiment. Categories include
        location-specific issues, digital inquiries, brand questions, escalations,
        spam, and general engagement.
    </bpmn:documentation>
</bpmn:userTask>

PART 3: SHARED BPMN GENERATION

Both modes use the same BPMN generation rules.

BPMN Element Mapping

Read references/bpmn-elements.md (relative to this plugin's directory) for element type mappings and DI constants, including:

  • Task Type Selection - keyword-to-BPMN-task-type mapping (userTask, serviceTask, sendTask, etc.)
  • Gateway Selection - decision-pattern-to-gateway-type mapping (exclusive, parallel, inclusive, event-based)
  • Event Selection - start and end event type mappings with XML elements

Phase Comments (CRITICAL for PowerPoint)

Always include phase comments to enable automatic phase detection for PowerPoint presentations:

<bpmn:process id="Process_Example" name="Example Process" isExecutable="true">

    <!-- Phase 1: Intake and Validation -->
    <bpmn:startEvent id="StartEvent_1" name="Request Received">
        ...
    </bpmn:startEvent>

    <!-- Phase 2: Processing -->
    <bpmn:serviceTask id="Activity_Process" name="Process Request">
        ...
    </bpmn:serviceTask>

    <!-- Phase 3: Fulfillment -->
    <bpmn:userTask id="Activity_Fulfill" name="Fulfill Request">
        ...
    </bpmn:userTask>

</bpmn:process>

XML Generation Rules

Required Structure

<?xml version="1.0" encoding="UTF-8"?>
<bpmn:definitions
    xmlns:bpmn="http://www.omg.org/spec/BPMN/20100524/MODEL"
    xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI"
    xmlns:dc="http://www.omg.org/spec/DD/20100524/DC"
    xmlns:di="http://www.omg.org/spec/DD/20100524/DI"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    id="Definitions_[unique-id]"
    targetNamespace="http://bpmn.io/schema/bpmn"
    exporter="Claude BPMN Generator"
    exporterVersion="2.0">

    <!-- Process definition goes here -->

    <!-- Diagram interchange goes here -->

</bpmn:definitions>

ID Generation Rules

Read references/bpmn-elements.md for the complete ID pattern table (Process, StartEvent, EndEvent, Activity, Gateway, Lane, Flow patterns with examples).

Sequence Flow Rules

  1. Every element (except start events) MUST have at least one incoming flow
  2. Every element (except end events) MUST have at least one outgoing flow
  3. Gateways splitting must eventually merge (except for end paths)
  4. Conditional flows MUST have condition expressions:
<bpmn:sequenceFlow id="Flow_1" sourceRef="Gateway_1" targetRef="Task_2">
    <bpmn:conditionExpression xsi:type="bpmn:tFormalExpression">
        ${condition == true}
    </bpmn:conditionExpression>
</bpmn:sequenceFlow>
  1. Default flows from gateways:
<bpmn:exclusiveGateway id="Gateway_1" default="Flow_default">
    ...
</bpmn:exclusiveGateway>
<bpmn:sequenceFlow id="Flow_default" sourceRef="Gateway_1" targetRef="Task_3"/>

Diagram Interchange Generation

Element Dimensions and Layout Constants

Read references/bpmn-elements.md for element dimension tables (width/height for events, tasks, gateways, subprocesses) and Draw.io-compatible layout constants (pool label width, lane offsets, element spacing).

Cross-Lane Edge Rule (CRITICAL)

Edges crossing lane boundaries MUST have parent="1" (root) with absolute mxPoint coordinates when targeting Draw.io conversion.

Validation Checklist

Before outputting XML, verify:

Structural Integrity

  • Exactly one start event (or multiple for event subprocess)
  • At least one end event
  • All elements connected via sequence flows
  • No orphaned elements
  • All IDs unique within document

Flow Validity

  • Start events have no incoming flows
  • End events have no outgoing flows
  • All other elements have both incoming and outgoing flows
  • Parallel splits have matching parallel joins
  • No infinite loops without exit condition

BPMN 2.0 Compliance

  • All required namespaces declared
  • All elements have required attributes (id, name where applicable)
  • Conditional flows have condition expressions
  • Default flows properly marked on gateways
  • Event definitions properly nested

Documentation & Phases

  • All tasks have <bpmn:documentation> elements
  • Phase comments included for PowerPoint compatibility
  • Documentation is comprehensive (not just task name repeated)

Diagram Interchange

  • Every process element has corresponding BPMNShape
  • Every sequence flow has corresponding BPMNEdge
  • All shapes have valid Bounds (x, y, width, height)
  • All edges have at least 2 waypoints
  • No negative coordinates
  • Elements don't overlap

OUTPUT FORMAT

For Interactive Mode

1. Decision Summary

Display a "Process Configuration Summary" with process name, ID, and a decisions table (# / Topic / Decision).

2. Process Description

Show a brief narrative of the process flow with a flow summary line (Start -> Task -> Gateway -> End).

3. BPMN XML File

Write the complete XML to a file named [process-name].bpmn in the current directory.

For Document Parsing Mode

1. Conversion Summary

Display source document, process name/ID, extracted structure counts (phases, roles/lanes, tasks by type, gateways, events), and any assumptions made during parsing.

2. BPMN XML File

Write complete XML to [process-name].bpmn

Common Output

Validation Confirmation

After generating XML, display validation results confirming: structural checks passed, flow validity passed, BPMN 2.0 compliance verified, diagram interchange complete, phase comments included, and the output filename.


Performance

Process ComplexityElementsExpected DurationNotes
Simple (linear flow)5-101-3 minutesFew gateways, single pool
Medium (branching)10-303-8 minutesMultiple gateways, 2-4 lanes
Complex (collaboration)30-608-15 minutesMultiple pools, message flows, subprocesses
Document parsing modevaries2-5 minutesFaster than interactive; no Q&A overhead

Interactive mode duration is dominated by the Q&A clarification phases (user response time not included). XML generation and DI coordinate calculation add 10-30 seconds regardless of complexity. Document parsing mode is faster because it skips the interactive question framework and extracts structure directly from markdown.

Error Handling

  • No file path and no process description provided: Ask the user for one before proceeding — do not guess a process or mode (see Mode Detection).
  • Document Parsing Mode input doesn't match any known structural pattern (no headings, no numbered steps, no role table): fall back to Interactive Mode and tell the user why, rather than emitting a mostly-empty BPMN file.
  • Validation Checklist failures (orphaned elements, missing flows, undocumented tasks) before writing output: fix the specific element or ask the user for the missing detail — never emit non-compliant XML.
  • Preview Mode declined (n/no): exit without writing any file.
  • Unrecognized session command during Interactive Mode Q&A: show the help message (see Session Commands) rather than silently treating it as an answer choice.
  • Referenced support files missing (../references/*.md, ../templates/*): report which file is missing and proceed using the inline defaults documented in Part 3 rather than failing outright.

REFERENCES

For detailed specifications, see:

  • ../references/bpmn-elements.md - Element type mappings, DI constants, ID patterns, and lane colors
  • ../references/bpmn-elements-reference.md - Complete element catalog
  • ../references/xml-namespaces.md - Namespace documentation
  • ../references/clarification-patterns.md - Question templates (Interactive mode)
  • ../references/markdown-parsing-guide.md - Document parsing patterns (Document mode)

For templates, see:

  • ../templates/bpmn-skeleton.xml - Base structure
  • ../templates/element-templates.xml - Element snippets
  • ../templates/lane-mapping.yaml - Role to lane color mapping

For examples, see:

  • ../examples/ - Complete working examples for both modes

BPMN to Draw.io Converter

Overview

This skill converts BPMN 2.0 XML files into Draw.io native format (.drawio) using the bpmn2drawio Python tool. The tool provides:

  • Automatic Graphviz-based layout for files without DI coordinates
  • Four built-in themes with custom YAML branding support
  • Visual markers for gateways (X, +, O) and task/event icons
  • Complete swimlane support with proper hierarchy
  • Model validation with error recovery

Conversion Workflow

Follow these steps in order. The workflow automatically handles dependency installation.

Step 1: Set Up Tool Path

The tool is bundled in the plugin's tools/bpmn2drawio/ directory. Use ${CLAUDE_PLUGIN_ROOT} for the plugin path (auto-set for marketplace-installed plugins):

# Use CLAUDE_PLUGIN_ROOT (auto-set for marketplace-installed plugins)
PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-/path/to/plugins/bpmn-plugin}"
TOOL_SRC="$PLUGIN_DIR/tools/bpmn2drawio/src"

Step 2: Check and Install Python Dependencies

Check for required Python packages and install any that are missing:

# Check which packages are missing
python -c "import lxml" 2>/dev/null || echo "lxml: MISSING"
python -c "import networkx" 2>/dev/null || echo "networkx: MISSING"
python -c "import yaml" 2>/dev/null || echo "pyyaml: MISSING"
python -c "import pygraphviz" 2>/dev/null || echo "pygraphviz: MISSING (requires Graphviz)"

If any packages are missing (except pygraphviz), ask the user:

"The following Python packages are missing: [list]. Install them now with pip install [packages]?"

If user approves:

pip install lxml networkx pyyaml

Note: pygraphviz is handled separately in Step 3 because it requires Graphviz.

Step 3: Check Graphviz and pygraphviz

The tool's default --layout auto resolves to preserve — using the file's own BPMN DI coordinates — only when every element in the file already has a position, and falls back to Graphviz-based layout otherwise. Graphviz is therefore not required for files with complete DI coordinates, but you can't know in advance which files those are, so check availability up front:

# Check for Graphviz
dot -V 2>/dev/null && echo "Graphviz: OK" || echo "Graphviz: MISSING"

If Graphviz is missing, display this standardized error:

Error: Required dependency 'graphviz' not found

/bpmn-to-drawio requires Graphviz when a BPMN file's DI coordinates are
missing or incomplete (the default --layout auto falls back to Graphviz
in that case).

Installation instructions:
  Windows: choco install graphviz
  macOS:   brew install graphviz
  Linux:   sudo apt install graphviz libgraphviz-dev

After installing Graphviz, also install the Python bindings:
  pip install pygraphviz

After installing, run the command again.

Note: If your BPMN file already has COMPLETE layout coordinates (every
element positioned), --layout auto will use them and Graphviz is not
needed. Do not force --layout=preserve as a workaround unless you have
verified the file's DI is complete — on a partially-positioned file it
strands the unpositioned elements at (0,0) instead of laying them out.

If user wants to install Graphviz, guide them through:

# Detect OS and install
if [[ "$OSTYPE" == "linux-gnu"* ]]; then
    sudo apt-get update && sudo apt-get install -y graphviz libgraphviz-dev
elif [[ "$OSTYPE" == "darwin"* ]]; then
    brew install graphviz
elif [[ "$OSTYPE" == "msys" ]] || [[ "$OSTYPE" == "cygwin" ]] || [[ -n "$WINDIR" ]]; then
    choco install graphviz -y
fi

After Graphviz is installed, install pygraphviz:

pip install pygraphviz

Step 4: Analyze Source BPMN

Check for structural complexity — used later to populate the conversion summary:

  • <bpmn:participant> - Multiple pools
  • <bpmn:lane> - Swimlanes present

The tool's --layout auto (the default; see Step 5) inspects the parsed model and resolves the layout mode itself. Do not grep the file for DI coordinates here to pre-select a --layout flag — that duplicates a decision the tool already makes correctly.

Step 5: Run Conversion

Default (--layout auto) — let the tool decide:

PYTHONPATH="$TOOL_SRC" python -m bpmn2drawio input.bpmn output.drawio

This is the recommended invocation for nearly all conversions. auto is the default when --layout is omitted; the tool inspects the parsed model and resolves preserve or graphviz itself — no pre-check of the file's DI content required.

Explicit override — only after verifying the file's DI is complete:

PYTHONPATH="$TOOL_SRC" python -m bpmn2drawio input.bpmn output.drawio --layout=preserve

Forcing preserve on a file whose DI is missing or incomplete strands the unpositioned elements at (0,0). Prefer the default auto unless you have specifically verified every element already has a position.

Explicit override — force Graphviz even if DI coordinates exist:

PYTHONPATH="$TOOL_SRC" python -m bpmn2drawio input.bpmn output.drawio --layout=graphviz

With theme:

PYTHONPATH="$TOOL_SRC" python -m bpmn2drawio input.bpmn output.drawio --theme=blueprint

Verbose output for debugging:

PYTHONPATH="$TOOL_SRC" python -m bpmn2drawio input.bpmn output.drawio --verbose

Step 6: Validate Output

Verify the conversion succeeded:

# Check file was created and has content
ls -la output.drawio
head -30 output.drawio

CLI Reference

Full command syntax, arguments, --theme/--layout/--direction/etc. options, and direction values — see ../references/bpmn2drawio-reference.md#cli-reference.


Themes

Built-in theme options (default, blueprint, monochrome, high_contrast) and custom YAML brand configuration (event/task/gateway/swimlane colors, lane-color pattern matching) — see ../references/bpmn2drawio-reference.md#themes.


Dependencies

Dependencies are checked and installed automatically during the conversion workflow (Steps 2-3).

Python Packages

  • lxml - XML parsing
  • networkx - Graph algorithms
  • pyyaml - YAML configuration parsing
  • pygraphviz - Graphviz Python bindings (requires Graphviz)

System Dependencies

  • Graphviz - Required for automatic layout generation
    • Not required when the file has complete DI coordinates — the default --layout auto resolves to preserve automatically in that case

Manual Installation (if needed)

Python packages:

pip install lxml networkx pyyaml pygraphviz

Graphviz:

  • Ubuntu/Debian: sudo apt-get install graphviz libgraphviz-dev
  • macOS: brew install graphviz
  • Windows: choco install graphviz

Python API

For programmatic use within scripts (Converter, parse_bpmn, validate_model) — see ../references/bpmn2drawio-reference.md#python-api.


Supported BPMN Elements

Full tables of supported Events, Activities, Gateways, Flows, and Containers (pools/lanes) — see ../references/bpmn2drawio-reference.md#supported-bpmn-elements.


Troubleshooting

Common Issues

IssueCauseSolution
ModuleNotFoundError: bpmn2drawioPYTHONPATH not setSet PYTHONPATH="$TOOL_SRC" before running
ModuleNotFoundError: lxmlMissing dependencyRun pip install lxml
ModuleNotFoundError: pygraphvizGraphviz not installedInstall Graphviz first, then pip install pygraphviz
Empty output fileInvalid BPMN inputCheck BPMN file validity
Elements overlapping / stranded at (0,0)--layout=preserve forced on a file with incomplete DIDon't force --layout=preserve — use the default --layout auto, which already falls back to Graphviz for incomplete DI
Wrong flow directionDefault is LRUse --direction=TB for vertical

Validation Errors

If the tool reports validation warnings:

# Run with verbose to see details
bpmn2drawio input.bpmn output.drawio --verbose

Common validation issues:

  • Orphan elements: Tasks not connected to flows
  • Missing end events: Process has no termination
  • Dangling sequence flows: Flow references non-existent element

The tool attempts recovery for most issues but warnings indicate potential problems.

Manual Inspection

If output doesn't render correctly in Draw.io:

  1. Open the .drawio file in a text editor
  2. Check for <mxCell> elements with valid geometry
  3. Verify cross-lane edges have parent="1"
  4. Check that all referenced IDs exist

Output Format

Conversion Summary

After successful conversion, report:

## Draw.io Conversion Summary

**Source File:** input.bpmn
**Output File:** output.drawio
**Theme:** default
**Layout:** graphviz
**Direction:** LR

### Elements Converted:
- Pools: X
- Lanes: X
- Tasks: X
- Gateways: X
- Events: X
- Sequence Flows: X
- Message Flows: X

### Validation:
✓ All elements converted successfully
✓ No orphan elements detected
✓ All flows connected

### Next Steps:
- Open output.drawio in Draw.io Desktop or diagrams.net
- Verify visual layout matches expectations
- Adjust element positions if needed

Fallback: Manual Conversion

If the bpmn2drawio tool is unavailable and cannot be installed, fall back to manual conversion using the reference documents:

  1. Conversion Standard: ../references/BPMN-to-DrawIO-Conversion-Standard.md
  2. Element Styles: ../templates/element-styles.yaml
  3. Draw.io Skeleton: ../templates/drawio-skeleton.xml

Manual Conversion Steps

  1. Parse BPMN XML to extract elements, flows, and DI coordinates
  2. Build coordinate registry for all elements
  3. Generate Draw.io XML structure
  4. Create pool and lane hierarchy
  5. Place elements within lanes
  6. Generate edges (intra-lane with relative coords, cross-lane with absolute)
  7. Write output file

Critical Rules for Manual Conversion:

  • Cross-lane edges MUST have parent="1" with absolute mxPoint coordinates
  • Lane positions are relative to their parent pool
  • Element positions are relative to their parent lane
  • Always calculate absolute coordinates for cross-lane edge routing

Performance

BPMN SizeElementsExpected DurationNotes
Small5-15Under 10 secondsSimple processes, single pool
Medium15-5010-30 secondsMultiple lanes, moderate gateways
Large50-10030-90 secondsMultiple pools, complex routing
Very large100+1-3 minutesGraphviz layout dominates at scale

Duration is dominated by Graphviz layout computation for files whose DI coordinates are missing or incomplete. When a file's DI coordinates are complete, the default --layout auto resolves to preserve automatically and conversion finishes in under 5 seconds regardless of size — no flag needed. Do not force --layout=preserve on a file with incomplete DI as a speed optimization: unpositioned elements are stranded at (0,0) instead of being laid out. Dependency installation (first run only) may add 30-60 seconds.

References

  • Bundled Tool: ../tools/bpmn2drawio/ (source code included in this plugin)
  • Original Repository: https://github.com/davistroy/bpmn/tree/main/bpmn2drawio
  • Conversion Standard: ../references/BPMN-to-DrawIO-Conversion-Standard.md
  • Element Styles: ../templates/element-styles.yaml
  • Draw.io Skeleton: ../templates/drawio-skeleton.xml
  • Example Files: ../examples/

Sponsors

Details

Marketplace
davistroy/claude-marketplace
Source
plugins/bpmn-plugin
Category
Workflow

More from davistroy/claude-marketplace

All 3