methodatlas
Architecture

Architecture Decision Record

Kurzer Record für eine wichtige Architekturentscheidung, Kontext, Optionen und Konsequenzen.

ArchitectureLowAsync15-45 min
Zweck

Architektur-Rationale sichern und wiederkehrende Debatten reduzieren.

Funktionsweise

Eine Entscheidung wird als versioniertes Dokument nahe am Code mit Status, Kontext und Folgen abgelegt.

Visuelle Orientierung

Konkretes Schema mit deutschen Bezeichnungen.

Architecture Decision RecordMichael Nygard · MADR
Status
Status
Proposed · Accepted · Superseded · Deprecated. Mit Datum versehen.
Context
Kontext
Welches Problem, welche Kräfte, welche Annahmen führen zur Entscheidung?
Decision
Entscheidung
Was wird entschieden? Konkret und in aktiver Form formuliert.
Consequences
Konsequenzen
Welche Trade-offs, Nebeneffekte und Folgeentscheidungen sind sichtbar?

Ablauf

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

Ideal für

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

Nicht gut für

  • Triviale Entscheidungen
  • Lange Spezifikationen

Vertiefung

Im Detail

Architecture Decision Record folgt einer klaren Arbeitslogik: Entscheidung benennen, Kontext beschreiben, Optionen erfassen, Entscheidung dokumentieren und Konsequenzen festhalten. 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 ADR File, Decision Log und Rationale, die Entscheidungen, Lernen oder weitere Planung anschlussfähig machen.

Einordnung

Architecture Decision Record eignet sich besonders für Architecture Governance, Team Memory und High-Change-Codebases. Die Methode unterstützt Arbeit rund um architecture, rationale und documentation und hilft, implizite Annahmen explizit zu machen. Vorsicht ist in Kontexten wie Triviale Entscheidungen und Lange Spezifikationen geboten; dann sollte vorher geklärt werden, ob genug Kontext, Beteiligung und Entscheidungsspielraum vorhanden sind.

Durchführung

Bereite eine klare Leitfrage, die passenden Informationen und eine sichtbare Arbeitsfläche vor. Plane etwa 15-45 min mit 1-3 Personen und nutze das Format asynchron. Die Durchführung bleibt leichtgewichtig; hilfreich sind kurze Timeboxes, sichtbare Zwischenergebnisse und ein Parkplatz für offene Fragen.

Output-Artefakte
ADR FileDecision LogRationale
Artefakt-Vorlagen
ADR Markdown TemplateKompakte Vorlage für Architecture Decision Records im Repository oder Wiki.
markdown
# 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:
- ...

Ähnliche Methoden

Alle Methoden