Kairo-Jinkendo/docs/reference/design-principles/README.md

57 lines
1.6 KiB
Markdown
Raw Permalink Normal View History

# 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.