methodatlas
Architecture

Architecture Decision Record

Dokumentiert eine Architekturentscheidung mit Kontext, Alternativen und Konsequenzen, damit spätere Reviews nachvollziehbar bleiben.

Kernfrage
Welche Architekturentscheidung trifft das Team jetzt, vor welchen Alternativen, und welche Konsequenzen akzeptiert es dafür?
NiedrigAsync15-45 min
Zweck

Ein ADR hält eine Architekturentscheidung mit Kontext, Abwägung und Konsequenz dauerhaft fest. Es schafft Anschlussfähigkeit für spätere Änderungen, weil der Entscheidungsweg nachvollziehbar bleibt.

Funktionsweise

Zuerst werden Problem, Ziele und Rahmenbedingungen präzise beschrieben. Danach dokumentiert das Team die Optionen, die gewählte Lösung und die wichtigsten Tradeoffs. Abschließend wird der Eintrag mit Datum, Status und Verweis auf Folgearbeit versioniert.

Visuelle Orientierung

Methodenskizze für ein schnelles Grundgefühl.

Architecture Decision Record · EntscheidungsrationaleKontext, Optionen, Entscheidung, Konsequenzen und Status versioniert festhalten
Architecture Decision RecordDie Skizze zeigt, wie Entscheidungskontext, Optionen, Entscheidung, Konsequenzen und Status in einem Architecture Decision Record nachvollziehbar dokumentiert werden.Architekturentscheidung als nachvollziehbaren Record sichernKontext, Optionen, Entscheidung und Konsequenzen bleiben versioniert auffindbar.EntscheidungsraumEntscheidungsbedarfADR RecordKurzes versioniertes EntscheidungsdokumentDecision LogStatus und NachvollziehbarkeitProblemWas wird entschieden?KontextConstraints und TreiberStatusProposed/AcceptedContextWarum ist das relevant?OptionsWelche Wege gab es?DecisionWas gilt jetzt?ConsequencesFolgen, Risiken, Trade-offsAcceptedgültige EntscheidungLinked to Codenah am RepositorySupersededdurch neue ADR ersetzt1Proposed2Accepted3Superseded

Ablauf

  1. 1Entscheidung benennen
  2. 2Kontext beschreiben
  3. 3Optionen erfassen
  4. 4Entscheidung dokumentieren
  5. 5Konsequenzen festhalten

Das Runsheet führt mit 7 Phasen, Timeboxen, 7 Stolperfallen und klaren Abbruchkriterien durch die Umsetzung.

Runsheet öffnen

Ideal für

  • Architecture Governance
  • Team Memory
  • High-Change-Codebases

Nicht gut für

  • Triviale Entscheidungen
  • Lange Spezifikationen

Vertiefung

Im Detail

Ein ADR wirkt, weil Architekturentscheidungen dadurch nicht nur festgehalten, sondern mitsamt Kontext und Folgen später wieder lesbar werden. Gute Nutzung dokumentiert die eigentliche Spannung zwischen Optionen und benennt die Tragweite der gewählten Richtung offen. So verhindert das Format, dass Teams Monate später nur noch das Ergebnis kennen, aber weder Anlass noch bewusste Tradeoffs nachvollziehen können.

Durchführung

Sammle vor dem Schreiben die echte Entscheidungsfrage, die wichtigsten Alternativen und die Qualitätsziele, die unter Spannung stehen. Seinen Wert zeigt das Format genau dort, wo die gewählte Option eine klare Konsequenz für Betrieb, Entwicklung oder Kopplung bekommt. Schließe mit präzisem Status, klarer Begründung und einem Verweis darauf, wann eine Revision fällig wäre.

Output-Artefakte
ADR FileDecision LogRationale
Tags
Artefakt-Vorlagen
ADR Markdown TemplateKompakte Vorlage für Architecture Decision Records im Repository oder Wiki.
markdown

adr-markdown.md

Kompakte Vorlage für Architecture Decision Records im Repository oder Wiki.

ADR-0001: Titel der Entscheidung

Status: proposed Datum: YYYY-MM-DD Decider: Vorname Nachname Trigger: Ticket, Incident oder RFC

Kontext

Welche Situation macht die Entscheidung nötig? Welche Constraints, Quality Attributes oder früheren Entscheidungen sind relevant?

Optionen

Option 1: ...

  • Pro:
  • Contra:

Option 2: ...

  • Pro:
  • Contra:

Entscheidung

Wir entscheiden uns für ...

Konsequenzen

Positive Folgen:

  • ...

Negative Folgen und Risiken:

  • ...

Folge-ADRs oder Tickets:

  • ...

Wann stattdessen?

Kurze Entscheidungshilfe für vorhandene Alternativen.

Architecture Inception Canvas

Statt Architecture Decision Record, wenn du die ersten Architekturfragen in einer knappen Startfolie bündeln willst.

Ähnliche Methoden

Alle Methoden