docs: enhance local dev docs, update Docker Compose, and archive old journals

Added Mailpit setup and updated Keycloak configuration in local development runbooks. Improved Docker Compose stability with updated service dependencies and configurations. Archived outdated journal entries and documents for better organization.
2026-01-20 14:00:09 +01:00
parent 5dc8f18201
commit 46361185d0
56 changed files with 596 additions and 1832 deletions
@@ -1,44 +1,10 @@
-# Journal: Ideen zur Verbesserung der Agenten-Zusammenarbeit
+---
+type: Journal
+status: ARCHIVED
+owner: Curator
+last_update: 2026-01-20
+---

-**Datum:** 15.01.2026
-**Autor:** Documentation & Knowledge Curator
-**Kontext:** Analyse des Status Quo der Agenten-Playbooks und Prozessoptimierung.
+# Collaboration Ideas (15.01.2026)

-## 1. Status Quo Analyse
-
-Die aktuelle Struktur mit spezialisierten Agenten-Playbooks (`docs/04_Agents/Playbooks/`) und einer zentralen Dokumentation (`docs/`) ist sehr solide.
- **Stärken:** Klare Verantwortlichkeiten, "Docs-as-Code" als Fundament, Unterscheidung zwischen Konzept (Gemini) und Umsetzung (Junie).
- **Potenzial:** Die Schnittstellen zwischen den Agenten (Handover) sind implizit definiert, könnten aber formalisiert werden, um Reibungsverluste zu minimieren.
-
-## 2. Vorschläge zur Verbesserung
-
-### A. Formalisierte Handover-Artefakte
-Statt nur Text zu übergeben, sollten Agenten strukturierte Formate nutzen, die vom nächsten Agenten direkt weiterverarbeitet werden können.
-
-*   **Domain Expert -> Backend/QA:**
-    *   Statt Prosa: Nutzung von **Gherkin** (Given/When/Then) für Akzeptanzkriterien.
-    *   Vorteil: QA kann dies direkt in Tests überführen, Backend Dev versteht die Edge-Cases.
-    *   *Beispiel:* `docs/03_Domain/UseCases/UC001_Nennung.feature`
-
-*   **Architect -> Devs:**
-    *   Statt nur ADR-Text: Bereitstellung von **PlantUML/Mermaid** Diagrammen, die ins Repo eingecheckt werden.
-    *   Vorteil: Visualisierung ist direkt in der Doku eingebunden und versioniert.
-
-### B. Cross-Agent Review Checklisten
-Jedes Playbook könnte eine kurze "Pre-Flight Checklist" erhalten, bevor ein Task als "Done" markiert wird.
-
-*   *Backend Dev:* "Habe ich die API-Änderungen mit dem Frontend-Expert (bzw. dessen Doku) abgeglichen?"
-*   *Architect:* "Habe ich das ADR vom Domain Expert auf fachliche Korrektheit prüfen lassen?"
-
-### C. "Session Context" Header
-Um den Kontext für die KI-Modelle (Junie/Gemini) schneller herzustellen, könnte ein standardisierter Header für Prompts etabliert werden, der auf die relevanten Doku-Pfade verweist.
-
-*   *Idee:* Ein kleines "Context-File" oder ein Abschnitt im Journal, der sagt: "Wir arbeiten gerade an Feature X, relevante Doku ist A, B und C."
-
-### D. Explizite "Shift-Left" QA
-Der **QA Specialist** wird oft erst am Ende aktiv. Er sollte explizit aufgefordert werden, schon während der **Domain-Analyse** Fragen zu stellen ("Wie testen wir das?", "Brauchen wir Testdaten dafür?").
-
-## 3. Nächste Schritte
-1.  Diskussion dieser Vorschläge mit dem Lead Architect (User).
-2.  Bei Zustimmung: Ergänzung der Playbooks um die spezifischen Handover-Formate und Checklisten.
-3.  Pilotierung des "Gherkin-Handovers" bei der nächsten fachlichen Anforderung.
+**MOVED:** This file has been archived to `_archive/2026-01-15_Agent_Collaboration_Ideas.md`.