Diagram Conventions¶

Use these conventions to keep diagrams readable and consistent.

Standards¶

• prefer TB direction for dense graphs
• keep node labels short and explicit
• use quoted Mermaid labels to avoid parse/render issues
• split large diagrams into staged subgraphs
• pair each major diagram with a short explanatory paragraph

Practical Limits¶

• keep high-level diagrams below ~15 nodes
• move detail into follow-up diagrams instead of one giant graph
• avoid crossing arrows where possible

Example Pattern¶

flowchart TB
    A["Stage A"] --> B["Stage B"] --> C["Stage C"]