# Designprinzipien – Referenzpaket für Kairo

Status: Referenz / nicht automatisch verbindlich  
Stand: 2026-07-04

Dieses Verzeichnis enthält die extrahierten Designprinzipien aus Mitai und Shinkan sowie den Abgleich.

Diese Dokumente sind **Referenzmaterial**, kein direkter Sprint-Scope.

Verbindlich für Kairo ist nur, was in folgenden Dokumenten steht:

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. eine spätere explizite Architecture Decision

## Struktur

```text
docs/reference/design-principles/
  mitai/
  shinkan/
  alignment/
```

## Für Kairo Sprint 0 relevant

- TenantContext / mandantenfähiger Request-Kontext
- Actor-first statt User-first
- Auth, Capability, Feature und Governance trennen
- Rights / Capability Registry
- minimale Feature Registry
- minimale Prompt Registry
- Prompt Templates nicht hardcoden
- Template und Kontext trennen
- typisierte und validierte Platzhalter
- nummerierte Migrationen und Fail-Fast

## Nicht automatisch übernehmen

- Mitai Data Layer
- Mitai Widget Dashboard
- Mitai Universal Import
- vollständige Mitai Prompt Engine
- Shinkan Exercise Catalog
- Shinkan Training Planning
- Shinkan Skill Scoring
- Shinkan Media Assets
- Shinkan Content Reports
- Shinkan Maturity Models
- Billing, Tiers, Coupons, Usage-Limits
- zentrale Familien-Konvergenz

## Regel

Wenn ein Agent ein Prinzip aus diesem Referenzpaket übernehmen möchte, das nicht im Sprint-0-Gate steht, muss er ein Architecture Decision Proposal erstellen.