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-06 (nach AP1.4b)  
**Zweck:** Ehrliche Trennung von **implementiert**, **teilweise**, **nur API/Schema**, **nur Dokumentiert**

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

---

## 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 012 |

---

## Operating Model — Persistenz

| Element | Stand | Anmerkung |
|---------|-------|-----------|
| Initiative | ✓ | |
| Project | ○ | Schema/API teils; **keine GUI** |
| Action | ✓ | UI-Label „Maßnahme“ |
| ActionAssignment | ✓ | |
| BacklogItem | ✓ | |
| Blocker | ✓ | `action_id` optional |
| Milestone | ◐ | Tabelle MVP-Brücke; kein Gate |
| Evidence | ✓ | |
| Decision | ✓ | |
| Review | ✓ | |
| RecurringElement | ✓ | |
| Task (unter Action) | ✗ | |
| Roadmap | ◐ | 1 pro Initiative; Migration 010 |
| RoadmapItem | ◐ | Verify über Checkliste AP1.4b |
| RoadmapItem Dependencies | ◐ | requires/blocks/related |
| RoadmapItem Criteria | ◐ | Checkliste, waive/defer, Reopen AP1.4b |
| Plan-Ist-Verknüpfung | ◐ | Evidence/Reviews + Kriterien |

---

## Steering

| Element | Stand | Anmerkung |
|---------|-------|-----------|
| steering_contexts (009) | ✓ | Lifecycle, method_key |
| backend/steering/ lifecycle | ✓ | |
| Signal Engine | ◐ | Regeln begrenzt |
| Method Registry | ◐ | generic_operating, product_milestone_driven |
| NextActionCandidate | ◐ | API + Widget; nicht konfigurierbar auf beiden Ebenen |
| Portfolio-Priorität (Initiativen) | ✗ | |
| Situativer Steuerungskontext (Next Action) | ✗ | 📄 Vision §7.6 |
| AttentionItem | ◐ | |
| Initiative Steering Snapshot | ✓ | Graph für Actions + linked |
| operating_phase | ✗ | entfernt AP1.2; Snapshot nutzt `signals` + Lifecycle |
| signals (Snapshot) | ✓ | `backend/steering/signals/snapshot_signals.py` |
| Hook Orchestrator | ✗ | AP1.3 geplant |
| Structure Builder | ✗ | 📄 |
| DoD Engine | ✗ | 📄 |

---

## UI / Information Architecture

| Sicht | Stand | Anmerkung |
|-------|-------|-----------|
| Workspace (Portfolio aller Initiativen) | ✓ | Portfolio-Widget |
| Initiative-Übersicht (operative Steuerung) | ✓ | AP1.2c |
| Initiative Unterseiten (Plan, Inbox, …) | ✓ | Shell + Pflege verschoben |
| Next-Action-Widget konfigurierbar (Workspace + Initiative) | ✓ | scope portfolio/initiative |
| Action Detail-Route | ✓ | `/initiatives/:id/actions/:actionId` |
| Action Detail-Seite | ✗ | |
| Gate Detail-Seite | ◐ | `/initiatives/:id/plan/items/:itemId` AP1.4b |
| Modal-Bearbeitung | ✗ | Inline-Formulare überall |
| Admin-UI | ✗ | |

---

## Milestone / Gate — Soll vs. Ist

| Gate-Anforderung (Vision) | Ist |
|---------------------------|-----|
| DoD / prüfbare Kriterien | ◐ | `roadmap_item_criteria`; Default „Gate allgemein“ |
| Zieltermin | ◐ | `target_date` |
| Abhängigkeiten | ◐ | API; Graph Engine AP1.4d |
| parallel vs. sequenziell | ◐ | `sequencing_mode` (deprecated); Graph AP1.4d |
| Verify vor `reached` | ◐ | Kriterienplan + gate_override |
| Reopen nach `reached` | ◐ | `active`, Kriterien bleiben AP1.4b |
| Decision bei `moved` | ✗ | |
| Quality-Gate-Semantik | ◐ | Checkliste + Audit |

---

## Terminologie im UI

| Vision | UI heute |
|--------|----------|
| Arbeitspaket | Maßnahme |
| Quality Gate | Meilenstein (CRUD) |
| Programm | Vorhaben |
| Plan | ◐ | Plan-Liste + Gate-Detail AP1.4b |

---

## Dokumente vs. Realität

| Risiko | Mitigation |
|--------|------------|
| Target State liest sich wie fertig | Truth Table + Vision v0.2 |
| Completion Reports = Vision erreicht | Banner „technisch, nicht produktlich“ |
| Usability Recovery → mehr InitiativeDetail | Recovery Plan v0.2 → IA-first |

---

## Nächste erwartete Änderungen (nach DOC-Programm)

| AP | Erwartete Truth-Table-Änderung |
|----|--------------------------------|
| AP1.2c | IA-Skeleton ✓ |
| AP1.2 | operating_phase ✗, signals ✓ |
| AP1.4 | RoadmapItem ◐, Gate Verify ◐ |
| AP1.5 | Task ○, Project GUI ◐ |
| AP1.8 | Portfolio-Priorität ○, situativer Kontext ○ |

---

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