tooling: make .junie/.gemini docs-first (remove legacy guidelines)

This commit is contained in:
2026-01-13 14:32:49 +01:00
parent 696c2e0bd8
commit ff0e1a36cc
66 changed files with 347 additions and 8923 deletions
+19
View File
@@ -0,0 +1,19 @@
# Playbook: Documentation & Knowledge Curator
## Zweck
Der Curator sorgt dafür, dass Wissen **auffindbar, konsistent und versioniert** bleibt. Er ist die „letzte Rolle“ jeder Session.
## Kernregeln
* `docs/` ist die **Wahrheit**.
* Jede Session endet mit **genau einem** Artefakt (ADR/Reference/How-to/Journal).
* Links/Verweise setzen (auf relevante Code-Stellen, Dateien, ADRs).
## Ablauf (leichtgewichtig)
1. Thema der Session in 1 Satz festhalten.
2. Ergebnis-Typ wählen (welches Artefakt passt?).
3. Artefakt erstellen/aktualisieren.
4. Offene Fragen in den passenden „Parking Lot“ übernehmen.
5. Optional: kurzes Journal-Update, wenn das Artefakt nicht selbsterklärend ist.
## Parking Lots
* Technisch/Architektur: `docs/01_Architecture/questions.md` (falls benötigt)
+21
View File
@@ -0,0 +1,21 @@
# Playbook: Gemini (parallel/extern)
## Zweck
Gemini wird genutzt für **Konzeptarbeit**: Varianten vergleichen, Argumente/Trade-offs schärfen, Formulierungen für ADRs/Doku liefern, Review von Entwürfen.
## Startpunkt
1. `docs/README.md`
2. `docs/03_Agents/README.md` (Artefakt-Vertrag)
3. Je nach Thema: Architektur (`docs/01_Architecture/`), Backend (`docs/04_Backend/`), Frontend (`docs/05_Frontend/`), Infrastruktur (`docs/06_Infrastructure/`)
## Do
* Immer 24 Optionen mit Vor-/Nachteilen liefern.
* Offene Fragen explizit als Liste zurückgeben.
* Formuliere Outputs so, dass sie **direkt** in ein `docs/*` Artefakt übernommen werden können.
## Dont
* Keine Annahmen als Fakten verkaufen.
* Keine Repo-spezifischen Behauptungen ohne Quelle (Dateipfad/Link).
## Abschluss (Pflicht)
Der Output wird durch den `Curator` als genau **ein** Artefakt in `docs/` verankert (ADR/Reference/How-to/Journal).
+21
View File
@@ -0,0 +1,21 @@
# Playbook: Junie (IDE)
## Zweck
Junie wird genutzt für **Repo-nahe Arbeit**: Code lesen, reale Pfade/Module finden, konkrete Änderungen vorschlagen und umsetzen.
## Startpunkt
1. `docs/README.md`
2. Relevanter Bereich (z.B. `docs/01_Architecture/`, `docs/04_Backend/`, `docs/05_Frontend/`)
3. Bei Rollen/Prozessfragen: `docs/03_Agents/README.md`
## Do
* Immer mit **konkreten Dateipfaden** arbeiten.
* Bei Unklarheit: gezielte Rückfragen stellen und Annahmen explizit machen.
* Änderungen so klein wie möglich halten und den passenden Doku-Output erzeugen.
## Dont
* Keine „zweite Wahrheit“ in `.junie/guidelines/*` etablieren.
* Keine Entscheidungen „im Chat verlieren“ am Ende muss ein Artefakt in `docs/` stehen.
## Abschluss (Pflicht)
Am Ende der Session genau **ein** Artefakt gemäß `docs/03_Agents/README.md` erzeugen (oder aktualisieren).
+34
View File
@@ -0,0 +1,34 @@
# 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/`:
1. **ADR** (`docs/01_Architecture/adr/`) Entscheidung/Optionen/Trade-offs (Status `proposed` ist erlaubt)
2. **Reference** (passender Bereich) Fakten/Ist-Zustand/Inventar
3. **How-to / Runbook** (passender Bereich) konkrete Schritte (Setup/Betrieb/Recovery)
4. **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`