Stefan Mogeritsch a454e6c97a docs: restructure domain documentation and update references

Implemented a standardized folder structure for domain documentation to improve clarity and maintainability. Migrated existing files to the new structure, updated links in related documentation, and added README files for navigation and guidance.

2026-01-15 13:44:49 +01:00

1.3 KiB

Raw Blame History

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

1.3 KiB Raw Blame History Unescape Escape