bpmn-generator

name	bpmn-generator
description	Generate and validate BPMN 2.0 diagrams from process descriptions
allowed-tools	["Read","Write","Glob","Grep","Bash"]
metadata	{"specialization":"business-analysis","domain":"business","id":"SK-002","category":"Process Modeling"}

BPMN Diagram Generator

Overview

The BPMN Diagram Generator skill provides specialized capabilities for creating, validating, and exporting BPMN 2.0 (Business Process Model and Notation) compliant process diagrams. This skill enables transformation of natural language process descriptions into standardized process models that can be used across various process modeling tools.

Capabilities

BPMN 2.0 Generation

• Generate BPMN 2.0 compliant XML from natural language process descriptions
• Create properly structured process diagrams with correct notation
• Support all BPMN 2.0 element types (activities, events, gateways, flows)
• Generate collaboration diagrams with multiple pools and lanes

Notation Validation

• Validate BPMN notation correctness against specification
• Check for proper use of start/end events
• Verify gateway logic and flow completeness
• Identify unreachable activities or incomplete paths

Swimlane Layout

• Create swimlane layouts automatically based on participant roles
• Organize activities by responsible parties
• Handle cross-lane message flows
• Optimize layout for readability

Gap Identification

• Identify missing gateways in decision points
• Flag missing events (start, end, intermediate)
• Detect incomplete or disconnected flows
• Highlight activities without clear inputs/outputs

AS-IS to TO-BE Comparison

• Generate side-by-side comparison views
• Highlight differences between current and future states
• Track process improvement changes
• Calculate process metric differences

Multi-Format Export

• Export to SVG for web display
• Export to PNG for documentation
• Export to BPMN XML for tool import
• Generate Markdown representations for documentation

Tool Integration

• Integrate with Camunda process engine format
• Support Bizagi file format
• Compatible with Signavio exports
• Support for draw.io BPMN diagrams

Usage

Generate BPMN from Description

Generate a BPMN 2.0 diagram for the following process:
[Process description in natural language]

Include swimlanes for each role mentioned and proper gateway notation.

Validate Existing BPMN

Validate this BPMN diagram for compliance:
[BPMN XML content]

Check for notation correctness and process completeness.

AS-IS to TO-BE Comparison

Compare the AS-IS and TO-BE processes:

AS-IS: [Current process description]
TO-BE: [Future process description]

Generate comparison view highlighting improvements.

Process Integration

This skill integrates with the following business analysis processes:

• bpmn-process-modeling.js - Core BPMN modeling activities
• sipoc-process-definition.js - Process boundary definition
• value-stream-mapping.js - Process flow visualization
• process-gap-analysis.js - Current vs future state comparison

Dependencies

• BPMN 2.0 specification library
• Diagram rendering capabilities
• XML generation and validation
• Layout algorithms for swimlane optimization

BPMN 2.0 Elements Reference

Flow Objects

• Events: Start, Intermediate, End (Message, Timer, Error, Signal, etc.)
• Activities: Task, Sub-Process, Call Activity
• Gateways: Exclusive, Inclusive, Parallel, Event-Based, Complex

Connecting Objects

• Sequence Flows: Connect flow objects within a pool
• Message Flows: Connect objects between pools
• Associations: Connect artifacts to flow objects

Swimlanes

• Pools: Represent participants/organizations
• Lanes: Subdivisions within pools for roles/departments

Artifacts

• Data Objects: Information flowing through process
• Groups: Visual grouping of elements
• Annotations: Additional explanatory text