Kairo-Jinkendo/docs/product/Kairo_Implementation_Truth_Table_v0.1.md

# Kairo — Implementation Truth Table v0.1

**Status:** living document — bei jedem AP aktualisieren  
**Stand:** 2026-07-11 (Review + DOC-Sync; Code `develop` @ `b85a6ec`, Frontend `0.18.0-ap2.0`)  
**Zweck:** Ehrliche Trennung von **implementiert**, **teilweise**, **nur API/Schema**, **nur Dokumentiert**

Verhindert, dass Zielbild-Dokumente als Ist-Stand gelesen werden.

**Review:** `Kairo_Status_Review_and_Next_Steps_v0.1.md` · **Dogfooding:** `Kairo_Dogfooding_Mirror_Steering_v0.1.md`

---

## Legende

| Symbol | Bedeutung |
|--------|-----------|
| ✓ | Nutzbar im Alltag (GUI + API) |
| ◐ | Backend/API/Schema, GUI unzureichend oder falsch platziert |
| ○ | Nur Schema oder Stub |
| ✗ | Nicht vorhanden |
| 📄 | Nur in Architektur-Docs beschrieben |

---

## Foundation

| Element | Stand | Anmerkung |
|---------|-------|-----------|
| Tenant / Membership | ✓ | |
| User ≠ Actor | ✓ | |
| Actor Directory | ✓ | human, agent, working_group, external_system |
| Capabilities | ✓ | Keine Objekt-Sichtbarkeit |
| Auth / Session | ✓ | |
| Audit (Auth/Admin) | ◐ | Nicht für alle OM-Events |
| Migrationen nummeriert | ✓ | Schema bis **022** (`portfolio_rank`) |

---

## Operating Model — Persistenz

| Element | Stand | Anmerkung |
|---------|-------|-----------|
| Initiative | ✓ | inkl. `archetype_key`, `portfolio_rank` |
| Project | ◐ | AP1.5 + AP1.5c: Baum, Blatt-Regel; `archetype_key` Mirror AP2.0b |
| Action | ✓ | Gate-Zuordnung AP1.6, `due_at` |
| ActionAssignment | ✓ | |
| BacklogItem | ✓ | Gate-Zuordnung AP1.6, `sort_order` |
| Blocker | ✓ | `action_id` optional |
| Milestone | ◐ | Legacy-Tabelle MVP-Brücke; RoadmapItem bevorzugt |
| Evidence | ✓ | `roadmap_item_id`, `action_id`; Gitea-Links in `description` (manuell) |
| Decision | ✓ | |
| Review | ✓ | `roadmap_item_id` |
| RecurringElement | ✓ | |
| Task (unter Action) | ◐ | AP1.5d: `parent_task_id`, Baum-API, Outline; Roll-up-UI ◐ |
| Roadmap | ◐ | 1 pro Initiative; Migration 010 |
| RoadmapItem | ◐ | CRUD + Detail; Verify AP1.4b |
| RoadmapItem Dependencies | ◐ | requires/blocks/related; Graph AP1.4d |
| RoadmapItem Criteria | ◐ | Checkliste, waive/defer, Reopen AP1.4b/c |
| Plan-Ist-Verknüpfung | ◐ | Links, Kriterien, Journey AP1.6; Snapshots AP1.14 |
| Plan-Snapshots | ◐ | Migration 021, Diff-View Kontrolle AP1.14 |
| Entity Field System | ◐ | Migration 017, Seeds AP1.10b/AP2.0b |
| Initiative Archetypes | ◐ | Migration 016, Registry AP2.0b |
| Method Profiles (Code-Seeds) | ◐ | `product.kairo_dev`, Kumite, Buch — AP2.0b |
| `work_cycle` / Sprint | ✗ | 📄 MVP v0.3 B3; Migration AP2.0f geplant |

---

## Steering

| Element | Stand | Anmerkung |
|---------|-------|-----------|
| steering_contexts (009) | ✓ | Lifecycle, method_key |
| backend/steering/ lifecycle | ✓ | |
| Signal Engine | ◐ | Regeln begrenzt; Cockpit-Kacheln offen AP1.9c |
| Method Registry | ◐ | AP2.0a: Stubs inkl. `continuous_product`, `program_delivery`, …; 2 Strategien aktiv |
| Archetyp-/Methoden-Katalog PO | ✓ | ADP v0.2 + MVP v0.3 |
| NextActionCandidate | ◐ | API + Widget; `reason_code` teilweise AP2.0c; Strategien AP2.0d offen |
| Portfolio-Priorität (Initiativen) | ◐ | AP1.8a: `portfolio_rank`, Reorder, Next-Action-Sort |
| Situativer Steuerungskontext (Next Action) | ✗ | 📄 Vision §7.6; AP1.8b deferred |
| AttentionItem | ◐ | |
| Initiative Steering Snapshot | ✓ | Actions + linked; Archetyp/Guidance AP2.0c |
| operating_phase | ✗ | entfernt AP1.2 |
| signals (Snapshot) | ✓ | `snapshot_signals.py` |
| Graph Read Models (blocked/ready) | ◐ | AP1.4d/e; Join/OR AP1.15d deferred |
| Hook Orchestrator | ✗ | AP1.3 geplant |
| Structure Builder | ✗ | 📄 |
| DoD Engine | ✗ | 📄 |
| Gitea / Webhook Integration | ✗ | 📄 Schicht 4; manuelle Evidence-Links Phase 1 |

---

## UI / Information Architecture

| Sicht | Stand | Anmerkung |
|-------|-------|-----------|
| PM Work Modes Shell | ✓ | AP1.9a: Cockpit, Work, Plan, Control + Redirects |
| Cockpit (Portfolio) | ◐ | Widget-Grid; Rang AP1.8a; Signale auf Kacheln ✗ AP1.9c |
| Ausführen (/work) | ◐ | Heute, Meine APs |
| Planen (/plan) | ◐ | Outline AP1.12, Gates, Inbox, Struktur, Profil |
| Kontrolle (/control) | ◐ | Status, Plan/Ist AP1.14, Journey AP1.6b |
| Scope-Breadcrumb modus-sensitiv | ◐ | AP1.9b teilweise |
| Workspace (Legacy-Redirect) | ✓ | → Cockpit |
| Initiative-Übersicht (Steuerung) | ✓ | AP1.2c / Control Status |
| Journey | ◐ | AP1.6b: Fokus-Gates, Kriterien read-only, Ist-Graph |
| Next-Action-Widget | ✓ | portfolio + initiative scope |
| Action Detail-Route | ✓ | `/actions/:actionId` |
| Action Detail-Seite | ✓ | ActionHubCard + TasksSection |
| Gate Detail-Seite | ◐ | `/gates/:gateId`; Checkliste AP1.4c |
| Gate Map (read-only) | ✓ | AP1.13a |
| Gate Dependencies pflegen | ◐ | AP1.13b Detail |
| Zielzustands-Designer | ◐ | AP1.15a–c; OR deferred |
| Plan-Outline | ◐ | AP1.12a–d: Baum, Modal, Reorder, Actions |
| Profil-Modal (Archetyp/EFS) | ◐ | AP1.10c |
| Modal-Bearbeitung (Gates/Profil) | ◐ | viele Sektionen noch Inline-CRUD |
| Admin-UI | ✗ | |
| Team-Modus | ✗ | AP1.9f |

---

## Milestone / Gate — Soll vs. Ist

| Gate-Anforderung (Vision) | Ist |
|---------------------------|-----|
| DoD / prüfbare Kriterien | ◐ | `roadmap_item_criteria`; UI AP1.4c |
| Zieltermin | ◐ | `target_date` |
| Abhängigkeiten | ◐ | API + Graph Engine AP1.4d; Designer AP1.15 |
| parallel vs. sequenziell | ◐ | Kanten + `parallel_group`; `sequencing_mode` deprecated |
| Plan-Graph vs. Ist-Overlay | ◐ | Designer AP1.15; Journey Ist-Graph AP1.6b; Diff AP1.14 |
| Zielzustands-Designer (Joint/Parallel) | ◐ | AP1.15a–c; Join/OR AP1.15d deferred |
| Plan-Revision / Graph-Historie | ◐ | AP1.14 Plan-Snapshots |
| Verify vor `reached` | ◐ | Kriterien + gate_override |
| Reopen nach `reached` | ◐ | AP1.4b |
| Decision bei `moved` | ✗ | |
| Quality-Gate-Semantik | ◐ | Checkliste + Audit teilweise |

---

## Archetyp / MVP v0.3

| Element | Stand | Anmerkung |
|---------|-------|-----------|
| Vier-Schichten-Modell dokumentiert | ✓ | ADP v0.2 |
| Initiative-Archetypen Seeds | ◐ | AP2.0b |
| Default-Methode bei Anlage | ◐ | AP2.0b |
| Next-Action program_delivery | ◐ | Strategie registriert |
| Next-Action continuous_product | ◐ | Strategie registriert |
| maturity / sequential / queue / recurring Strategien | ○ | AP2.0d |
| Referenz-Ausprägung product.kairo_dev | ◐ | Code-Seed; Dogfooding manuell |
| MVP-Abnahfe Stufe A validiert | ✗ | AP0.10d / AP2.1 offen |
| Operational Actor API | ✗ | AP1.7 |
| MCP produktiv | ✗ | nach AP1.7 |

---

## Terminologie im UI

| Vision | UI heute |
|--------|----------|
| Arbeitspaket | Maßnahme (interim) |
| Quality Gate | Zielzustand / Gate (teils „Meilenstein“ legacy) |
| Programm | Vorhaben |
| Plan | ◐ | Plan-Outline + Gates + Designer |
| Cockpit | ✓ | ehem. Workspace |

---

## MVP-Nutzbarkeits-Bar (v0.3 §5) — Kurz

| # | Kriterium | Stand |
|---|-----------|-------|
| 1 | Anlegen Archetyp/Methode | ◐ |
| 2 | Struktur modellieren | ◐ |
| 3 | Ist committen | ◐ |
| 4 | Kontrolle begründet | ◐ |
| 5 | Journey | ◐ |
| 6 | Leitfrage ≤2 Min | ◐ |
| 7 | Cockpit Attention | ◐ |

Details: `Kairo_Status_Review_and_Next_Steps_v0.1.md` §2.1

---

## Dokumente vs. Realität

| Risiko | Mitigation |
|--------|------------|
| Target State liest sich wie fertig | Truth Table + Vision v0.2 |
| Completion Reports = Vision erreicht | Review-Doc + Dogfooding |
| Roadmap-Phasen veraltet | Roadmap v0.2 §2 aktualisiert 2026-07-11 |
| Usability Recovery → InitiativeDetail | IA-first, Redirects AP1.9a |

---

## Nächste erwartete Truth-Table-Änderungen

| AP | Erwartung |
|----|-----------|
| AP1.9c | Cockpit-Signale ◐→✓ |
| AP2.0d | Strategien ○→◐ |
| Dogfooding R1 | Referenz-Vorhaben in Alltag ◐ |
| AP2.0f | work_cycle ○→◐ |
| AP1.7 | Operational API ✗→◐ |

---

*Aktualisieren bei: jedem Merge auf develop mit produktrelevantem AP.*