documenting-with-diagrams
Installation
SKILL.md
Documenting with Diagrams
Core Principle
Use Mermaid only when a visual relationship is easier than prose.
Reference: mmdc-cli for CLI flags, examples for walkthroughs.
Question → Type
| Question | Type |
|---|---|
| What owns / depends on what? | flowchart + subgraph |
| Who interacts in what order, with what outcomes? | sequenceDiagram |
| How does a decision / algorithm branch? | flowchart |
| Which durable states + transitions? | stateDiagram-v2 |
| Data entity relations? | erDiagram |
| Class / interface relations? | classDiagram |
| What happened / planned over time? | timeline |