stefan
3465cab246
Applied a unified header format to all documentation files for better status identification, referencing, and ownership tracking. Archived outdated roadmaps, reports, and journal entries. Updated playbooks with new responsibilities, lifecycle rules, and consistent handover formats to align with the new archiving strategy.
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