Diagrams — Mermaid

Rules

1. Use Mermaid (flowchart, sequenceDiagram, stateDiagram, erDiagram) in Markdown and specs.
2. Never hand-draw ASCII diagrams (boxes with |---|, trees in plain text).
3. Update diagrams when the flow changes.
4. Exception: terminal commands and config snippets are not diagrams.
5. Prefer flowchart / sequenceDiagram; avoid block-beta (poor viewer support).

Validate before showing the user

Every Mermaid block must parse successfully before you send the doc or message.

Workflow