From cc3129116af2af50eed3cf63e05b29cc5ee7398b Mon Sep 17 00:00:00 2001 From: Lars Date: Sun, 5 Jul 2026 08:17:51 +0200 Subject: [PATCH] =?UTF-8?q?AP0.R1:=20Product=20Reset=20Integration=20?= =?UTF-8?q?=E2=80=94=20CLAUDE,=20README,=20Cursor=20Rule,=20Abschlussberic?= =?UTF-8?q?ht?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Cursor --- .cursor/rules/kairo-architecture.mdc | 29 +++- CLAUDE.md | 110 ++++++++++---- README.md | 42 +++++- .../Sprint0_AP0_R1_Completion_Report_v0.1.md | 139 ++++++++++++++++++ 4 files changed, 275 insertions(+), 45 deletions(-) create mode 100644 docs/sprints/Sprint0_AP0_R1_Completion_Report_v0.1.md diff --git a/.cursor/rules/kairo-architecture.mdc b/.cursor/rules/kairo-architecture.mdc index cb0050d..f1b9e1e 100644 --- a/.cursor/rules/kairo-architecture.mdc +++ b/.cursor/rules/kairo-architecture.mdc @@ -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 diff --git a/CLAUDE.md b/CLAUDE.md index de0a3f9..bb63459 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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.1–AP0.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.1–AP0.7 ist abgeschlossen. Fachlicher Ausbau nur entlang des Canonical Operating Models. diff --git a/README.md b/README.md index 28a49d4..3eaa5b3 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/docs/sprints/Sprint0_AP0_R1_Completion_Report_v0.1.md b/docs/sprints/Sprint0_AP0_R1_Completion_Report_v0.1.md new file mode 100644 index 0000000..50ecd97 --- /dev/null +++ b/docs/sprints/Sprint0_AP0_R1_Completion_Report_v0.1.md @@ -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 #1–3 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 | ✓ |