mermaid-architecturelisted

# Mermaid Architecture Diagrams Create structured, high-contrast, production-ready Mermaid architecture diagrams, workflows, and system design documentation. Native diagrams render directly in Markdown viewers (GitHub, GitLab, Obsidian, wikis) with optional image exports (PNG/SVG) generated via Mermaid CLI (`mmdc` / `npx @mermaid-js/mermaid-cli`). ## 📁 Storage Location (`docs/architecture/`) All generated architecture diagrams, source `.mmd` files, exported images, and system design documents **must be stored in `docs/architecture/`**, consistent with the `drawio-architecture` convention: ```text docs/architecture/ ├── system-architecture.md # Architecture documentation with embedded Mermaid blocks ├── <name>_<type>_<title>.mmd # Source Mermaid definitions ├── <name>_<type>_<title>.png # Optional exported raster image └── <name>_<type>_<title>.svg # Optional exported vector image ``` Ensure the directory exists before saving: ```bash mkdir -p docs/architecture ``` ## When to Use - The user asks for an **architecture diagram**, **system structure**, **component overview**, **C4 model**, **microservices topology**, or **data flow**. - Documenting **API interactions**, **service call sequences**, **authentication flows**, or **request lifecycles**. - Visualizing **workflows**, **state machines**, **business logic**, **ETL pipelines**, or **decision trees**. - Mapping code to diagrams (Spring Boot, FastAPI, React, Node/Express, Pytho