arc42 architecture documentation template (all 12 sections) combined with C4 diagrams (Context, Container, Component, Deployment) in PlantUML. The standard for architecture documentation in this setup. Maps each section to the Claude skills that help fill it.
From clarcnpx claudepluginhub marvinrichter/clarc --plugin clarcThis skill uses the workspace's default tool permissions.
Designs and optimizes AI agent action spaces, tool definitions, observation formats, error recovery, and context for higher task completion rates.
Enables AI agents to execute x402 payments with per-task budgets, spending controls, and non-custodial wallets via MCP tools. Use when agents pay for APIs, services, or other agents.
Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.
arc42 is a template for architecture documentation with 12 sections. C4 is a diagram model (Context → Container → Component → Code) that maps directly into arc42's structural sections.
Do not use arc42 for projects under 10 files — use a simple README instead.
| # | Section | C4 Diagram | Claude Skill |
|---|---|---|---|
| 1 | Introduction & Goals | — | commands/prd.md (requirements) |
| 2 | Architecture Constraints | — | adr-writing (constraints documented) |
| 3 | System Scope & Context | C4 Level 1: Context | — |
| 4 | Solution Strategy | — | agents/solution-designer |
| 5 | Building Block View | C4 Level 2: Container + Level 3: Component | — |
| 6 | Runtime View | Sequence Diagrams | skills/api-contract |
| 7 | Deployment View | C4 Deployment Diagram | skills/kubernetes-patterns, deployment-patterns |
| 8 | Cross-cutting Concepts | — | observability, security-review, multi-tenancy, caching-patterns |
| 9 | Architecture Decisions | — | skills/adr-writing, commands/explore |
| 10 | Quality Requirements | — | skills/load-testing |
| 11 | Risks & Technical Debt | — | — |
| 12 | Glossary | — | — |
Full template (all 12 sections with C4 PlantUML diagrams): docs/templates/arc42-template.md
Save the generated document to: docs/architecture/arc42.md
Diagrams to: docs/architecture/diagrams/*.puml
docs/decisions/ file — always both