20 lines
965 B
Markdown
20 lines
965 B
Markdown
 
|
# Architecture Decision Records (ADR)
|
||
|
|
|
||
|
|
Eine Datei pro Entscheidung, fortlaufend nummeriert, Format siehe
|
||
|
|
[template.md](template.md) (MADR-light). ADRs werden **nie umgeschrieben** —
|
||
|
|
eine revidierte Entscheidung bekommt ein neues ADR, das alte wird im Status
|
||
|
|
auf `abgelöst durch NNNN` gesetzt.
|
||
|
|
|
||
|
|
**Wann ist ein ADR Pflicht:**
|
||
|
|
|
||
|
|
- Architektur- oder Prozessentscheidungen, die mehrere Repos/Hosts betreffen
|
||
|
|
- **Jede dauerhafte Ausnahme von einer bestehenden Regel** — eine Ausnahme, die
|
||
|
|
nur dokumentiert, aber nicht entschieden wurde, ist ein Fehler (gelernt beim
|
||
|
|
git.lab-Cutover 2026-08-01: die „Übergabe-Issues bleiben auf Gitea"-Ausnahme
|
||
|
|
hätte als Entscheidungsvorlage kommen müssen, nicht als Fußnote)
|
||
|
|
- Verworfene Wege, deren erneute Prüfung Zeit kosten würde („warum haben wir
|
||
|
|
das damals nicht gemacht?")
|
||
|
|
|
||
|
|
Kleine, repo-lokale Entscheidungen bleiben im jeweiligen Projekt (Commit-Message
|
||
|
|
oder Issue) — nicht jede Abwägung braucht ein ADR.
|