Ziele, Kontext, Bausteine, Laufzeit, Deployment, Risiken und Entscheidungen konsistent dokumentieren.
arc42
Pragmatisches Template für strukturierte, lebendige Softwarearchitektur-Dokumentation.
Die Template-Kapitel werden bedarfsgerecht befüllt und mit Diagrammen, ADRs und Constraints verbunden.
Visuelle Orientierung
Methodenskizze für ein schnelles Grundgefühl.
Ablauf
- 1Ziele und Stakeholder erfassen
- 2Kontext abgrenzen
- 3Building Blocks dokumentieren
- 4Runtime und Deployment beschreiben
- 5Risiken und Entscheidungen verlinken
Ideal für
- Living Architecture Docs
- Team Handover
- Komplexe Systeme
Nicht gut für
- Wegwerfprojekte
- Teams ohne Dokumentationsbedarf
Vertiefung
arc42 folgt einer klaren Arbeitslogik: Ziele und Stakeholder erfassen, Kontext abgrenzen, Building Blocks dokumentieren, Runtime und Deployment beschreiben und Risiken und Entscheidungen verlinken. Dadurch wird die Methode nicht nur als Gespräch geführt, sondern als sichtbarer Denkprozess aufgebaut. Die Beteiligten bewegen sich schrittweise von Rohmaterial, Beobachtungen oder Optionen zu einer gemeinsamen Struktur. Als Ergebnis entstehen Architecture Document, Context View und Runtime View, die Entscheidungen, Lernen oder weitere Planung anschlussfähig machen.
arc42 eignet sich besonders für Living Architecture Docs, Team Handover und Komplexe Systeme. Die Methode unterstützt Arbeit rund um architecture, documentation und template und hilft, implizite Annahmen explizit zu machen. Vorsicht ist in Kontexten wie Wegwerfprojekte und Teams ohne Dokumentationsbedarf geboten; dann sollte vorher geklärt werden, ob genug Kontext, Beteiligung und Entscheidungsspielraum vorhanden sind.
Bereite eine klare Leitfrage, die passenden Informationen und eine sichtbare Arbeitsfläche vor. Plane etwa 1-2 Tage mit 1-4 Personen und nutze das Format wahlweise im Workshop oder asynchron. Die Durchführung bleibt leichtgewichtig; hilfreich sind kurze Timeboxes, sichtbare Zwischenergebnisse und ein Parkplatz für offene Fragen.
Quellen
arc42 ArbeitsvorlageKompakte Arbeitsvorlage für arc42 mit Kontext, Input, Ergebnisartefakten und nächstem Schritt.markdown
# arc42 Arbeitsvorlage
## Ziel
Pragmatisches Template für strukturierte, lebendige Softwarearchitektur-Dokumentation.
## Kontext
Wann und wofür nutzen wir diese Methode?
## Input
Welche Daten, Beobachtungen, Entscheidungen oder Materialien liegen vor?
## Durchführung
Kurze Notizen entlang des Run Sheets.
## Ergebnisartefakte
- Architecture Document:
- Context View:
- Runtime View:
- Deployment View:
## Annahmen und offene Fragen
- ...
## Entscheidung / Nächster Schritt
Owner, Datum und Erfolgssignal.Ähnliche Methoden
Alle MethodenDokumentiert Architektur über stakeholderrelevante Views plus Cross-view-Information.
Kurzer Record für eine wichtige Architekturentscheidung, Kontext, Optionen und Konsequenzen.
Diagramm-Hierarchie für Context, Container, Component und Code.
Strukturierter Workshop für architekturkritische Quality Attributes und Szenarien.
Canvas zur Planung zielgruppengerechter Architekturkommunikation.
Leichter Canvas für frühe Architekturausrichtung über Ziele, Constraints, Risiken und Systemform.