diff --git a/docs/04_Agents/Playbooks/Architect.md b/docs/04_Agents/Playbooks/Architect.md index 0c737c1e..222965ab 100644 --- a/docs/04_Agents/Playbooks/Architect.md +++ b/docs/04_Agents/Playbooks/Architect.md @@ -31,4 +31,13 @@ Deine Aufgaben: 5. Pflege die übergreifende Projektdokumentation im `/docs`-Verzeichnis, insbesondere im `01_Architecture`-Bereich. 6. **Handover:** Stelle Architekturentscheidungen nicht nur als Text, sondern auch als Diagramm (Mermaid/PlantUML) bereit. 7. Erstelle und pflege die MASTER ROADMAP. Du bist der "Hüter des Plans". Du delegierst Aufgaben an die spezialisierten Agenten (Backend, Frontend, DevOps, QA), führst sie aber nicht selbst aus, es sei denn, es betrifft direkt die Architektur oder das Build-System. + +Don't: +- Implementiere keine Business-Logik in Backend-Services (→ Backend Developer). +- Schreibe keine UI-Komponenten oder Compose-Code (→ Frontend Expert). +- Konfiguriere keine Docker-Container oder CI/CD-Pipelines (→ DevOps Engineer). +- Erstelle keine Testfälle oder Teststrategien (→ QA Specialist). ``` + +## Abschluss (Pflicht) +Am Ende der Session genau **ein** Artefakt gemäß `docs/04_Agents/README.md` erzeugen oder aktualisieren (ADR / Reference / How-to / Journal Entry). diff --git a/docs/04_Agents/Playbooks/BackendDeveloper.md b/docs/04_Agents/Playbooks/BackendDeveloper.md index 351cafe0..403b3a0b 100644 --- a/docs/04_Agents/Playbooks/BackendDeveloper.md +++ b/docs/04_Agents/Playbooks/BackendDeveloper.md @@ -34,3 +34,6 @@ Regeln: 6. **Pre-Flight Check:** Prüfe vor Abschluss, ob API-Änderungen (insb. Sync) mit den Anforderungen des Frontend-Experts kompatibel sind. 7. **Dokumentation:** Aktualisiere die Implementierungs-Dokumentation für deinen Service unter `/docs/05_Backend/Services/`. ``` + +## Abschluss (Pflicht) +Am Ende der Session genau **ein** Artefakt gemäß `docs/04_Agents/README.md` erzeugen oder aktualisieren (ADR / Reference / How-to / Journal Entry). diff --git a/docs/04_Agents/Playbooks/Curator.md b/docs/04_Agents/Playbooks/Curator.md index f5884b5d..a96e6f73 100644 --- a/docs/04_Agents/Playbooks/Curator.md +++ b/docs/04_Agents/Playbooks/Curator.md @@ -1,3 +1,9 @@ +--- +type: Reference +status: ACTIVE +owner: Lead Architect +last_update: 2026-03-25 +--- # Playbook: Documentation & Knowledge Curator (Pflichtrolle) ## Beschreibung diff --git a/docs/04_Agents/Playbooks/DevOpsEngineer.md b/docs/04_Agents/Playbooks/DevOpsEngineer.md index 78021947..8f1d7ea6 100644 --- a/docs/04_Agents/Playbooks/DevOpsEngineer.md +++ b/docs/04_Agents/Playbooks/DevOpsEngineer.md @@ -40,3 +40,6 @@ Arbeitsweise: - **Smoke Tests:** Verlasse dich nicht auf "sollte gehen". Fordere Logs an oder prüfe Endpunkte (curl/Browser), um den Erfolg zu bestätigen. - **Support:** Unterstütze Backend- und Frontend-Devs bei Problemen mit der Docker-Umgebung. ``` + +## Abschluss (Pflicht) +Am Ende der Session genau **ein** Artefakt gemäß `docs/04_Agents/README.md` erzeugen oder aktualisieren (ADR / Reference / How-to / Journal Entry). diff --git a/docs/04_Agents/Playbooks/DomainExpert.md b/docs/04_Agents/Playbooks/DomainExpert.md index fa4329b2..b3bfee56 100644 --- a/docs/04_Agents/Playbooks/DomainExpert.md +++ b/docs/04_Agents/Playbooks/DomainExpert.md @@ -32,3 +32,6 @@ Output: - **Handover-Format:** Nutze **Gherkin (Given/When/Then)** für Akzeptanzkriterien, damit QA und Devs diese direkt verarbeiten können. - Erstelle die Grundlage für technische ADRs, indem du die fachlichen "Warum"-Fragen beantwortest. ``` + +## Abschluss (Pflicht) +Am Ende der Session genau **ein** Artefakt gemäß `docs/04_Agents/README.md` erzeugen oder aktualisieren (ADR / Reference / How-to / Journal Entry). diff --git a/docs/04_Agents/Playbooks/FrontendExpert.md b/docs/04_Agents/Playbooks/FrontendExpert.md index f980ec7a..eca21bfd 100644 --- a/docs/04_Agents/Playbooks/FrontendExpert.md +++ b/docs/04_Agents/Playbooks/FrontendExpert.md @@ -33,3 +33,6 @@ Regeln: 5. **Pre-Flight Check:** Stimme dich bei API-Anforderungen (insb. Delta-Sync & Datenmodelle) eng mit dem Backend Developer ab, bevor du implementierst. 6. **Dokumentation:** Pflege die Frontend-spezifische Dokumentation unter `/docs/06_Frontend/`. ``` + +## Abschluss (Pflicht) +Am Ende der Session genau **ein** Artefakt gemäß `docs/04_Agents/README.md` erzeugen oder aktualisieren (ADR / Reference / How-to / Journal Entry). diff --git a/docs/04_Agents/Playbooks/Gemini.md b/docs/04_Agents/Playbooks/Gemini.md index 9c1802ae..3a3683ec 100644 --- a/docs/04_Agents/Playbooks/Gemini.md +++ b/docs/04_Agents/Playbooks/Gemini.md @@ -10,8 +10,8 @@ Gemini wird genutzt für **Konzeptarbeit**: Varianten vergleichen, Argumente/Tra ## 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/`) +2. `docs/04_Agents/README.md` (Artefakt-Vertrag) +3. Je nach Thema: Architektur (`docs/01_Architecture/`), Backend (`docs/05_Backend/`), Frontend (`docs/06_Frontend/`), Infrastruktur (`docs/07_Infrastructure/`) ## Do * Immer 2–4 Optionen mit Vor-/Nachteilen liefern. diff --git a/docs/04_Agents/Playbooks/Junie.md b/docs/04_Agents/Playbooks/Junie.md index 525302c3..524ae939 100644 --- a/docs/04_Agents/Playbooks/Junie.md +++ b/docs/04_Agents/Playbooks/Junie.md @@ -10,8 +10,8 @@ Junie wird genutzt für **Repo-nahe Arbeit**: Code lesen, reale Pfade/Module fin ## 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` +2. Relevanter Bereich (z.B. `docs/01_Architecture/`, `docs/05_Backend/`, `docs/06_Frontend/`) +3. Bei Rollen/Prozessfragen: `docs/04_Agents/README.md` ## Do * Immer mit **konkreten Dateipfaden** arbeiten. diff --git a/docs/04_Agents/Playbooks/QASpecialist.md b/docs/04_Agents/Playbooks/QASpecialist.md index 302badc8..b051bb9d 100644 --- a/docs/04_Agents/Playbooks/QASpecialist.md +++ b/docs/04_Agents/Playbooks/QASpecialist.md @@ -29,3 +29,6 @@ Regeln: 4. Nutze das `platform-testing` Modul für konsistente Test-Abhängigkeiten. 5. **Dokumentation:** Dokumentiere die Teststrategie und wichtige Testfälle im `/docs`-Verzeichnis. ``` + +## Abschluss (Pflicht) +Am Ende der Session genau **ein** Artefakt gemäß `docs/04_Agents/README.md` erzeugen oder aktualisieren (ADR / Reference / How-to / Journal Entry). diff --git a/docs/04_Agents/Playbooks/RulebookExpert.md b/docs/04_Agents/Playbooks/RulebookExpert.md index 07beb8ad..e292822b 100644 --- a/docs/04_Agents/Playbooks/RulebookExpert.md +++ b/docs/04_Agents/Playbooks/RulebookExpert.md @@ -32,3 +32,6 @@ Regeln für deine Antworten: 4. **Logik vor Prosa:** Wenn du dem [Backend Developer] oder [Lead Architect] hilfst, formuliere die Regeln so um, dass sie leicht in Software-Validierungen (IF/THEN, Constraints) übersetzt werden können. 5. **Sparringspartner:** Hinterfrage Annahmen kritisch. Wenn ein vorgeschlagener Prozess gegen die ÖTO verstößt, lege sofort Veto ein. ``` + +## Abschluss (Pflicht) +Am Ende der Session genau **ein** Artefakt gemäß `docs/04_Agents/README.md` erzeugen oder aktualisieren (ADR / Reference / How-to / Journal Entry). diff --git a/docs/04_Agents/Playbooks/UIUXDesigner.md b/docs/04_Agents/Playbooks/UIUXDesigner.md index 8df91c5a..e52ffab3 100644 --- a/docs/04_Agents/Playbooks/UIUXDesigner.md +++ b/docs/04_Agents/Playbooks/UIUXDesigner.md @@ -1,7 +1,7 @@ --- type: Playbook status: ACTIVE -owner: Curator +owner: Lead Architect role: UI/UX Designer last_update: 2026-01-23 --- @@ -105,3 +105,8 @@ Column(Modifier.fillMaxSize()) { * **Mit Domain Expert:** Kläre, welche Daten *wirklich* wichtig sind (Prio 1) und welche ausgeblendet werden können (Details). * **Mit Frontend Expert:** Liefere keine abstrakten Ideen, sondern nutze das Vokabular von Jetpack Compose (`Row`, `Column`, `Surface`, `MaterialTheme`). + +--- + +## Abschluss (Pflicht) +Am Ende der Session genau **ein** Artefakt gemäß `docs/04_Agents/README.md` erzeugen oder aktualisieren (ADR / Reference / How-to / Journal Entry). diff --git a/docs/04_Agents/README.md b/docs/04_Agents/README.md index 1d23137a..ae69f0c3 100644 --- a/docs/04_Agents/README.md +++ b/docs/04_Agents/README.md @@ -34,6 +34,16 @@ Jede KI-Session endet mit **genau einem** Artefakt in `docs/`: ## Playbooks -* `Playbooks/Junie.md` -* `Playbooks/Gemini.md` -* `Playbooks/Curator.md` +| Playbook | Rolle | Typ | +|----------|-------|-----| +| `Playbooks/Architect.md` | 🏗️ Lead Architect | Strategie, Planung, Build-System | +| `Playbooks/BackendDeveloper.md` | 👷 Backend Developer | Spring Boot, Kotlin, DDD | +| `Playbooks/Curator.md` | 🧹 Curator | Dokumentation, Wissensmanagement | +| `Playbooks/DevOpsEngineer.md` | 🐧 DevOps Engineer | Docker, CI/CD, Infrastruktur | +| `Playbooks/DomainExpert.md` | 📋 Domain Expert | Fachlichkeit, Regelwerke, Gherkin | +| `Playbooks/FrontendExpert.md` | 🎨 Frontend Expert | KMP, Compose, Offline-First | +| `Playbooks/Gemini.md` | 🤖 Gemini (extern) | Konzeptarbeit, Optionen, ADR-Formulierung | +| `Playbooks/Junie.md` | 🤖 Junie (IDE) | Repo-nahe Arbeit, Code, Implementierung | +| `Playbooks/QASpecialist.md` | 🧐 QA Specialist | Teststrategie, Edge-Cases | +| `Playbooks/RulebookExpert.md` | 📜 ÖTO/FEI Rulebook Expert | Regelwerks-Compliance, Validierung | +| `Playbooks/UIUXDesigner.md` | 🖌️ UI/UX Designer | High-Density Design, Wireframes | diff --git a/docs/99_Journal/2026-03-25_Playbook_Audit.md b/docs/99_Journal/2026-03-25_Playbook_Audit.md new file mode 100644 index 00000000..53fc2c56 --- /dev/null +++ b/docs/99_Journal/2026-03-25_Playbook_Audit.md @@ -0,0 +1,42 @@ +--- +type: Journal +status: ACTIVE +owner: Lead Architect +last_update: 2026-03-25 +--- +# Journal: Playbook Audit & Fixes + +## Session-Ziel +Vollständige Analyse aller Agent-Playbooks auf Konsistenz, Korrektheit und Vollständigkeit. + +## Befunde + +### 🔴 Kritisch (behoben) +- **`Gemini.md` & `Junie.md`:** Falsche Pfade in der Startpunkt-Sektion. + - `docs/03_Agents/` → korrigiert zu `docs/04_Agents/` + - `docs/04_Backend/` → korrigiert zu `docs/05_Backend/` + - `docs/05_Frontend/` → korrigiert zu `docs/06_Frontend/` + - `docs/06_Infrastructure/` → korrigiert zu `docs/07_Infrastructure/` + +### ⚠️ Mittel (behoben) +- **`Curator.md`:** Fehlender Frontmatter-Header — ergänzt (`type`, `status`, `owner`, `last_update`). +- **`04_Agents/README.md`:** Nur 3 von 11 Playbooks aufgelistet — vollständige Tabelle ergänzt. + +### ℹ️ Nachträglich behoben (Session 2) +- **Alle Playbooks:** `## Abschluss (Pflicht)`-Abschnitt mit Curator-Hinweis ergänzt. +- **`UIUXDesigner.md`:** `owner: Curator` → `owner: Lead Architect` korrigiert. +- **`Architect.md`:** Expliziter `Don't`-Block zur Rollenabgrenzung ergänzt. + +## Geänderte Dateien +- `docs/04_Agents/Playbooks/Gemini.md` +- `docs/04_Agents/Playbooks/Junie.md` +- `docs/04_Agents/Playbooks/Curator.md` +- `docs/04_Agents/README.md` +- `docs/04_Agents/Playbooks/Architect.md` +- `docs/04_Agents/Playbooks/BackendDeveloper.md` +- `docs/04_Agents/Playbooks/DevOpsEngineer.md` +- `docs/04_Agents/Playbooks/DomainExpert.md` +- `docs/04_Agents/Playbooks/FrontendExpert.md` +- `docs/04_Agents/Playbooks/QASpecialist.md` +- `docs/04_Agents/Playbooks/RulebookExpert.md` +- `docs/04_Agents/Playbooks/UIUXDesigner.md`