Lars
1ce20d8bdb
Some checks failed
Test Suite / playwright-tests (push) Waiting to run
Deploy Development / deploy (push) Failing after 0s
Test Suite / pytest-backend (push) Failing after 5m1s
Test Suite / lint-backend (push) Failing after 0s
Test Suite / build-frontend (push) Successful in 0s
Test Suite / k6 /api/health Baseline (push) Has been cancelled
Co-authored-by: Cursor <cursoragent@cursor.com>
106 lines
3.1 KiB
Markdown
106 lines
3.1 KiB
Markdown
# 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
|