document-architecture

Generate Arc42 architecture documentation with Mermaid C4 diagrams.

Updated Aug 27, 2026

Search Tags:#architecture #documentation #mermaid #architecture-docs #c4 #arc42

Ready to run

npx skills add https://github.com/amak07/acr-automotive --skill document-architecture

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: document-architecture
Source: https://github.com/amak07/acr-automotive/tree/main/.claude/skills/document-architecture
Command: npx skills add https://github.com/amak07/acr-automotive --skill document-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps document system architecture comprehensively using Arc42 structure and C4 diagrams, making complex systems easy to understand and maintain.

Core Features & Use Cases

Arc42 Template Compliance: Produces a complete architecture document with the standard Arc42 sections.
Mermaid C4 Diagrams: Generates context, container, and component diagrams, plus runtime views.
Decision Traceability: Links to ADRs for architectural decisions.
Use Case: Document the ACR Automotive system architecture with diagrams and decisions.

Quick Start

Output to /docs/architecture/acr-automotive.md and include Mermaid-based C4 diagrams for context, containers, and components.

Frequently Asked Questions about document-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I generate architecture documentation with C4 diagrams?▼

Arc42-based architecture documentation with C4 diagrams is generated by analyzing your codebase to produce a 12-section Arc42 document with Mermaid diagrams at four levels: System Context, Containers, Components, and Runtime. The output is written to /docs/architecture/[system].md, providing a comprehensive, structured view of your system's architecture.

What is Arc42 and why use it for architecture docs?▼

Arc42 is a standardized 12-section template for documenting software architecture that ensures consistency, completeness, and clarity across projects. It pairs with C4 diagrams to visually represent system structure, stakeholder decisions, and architectural rationale in a format teams can easily reference and maintain.

Can I use Mermaid diagrams to show all levels of system architecture?▼

Yes. Mermaid C4 diagrams support all four architectural levels: System Context shows external dependencies, Containers decompose major components, Components break down internal structure, and Runtime illustrates dynamic interactions. This Skill generates diagrams at each level for comprehensive documentation.

How do I link architectural decisions to my documentation?▼

Arc42 architecture documentation includes sections for documenting architectural decisions or linking to ADRs (Architecture Decision Records). This traceability connects your design rationale directly to the architecture docs, making decision context visible to current and future team members.

What happens if my codebase structure doesn't fit standard C4 levels?▼

Arc42 with C4 diagrams adapts to diverse architectures by allowing flexible interpretation of containers and components based on your system's actual structure. The template guides decomposition while remaining practical for microservices, monoliths, and hybrid systems without forcing artificial categories.

Do I need existing documentation before using Arc42?▼

No. This Skill explores your entire codebase to generate Arc42 documentation from scratch, producing the complete 12-section structure and Mermaid diagrams without requiring pre-existing docs. It extracts architecture from code analysis and generates the markdown output ready to refine.