bpmn-workflow

Generate BPMN 2.0 diagrams from feature specifications and link them to Gherkin scenarios.

341|48|Updated Apr 4, 2025
One-click install
npx skills add https://github.com/WellApp-ai/Well --skill bpmn-workflow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bpmn-workflow
Source: https://github.com/WellApp-ai/Well/tree/main/cursor-rules/skills/bpmn-workflow
Command: npx skills add https://github.com/WellApp-ai/Well --skill bpmn-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate BPMN 2.0 process diagrams from feature specifications and link them to Gherkin scenarios to improve clarity and traceability.

Core Features & Use Cases

  • Generate BPMN diagrams from feature contexts and wireframes.
  • Link BPMN elements to Gherkin scenarios for traceability and stakeholder communication.
  • Compose a master system diagram by aggregating feature-level BPMN diagrams.
  • Phase-driven workflow: gather context, create BPMN, link with Gherkin, and update system diagrams.

Quick Start

Use the BPMN Workflow Skill after you have feature specifications and wireframes. Run the MCP-based workflow to generate BPMN diagrams, link them to Gherkin scenarios, and update the master system diagram. Ensure the MCP server (bpmn-mcp) is configured and outputs are placed under docs/bpmn/.

Frequently Asked Questions about bpmn-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate BPMN diagrams from feature specifications?▼

To generate BPMN diagrams from feature specifications, provide your feature contexts and wireframes to the Skill, which then produces BPMN 2.0 process diagrams and outputs them to the configured docs/bpmn/ directory.

Can I link BPMN elements to Gherkin scenarios for traceability?▼

Yes, you can link BPMN elements to Gherkin scenarios for traceability by running the phase-driven workflow, which connects your generated BPMN process diagrams directly to their corresponding Gherkin scenarios.

What is the best way to compose a master system diagram from multiple feature-level BPMN files?▼

The best way to compose a master system diagram from multiple feature-level BPMN files is to use the Skill's aggregation phase, which consolidates individual feature-level BPMN artifacts into a unified system diagram.

Do I need a configured MCP server to run the BPMN workflow?▼

Yes, you need the bpmn-mcp server configured to run the BPMN workflow, as the generation process operates through MCP-driven phases to gather context, generate diagrams, and link Gherkin scenarios.

Does this workflow support stakeholder communication and feature exploration?▼

Yes, this workflow supports stakeholder communication and feature exploration by producing traceable BPMN artifacts and system diagrams that visually map feature specifications to Gherkin scenarios.

When should I not use automated BPMN diagram generation?▼

You should not use automated BPMN diagram generation if you lack feature specifications and wireframes, as the workflow requires these inputs to successfully gather context and produce traceable BPMN artifacts.