What problem does it solve? Writing software architecture documentation is time-consuming, and teams struggle to produce consistent, audience-appropriate diagrams. This Skill automates the creation of C4 model diagrams (Context, Container, Component, Deployment, Dynamic) in Mermaid syntax, so architecture documentation stays accurate and readable. ## Core Features & Use Cases - Multi-level C4 diagram generation: Produces System Context, Container, Component, Deployment, and Dynamic diagrams with correct Mermaid C4 syntax, element types, boundaries, and relationships. - Audience-aware scoping: Selects the right abstraction level based on the target audience (executives, product managers, architects, developers, DevOps) and enforces best practices like unidirectional arrows, technology labels, and the 20-element limit. - Reference guides for advanced cases: Includes a full Mermaid C4 syntax reference, a catalog of common anti-patterns (e.g., modeling shared libraries as containers, single message-bus diagrams), and advanced patterns for microservices, event-driven systems, CQRS, and multi-region deployments. - Use Case: Ask it to document a microservices e-commerce platform, and it produces a Context diagram plus a Container diagram showing services, databases, and individual Kafka topics, written to docs/architecture/. ## Quick Start Ask the assistant to create C4 architecture diagrams for your system, for example: generate a system context and container diagram for my application and save them under docs/architecture.
