| name | diagram-generator |
| description | Generates Mermaid flowcharts from parsed scenario data (scenario-reader output). Called by scenario-reporter and automation-planner. Saves diagrams to .make/diagrams/. |
Skill: diagram-generator
Generates Mermaid flowcharts from parsed scenario data (scenario-reader output).
Called by scenario-reporter and automation-planner.
Input
Structured scenario representation from scenario-reader skill.
Output
Valid Mermaid flowchart syntax. Save to .make/diagrams/{scenario-id}-{timestamp}.md.
See mermaid-template.md for the full Mermaid template and node naming rules.
Complexity Limit
If scenario has > 20 modules:
- Generate a high-level diagram (main flow only, collapse sub-flows)
- Generate separate detailed diagrams per branch
- Label files:
{id}-overview.md, {id}-branch-1.md, etc.
Plain Language Notes
After the diagram, add a plain-language key:
## What This Diagram Shows
This scenario starts when [trigger description]. It then [step 1], [step 2],
and finally [destination]. If anything fails, [error handling description].
File Format
Save as:
# Scenario Diagram: {scenario name}
Generated: {timestamp}
Scenario ID: {id}
## Flow Diagram
```mermaid
{diagram}
What This Diagram Shows
{plain-language description}
