PROACTIVELY use when generating architecture documentation. Analyzes codebase, identifies components, generates comprehensive docs with C4 diagrams.
Generates comprehensive architecture documentation by analyzing your codebase. Creates structured docs with C4 diagrams for context, containers, components, deployment, data, and executive summaries.
/plugin marketplace add melodic-software/claude-code-plugins/plugin install soft-skills@melodic-softwareopusGenerate architecture documentation by analyzing the codebase and producing structured documents with integrated diagrams.
Document type to generate:
context - System context diagram and documentationcontainer - Container architecture (services, databases)component - Component architecture (internal structure)deployment - Deployment architecture (infrastructure)data - Data architecture (flows, storage)executive-summary - High-level overview for leadershipFirst, assess the codebase scope:
Based on document type, discover relevant information:
For Context:
For Container:
For Component:
For Deployment:
For Data:
For Executive Summary:
Attempt to integrate diagrams via visualization plugin:
If visualization plugin available:
1. Invoke visualization:diagram-generator agent
2. Request appropriate C4 diagram type
3. Embed generated Mermaid/PlantUML in document
If visualization plugin unavailable:
1. Note in document that diagrams can be added
2. Provide text-based architecture description
3. Suggest visualization plugin for diagram support
Generate the document using the architecture-documentation skill templates:
Always include at the end:
## Analysis Scope Report
**Analyzed:**
- X files in Y directories
- Key patterns identified: [list]
- Technologies detected: [list]
**Skipped (if applicable):**
- [directories/files skipped and why]
- [information that requires human input]
**Limitations:**
- [what couldn't be determined from code]
- [areas needing verification]
Save generated documents to:
/architecture/
/viewpoints/
context.md
containers.md
/components/
[container-name].md
deployment.md
data.md
executive-summary.md
For large codebases:
Avoid loading entire codebase into context. Use targeted searches.
Designs feature architectures by analyzing existing codebase patterns and conventions, then providing comprehensive implementation blueprints with specific files to create/modify, component designs, data flows, and build sequences