History

Stefan Mogeritsch 84337697ce docs: update code block formatting in reports and restructure guides Updated code block formatting in `Ping-Service_Impl_01-2026.md` for consistency by switching from `kotlin` to `text`. Refactored `README.md` to rename `02_Onboarding` to `02_Guides` for improved clarity. Adjusted UI code example in `UIUXDesigner.md` with added descriptive comments.		2026-01-23 13:39:07 +01:00
..
Playbooks	docs: update code block formatting in reports and restructure guides	2026-01-23 13:39:07 +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