AP0.10b: Steering UI Minimum — Next Actions, Heute, Snapshot v2
Deploy Development / deploy (push) Successful in 45s
Test Suite / pytest-backend (push) Successful in 1m13s
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 15s

Workspace beantwortet die Leitfrage mit prominenten Next-Action- und Heute-Widgets sowie erweitertem Steuerungszustand pro Vorhaben.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
LarsandCursor committed 2026-07-05 15:55:05 +02:00
1 parent 6ea663b4c4
commit 451d62ed46
20 files changed
+892 -21

No files matched your search

@@ -0,0 +1,189 @@
# Kairo — MVP Usability Recovery Plan
**Status:** Planungsdokument (Product Direction)
**Stand:** 2026-07-05
**Auslöser:** AP0.8–0.10 liefern Entitäten, aber **keinen täglich nutzbaren Steuerungswert** — schlechter als To-do-/PM-Tools für den Alltag.
---
## 1. Diagnose
| Was Nutzer erwarten | Was Kairo heute liefert |
|---------------------|-------------------------|
| „Was mache ich jetzt?“ | Parallele Listen, keine Priorität in der UI |
| „Wo steht das Vorhaben?“ | Heuristik-Badge ohne Lifecycle-Modell |
| „Was kommt als Nächstes?“ | NextAction-API existiert, **kein Widget** |
| „Was blockiert?“ | Blocker-Liste, kaum mit Maßnahme verbunden |
| Meilensteine / Fristen | CRUD-Sektion, kein Horizont |
| Weniger als Todoist/Linear | **Ja** — mehr Klicks, weniger Antworten |
Das Product Reset (`Kairo_Product_Definition_and_MVP_Reset_v0.1.md` §4) warnt genau davor:
*Initiative → Action allein ist weniger als To-do-Listen und verfehlt den Program-Director-Anspruch.*
**Technisch:** Foundation + OM-Inventar ✓
**Produkt:** Steuerungsantwort auf die Leitfrage ✗
---
## 2. MVP-Nutzbarkeits-Bar (Definition of Done)
Kairo ist **minimal täglich nutzbar**, wenn ein Nutzer ohne Erklärung:
1. **In ≤30 Sekunden** seine nächste sinnvolle Maßnahme findet (Workspace).
2. **Pro Vorhaben** sieht: Phase (grober Zustand), nächster Meilenstein, größtes Hindernis, empfohlene Aktion.
3. **Backlog vs. Maßnahme** unterscheiden und Backlog in Maßnahme überführen kann.
4. **Blocker** erkennt, die echte Arbeit stoppen (nicht nur als Liste).
5. Das **ohne** Prompt/KI/MCP/Method Designer schafft.
Das ist **nicht** Feature-Parität mit Todoist — sondern **Steuerungsmehrwert** gegenüber reinen Listen:
> Nicht nur *was* existiert, sondern *was jetzt wirkt*.
---
## 3. Strategische Korrektur der Roadmap
Die bisherige Reihenfolge:
```text
AP0.8 Entitäten → AP0.9 Entitäten → AP0.10 Validation → Sprint 1 Steering Core
```
**Problem:** Validation auf CRUD-Listen liefert nur „fehlt alles“ — ohne vorherige **Steering Surface**.
**Korrigierte Reihenfolge:**
```text
AP0.10b Steering UI Minimum ← zuerst (Nutzen sichtbar)
AP0.10c Initiative Flow Minimum
AP0.10d MVP Validation (5 Vorhaben)
AP1.0 Steering Core Foundation (nur mit Validation-Ergebnis)
AP1.1 Method Registry minimal
```
**Regel bis AP1.0:** Keine neuen OM-Tabellen. Nur verbinden, anzeigen, orchestrieren, validieren.
---
## 4. Empfohlene Pakete
### AP0.10b — Steering UI Minimum (Priorität 1)
**Ziel:** Leitfrage im Workspace beantworten.
| # | Lieferung | Aufwand | Nutzen |
|---|-----------|---------|--------|
| 1 | **NextActionWidget** — `/api/workspace/next-actions`, Top 5, Link zu Vorhaben/Maßnahme | S | ★★★ |
| 2 | **Workspace „Heute“** — meine offenen Maßnahmen sortiert: überfällig → blockiert → high priority | S | ★★★ |
| 3 | **Steuerungszustand erweitern** — nächster Meilenstein (`target_date`), Top-Next-Action *für dieses Vorhaben*, Klartext statt `work_in_progress` | M | ★★★ |
| 4 | Attention-Widget: Kind + empfohlene Aktion lesbar | S | ★★ |
**Nicht-Scope:** Redesign, neue Entitäten, KI-Ranking.
---
### AP0.10c — Initiative Flow Minimum (Priorität 2)
**Ziel:** Vorhaben-Detail beantwortet „Wo stehe ich?“ — nicht „Hier sind 8 Listen“.
| # | Lieferung | Aufwand | Nutzen |
|---|-----------|---------|--------|
| 1 | **Maßnahmen-zentrierte Ansicht** — Blocker/Evidence/Reviews unter der Maßnahme, nicht nur global | M | ★★★ |
| 2 | **Sektionen einklappen** — Backlog/Evidence/Decision/Recurring unter „Erweitert“ | S | ★★ |
| 3 | **Meilenstein-Horizont** — „Als Nächstes: …“ (planned/active, sortiert nach `target_date`) | S | ★★ |
| 4 | **Flows sichtbar machen** — Blocker→blockiert, Review→review_required→done (Hinweis in UI) | S | ★★ |
| 5 | Snapshot-API in UI: `next_actions[]`, `upcoming_milestones[]` Felder | M | ★★★ |
---
### AP0.10d — MVP Validation (Priorität 3)
**Ziel:** Mit echten Vorhaben prüfen — dokumentiert, nicht Bauchgefühl.
Testvorhaben (Roadmap): Kairo, Gewaltschutzkurs, Karate, Familienorganisation, Server/Mindnet.
**Checkliste pro Vorhaben (15 Min):**
- [ ] Nächste Aktion in ≤30s gefunden?
- [ ] Blocker früh sichtbar?
- [ ] Meilenstein-Horizont hilfreich?
- [ ] Backlog→Maßnahme sinnvoll?
- [ ] Besser als Todo-Tool für *dieses* Vorhaben? Wenn nein: was fehlt?
**Output:** `Sprint0_AP0_10_Validation_Report_v0.1.md` + Go/No-Go für AP1.0.
---
### AP1.0 — Steering Core Foundation (Priorität 4, nach Validation)
**Ziel:** Heuristik durch echte Steuerungsstruktur ersetzen — schmal starten.
| Baustein | Minimal-Inhalt |
|----------|----------------|
| `SteeringContext` | `initiative_id`, `method_key` (default `generic_program`), `lifecycle_step` |
| Lifecycle | 5 Schritte: `intake`, `planning`, `execution`, `review`, `closure` |
| `operating_phase` | Liest aus `lifecycle_step`, nicht nur Zähler |
| Hooks (stub) | `on_blocker_open`, `on_next_action_requested` — Logging only |
| Migration | `009_steering_context.sql` |
**Nicht in AP1.0:** Method Designer, Workflow Runtime, Dependencies, Sprints.
---
### AP1.1 — Method Registry minimal (Priorität 5)
- Eine eingebaute Methode: **`generic_program`**
- Signal Rules + NextAction Strategy für diese Methode
- Später: `software_delivery`, `content_development`, …
---
## 5. Was bewusst warten muss
| Thema | Warum später |
|-------|--------------|
| Project-Entität | Erst wenn Initiative-Steuerung trägt |
| Abhängigkeiten / Gantt | Steering Core + Validation |
| Sprints / Work Cycles | Method Registry |
| KI-Priorisierung | Regelbasiert muss zuerst gut genug sein |
| UI-Redesign | Erst wenn Informationsarchitektur steht |
| Weitere OM-Tabellen | Stop — Inventar reicht |
---
## 6. Erfolgskriterien (Go für Sprint 1)
Sprint 1 (Steering Core) startet nur wenn:
1. **≥3 von 5** Testvorhaben: „Hilft bei täglicher Steuerung“ = ja (schwach ja reicht nicht).
2. **Leitfrage** auf Workspace in User-Test beantwortbar ohne Schulung.
3. **NextActionWidget** und erweiterter Steuerungszustand deployed und genutzt.
4. Validation-Report dokumentiert verbleibende Lücken — keine stillen Annahmen.
---
## 7. Empfohlene unmittelbare Reihenfolge (nächste 2–3 Umsetzungssprints)
```text
Sprint A (AP0.10b) NextActionWidget + Workspace Heute + Steuerungszustand v2
Sprint B (AP0.10c) Maßnahmen-Hub + Meilenstein-Horizont + UI entrauschen
Sprint C (AP0.10d) Validation + Report + AP1.0 Auftrag schärfen
Sprint D (AP1.0) SteeringContext + Lifecycle stub
```
**Sofort starten mit Sprint A** — größter Hebel, kleinster Scope, API existiert bereits.
---
## 8. Einordnung: Kairo vs. To-do-Tool
Kairo muss **nicht** mehr Features als Todoist haben.
Es muss **eine Frage besser beantworten**:
> *Welcher nächste Schritt bringt dieses Vorhaben jetzt am wirksamsten voran — und warum?*
Solange diese Frage in der UI nicht zentral beantwortet wird, ist jeder OM-Ausbau wertlos.
---
*v0.1 — Product Direction, ergänzt Corrected MVP Roadmap AP0.10*