tooling: make .junie/.gemini docs-first (remove legacy guidelines)
This commit is contained in:
@@ -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).
|
||||
@@ -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`
|
||||
Reference in New Issue
Block a user