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
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:
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
|
||||
|
||||
|
||||
Reference in new issue
Block a user