# Jinkendo Kairo
## Sprint-0 Principle Gate v0.1

Status: verbindlicher Scope-Filter für Sprint 0  
Stand: 2026-07-04

---

## 1. Zweck

Dieses Dokument verhindert Drift.

Es legt fest, welche Prinzipien aus Mitai/Shinkan/Family-Alignment für Kairo Sprint 0 verbindlich sind und welche ausdrücklich nicht umgesetzt werden.

---

## 2. Entscheidungsregel

Ein Prinzip ist nur dann Sprint-0-verbindlich, wenn alle drei Fragen mit Ja beantwortet werden:

1. Verhindert es später teures strukturelles Refactoring?
2. Ist es für Sprint 0 zwingend erforderlich?
3. Kann es minimal umgesetzt werden, ohne Kairo zu überladen?

---

## 3. Sprint-0-verbindliche Prinzipien

| ID | Prinzip | Sprint-0-Konsequenz |
|---|---|---|
| G-01 | Tenant-first | Tenant ist Kernobjekt; keine Single-User-Architektur |
| G-02 | Actor-first | Assignments gehen an Actors, nicht direkt an User |
| G-03 | TenantContext pro Request | Auth-Kontext wird zentral aufgelöst |
| G-04 | Auth / Capability / Feature / Governance trennen | Keine Vermischung von Login, Rollen, Limits und Objektzugriff |
| G-05 | Rights Registry | Rechte/Capabilities werden registriert, nicht verstreut hardcodiert |
| G-06 | Feature Registry minimal | Features sind bekannt und benannt, auch wenn Limits später kommen |
| G-07 | Prompt Registry minimal | Prompts sind administrierbare Templates, nicht Code-Strings |
| G-08 | Platzhalter validieren | Pflichtplatzhalter dürfen nicht stillschweigend fehlen |
| G-09 | Config statt Hardcoding | Fachliche Konfiguration nicht im Code verdrahten |
| G-10 | Audit | Admin- und Agentenaktionen werden protokolliert |
| G-11 | Migration Standard | Nummerierte SQL-Migrationen + Tracking |
| G-12 | Fail-Fast Startup | App startet nicht mit fehlerhaftem Schema |

---

## 4. Nur vorbereiten, nicht vollständig bauen

| Thema | Sprint-0-Umfang |
|---|---|
| Entitlements | Minimaler `/me/entitlements` Snapshot: tenant, actor, roles, capabilities |
| Feature Limits | Datenmodell optional vorbereiten; keine Usage-Zähler |
| Prompt Engine | Templates, Versionen, Platzhalter; keine Workflows/Pipelines |
| Admin UI | Minimal prüfbar; keine ausgereifte Oberfläche |
| MCP | Schnittstellen später; keine MCP-Implementierung in Sprint 0 |
| AI Agenten | Actor Type Agent vorbereiten; keine vollständige Agentensteuerung |

---

## 5. Explizit nicht Sprint 0

- Billing
- Tiers
- Pläne
- Coupons
- Usage-Zähler
- SSO
- Mitai Data Layer
- Mitai Widget Dashboard
- Universal Import
- Shinkan Exercise Catalog
- Shinkan Training Planning
- Shinkan Media Assets
- Shinkan Content Reports
- Shinkan Maturity Models
- vollständige Familien-Konvergenz
- Lebensmanager-/Seichō-Fachlogik

---

## 6. Review-Regel

Jeder neue Vorschlag im Sprint wird mit einer Kategorie versehen:

```text
A – Sprint-0-verbindlich
B – Architektur-Backlog
C – Produktspezifisch / ignorieren
```

Nur Kategorie A darf in Sprint 0 umgesetzt werden.

---

## 7. Abweichungsregel

Ein Coding-Agent darf nicht eigenmächtig von diesem Gate abweichen.

Bei notwendiger Abweichung erstellt er ein Architecture Decision Proposal mit:

- Problem
- betroffene Regel
- vorgeschlagene Änderung
- Risiko
- Alternative
- Empfehlung