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.