Lars/Kairo-Jinkendo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
0443b734c1
Kairo-Jinkendo/docs/architecture/Kairo_Sprint0_Principle_Gate_v0.1.md
Lars 1ce20d8bdb
Some checks failed
Test Suite / playwright-tests (push) Waiting to run
Details
Deploy Development / deploy (push) Failing after 0s
Details
Test Suite / pytest-backend (push) Failing after 5m1s
Details
Test Suite / lint-backend (push) Failing after 0s
Details
Test Suite / build-frontend (push) Successful in 0s
Details
Test Suite / k6 /api/health Baseline (push) Has been cancelled
Details
Sprint-0-Spezifikationen ergaenzen, AP0.1-Setup-Luecken schliessen (Health, CI, ADR-Vorlage). 
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-04 19:08:55 +02:00

3.1 KiB
Raw Blame History

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:

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