Mermaid Diagrams

Produce a Mermaid diagram that a human reads correctly on the first pass and that actually renders on the destination host. Readability outranks completeness: a diagram that needs study has failed even if every fact is in it.

Baseline: Mermaid v11.16 syntax, written down to the version-safe subset when the destination host is older or unknown. Keep reusable examples in English with neutral sample domains; for user artifacts, follow the requested or source language and never introduce names, incident details, or unreleased context the user did not provide.

Reference Files

File	Read when
`references/syntax-pitfalls.md`	Before writing any non-trivial diagram, or when a diagram fails to parse — line-break trap, parser breakers, escaping, frontmatter config
`references/diagram-catalog.md`	Choosing a type, choosing detail level, or wanting a starting pattern — includes v11 types and compact-vs-detailed forms
`references/color-and-style.md`	When color/emphasis would add meaning — ready palettes, themeVariables, dark-mode survival, hierarchy without color
`references/renderer-compat.md`	When the destination host matters or before shipping — host matrix, version gates, validation workflow

Non-Negotiable Syntax Rules

The five failures that dominate real-world broken diagrams:

mermaid-diagrams

Mermaid Diagrams

Reference Files

Non-Negotiable Syntax Rules