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

+119 -136
View File
@@ -2,10 +2,11 @@
## Corrected MVP Roadmap v0.2
**Status:** führende Produkt-Roadmap
**Stand:** 2026-07-05
**Stand:** 2026-07-06 (PO-Korrektur Schichtung)
**Ersetzt:** `Kairo_Corrected_MVP_Roadmap_v0.1.md`
**Vision:** `Kairo_Vision_and_Product_Direction_v0.2.md`
**Ist-Stand:** `Kairo_Implementation_Truth_Table_v0.1.md`
**Ist-Stand:** `Kairo_Implementation_Truth_Table_v0.1.md`
**PO-ADP:** `ADP_PO_Product_Layering_and_IA_Reset_v0.1.md`
---
@@ -14,8 +15,25 @@
1. **Vision vor UI-Patches** — keine Omnibus-CRUD-Seiten ausbauen
2. **IA vor Gate-Schema** — Routing/Shell vor RoadmapItem-Migration
3. **Steering in `backend/steering/`** — keine parallelen Heuristiken
4. **Plan vs. Ist** — RoadmapItem (Plan) getrennt von Action (Ist)
4. **Plan vs. Ist** — RoadmapItem (Ziel/Gate) getrennt von Action (Ist)
5. **Agenten = Actors** — Operational Interface, keine Sonderdomäne
6. **Gates ≠ operativer Plan** — Meilensteine = Zielzustände (optional); Plan zwischen Gates = Project/Action/Task (PO 2026-07-06)
---
## 1.1 PO-Korrektur 2026-07-06
**Auslöser:** Gefahr, AP1.4b-Gate-UI zu optimieren und Ist-Ebene (Project, Task, Ausführung) zu vernachlässigen.
| Entscheidung | |
|--------------|--|
| AP1.4b Backend | ✓ behalten (Kriterien, Verify, Reopen) |
| Gate-UI-Politur (Modal, Graph-Workflow) | ⏸ **eingefroren** bis AP1.5 |
| Nächstes Code-Paket | **AP1.5** Hierarchie + Ausführung als Ist-Kern |
| Tab „Plan“ | fachlich **Gates / Zielzustände** — Umbenennung AP1.5b |
| Graph Engine AP1.4d | Gate-Kanten only — **kein** Lifecycle-Workflow |
Siehe `ADP_PO_Product_Layering_and_IA_Reset_v0.1.md`.
---
@@ -25,14 +43,16 @@
Phase 0 Foundation AP0.1–AP0.7, AP0.R1 ✓
Phase A OM-Inventar AP0.8–AP0.10 ✓ (technisch)
Phase B Steering Skeleton AP1.0–AP1.1b ✓ (technisch)
Phase C Dokumentation Welle 1–2 ◐ (Welle 2 jetzt)
Phase D IA-Skeleton AP1.2 + AP1.2c ← NÄCHSTES CODE
Phase E Steering Härtung AP1.2, AP1.3 geplant
Phase F Gate-Modell AP1.4 + ADP geplant
Phase G Hierarchie & Plan/Ist AP1.5–AP1.6 geplant
Phase H Portfolio & Kontext AP1.8 geplant
Phase I Agent Interface AP1.7 geplant
Phase J Validation AP0.10d (laufend PO) parallel
Phase C Dokumentation Welle 1–2 ✓
Phase D IA-Skeleton AP1.2 + AP1.2c ✓
Phase E Steering AP1.2, AP1.3 ◐
Phase F Gate-Backend AP1.4 + AP1.4b ✓ (Backend); UI minimal
Phase G **Ist-Hierarchie AP1.5** ← **NÄCHSTES CODE**
Phase H Plan/Ist-Verknüpfung AP1.6 geplant
Phase I Gate-Graph AP1.4d–4e nach AP1.5
Phase J Portfolio & Kontext AP1.8 geplant
Phase K Agent Interface AP1.7 geplant
Phase L Validation AP0.10d (laufend PO) parallel
```
---
@@ -47,185 +67,149 @@ Phase J Validation AP0.10d (laufend PO) parallel
| AP0.10b | 0.10.1 | NextAction/Heute-Widgets, Snapshot v2 |
| AP1.0 | 0.11.0 | steering_contexts, backend/steering/, Lifecycle |
| AP1.1 | 0.11.1 | Method Registry, product_milestone_driven |
| AP1.1b | 0.11.2 | InitiativeDetail UX-Patch (**kein Zielbild** — Übergang) |
| DOC Welle 1 | — | Vision v0.2, Canonical OM v0.2, Truth Table |
| AP1.2 | 0.11.3-ap1.2 | Signals, operating_phase weg |
| AP1.2c | 0.12.0-ap1.2c | IA-Skeleton |
| AP1.4 | 0.13.0-ap1.4 | RoadmapItem / Gates Minimal |
| AP1.4b | 0.13.1-ap1.4b | Gate-Checkliste Backend + Detail-Route |
| DOC PO | 2026-07-06 | ADP Product Layering & IA-Reset |
---
## 4. Nächste Pakete (verbindliche Reihenfolge)
## 4. Nächste Pakete (verbindliche Reihenfolge — PO 2026-07-06)
### DOC Welle 2 — Zielbild präzisieren ◐
### AP1.5 — Hierarchie & Ist-Ebene (**NÄCHSTES CODE-PAKET**)
| # | Lieferung |
|---|-----------|
| 1 | Roadmap v0.2 (dieses Dokument) |
| 2 | Recovery Plan v0.2 |
| 3 | Gap Analysis v0.2 |
| 4 | ADP RoadmapItem & Quality Gate |
| 5 | ADP Operational Actor Interface |
| 6 | Target State Implementation Map v0.2 |
| 7 | Vibe-Coder Handover v0.2 |
**Gate:** PO bestätigt Begriffe, IA, Reihenfolge → dann AP1.2c.
---
### AP1.2 — Signals konsolidieren
**Ziel:** `operating_phase` entfernen; Snapshot nur Lifecycle + Signals.
**Ziel:** Operativer Plan zwischen Gates — Project, Task, Ausführung-Tab; Gates optional nutzbar.
| Scope | |
|-------|--|
| ✓ | `operating_phase` aus Snapshot/API deprecate → entfernen |
| ✓ | Signals in `backend/steering/signals/` konsolidieren |
| ✓ | Tests, Truth Table aktualisieren |
| Project GUI + API |
| Task minimal unter Action |
| Ausführung als Ist-Kern (nicht Gate-Liste) |
| Vorhaben ohne Gates voll nutzbar |
**Nicht:** neue UI, neue Tabellen.
**Version:** `0.11.3-ap1.2`
**ADP:** `ADP_PO_Product_Layering_and_IA_Reset_v0.1.md`
**Assignment:** `Sprint1_AP1_5_Hierarchy_Assignment_v0.1.md`
**Version:** `0.14.0-ap1.5`
---
### AP1.2c — IA-Skeleton (nächstes sichtbares Produktpaket)
**Ziel:** Navigation und Shell gemäß Vision §7 — **ohne** neues Schema.
| # | Lieferung |
|---|-----------|
| 1 | **Workspace** — Portfolio-Kacheln aller Initiativen + Attention |
| 2 | **Initiative-Übersicht** — read-only Steuerung (Snapshot, Next Action, Blocker-Hinweis) |
| 3 | **Routing** — `/initiatives/:id`, `/plan`, `/execution`, `/inbox`, `/journey` (Shell) |
| 4 | **Next-Action-Widget** — konfigurierbar auf Workspace + Initiative-Übersicht |
| 5 | **Modal/Detail-Pattern** — erste Objekt-Route z. B. `/actions/:id` |
| 6 | Omnibus `InitiativeDetailPage` → Redirect auf neue Struktur |
**Nicht:** RoadmapItem, Gate-Verify, Portfolio-Priorität-Feld, Agent-API.
**Version:** `0.12.0-ap1.2c`
---
### AP0.10d — MVP Validation (parallel, PO)
Testvorhaben: Kairo, Gewaltschutzkurs, Karate, Familienorganisation, Server/Mindnet.
Vorlage: `Sprint0_AP0_10_Validation_Report_v0.1.md`
**Go/No-Go** für Gate-Modell (AP1.4) — nicht für weiteres CRUD.
---
### AP1.3 — Hook Orchestrator
**Ziel:** `operating_transitions` → Hook-Ausführung (stub → minimal).
**Nach AP1.2.** Keine Workflow-Runtime.
---
### AP1.4 — RoadmapItem & Quality Gate (+ ADP)
**Ziel:** Milestone-Brücke → RoadmapItem; Gate mit DoD, Dependencies, Verify.
### AP1.5b — IA-Begriffe Gates vs. Ausführung
| Scope | |
|-------|--|
| Migration Roadmap + RoadmapItem (+ dependencies) |
| Gate-Status `reached` nur via Evidence/Review |
| Plan-Unterseite mit echten Gates |
| Migration bestehender `milestones` |
| Nav: Plan → **Gates** / Zielzustände (Untertitel) |
| Lead-Texte: Gates optional, Ist in Ausführung |
| Kein Gate-Modal |
**ADP:** `ADP_RoadmapItem_and_Quality_Gate_Model_v0.1.md`
**Version:** `0.13.0-ap1.4` — **Minimal geliefert**; Verify-Compat siehe 0.13.1.
**Kann mit AP1.5 im selben Sprint.**
---
### AP1.4b — Gate-Checkliste & Pflege (**PO-Freigabe 2026-07-05**)
### AP1.6 — Plan/Ist-Verknüpfung & Journey
**Ziel:** Prüfplan pro Gate; Waive/Defer per Decision; Reopen mit Rollen; Audit.
Backlog/Action → RoadmapItem; Decision-Spur; Journey-Timeline.
| Scope | |
|-------|--|
| Migration `roadmap_item_criteria` |
| Verify: Pflicht-Kriterien `satisfied` \| `waived` \| `deferred` (waive/defer → Decision) |
| Compat: Default-Kriterium pro bestehendem Gate |
| Reopen `reached → active`; Kriterien-Status **bleibt** |
| Reopen: Verantwortlicher, Tenant-Admin/Owner, Portal-Admin (Notfall) |
| Kriterium ändern bei `reached` + Begründung → Gate `active` |
| Plan-Detail-Route; Capabilities `kairo.roadmap.reopen*` |
| Audit für alle Gate-/Kriterien-Änderungen |
**Nach AP1.5** — Gates bekommen Bedeutung durch Ist-Bezug.
**ADP:** `ADP_Roadmap_Graph_and_Gate_Checklist_v0.1.md` § PO-Freigabe
**Version:** `0.13.1-ap1.4b`
**Version:** `0.15.0-ap1.6`
---
### AP1.4d — Roadmap Graph Engine
### AP1.4c — Gate-UI-Politur ⏸ (eingefroren bis AP1.5)
**Ziel:** Sequenziell/Parallel/Optional nur über **Kanten**; erste Graph Engine in `backend/steering/graph/`.
Modal Gate anlegen/bearbeiten; Checkliste-UX; Fortschritt in Liste.
**Nicht starten vor AP1.5.**
---
### AP1.4d — Roadmap Graph Engine (nur Gate-Kanten)
**Ziel:** Sequenziell/Parallel/Optional über **Kanten zwischen Gates** — **kein** Workflow-Editor, **kein** Lifecycle aus Graph.
| Scope | |
|-------|--|
| `edge_kind`, `parallel_group` auf Dependencies |
| Deprecate `sequencing_mode` am Item (UI + Engine) |
| Deprecate `sequencing_mode` am Item |
| Read Models: blocked, ready, fulfillment_ratio |
| Attention/Blocker aus Graph ableiten |
**Version:** `0.14.0-ap1.4d`
**Version:** `0.14.1-ap1.4d` (nach AP1.5)
---
### AP1.4e — Methodenprofile am Graph
Erfüllungsgrad-Methoden vs. Gate-Abschluss; Next Action aus Graph + Method Registry.
Erfüllungsgrad vs. Gate-Abschluss; `generic_operating` ohne Gate-Zwang.
**Version:** `0.14.1-ap1.4e`
**Version:** `0.14.2-ap1.4e`
---
### AP1.5 — Hierarchie (Project, Task)
### AP1.3 — Hook Orchestrator (parallel möglich)
Project GUI; Task unter Action (methodenabhängig minimal).
**Ziel:** `operating_transitions` → Hook-Ausführung (stub → minimal). Keine Workflow-Runtime.
---
### AP1.6 — Plan/Ist & Journey
### AP0.10d — MVP Validation (parallel, PO)
Plan-Ist-Delta; Decision-Spur; Journey-Timeline auf Initiative.
Testvorhaben inkl. **Szenario ohne Gates**. Vorlage: `Sprint0_AP0_10_Validation_Report_v0.1.md`
---
### AP1.7 — Operational Actor Interface (Vibe-Coder)
### AP1.7 — Operational Actor Interface
REST-API für Agent-Actors: Snapshot, Next Action, Status, Evidence, Blocker, Decision-Unterlagen.
REST für Agent-Actors. **Nach AP1.5 + Gate-Verify tragfähig.**
**ADP:** `ADP_Operational_Actor_Interface_Vibe_Coder_v0.1.md`
**Nach AP1.2c + Capability für Agent-Auth.**
**Version:** `0.16.0-ap1.7`
---
### AP1.8 — Portfolio-Priorität & situativer Kontext
- `portfolio_priority` auf Initiative (oder Steuerungsobjekt)
- Next-Action-Strategie: Portfolio-Prio × Dringlichkeit × **Situationskontext** (Actor)
- Konfigurierbare Widget-Filter
**Nicht:** Urlaubsplanung — situative Eignung von Arbeit (Vision §7.6).
**Version:** `0.17.0-ap1.8`
---
## 4.1 Erledigte Pakete (Referenzdetail)
<details>
<summary>DOC Welle 2, AP1.2 – AP1.4b</summary>
### DOC Welle 2 — Zielbild ◐
Roadmap v0.2, Recovery, Gap Analysis, ADPs, Handover v0.2.
### AP1.2 — Signals ✓
`operating_phase` entfernt; Signals in `backend/steering/signals/`. Version `0.11.3-ap1.2`
### AP1.2c — IA-Skeleton ✓
Workspace, Initiative-Übersicht, Routing, Next-Action-Widget. Version `0.12.0-ap1.2c`
### AP1.4 — RoadmapItem ✓
Migration 010/011, Gate-Verify Minimal. Version `0.13.0-ap1.4`
### AP1.4b — Gate-Checkliste ✓
Criteria, Waive/Defer, Reopen, Detail-Route. Version `0.13.1-ap1.4b`
</details>
---
## 5. Eingefroren / Nicht-Scope
| Thema | Bis wann |
|-------|----------|
| Prompt/KI/MCP produktiv | Gate-Modell + IA |
| Gate-UI-Politur (Modal, Graph-Workflow) | **Nach AP1.5** (PO 2026-07-06) |
| Prompt/KI/MCP produktiv | Ist-Hierarchie + Plan/Ist |
| Method Designer UI | AP1.3+ |
| Gantt / Kalender | nach Plan/Ist |
| Admin-Konsole | später |
| Weitere InitiativeDetail-Refactors | **Stop** — nur Redirect zu IA |
---
## 6. MVP-Nutzbarkeit (neu, aus Vision)
@@ -234,25 +218,24 @@ MVP-nah wenn:
1. Workspace: Portfolio + Next Action (konfigurierbar) in ≤30s
2. Initiative-Übersicht: operative Steuerung ohne CRUD-Wand
3. Unterseiten: Pflege getrennt
4. Gate durchspielbar (nach AP1.4)
3. Unterseiten: Pflege getrennt (Gates optional, Ist in Ausführung)
4. Gate durchspielbar (Backend AP1.4b) **oder** Vorhaben ohne Gates nutzbar
5. Validation ≥3/5 Vorhaben „hilft bei Steuerung“
---
## 7. Versionslinie (Ausblick)
```text
0.11.2-ap1.1b ✓ InitiativeDetail Patch
0.11.3-ap1.2 Signals, operating_phase weg
0.12.0-ap1.2c IA-Skeleton
0.13.0-ap1.4 RoadmapItem / Gates
0.14.0-ap1.5 Hierarchie
0.15.0-ap1.6 Journey / Plan-Ist
0.16.0-ap1.7 Agent Interface
0.17.0-ap1.8 Portfolio + Kontext
0.11.3-ap1.2 ✓ Signals
0.12.0-ap1.2c ✓ IA-Skeleton
0.13.0-ap1.4 ✓ RoadmapItem / Gates Backend
0.13.1-ap1.4b ✓ Gate-Checkliste Backend
0.14.0-ap1.5 → Hierarchie (Project, Task) — NÄCHSTES
0.15.0-ap1.6 → Journey / Plan-Ist
0.14.1-ap1.4d → Gate-Graph (nach AP1.5)
0.16.0-ap1.7 → Agent Interface
0.17.0-ap1.8 → Portfolio + Kontext
```
---
*Siehe auch: `Kairo_MVP_Usability_Recovery_Plan_v0.2.md`, `Sprint1_AP1_2c_IA_Skeleton_Assignment_v0.1.md`*
*Siehe auch: `ADP_PO_Product_Layering_and_IA_Reset_v0.1.md`, `Sprint1_AP1_5_Hierarchy_Assignment_v0.1.md`, `Kairo_MVP_Usability_Recovery_Plan_v0.2.md`*