Architecture Handbook
Maintain the structured, durable architecture story for a project
The Architecture Handbook organizes formal project guidance without duplicating model-owned structure. Open it under Documentation → Handbook.
Older projects, links, or integrations may still use the name “Arc42 Workspace.” The current product name is Architecture Handbook.
Handbook Chapters
| Chapter | Capture |
|---|---|
| Purpose & Goals | Business goals, stakeholders, and architectural outcomes |
| Constraints | Technical, organizational, regulatory, and operational boundaries |
| Scope & Context | The system boundary and important external context |
| Solution Strategy | The major approaches chosen to meet the goals |
| Decisions | Architecture decision records and their rationale |
| Quality Requirements | Quality goals and concrete scenarios |
| Risks & Technical Debt | Known exposure, mitigation, and intentional debt |
Systems, relationships, workflows, deployment topology, and data structure remain in their canonical Model surfaces. The Handbook explains why those structures exist and what governs their evolution.
From Review To Handbook
Analysis and Decisions can surface concerns, risks, technical debt, and decision suggestions. Review the evidence before promoting a durable conclusion into the appropriate Handbook chapter.
Use:
- Architecture Documents for reusable, free-form narratives
- Project Knowledge for source evidence, approved memories, and reviewed insights
- Architecture Handbook for formal project guidance and decisions
Imported root projects can expose a read-only Handbook when their content is owned by the source project.