Records the refinement decision of 2026-08-09 (M5 created, 14 issues moved out of M1, dividing line documented). Drafted during the neckbeard field-test analysis (finding F-001); placement decided by sorb on 2026-08-10: old scheme, nothing migrated yet.
Architecture Decision Records (ADR)
Eine Datei pro Entscheidung, fortlaufend nummeriert, Format siehe
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.