Kairo-Jinkendo/.cursor/rules/kairo-architecture.mdc
Lars 8c31802662
All checks were successful
Deploy Development / deploy (push) Successful in 45s
Test Suite / pytest-backend (push) Successful in 1m22s
Test Suite / lint-backend (push) Successful in 2s
Test Suite / compose-smoke (push) Has been skipped
Test Suite / k6 /api/health Baseline (push) Successful in 19s
Test Suite / playwright-smoke (push) Successful in 12s
docs: Vision v0.2 und Dokumentations-Überarbeitung Welle 1
Führendes Zielbild: Workspace-Portfolio, Initiative-Übersicht vs. Unterseiten, Vibe-Coder-Schnittstelle, Next-Action-Widget auf beiden Ebenen, Portfolio-Priorität und situativer Steuerungskontext. Canonical OM v0.2, Truth Table, Revision Program; v0.1-Docs mit Superseded-Banner; CLAUDE.md und Cursor-Rules aktualisiert.
2026-07-05 18:06:26 +02:00

58 lines
2.0 KiB
Plaintext

---
description: Kairo Architektur-Leitplanken und Dokumentenpriorität
globs: backend/**,frontend/**,docs/**,.gitea/**
alwaysApply: true
---
# Kairo Architecture Rules
Du arbeitest an **Jinkendo Kairo**. Kairo ist mandantenfähig und Actor-first.
## Führende Product-Dokumente (ab 2026-07-05)
1. `docs/product/Kairo_Vision_and_Product_Direction_v0.2.md`
2. `docs/product/Kairo_Canonical_Operating_Model_v0.2.md`
3. `docs/product/Kairo_Implementation_Truth_Table_v0.1.md`
## Product Vision
Kairo ist Program Director — nicht To-do-Tool, nicht CRUD-Omnibus.
- **Plan:** Roadmap / RoadmapItem (Gates, Meilensteine, Reifegrade)
- **Ist:** committete Actions (Arbeitspakete), später Tasks
- **IA:** Workspace (Ausführung), Initiative-Unterseiten (Steuerung, Ausführung, Plan, Eingang, Journey)
- **Bearbeitung:** Modal oder Objekt-Detail — nicht Inline-CRUD auf Übersichtsseiten
Do not reduce Kairo to Initiative → Action.
Do not expand InitiativeDetail as all-in-one CRUD wall.
Do not continue prompt/AI/workflow/MCP before Plan/Ist and Gates are modeled.
## Dokumentenpriorität bei Konflikten
1. Vision & Product Direction v0.2
2. Canonical Operating Model v0.2
3. Implementation Truth Table
4. System Target State, ADPs (Scope Lock)
5. Tenant Invariants, Principle Gate
6. Product Spec v0.2 (Referenz)
7. Sprint History (Completion Reports — nicht als Zielbild)
## Reference design principles
Referenzmaterial unter `docs/reference/design-principles/`. Nicht automatisch Scope.
## Harte Guardrails
- Kein Single-User ohne Tenant
- User ≠ Actor; Agenten sind Actors
- Auth, Capability, Feature, Governance trennen
- Keine hardcodierten Rechte, Prompts oder Fachkonfiguration
- Nummerierte SQL-Migrationen; kein ad-hoc DDL in Routern
- Keine Mitai-/Shinkan-Domänenlogik kopieren
- Keine parallele Steuerungslogik außerhalb `backend/steering/`
- Keine neuen OM-Tabellen ohne ADP (Scope Lock bis RoadmapItem-ADP)
## Abweichungen
Architecture Decision Proposal nach `docs/architecture/ARCHITECTURE_DECISION_PROPOSAL_TEMPLATE.md`.