Who should use the Architecture Documentation skill?

It is designed for Solutions Architects, Lead Developers, and Engineering Managers who need to maintain clear alignment and technical history across engineering teams.

Can I use this for cloud-native system design?

Yes, the skill includes specialized sections for AWS/cloud infrastructure, horizontal scaling, and disaster recovery planning (RPO/RTO).

What is the C4 model in architecture documentation?

The C4 model is a lean graphical notation technique for modeling the architecture of software systems across four levels: Context, Containers, Components, and Code.

How does this skill help with Architecture Decision Records (ADRs)?

It provides structured templates that prompt for context, alternatives considered, rationale, and consequences, ensuring all key technical decisions are documented consistently.

Architecture Documentation

Name: Architecture Documentation
Author: spjoshis

byspjoshis

•

Learning & Documentation

Generates comprehensive system architecture documents, C4 model diagrams, and Architecture Decision Records (ADRs) for clear technical communication.

The Architecture Documentation skill empowers developers and solutions architects to maintain high-quality technical records by automating the creation of Architecture Decision Records (ADRs) and multi-level system overviews. By implementing the C4 model and standardized documentation patterns, it helps teams track the rationale behind technical choices, streamline developer onboarding, and ensure long-term system maintainability. Whether you are designing a new microservices architecture or documenting legacy systems, this skill provides the structure needed to align stakeholders and engineering teams on complex design decisions.

Key Features

011 GitHub stars

02Detailed technology stack and security framework documentation

03Standardized ADR generation with context, rationale, and consequences

04Comprehensive templates for scalability and disaster recovery planning

05C4 model visualization for System Context and Container levels

06Version-control-ready markdown output for documentation-as-code

Use Cases

01Documenting architectural shifts and database selections via ADRs for historical context

02Standardizing technical documentation for compliance reviews and stakeholder alignment

03Creating visual system overviews to accelerate onboarding for new team members

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add spjoshis/claude-code-plugins architecture-documentation

For use in Claude.ai and ChatGPT

Download Skill