From f640b18f47f0966073b988f2607845efb3dafb64 Mon Sep 17 00:00:00 2001
From: Eddy <eddy@alles-watt-laeuft.de>
Date: Tue, 14 Apr 2026 12:20:18 +0200
Subject: [PATCH] =?UTF-8?q?Phase=2011:=20Multi-Agent-Architektur=20f=C3=BC?=
 =?UTF-8?q?r=20Context-Einsparung?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Orchestrator + spezialisierte Sub-Agents statt einem Main-Agent:
- Orchestrator: Plant, delegiert, entscheidet (kleiner Context)
- Research Agent: Durchsucht Code, gibt Zusammenfassung
- Implement Agent: Schreibt Code nach Spec
- Test Agent: Führt Tests aus, berichtet Ergebnisse
- Review Agent: Prüft Code-Qualität

Vorteile:
- Main Context bleibt klein (~10k statt 200k)
- Compacting selten nötig
- Parallele Arbeit möglich
- Spezialisierung = bessere Ergebnisse

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 ROADMAP.md | 74 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 73 insertions(+), 1 deletion(-)

diff --git a/ROADMAP.md b/ROADMAP.md
index db6f470..e67e2a5 100644
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -404,7 +404,79 @@ Gross — eigenes Teilprojekt, 2-3 Wochen
 
 ---
 
-## Phase 11: Hook-System für Automatisierung
+## Phase 11: Multi-Agent-Architektur (Context-Einsparung)
+
+### Das Konzept
+
+Statt einem Main-Agent der alles macht und ständig compactet:
+**Orchestrator + spezialisierte Sub-Agents**
+
+```
+ORCHESTRATOR (10k Token, selten Compacting)
+     ↓ delegiert
+┌────┴────┬────────┬────────┐
+│Research │Implement│ Test  │ (je 40k Token, wird verworfen)
+└─────────┴────────┴────────┘
+```
+
+### Vorteile
+
+| Aspekt | Ein Agent | Multi-Agent |
+|--------|-----------|-------------|
+| Context Main | 200k (voll) | 10k (klein) |
+| Compacting | Ständig | Selten |
+| Wissen verloren | Viel | Wenig |
+| Parallelität | Nein | Ja |
+
+### Agent-Typen
+
+| Agent | Aufgabe | Gibt zurück |
+|-------|---------|-------------|
+| **Orchestrator** | Plant, delegiert, entscheidet | - |
+| **Research** | Durchsucht Code, liest Docs | Zusammenfassung (500 Token) |
+| **Implement** | Schreibt Code nach Spec | "3 Dateien geändert" |
+| **Test** | Führt Tests aus | "2 Tests failed, weil..." |
+| **Review** | Prüft Code-Qualität | "3 Issues gefunden" |
+
+### Aufgaben
+
+- [ ] **scripts/claude-bridge.js**
+  - [ ] `spawnSubAgent(type, task, maxTokens)` Funktion
+  - [ ] `summarizeResult(result, maxTokens)` — Ergebnis komprimieren
+  - [ ] Orchestrator-Modus: Main Agent delegiert automatisch
+
+- [ ] **Orchestrator-Prompt**
+  ```
+  Du bist ein ORCHESTRATOR. Du machst NICHT selbst die Arbeit.
+  Für jede Aufgabe:
+  1. Analysiere was nötig ist
+  2. Delegiere an passenden Sub-Agent
+  3. Warte auf ZUSAMMENFASSUNG (nicht rohe Daten)
+  4. Entscheide nächsten Schritt
+
+  Sub-Agents: Research, Implement, Test, Review
+  ```
+
+- [ ] **Sub-Agent-Prompts**
+  - [ ] Research: "Fasse Ergebnisse in max 500 Token zusammen"
+  - [ ] Implement: "Berichte nur: welche Dateien, was geändert"
+  - [ ] Test: "Berichte nur: passed/failed, Fehlerursache"
+
+- [ ] **UI: Agent-Delegation anzeigen**
+  - [ ] AgentView zeigt: Orchestrator → Sub-Agent Delegation
+  - [ ] Ergebnis-Zusammenfassung sichtbar
+
+### Verifikation
+```bash
+# Große Aufgabe starten
+# Prüfen: Main Agent delegiert statt selbst zu arbeiten
+# Prüfen: Sub-Agent Ergebnisse sind komprimiert
+# Prüfen: Main Agent Context bleibt klein
+```
+
+---
+
+## Phase 12: Hook-System für Automatisierung
 
 ### Konzept