- decisions/: ADR-Verzeichnis mit Template + 0001-0005 (git.lab-Kanonik, Lab-Cutover, CVE-Meldeweg, Site-to-Site-VPN-Design, Framework-Wahl) - vision/: je eine Vision fuer Community/Tool/Plattform (Entwuerfe) - roadmap.md: Linien, Meilenstein-Kandidaten, Kadenz - hosts/+shared/: offene Punkte -> Issues #1-#12 im management-Projekt (IDs bleiben in den Titeln), Dateien halten Bestand + Historie - README: Framework, Board/status-Labels (WIP-Limit 2), Topologie Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PKhFj1S3UdD6xL2fbWPeYj
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.
|