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

2026-01-13 14:32:49 +01:00
parent 696c2e0bd8
commit ff0e1a36cc
66 changed files with 347 additions and 8923 deletions
@@ -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)
@@ -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 2–4 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.
+
+## Don’t
+* 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).
@@ -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.
+
+## Don’t
+* 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).