stefan
dbe7c74a9c
- Add database schema documentation: `Database_Schema_V1-V009.md` for tenant-isolated entities (`veranstaltungen`, `turniere`, `bewerbe`, etc.). - Draft initial Kassa API reference: `Kassa_API.md` (status: DRAFT). - Finalize Stammdaten API reference: `API_Uebersicht_Stammdaten.md` (status: ACTIVE). - Summarize tenant isolation and multi-tenant strategy in `Multi_Tenant_Kurz.md`. - Update `README.md` with links to new references. Mark B-2 roadmap tasks as partially complete.
type, status, owner
| type | status | owner |
|---|---|---|
| Reference | ACTIVE | Lead Architect |
Agent Operating Model (AOM)
Dieses Verzeichnis definiert, wie KI-Unterstützung im Projekt eingesetzt wird: Rollen/Playbooks, Ablageorte und der minimale Prozess, damit Wissen nicht verloren geht.
Governance (Konfliktregel)
- Single Source of Truth:
docs/ - Tooling/Automatisierung:
.junie/(Scripts, Checks, optional Archiv – keine zweite „Wahrheit“) - Personas-Übersicht:
AGENTS.md(Repo-Root)
Wenn Aussagen in .junie/* und docs/* widersprechen, gilt docs/*.
Artefakt-Vertrag (Anti-Wissensverlust)
Jede KI-Session endet mit genau einem Artefakt in docs/:
- ADR (
docs/01_Architecture/adr/) – Entscheidung/Optionen/Trade-offs (Statusproposedist erlaubt) - Reference (passender Bereich) – Fakten/Ist-Zustand/Inventar
- How-to / Runbook (passender Bereich) – konkrete Schritte (Setup/Betrieb/Recovery)
- Journal Entry (
docs/99_Journal/) – Kurzprotokoll, wenn nichts „fertig“ wird
Tool-Rollen (keine Doppelarbeit)
- Junie (IDE-nah): Code/Repo-Wahrheit (Dateien, konkrete Implementierung, Refactors)
- Gemini (parallel/extern): Variantenraum (Optionen, Argumentation, Formulierungen, Gegenentwurf)
„Wahr“ wird es erst, wenn es im passenden docs/* Artefakt verankert ist.
Playbooks
| Playbook | Rolle | Typ |
|---|---|---|
Playbooks/Architect.md |
🏗️ Lead Architect | Strategie, Planung, Build-System |
Playbooks/BackendDeveloper.md |
👷 Backend Developer | Spring Boot, Kotlin, DDD |
Playbooks/Curator.md |
🧹 Curator | Dokumentation, Wissensmanagement |
Playbooks/DevOpsEngineer.md |
🐧 DevOps Engineer | Docker, CI/CD, Infrastruktur |
Playbooks/DomainExpert.md |
📋 Domain Expert | Fachlichkeit, Regelwerke, Gherkin |
Playbooks/FrontendExpert.md |
🎨 Frontend Expert | KMP, Compose, Offline-First |
Playbooks/Gemini.md |
🤖 Gemini (extern) | Konzeptarbeit, Optionen, ADR-Formulierung |
Playbooks/Junie.md |
🤖 Junie (IDE) | Repo-nahe Arbeit, Code, Implementierung |
Playbooks/QASpecialist.md |
🧐 QA Specialist | Teststrategie, Edge-Cases |
Playbooks/RulebookExpert.md |
📜 ÖTO/FEI Rulebook Expert | Regelwerks-Compliance, Validierung |
Playbooks/UIUXDesigner.md |
🖌️ UI/UX Designer | High-Density Design, Wireframes |