Audit and enhance playbook documentation: fix path inconsistencies, add missing "Abschluss" sections, standardize "Curator" frontmatter, and update Agent roles in README

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).

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).

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

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).

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).

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).

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.

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.

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).

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).

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).

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 |

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`