---
description: "Diagram and visualization preferences for documentation"
globs: ["*.md", "docs/**"]
---

## Documentation Diagram Standards

- NEVER use ASCII art diagrams (box-drawing characters, pipes, dashes)
- ALWAYS use Mermaid diagrams for architecture, flows, and sequences
- Mermaid renders natively on GitHub, Notion, and most markdown viewers
- For README files, use Mermaid `graph`, `sequenceDiagram`, or `flowchart` syntax
- Keep diagrams high-level and professional — not cluttered with implementation details
- Use subgraphs for logical grouping
- Prefer `graph TD` (top-down) for architecture, `sequenceDiagram` for flows, `flowchart LR` for pipelines