docs: PO-Schichtung Gates vs. Plan — AP1.5 vor Gate-UI
Deploy Development / deploy (push) Successful in 43s
Test Suite / pytest-backend (push) Successful in 1m34s
Test Suite / lint-backend (push) Successful in 2s
Test Suite / compose-smoke (push) Has been skipped
Test Suite / k6 /api/health Baseline (push) Successful in 18s
Test Suite / playwright-smoke (push) Successful in 12s

ADP Product Layering, Roadmap-Reihenfolge, Sprint-Assignment AP1.5; Gate-UI eingefroren.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
LarsandCursor committed 2026-07-06 07:53:07 +02:00
1 parent 9bf6ccee36
commit 2e7651812a
4 files changed
+350 -138

No files matched your search

@@ -0,0 +1,158 @@
# ADP — Produkt-Schichtung, Gates vs. Plan & IA-Reset v0.1
**Status:** PO-Freigabe (2026-07-06)
**Stand:** 2026-07-06
**Auslöser:** PO-Review nach AP1.4b — Gefahr, Gate-UI zu optimieren und Gesamtbild (Ist-Ebene, Optionalität) zu verlieren
**Bezug:** Vision v0.2 §5–7, Canonical OM v0.2 §4–8, `Kairo_Corrected_MVP_Roadmap_v0.2.md`
---
## Problem
AP1.4 / AP1.4b liefert **Gate-Infrastruktur** (RoadmapItem, Kriterien, Verify, Reopen). Die **UI** benennt und platziert das jedoch so, als wäre **Plan = Liste von Meilensteinen**.
Das widerspricht dem kanonischen Modell:
| Schicht | Bedeutung | Beispiele |
|---------|-----------|-----------|
| **Zielzustände (Gates)** | Erreichbare **Quality Gates** / Zielstatus — optional | `RoadmapItem` milestone, review_gate, maturity_stage |
| **Operativer Plan (Ist)** | Committete Arbeit **zwischen** Gates | Backlog → Action (Arbeitspaket) → Task |
| **Struktur (optional)** | Programm-Organisation | Project, Projekt-Roadmap bei großen Vorhaben |
**PO-Klarstellung (2026-07-06):**
- Meilensteine sind **nicht zwingend** ein Plan — sie sind **Zustandsgates**.
- Der eigentliche Plan passiert **zwischen** den Gates (Projekte, Arbeitspakete, Aufgaben).
- Projekt-Abfolgen **können** roadmap-artig modelliert werden (große Vorhaben) — das ist **nicht dasselbe** wie Gate-Graph.
- Es kann **nur ein Projekt**, **nur Aufgaben**, oder **keine Meilensteine / keine Roadmap** geben (`generic_operating`).
**Implementierungs-Drift:**
1. Tab **Plan** = Gate-CRUD — wirkt wie Pflicht für jedes Vorhaben
2. **1 Roadmap pro Initiative** — suggeriert Gates überall
3. **Ausführung** unterentwickelt — Project/Task (AP1.5) fehlt in GUI
4. Weitere Gate-UI (Modal, Graph-Editor-Optik) **vor** Ist-Hierarchie würde Verzerrung verstärken
---
## Betroffene Regeln
| Dokument | Regel |
|----------|--------|
| Vision v0.2 §5 | Plan (Roadmap) vs. Ist (Action) — zentrale Trennung |
| Vision v0.2 §6 | Meilenstein = Quality Gate, kein Task |
| Vision v0.2 §7.3 | Unterseite Plan = Gates/DoD; Ausführung = Arbeitspakete |
| Vision v0.2 §9 | Methodenflexibilität — kein einziges Gate-Modell |
| Canonical OM v0.2 §4–5 | Project optional; Backlog zahlt auf RoadmapItem ein |
| Roadmap v0.2 Leitprinzip 4 | Plan vs. Ist |
---
## Entscheidung (PO-Freigabe)
### 1. Begriffe und IA
| Heute (UI) | Product Language | Inhalt |
|------------|------------------|--------|
| Tab **Plan** | **Gates / Zielzustände** (interim: Untertitel klarstellen) | RoadmapItems, Kriterien, Verify, Gate-Abhängigkeiten |
| Tab **Ausführung** | **Operative Planung / Ist** | Backlog-Commit, Actions (Arbeitspakete), später Project/Task |
| **Roadmap** (Modell) | Zwei Bedeutungen — **nicht vermischen** | (a) Gate-Struktur pro Initiative (b) optional Projekt-Abfolge (AP1.5+) |
**Graph-Editor (später):** Kanten zwischen **Gates** (AP1.4d) — **kein** Workflow-Editor für Lifecycle. Ob Graph später Lifecycle mitsteuert: **offene Produktfrage**, nicht AP1.4b.
### 2. Optionalität
- Gates und Roadmap sind **methodenabhängig optional**, nicht Default für jedes Vorhaben.
- `steering_context.method_key` steuert Sichtbarkeit und Pflicht (Registry, AP1.4e).
- Bis AP1.4e: Initiative ohne Gates muss **ohne leere Plan-Pflicht** nutzbar sein (IA-Hinweis, leerer Zustand OK).
### 3. AP1.4b — Status
**Backend behalten** (Migration 012, Criteria, Verify, Reopen, Audit) — Fundament für Gates.
**Gate-UI-Politur eingefroren** bis AP1.5:
- kein Modal-Editor für Gate-Anlage
- kein Graph-Workflow-UI
- keine weitere Optimierung der Plan-Liste als „Haupt-Plan“
Minimaler Fix erlaubt: Tab-Beschreibung / Breadcrumb „Gates“ statt implizit „Plan = alles“.
### 4. Repriorisierung (verbindlich)
```text
✓ AP1.4b Gate-Checkliste Backend + Minimal-Detail-Route
→ AP1.5 Project, Task, Ausführung als Ist-Kern (NÄCHSTES CODE-PAKET)
→ AP1.5b IA/Begriffe: Gates vs. Ausführung, optionale Gate-Sicht
→ AP1.6 Plan/Ist-Verknüpfung, Journey (Action/Backlog → Gate)
⏸ AP1.4c Gate-UI (Modal, Checkliste-UX) — nach AP1.5
→ AP1.4d Graph Engine (Gate-Kanten only)
→ AP1.4e Methodenprofile (generic_operating ohne Gate-Zwang)
```
---
## Schichtenmodell (Referenz)
```text
Initiative (Vorhaben / Programm)
│
├── [optional] Gates (RoadmapItem) ← Zielzustände, Verify, Kriterien
│ ▲
│ │ zahlt ein (Evidence, Zuordnung)
│ │
├── [optional] Project ← AP1.5
│ └── Action (Arbeitspaket) ← Ist — „Plan zwischen Gates“
│ └── Task ← AP1.5 minimal
│
├── Backlog → Commit → Action
└── steering_context (Lifecycle, method_key) ← getrennt von Gate-Graph
```
**Großes Vorhaben:** Gate-Graph **und** Projekt-Roadmap **parallel** möglich — getrennte Konzepte.
**Kleines Vorhaben:** nur Actions/Tasks, **keine** Gates.
---
## Konsequenzen für Implementierung
| Bereich | Konsequenz |
|---------|------------|
| Roadmap v0.2 | Reihenfolge AP1.5 vor AP1.4c/4d — siehe Update |
| Neue Features | Keine Gate-UI ohne PO-Freigabe nach AP1.5 |
| `sequencing_mode` am Item | Deprecated — nicht in UI ausbauen |
| 1 Roadmap/Initiative | Behalten als Schema-Compat; später methodenabhängig leer/unsichtbar |
| Tests / Validation | Szenario „Vorhaben ohne Gates“ in AP0.10d explizit |
| Agent-API AP1.7 | Gates schließen nur Verify-Pfad — unverändert |
---
## Risiko
| Risiko | Mitigation |
|--------|------------|
| AP1.4b-UI wirkt „halbfertig“ | PO-Kommunikation: Backend da; UI nach Schichtung |
| Doppelte Roadmap-Bedeutung verwirrt | ADP + UI-Labels; AP1.5 trennt Project-Sequenz |
| Team baut weiter Gate-Editor | Scope Lock in Roadmap + dieses ADP |
---
## Rückbaubarkeit
- ADP ist **Priorisierungs- und Begriffsentscheidung** — kein Schema-Rollback.
- AP1.4b-Backend bleibt; UI-Labels jederzeit änderbar.
- Graph Engine AP1.4d kann Scope auf Gate-Kanten begrenzt bleiben.
---
## Abnahme PO
- [x] Gates ≠ operativer Plan — dokumentiert
- [x] AP1.5 vor Gate-UI-Politur — Roadmap angepasst
- [x] Graph ≠ Lifecycle-Workflow — festgehalten
- [ ] Tab-Umbenennung / Untertitel — Umsetzung AP1.5b
---
*Referenz: `Kairo_Corrected_MVP_Roadmap_v0.2.md` (PO-Korrektur 2026-07-06), `Sprint1_AP1_5_Hierarchy_Assignment_v0.1.md`*
@@ -1,7 +1,7 @@
# ADP — Roadmap-Graph, Gate-Checkliste & Methodenprofile v0.1
**Status:** PO-Freigabe AP1.4b (2026-07-05)
**Stand:** 2026-07-05
**Status:** PO-Freigabe AP1.4b (2026-07-05); **Priorität UI/Graph** siehe `ADP_PO_Product_Layering_and_IA_Reset_v0.1.md` (2026-07-06)
**Stand:** 2026-07-06
**Bezug:** `ADP_RoadmapItem_and_Quality_Gate_Model_v0.1.md`, Vision v0.2 §9.1
**Ersetzt nicht:** AP1.4-Minimal (Schema 010/011) — **korrikt und erweitert** Zielbild