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