Architecture Decision Records

ADRs dokumentieren zentrale Architekturentscheidungen. Sie werden fortlaufend nummeriert.

Verbindliche Struktur

Jedes ADR verwendet diese Gliederung:

# ADR NNNN - Titel
## Status
## Kontext
## Entscheidung
## Begründung
## Konsequenzen

Abschnitte

Status: aktueller Zustand der Entscheidung, zum Beispiel Vorgeschlagen, Akzeptiert, Ersetzt oder Verworfen.
Kontext: Ausgangslage und Problemstellung.
Entscheidung: konkret getroffene Architekturentscheidung.
Begründung: Gründe für die gewählte Lösung.
Konsequenzen: positive, negative und organisatorische Folgen.

Umgang mit bestehenden ADRs

Bereits akzeptierte ADRs werden nicht stillschweigend inhaltlich umgedeutet. Wird eine Entscheidung ersetzt, soll ein neues ADR angelegt und das alte ADR entsprechend referenziert werden.