# 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.