architecture-diagrams

Create system architecture diagrams using Mermaid, PlantUML, C4 model, flowcharts, and sequence diagrams. Use when documenting architecture, system design, data flows, or technical workflows.

By aj-geddes · 1,913 installs

npx skills add aj-geddes/useful-ai-prompts --skill architecture-diagrams

Source repository · Upstream listing

Architecture Diagrams Table of Contents [Overview]( overview) [When to Use]( when to use) [Quick Start]( quick start) [Reference Guides]( reference guides) [Best Practices]( best practices) Overview Create clear, maintainable architecture diagrams using code based diagramming tools like Mermaid and PlantUML for system design, data flows, and technical documentation. When to Use System architecture documentation C4 model diagrams Data flow diagrams Sequence diagrams Component relationships Deployment diagrams Infrastructure architecture Microservices architecture Database schemas (visual) Integration patterns Quick Start Minimal working example: Reference Guides Detailed implementations in the references/ directory: Guide Contents [System Architecture Diagram](references/system architecture diagram.md) System Architecture Diagram [Sequence Diagram](references/sequence diagram.md) Sequence Diagram [C4 Context Diagram](references/c4 context diagram.md) C4 Context Diagram [Component Diagram](references/component diagram.md) Component Diagram [Deployment Diagram](references/deployment diagram.md) Deployment Diagram [Data Flow Diagram](references/data flow diagram.md) Data Flow Diagram [Class Diagram](references/class diagram.md) Class Diagram [Component Diagram](references/component diagram 2.md) Component Diagram [Deployment Diagram](references/deployment diagram 2.md) Deployment Diagram Best Practices ✅ DO Use consistent notation and symbols Include legends for complex diagrams Keep diagrams focused on one aspect Use color coding meaningfully Include titles and descriptions Version control your diagrams Use text based formats (Mermaid, PlantUML) Show data flow direction clearly Include deployment details Document diagram conventions Keep diagrams up to date with code Use subgraphs for logical grouping ❌ DON'T Overcrowd diagrams with details Use inconsistent styling Skip diagram legends Create binary image files only Forget to document relationships Mix abstraction levels in one diagram Use proprietary formats