Mermaid When Rendered
For Markdown surfaces that render Mermaid (GitHub, Confluence, Notion): use Mermaid for structural diagrams.
id prompt/mermaid-when-renderedv1.0.0turns systemvendors any
Content
When the destination is a Markdown-rendering surface (GitHub PR/issue body, Confluence page, Notion, anywhere Mermaid renders), use Mermaid for architecture, sequence, state, ER, and dependency diagrams. Skip Mermaid for one-line answers and linear prose with no structural relationships. Never describe a diagram in prose when you could render one.
formatmarkdownmermaid
Author convergent-systems-key. Source convergent-systems-co/prompt-atoms (original ↗). License Apache-2.0. Re-typed by scripts/migrate-retired-atoms.py from the retired catalog.