Architekturdokumentation
Wie wir Architektur mit Diagrammen, ADRs und Entscheidungsbewertung dokumentieren
Ein Semantic Contract: Vokabular, das dein Projekt selbst mitliefert — zum Einsetzen in deine CLAUDE.md / AGENTS.md.
Architekturdokumentation folgt arc42. Diagramme sind C4 über PlantUMLs gebündelte C4-PlantUML-Standardbibliothek (die `!include <C4/...>`-stdlib-Form), nicht Mermaid. Entscheidungen sind Nygard-ADRs mit einer 3-Punkt-Pugh-Matrix. Qualitätsanforderungen sind sechsteilige Quality Attribute Scenarios (Source, Stimulus, Artifact, Environment, Response, Response Measure) mit einer konkreten Response Measure.
Das ist das gemeinsame Vokabular. Die Prozedur zum Erstellen eines solchen Dokuments — Scaffolding des arc42-with-help-Templates, die Cross-Section-Traceability-Regeln, die Kapitel-11-Struktur (Risiken vs. Technische Schuld), das ADR-zu-Risiko-ID-Wiring und die Kapitel-1.2-vs-10-Markierung der Qualitätsziele — liegt im arc42-documentation-Skill, der bei Bedarf geladen wird.