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.

About

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

1 GitHub stars
Detailed technology stack and security framework documentation
Standardized ADR generation with context, rationale, and consequences
Comprehensive templates for scalability and disaster recovery planning
C4 model visualization for System Context and Container levels
Version-control-ready markdown output for documentation-as-code

Use Cases

Documenting architectural shifts and database selections via ADRs for historical context
Standardizing technical documentation for compliance reviews and stakeholder alignment
Creating visual system overviews to accelerate onboarding for new team members

About

Key Features

1 GitHub stars
Detailed technology stack and security framework documentation
Standardized ADR generation with context, rationale, and consequences
Comprehensive templates for scalability and disaster recovery planning
C4 model visualization for System Context and Container levels
Version-control-ready markdown output for documentation-as-code

Use Cases

Documenting architectural shifts and database selections via ADRs for historical context
Standardizing technical documentation for compliance reviews and stakeholder alignment
Creating visual system overviews to accelerate onboarding for new team members