# Architecture Decision Records ADRs dokumentieren zentrale Architekturentscheidungen. Sie werden fortlaufend nummeriert. ## Verbindliche Struktur Jedes ADR verwendet diese Gliederung: ```text # 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.