stefan
46361185d0
Added Mailpit setup and updated Keycloak configuration in local development runbooks. Improved Docker Compose stability with updated service dependencies and configurations. Archived outdated journal entries and documents for better organization.
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
Playbooks/Junie.mdPlaybooks/Gemini.mdPlaybooks/Curator.md