| name | miro-diagram-generator |
| description | Generate Miro board prompts for architecture diagrams. Use this skill to produce per-view Miro prompts from canonical 4+1 diagram sources, with RISEN structure, strict scope boundaries, and track-specific validation. |
| metadata | {"skill-author":"Marie-Lynne Block"} |
Miro Diagram Generator
Generates Miro prompt artefacts for architecture views.
This skill is output-track specific:
- consumes canonical architecture view content
- produces Miro prompts only
- does not own 4+1 method logic
Inputs required
For each view, provide:
- view name (
logical, process, development, physical, scenarios)
- audience (
dev-only, cross-functional, executive)
- exact component list
- exact relationship list
- canonical source path (
.mmd or .puml)
Workflow
Step 1 — Load template
Use templates/miro-prompt-template.md as the base.
Step 2 — Fill RISEN sections
The prompt must include:
- Role
- Input
- Steps
- Expectation
- Narrowing
Step 3 — Enforce deterministic specificity
All prompts must include:
- explicit frame title
- explicit counts of shapes and arrows
- explicit labels for all entities and connectors
- explicit arrow semantics (solid/dashed/dotted)
- explicit exclusions in Narrowing
- for BPMN/swimlane process views, explicit shared semantic mapping: user task = primary, service task/start event = success, gateway = warning, end event = error, lane = neutral
Step 4 — Validate against canonical source
Check that names and relationships in the prompt match the canonical source exactly.
Step 5 — Write per-view output
Output files:
diagrams/miro/
<view>-miro-prompt.md
Optional aggregate output:
diagrams/miro/full-board-prompt.md
Use templates/full-board-prompt-template.md when the user wants one aggregate board prompt that orchestrates all per-view Miro prompts.
Output contract
Each output must be:
- valid markdown
- one view per file
- scoped to the target view only
- free of cross-view leakage
Validation checklist
- naming pattern:
<view>-miro-prompt.md
- template sections present (Role, Input, Steps, Expectation, Narrowing)
- all component names match canonical source
- all relationship labels match canonical source
- no unlabeled arrows in instructions
- no unsupported decorative elements
- BPMN/swimlane process prompts include the shared semantic mapping above
References
templates/miro-prompt-template.mdtemplates/full-board-prompt-template.mdexamples/synth-claim/miro-prompts/
