Kairo-Jinkendo/.cursor/rules/kairo-architecture.mdc

---
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)
- **Archetyp-/Methoden-Plugin (AP2.3/AP2.4):** siehe `.cursor/rules/kairo-plugin-architecture.mdc` — keine Archetyp-Ifs in Pages, keine neuen Features in `methodUiDefaults.js`

## Abweichungen

Architecture Decision Proposal nach `docs/architecture/ARCHITECTURE_DECISION_PROPOSAL_TEMPLATE.md`.