Add AI workspace reviews
This commit is contained in:
@@ -0,0 +1,55 @@
|
||||
# ADR 0022 — Dokumentenhierarchie und Single Source of Truth
|
||||
|
||||
## Status
|
||||
Accepted
|
||||
|
||||
## Kurz erklärt
|
||||
Single Source of Truth bedeutet:
|
||||
|
||||
```text
|
||||
Es gibt eine verbindliche Quelle,
|
||||
wenn sich Dokumente widersprechen.
|
||||
```
|
||||
|
||||
## Kontext
|
||||
Das Architekturreview hat kritisiert, dass mehrere Dokumente unterschiedliche Aussagen enthalten.
|
||||
|
||||
Beispiele:
|
||||
|
||||
- V1-Kundenzahl
|
||||
- KI in V1 oder V2
|
||||
- Customer Portal in V1 oder V2
|
||||
- Module im Core oder Service-Modul
|
||||
|
||||
## Entscheidung
|
||||
Es gilt folgende Dokumentenhierarchie:
|
||||
|
||||
1. ADRs
|
||||
2. Architektur-Dokumente
|
||||
3. Modulstruktur
|
||||
4. Roadmap
|
||||
5. Modul-Detaildokumente
|
||||
6. Brainstorming-/Ideendokumente
|
||||
|
||||
## Konsequenz
|
||||
Wenn sich Dokumente widersprechen, gilt die höhere Ebene.
|
||||
|
||||
Beispiel:
|
||||
|
||||
Wenn ADR 0019 sagt „KI ist V2“, aber ein altes Modul-Dokument KI als V1 beschreibt, gilt ADR 0019.
|
||||
|
||||
## Pflege-Regel
|
||||
Nach jeder größeren ADR-Serie müssen betroffene Dokumente aktualisiert werden.
|
||||
|
||||
## Ziel
|
||||
Architekturdrift verhindern.
|
||||
|
||||
Architekturdrift bedeutet:
|
||||
|
||||
```text
|
||||
Planung und tatsächliche Umsetzung entfernen sich schleichend voneinander.
|
||||
```
|
||||
|
||||
## Verwandte ADRs
|
||||
- ADR 0019 — V1-Scope-Finalisierung
|
||||
- ADR 0009 — Core-Grenzen
|
||||
Reference in New Issue
Block a user