AP0.R1: Product Reset Integration — CLAUDE, README, Cursor Rule, Abschlussbericht
Some checks failed
Test Suite / pytest-backend (push) Waiting to run
Test Suite / lint-backend (push) Waiting to run
Test Suite / compose-smoke (push) Waiting to run
Test Suite / k6 /api/health Baseline (push) Blocked by required conditions
Test Suite / playwright-smoke (push) Blocked by required conditions
Deploy Development / deploy (push) Has been cancelled

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Lars 2026-07-05 08:17:51 +02:00
parent a01457debb
commit cc3129116a
4 changed files with 275 additions and 45 deletions

View File

@ -8,13 +8,29 @@ alwaysApply: true
Du arbeitest an **Jinkendo Kairo** (Sprint 0). Kairo ist mandantenfähig und Actor-first.
## Kairo Product Reset
Before implementing new functionality, preserve the canonical operating model:
Initiative, Project optional, Milestone, BacklogItem, Action, Assignment, Blocker, Decision, Evidence, Review, RecurringElement, AttentionItem, NextActionCandidate.
Do not reduce Kairo to Initiative → Action.
Do not continue prompt/AI/workflow/MCP work before the operating model MVP is restored.
Führende Product-Dokumente: `docs/product/Kairo_Product_Definition_and_MVP_Reset_v0.1.md`, `Kairo_Canonical_Operating_Model_v0.1.md`, `Kairo_Corrected_MVP_Roadmap_v0.1.md`.
## Dokumentenpriorität bei Konflikten
1. `docs/architecture/Kairo_Sprint0_Principle_Gate_v0.1.md`
2. `docs/sprints/Jinkendo_Kairo_04_Sprint0_Foundation_v0.3.md`
3. `docs/product/Jinkendo_Kairo_Product_Spec_v0.2.md`
4. `docs/reference/design-principles/alignment/*`
5. Mitai/Shinkan-Einzelprinzipien (nur Begründung, kein Scope)
1. `docs/product/Kairo_Product_Definition_and_MVP_Reset_v0.1.md`
2. `docs/product/Kairo_Canonical_Operating_Model_v0.1.md`
3. `docs/product/Kairo_Corrected_MVP_Roadmap_v0.1.md`
4. `docs/product/Jinkendo_Kairo_Product_Spec_v0.2.md`
5. `docs/architecture/Kairo_Current_State_Gap_Analysis_AP0.1_AP0.6b_v0.1.md`
6. `docs/architecture/CLAUDE_Product_Direction_Addendum_v0.1.md`
7. `docs/architecture/Kairo_Tenant_Invariants_v0.1.md`
8. `docs/architecture/Kairo_Sprint0_Principle_Gate_v0.1.md`
9. `docs/sprints/Jinkendo_Kairo_04_Sprint0_Foundation_v0.3.md`
10. `docs/reference/design-principles/alignment/*`
11. Mitai/Shinkan-Einzelprinzipien (nur Begründung, kein Scope)
## Reference design principles
@ -34,7 +50,8 @@ Nicht automatisch Implementierungs-Scope. Übernahme nur via Principle Gate oder
- Keine hardcodierten Rechte, Prompts oder Fachkonfiguration
- Nummerierte SQL-Migrationen; kein ad-hoc DDL in Routern
- Keine Mitai-/Shinkan-Domänenlogik kopieren
- Keine Vorhaben-/Projektlogik vor Sprint-0-Abschluss
- Kairo nicht auf Initiative → Action reduzieren
- Keine Prompt-/KI-/Workflow-/MCP-Erweiterung vor Operating-Model-MVP
## Abweichungen

110
CLAUDE.md
View File

@ -12,24 +12,17 @@ Welcher nächste Schritt bringt ein Vorhaben aktuell am wirkungsvollsten voran?
## 1. Aktueller Entwicklungsstand
Sprint 0.
Sprint 0 — Foundation und erster technischer Slice abgeschlossen (AP0.1AP0.7, AP0.6b).
Es geht noch nicht um die vollständige Fachanwendung, sondern um das Fundament.
Bereits vorhanden:
Sprint 0 baut:
- Tenant, User, Actor, TenantContext, Auth, Capabilities
- Feature / Prompt / Config Registry
- Vorhaben / Maßnahmen (technischer Startpunkt, nicht Zielmodell)
- Workspace-GUI, Data Layer Minimum, Actor Directory
- Tenant-Invarianten, Product Reset (AP0.R1)
- Tenant
- User
- Actor
- TenantContext
- Auth-Gates
- Capability / Rights Registry
- minimale Feature Registry
- minimale Prompt Registry
- Placeholder Validation
- Configuration-Grundmodell
- Audit
- Migration/Deploy-Grundlage
Nächster Fokus: MVP-Fachkern entlang des **Canonical Operating Models** — nicht weitere Foundation ohne Produktbezug.
---
@ -37,12 +30,64 @@ Sprint 0 baut:
Lies bei Projektstart in dieser Reihenfolge:
1. `docs/product/Jinkendo_Kairo_Product_Spec_v0.2.md`
2. `docs/architecture/Kairo_Sprint0_Principle_Gate_v0.1.md`
3. `docs/sprints/Jinkendo_Kairo_04_Sprint0_Foundation_v0.3.md`
4. `docs/sprints/Sprint0_Vibe_Coder_Handover_v0.1.md`
5. `docs/architecture/Kairo_Architecture_References_v0.1.md`
6. `.cursor/rules/kairo-architecture.mdc`
1. `docs/product/Kairo_Product_Definition_and_MVP_Reset_v0.1.md`
2. `docs/product/Kairo_Canonical_Operating_Model_v0.1.md`
3. `docs/product/Kairo_Corrected_MVP_Roadmap_v0.1.md`
4. `docs/product/Jinkendo_Kairo_Product_Spec_v0.2.md`
5. `docs/architecture/Kairo_Current_State_Gap_Analysis_AP0.1_AP0.6b_v0.1.md`
6. `docs/architecture/CLAUDE_Product_Direction_Addendum_v0.1.md`
7. `docs/architecture/Kairo_Tenant_Invariants_v0.1.md`
8. `docs/architecture/Kairo_Sprint0_Principle_Gate_v0.1.md`
9. `docs/sprints/Jinkendo_Kairo_04_Sprint0_Foundation_v0.3.md`
10. `docs/sprints/Sprint0_Vibe_Coder_Handover_v0.1.md`
11. `docs/architecture/Kairo_Architecture_References_v0.1.md`
12. `.cursor/rules/kairo-architecture.mdc`
Bei Konflikten gilt folgende Auslegungsreihenfolge:
1. Product & MVP Reset
2. Canonical Operating Model
3. Corrected MVP Roadmap
4. ursprüngliche Product Spec
5. Current State & Gap Analysis
6. Product Direction Addendum
7. Tenant Invariants
8. Sprint-0 Principle Gate
9. Sprint-0 Foundation
10. Architecture References
11. Mitai/Shinkan Designprinzipien und Referenzcode
Die frühere Product Spec bleibt gültige Grundlage, wird aber durch Reset und Operating Model konkretisiert.
---
## Aktuelle Produktleitlinie
Kairo darf nicht auf `Initiative → Action` reduziert werden.
Der aktuelle Vorhaben-/Maßnahmen-Slice ist nur ein technischer Startpunkt.
Kairo ist ein operativer Program Director.
Das kanonische Operating Model umfasst:
- Initiative / Vorhaben
- Project optional
- Milestone
- BacklogItem
- Action
- Assignment to Actor
- Blocker
- Decision
- Evidence
- Review
- RecurringElement
- AttentionItem
- NextActionCandidate
Neue Implementierungsaufträge müssen die Program-Director-Vision stützen oder eine konkret dokumentierte Umbaufalle verhindern.
Prompt-/KI-/Workflow-/MCP-Themen bleiben eingefroren, bis der MVP-Fachkern entlang des Operating Models trägt.
---
@ -67,14 +112,12 @@ Sie dürfen nicht dazu verwendet werden, Kairo mit Mitai- oder Shinkan-Domänenl
## 4. Auslegungsreihenfolge bei Konflikten
Bei Konflikten gilt:
Siehe **Abschnitt 2** — die Product-Reset-Reihenfolge ist verbindlich.
1. `Kairo_Sprint0_Principle_Gate_v0.1.md`
2. `Jinkendo_Kairo_04_Sprint0_Foundation_v0.3.md`
3. `Jinkendo_Kairo_Product_Spec_v0.2.md`
4. `Jinkendo_Foundation_Minimum_Viable_Foundation_v0.2.md`
5. `DESIGN_PRINCIPLES_ALIGNMENT.md`
6. Mitai/Shinkan Einzelprinzipien
Bei technischen Foundation-Konflikten zusätzlich:
- `Kairo_Sprint0_Principle_Gate_v0.1.md`
- `Jinkendo_Foundation_Minimum_Viable_Foundation_v0.2.md`
Mitai/Shinkan-Prinzipien dürfen Kairo nicht überstimmen.
@ -99,12 +142,13 @@ Mitai/Shinkan-Prinzipien dürfen Kairo nicht überstimmen.
## 6. Nicht tun
- Kairo auf `Initiative → Action` reduzieren oder als To-do-Tool behandeln
- Prompt-/KI-/Workflow-/MCP-Arbeit vor Operating-Model-MVP
- keine Mitai-Domänenlogik kopieren
- keine Shinkan-Domänenlogik kopieren
- keine Trainingsplanung bauen
- keine Gesundheitslogik bauen
- keine Lebensmanager-/Seichō-Logik in Kairo einbauen
- keine Vorhaben-/Projektlogik in AP0.1 vorziehen
- kein Billing oder SSO bauen
- keine strategischen Produktentscheidungen eigenmächtig ändern
- keine Designprinzipien aus `docs/reference/` ohne Principle-Gate oder Architecture Decision in Scope ziehen
@ -115,6 +159,10 @@ Mitai/Shinkan-Prinzipien dürfen Kairo nicht überstimmen.
Bei notwendiger Abweichung erstelle ein Architecture Decision Proposal.
## 8. Aktueller erster Auftrag
---
AP0.1 Projektgrundlage (Backend, Frontend minimal, Tests, Deploy).
## 8. Nächste Entwicklungsschritte
Siehe `docs/product/Kairo_Corrected_MVP_Roadmap_v0.1.md` und Abschlussberichte AP0.7 / AP0.R1.
Foundation AP0.1AP0.7 ist abgeschlossen. Fachlicher Ausbau nur entlang des Canonical Operating Models.

View File

@ -8,6 +8,24 @@ Kairo steuert Vorhaben, Programme, Projekte, Meilensteine, Maßnahmen, Backlogs,
> Welcher nächste Schritt bringt ein Vorhaben aktuell am wirkungsvollsten voran?
## Product Direction Reset
Kairo wurde nach AP0.7 produktstrategisch neu ausgerichtet.
Die führenden Dokumente sind:
- `docs/product/Kairo_Product_Definition_and_MVP_Reset_v0.1.md`
- `docs/product/Kairo_Canonical_Operating_Model_v0.1.md`
- `docs/product/Kairo_Corrected_MVP_Roadmap_v0.1.md`
Kairo ist nicht als einfache Aufgabenliste zu verstehen, sondern als operativer Program Director.
Der aktuelle technische Slice `Initiative → Action` bleibt gültig, ist aber nicht das Zielmodell.
Siehe auch `CLAUDE.md` für die verbindliche Dokumentenreihenfolge.
Abschlussbericht: `docs/sprints/Sprint0_AP0_R1_Completion_Report_v0.1.md`
## Startzustand
Dieses Repository startet mit einem reinen Spezifikations- und Sprint-0-Handover-Paket.
@ -22,14 +40,22 @@ Noch nicht enthalten:
## Verbindliche Dokumente für Sprint 0
1. `docs/product/Jinkendo_Kairo_Product_Spec_v0.2.md`
2. `docs/architecture/Jinkendo_Foundation_Minimum_Viable_Foundation_v0.2.md`
3. `docs/architecture/Kairo_Sprint0_Principle_Gate_v0.1.md`
4. `docs/sprints/Jinkendo_Kairo_04_Sprint0_Foundation_v0.3.md`
5. `docs/sprints/Sprint0_Vibe_Coder_Handover_v0.1.md`
6. `docs/sprints/Sprint0_AP0_1_Project_Setup_Assignment_v0.1.md`
7. `CLAUDE.md`
8. `.cursor/rules/kairo-architecture.mdc`
**Product Reset (führend ab AP0.R1):**
1. `docs/product/Kairo_Product_Definition_and_MVP_Reset_v0.1.md`
2. `docs/product/Kairo_Canonical_Operating_Model_v0.1.md`
3. `docs/product/Kairo_Corrected_MVP_Roadmap_v0.1.md`
**Foundation & Steuerung:**
4. `docs/product/Jinkendo_Kairo_Product_Spec_v0.2.md`
5. `docs/architecture/Kairo_Current_State_Gap_Analysis_AP0.1_AP0.6b_v0.1.md`
6. `docs/architecture/Kairo_Tenant_Invariants_v0.1.md`
7. `docs/architecture/Kairo_Sprint0_Principle_Gate_v0.1.md`
8. `docs/sprints/Jinkendo_Kairo_04_Sprint0_Foundation_v0.3.md`
9. `docs/sprints/Sprint0_Vibe_Coder_Handover_v0.1.md`
10. `CLAUDE.md`
11. `.cursor/rules/kairo-architecture.mdc`
## Arbeitsmodus

View File

@ -0,0 +1,139 @@
# AP0.R1 Abschlussbericht Product Reset Integration
**Status:** abgeschlossen
**Stand:** 2026-07-05 (final)
**Branch:** `develop`
**Art:** Dokumentations- und Steuerungsauftrag — **keine Codeänderungen**
---
## 1. Scope
AP0.R1 integriert das Product Reset Paket ins Repository und aktualisiert die Projektsteuerung für Coding-Agenten.
Ziel: Kairo künftig nicht mehr als flache `Initiative → Action`-Liste, sondern als **operativer Program Director** weiterentwickeln.
**Nicht-Scope eingehalten:** Keine Backend-/Frontend-/Migration-/UI-Änderungen.
---
## 2. Umgesetzte Dateien
### Reset-Dokumente (im Repo verankert)
| Pfad | Status |
|------|--------|
| `docs/product/Kairo_Product_Definition_and_MVP_Reset_v0.1.md` | ✓ vorhanden |
| `docs/product/Kairo_Canonical_Operating_Model_v0.1.md` | ✓ vorhanden |
| `docs/product/Kairo_Corrected_MVP_Roadmap_v0.1.md` | ✓ vorhanden |
| `docs/architecture/Kairo_Current_State_Gap_Analysis_AP0.1_AP0.6b_v0.1.md` | ✓ vorhanden |
| `docs/architecture/CLAUDE_Product_Direction_Addendum_v0.1.md` | ✓ vorhanden |
### Steuerungsdateien (aktualisiert)
| Datei | Änderung |
|-------|----------|
| `CLAUDE.md` | Primärdokumente, Auslegungsreihenfolge, Produktleitlinie, Nicht-tun |
| `README.md` | Product Direction Reset, Dokumentenliste |
| `.cursor/rules/kairo-architecture.mdc` | Product Reset Block, neue Dokumentenpriorität |
### Neu in AP0.R1
| Datei | Zweck |
|-------|--------|
| `docs/sprints/Sprint0_AP0_R1_Completion_Report_v0.1.md` | dieser Bericht |
---
## 3. Aktualisierung CLAUDE.md
- **Abschnitt 2:** 12 Primärdokumente in Reset-Reihenfolge (inkl. Tenant Invariants #7)
- **Auslegungsreihenfolge:** 11-stufig, Product Reset vor Sprint-0-Foundation
- **Neu:** Abschnitt „Aktuelle Produktleitlinie“ — Operating Model, Anti-Reduktion, KI-Freeze
- **Abschnitt 4:** Verweis auf Abschnitt 2 (keine widersprüchliche alte Reihenfolge mehr)
- **Abschnitt 6:** Ergänzt — kein Initiative→Action, kein Prompt/KI vor MVP
- **Abschnitt 8:** Nächste Schritte via Corrected MVP Roadmap
---
## 4. Aktualisierung README.md
- Neuer Abschnitt **Product Direction Reset** (führende Dokumente, Program Director, Slice vs. Zielmodell)
- **Verbindliche Dokumente** auf Reset-first umgestellt
---
## 5. Cursor Rule / Architekturregel
`.cursor/rules/kairo-architecture.mdc` ergänzt:
- Block **Kairo Product Reset** (Operating Model, keine Initiative→Action-Reduktion, KI-Freeze)
- **Dokumentenpriorität** auf Reset-Dokumente #13 vor Product Spec
- Guardrail: keine Prompt/KI/Workflow/MCP vor Operating-Model-MVP
---
## 6. Neue verbindliche Dokumentenreihenfolge
```text
1. Kairo_Product_Definition_and_MVP_Reset_v0.1.md
2. Kairo_Canonical_Operating_Model_v0.1.md
3. Kairo_Corrected_MVP_Roadmap_v0.1.md
4. Jinkendo_Kairo_Product_Spec_v0.2.md
5. Kairo_Current_State_Gap_Analysis_AP0.1_AP0.6b_v0.1.md
6. CLAUDE_Product_Direction_Addendum_v0.1.md
7. Kairo_Tenant_Invariants_v0.1.md
8. Kairo_Sprint0_Principle_Gate_v0.1.md
9. Jinkendo_Kairo_04_Sprint0_Foundation_v0.3.md
10. Sprint0_Vibe_Coder_Handover_v0.1.md
11. Kairo_Architecture_References_v0.1.md
12. .cursor/rules/kairo-architecture.mdc
```
---
## 7. Nicht umgesetzte Punkte
Bewusst nicht Teil von AP0.R1 (laut Roadmap später):
- BacklogItem, Milestone, Blocker, Evidence, Review, AttentionItem, NextActionCandidate
- Audit UI, Actor Workload Widget
- Prompt/KI/MCP/Workflow
- Admin-Konsole
---
## 8. Prüfung gegen Nicht-Scope
| Nicht-Scope | Ergebnis |
|-------------|----------|
| Backend-Endpoints | ✓ keine Änderung |
| Tabellen / Migrationen | ✓ keine |
| UI | ✓ keine |
| Fachfeatures | ✓ keine |
| Tests | ✓ unverändert (nur Doku) |
---
## 9. Empfehlung für AP0.8
Gemäß `Kairo_Corrected_MVP_Roadmap_v0.1.md` — erster Fachschritt entlang Operating Model, z.B.:
1. **BacklogItem** oder **Milestone** als nächstes minimales Domänenobjekt (mit ADP)
2. **AttentionItem / NextActionCandidate** als Read Model auf bestehendem Data Layer
3. Optional parallel: Audit/Admin minimal (weiterhin Foundation-Backlog)
**Nicht starten:** Prompt/KI/MCP bis MVP-Fachkern trägt.
---
## Abnahme-Checkliste AP0.R1
| Kriterium | Erfüllt |
|-----------|---------|
| Reset-Dokumente im Repo | ✓ |
| CLAUDE.md neue Reihenfolge | ✓ |
| Produktleitlinie Anti-Reduktion | ✓ |
| README Product Reset | ✓ |
| Cursor Rule ergänzt | ✓ |
| Keine Fach-/Tech-Umbauten | ✓ |