AP0.10a: OM-Integration — Steering-Snapshot, Transitions, Verknüpfungen
Deploy Development / deploy (push) Successful in 45s
Test Suite / pytest-backend (push) Failing after 1m10s
Test Suite / k6 /api/health Baseline (push) Has been skipped
Test Suite / playwright-smoke (push) Has been skipped
Test Suite / lint-backend (push) Successful in 1s
Test Suite / compose-smoke (push) Has been skipped
Deploy Development / deploy (push) Successful in 45s
Test Suite / pytest-backend (push) Failing after 1m10s
Test Suite / k6 /api/health Baseline (push) Has been skipped
Test Suite / playwright-smoke (push) Has been skipped
Test Suite / lint-backend (push) Successful in 1s
Test Suite / compose-smoke (push) Has been skipped
Beantwortet die Lücke zwischen parallelen Tabellen und späterem Steering Core: Graph-Read-Model, minimale Flows, sichtbarer Steuerungszustand. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
1 parent
a025542545
commit
e25ff86420
17 files changed
+1034
-5
No files matched your search
@@ -0,0 +1,146 @@
|
||||
# Kairo — Operating Model → Steering Bridge
|
||||
|
||||
**Status:** Architektur-Einordnung
|
||||
**Stand:** 2026-07-05
|
||||
**Zweck:** Ehrliche Antwort auf die Frage, ob AP0.8/0.9 auf spätere Steuerungslogik einzahlen — und was noch fehlt.
|
||||
|
||||
---
|
||||
|
||||
## 1. Kurzantwort
|
||||
|
||||
**Ja, aber indirekt.** AP0.8/0.9 haben das **Vokabular und die Persistenzschicht** des kanonischen Operating Models geliefert — nicht den **Steuerungsgraph**, nicht den **Lifecycle-Orchestrator** und nicht die **Method Registry**.
|
||||
|
||||
Das ist kein Versehen, sondern die dokumentierte Reihenfolge:
|
||||
|
||||
```text
|
||||
Foundation (AP0.1–0.7)
|
||||
→ Operating Model Entitäten (AP0.8–0.9) ← wir sind hier
|
||||
→ Integration & Validation (AP0.10)
|
||||
→ Steering Core Foundation (Sprint 1 / AP1.x)
|
||||
→ Method Registry, Hooks, Lifecycle Runtime
|
||||
```
|
||||
|
||||
Ohne die Entitäten hätte Steering nichts zu lesen und zu steuern.
|
||||
Mit nur den Entitäten **ohne Verbindungslogik** wirkt Kairo zu Recht wie eine Sammlung paralleler Tabellen.
|
||||
|
||||
---
|
||||
|
||||
## 2. Was AP0.8/0.9 tatsächlich vorbereitet
|
||||
|
||||
| Baustein | Beitrag für späteres Steering | Noch nicht da |
|
||||
|----------|------------------------------|---------------|
|
||||
| **Entitäten** | Blocker, Backlog, Milestone, Evidence, Decision, Review, Recurring | SteeringContext, Project, Dependency |
|
||||
| **Schwache FKs** | `blocker.action_id`, `evidence.action_id`, `review.action_id` | Pflicht-Struktur, Graph-Traversierung in UI |
|
||||
| **Attention (Regeln 1–9)** | Proto-Signal-Engine, erklärbare DTOs | Methoden-spezifische Signal Rules, Ranking |
|
||||
| **NextActionCandidates** | Regelbasierte Empfehlungen | Hook `on_next_action_requested`, Strategien |
|
||||
| **Audit-Events** | Nachvollziehbarkeit für Agenten/Steering | Lifecycle-Audit-Kette |
|
||||
| **Actor-Assignments** | Wer handelt | Waiting/Reminder/Escalation |
|
||||
| **Status-Enums** | Anknüpfpunkte für Lifecycle-Transitions | State Machine + Guards |
|
||||
|
||||
**Fazit:** AP0.8/0.9 = **System of Record für OM-Objekte** + **regelbasierte Signale**.
|
||||
Das ist Schritt 5–7 der Evolutionslinie (`Kairo_System_Target_State_v0.1.md` §24), **nicht** Schritt 2–4 (Steering Core, Method Registry, Lifecycle).
|
||||
|
||||
---
|
||||
|
||||
## 3. Kanonisches Modell vs. Ist-Implementierung
|
||||
|
||||
### Soll (Canonical Operating Model)
|
||||
|
||||
```text
|
||||
Initiative
|
||||
├── Milestone
|
||||
├── BacklogItem
|
||||
├── Action
|
||||
│ ├── Assignment
|
||||
│ ├── Blocker ← primär an Maßnahme
|
||||
│ └── Evidence ← primär an Maßnahme
|
||||
├── Decision
|
||||
├── Review
|
||||
└── RecurringElement
|
||||
```
|
||||
|
||||
### Ist (AP0.9)
|
||||
|
||||
```text
|
||||
Initiative
|
||||
├── [parallele Sektionen in UI]
|
||||
├── Action (Liste)
|
||||
├── Blocker (Liste, action_id optional)
|
||||
├── Evidence (Liste, action_id optional)
|
||||
├── …
|
||||
```
|
||||
|
||||
**Lücke:** Objekte existieren, aber **Struktur und Flow sind nicht sichtbar**.
|
||||
Der Nutzer sieht Listen, keinen **Steuerungszustand** eines Vorhabens.
|
||||
|
||||
---
|
||||
|
||||
## 4. Was „Steuerungslogik“ später bedeutet
|
||||
|
||||
Aus `Kairo_Target_Architecture_Method_Driven_Adaptive_Steering_Core_v0.1.md`:
|
||||
|
||||
| Komponente | Rolle |
|
||||
|------------|-------|
|
||||
| **SteeringContext** | Bindet Initiative an Methode, Lifecycle, Domain |
|
||||
| **Method Registry** | Liefert Structure Builder, Signal Rules, Strategien |
|
||||
| **Standard Lifecycle** | intake → … → closure mit Guards |
|
||||
| **Hook Registry** | `on_review_due`, `on_blocker_open`, `on_next_action_requested` |
|
||||
| **Signal Engine** | Attention + NextAction aus Methode + Kontext |
|
||||
| **Transition Orchestrator** | Statusänderung → Side Effects (unblock, review anstoßen) |
|
||||
|
||||
AP0.8/0.9 **ersetzen** das nicht — sie liefern die **Daten**, an die Hooks und Regeln andocken.
|
||||
|
||||
---
|
||||
|
||||
## 5. AP0.10 — Integration statt nur Validation
|
||||
|
||||
AP0.10 wird daher **zweigeteilt**:
|
||||
|
||||
### A) Operating Model Integration (technisch)
|
||||
|
||||
- **Steering-Snapshot** Read-Model: Initiative als verknüpfter Graph (Actions mit Blockern/Evidence/Reviews)
|
||||
- **Operating Cycle Phase** (heuristisch, erklärbar): triage / execute / verify / review / adapt
|
||||
- **Transition-Orchestrierung minimal:** z. B. Blocker gelöst → verknüpfte Maßnahme entblocken; Review abgeschlossen → Maßnahme weiterführen
|
||||
- **UI:** Verknüpfungen sichtbar (Maßnahme ↔ Blocker/Evidence), nicht nur parallele Sektionen
|
||||
- **Attention:** Regeln, die **Beziehungen** nutzen (Maßnahme blockiert + offener Blocker auf derselben Maßnahme)
|
||||
|
||||
### B) MVP Validation (fachlich)
|
||||
|
||||
Testvorhaben aus Roadmap (Kairo, Gewaltschutzkurs, …) — Prüffragen: Hilft es bei täglicher Steuerung? Fehlt was **wirklich** als Nächstes?
|
||||
|
||||
---
|
||||
|
||||
## 6. Evolutionspfad (konkret)
|
||||
|
||||
```text
|
||||
AP0.10 Integration + Validation ← nächster Schritt
|
||||
AP1.0 backend/steering/ Foundation (SteeringContext, Lifecycle stub)
|
||||
AP1.1 Method Registry minimal + Hook Registry
|
||||
AP1.2 Signal Engine aus attention.py → steering/signals/
|
||||
AP1.3 Transition Orchestrator (ersetzt operating_transitions.py)
|
||||
Sprint 2+ Dependencies, Waiting, Method Profiles
|
||||
```
|
||||
|
||||
**Regel:** Keine neuen parallelen Tabellen ohne OM-Bezug.
|
||||
Neue Arbeit muss either **verbinden**, **orchestratieren** oder **validieren**.
|
||||
|
||||
---
|
||||
|
||||
## 7. Leitfrage-Check
|
||||
|
||||
> Zahlt jede Entität auf „Welcher nächste Schritt bringt das Vorhaben voran?“ ein?
|
||||
|
||||
| Entität | Heute | Nach AP0.10 | Nach Steering Core |
|
||||
|---------|-------|-------------|-------------------|
|
||||
| Action | ✓ Commit/Execute | ✓ mit Kontext | ✓ NextAction-Ziel |
|
||||
| Blocker | △ Signal | ✓ an Maßnahme | ✓ Hook on_blocker_open |
|
||||
| Backlog | ✓ Triage | ✓ Convert-Flow | ✓ Structure Builder |
|
||||
| Milestone | △ Signal at_risk | ✓ mit Reviews | ✓ Roadmap-Lane |
|
||||
| Evidence | △ passive | ✓ an Maßnahme | ✓ Verify-Phase |
|
||||
| Review | △ due signal | ✓ schließt Execute | ✓ Review Strategy |
|
||||
| Decision | △ passive | △ Adapt-Hinweis | ✓ Adapt-Hook |
|
||||
| Recurring | △ due signal | △ Routine-Hinweis | ✓ routine_control |
|
||||
|
||||
---
|
||||
|
||||
*v0.1 — Referenz für AP0.10 und Sprint-1-Planung*
|
||||
@@ -0,0 +1,50 @@
|
||||
# AP0.10 — Operating Model Integration & MVP Validation
|
||||
## Implementierungsauftrag v0.1
|
||||
|
||||
**Status:** freigegeben
|
||||
**Stand:** 2026-07-05
|
||||
**Vorgänger:** AP0.9 ✓
|
||||
**Zielversion:** `0.10.0-ap0.10` (keine Schema-Migration)
|
||||
|
||||
---
|
||||
|
||||
## Warum AP0.10 anders ist als AP0.8/0.9
|
||||
|
||||
AP0.8/0.9 lieferten **Entitäten + Signale**.
|
||||
AP0.10 liefert **Verknüpfung + erklärbaren Zustand + minimale Flows** — Brücke zum Steering Core.
|
||||
|
||||
Referenz: `docs/architecture/Kairo_Operating_Model_Steering_Bridge_v0.1.md`
|
||||
|
||||
---
|
||||
|
||||
## Teil A — Integration (technisch)
|
||||
|
||||
| Slice | Inhalt |
|
||||
|-------|--------|
|
||||
| 10a | Steering-Snapshot Read-Model + API |
|
||||
| 10b | Operating-Transitions (Blocker→Action, Review→Action) |
|
||||
| 10c | Attention Regel: review_required ohne Review |
|
||||
| 10d | UI: Steuerungszustand + Verknüpfungen an Maßnahmen |
|
||||
|
||||
## Teil B — Validation (fachlich)
|
||||
|
||||
Testvorhaben aus Roadmap durchspielen, Lücken dokumentieren, AP1.0-Prioritäten ableiten.
|
||||
|
||||
## Nicht-Scope
|
||||
|
||||
- SteeringContext, Method Registry, Dependencies, Sprints
|
||||
- UI-Redesign
|
||||
- KI/MCP/Workflow
|
||||
|
||||
---
|
||||
|
||||
## Abnahme Teil A
|
||||
|
||||
- `GET /api/initiatives/{id}/steering-snapshot` liefert Graph + operating_phase
|
||||
- Blocker resolved → verknüpfte Maßnahme entblockt (wenn keine weiteren offenen Blocker)
|
||||
- Review completed → Maßnahme in review_required → done
|
||||
- UI zeigt Phase + Maßnahmen-Kontext (Blocker/Evidence)
|
||||
|
||||
---
|
||||
|
||||
*Freigegeben — Integration vor Validation.*
|
||||
Reference in new issue
Block a user