History

Stefan Mogeritsch 46361185d0 docs: enhance local dev docs, update Docker Compose, and archive old journals 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.		2026-01-20 14:00:09 +01:00
..
Playbooks	docs: enhance local dev docs, update Docker Compose, and archive old journals	2026-01-20 14:00:09 +01:00
README.md	docs: restructure domain documentation and update references	2026-01-15 13:44:49 +01:00

README.md

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 (Status proposed ist 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.md
Playbooks/Gemini.md
Playbooks/Curator.md