# Kairo Architecture References v0.1

Status: verbindliche Referenzliste für Coding-Agenten  
Stand: 2026-07-04

## Primäre Kairo-Dokumente

1. `docs/product/Jinkendo_Kairo_Product_Spec_v0.2.md`
2. `docs/architecture/Jinkendo_Foundation_Minimum_Viable_Foundation_v0.2.md`
3. `docs/architecture/Kairo_Sprint0_Principle_Gate_v0.1.md`
4. `docs/sprints/Jinkendo_Kairo_04_Sprint0_Foundation_v0.3.md`
5. `docs/sprints/Sprint0_Vibe_Coder_Handover_v0.1.md`
6. `CLAUDE.md`
7. `.cursor/rules/kairo-architecture.mdc`
8. `docs/sprints/Sprint0_AP0_1_Project_Setup_Assignment_v0.1.md`

## Hilfsdokumente

- `docs/architecture/ARCHITECTURE_DECISION_PROPOSAL_TEMPLATE.md`
- `infra/README.md` — Platzhalter für serverseitige Infra-Ergänzungen

## Referenzdokumente

### Alignment

- `docs/reference/design-principles/alignment/DESIGN_PRINCIPLES_ALIGNMENT.md`
- `docs/reference/design-principles/alignment/FAMILY_ENTITLEMENT_MODEL.md`

### Mitai

- `docs/reference/design-principles/mitai/PROMPT_ENGINE_DESIGN_PRINCIPLES.md`
- `docs/reference/design-principles/mitai/REGISTRY_PLUGIN_DESIGN_PRINCIPLES.md`
- `docs/reference/design-principles/mitai/FEATURE_ENTITLEMENT_DESIGN_PRINCIPLES.md`
- `docs/reference/design-principles/mitai/AUTH_SESSION_DESIGN_PRINCIPLES.md`
- `docs/reference/design-principles/mitai/MIGRATION_DEPLOY_DESIGN_PRINCIPLES.md`

### Shinkan

- `docs/reference/design-principles/shinkan/ACCESS_LAYER_DESIGN_PRINCIPLES.md`
- `docs/reference/design-principles/shinkan/RIGHTS_REGISTRY_DESIGN_PRINCIPLES.md`
- `docs/reference/design-principles/shinkan/CAPABILITY_ENTITLEMENT_DESIGN_PRINCIPLES.md`
- `docs/reference/design-principles/shinkan/AI_PROMPT_RUNTIME_DESIGN_PRINCIPLES.md`
- `docs/reference/design-principles/shinkan/AUTH_SESSION_DESIGN_PRINCIPLES.md`
- `docs/reference/design-principles/shinkan/MIGRATION_DEPLOY_DESIGN_PRINCIPLES.md`

## Auslegungsregel

Bei Konflikten gilt diese Reihenfolge:

1. Kairo Sprint-0 Principle Gate
2. Sprint-0 Foundation v0.3
3. Kairo Product Spec
4. Kairo Foundation v0.2
5. Alignment-Dokumente
6. Mitai/Shinkan Einzelprinzipien

Mitai/Shinkan-Dokumente dürfen Kairo nicht überstimmen.

## Drift-Regel

Ein Agent darf Designprinzipien nur als Begründung verwenden, nicht als Erweiterungsauftrag.

Erlaubt:
> Shinkan Rights Registry begründet, warum Kairo eine Capability Registry braucht.

Nicht erlaubt:
> Shinkan hat Club Features, also bauen wir Club Features in Kairo.