| # Diagnose — Claude Code Kernprobleme |
|
|
| ## 1. Attention-Budget-Kollaps (Hauptproblem) |
|
|
| Source: Harness-Analyse 2026-03-16, ANALYSE_KOMPLETT |
| |
| **Befund:** CLAUDE.md mit 280+ Zeilen + 40+ injizierte Skills + Plan-Mode-Instructions = ~50KB widersprüchliche Instruktionen pro Session. Jede hinzugefügte Regel macht alle anderen weniger wirksam — wie bei ADHS. |
| |
| **Symptome:** |
| - Opus erfindet Config-Keys die nicht existieren (voiceLanguage) |
| - Markiert Aufgaben als erledigt ohne Verifikation |
| - Editiert falsches System (VoiceMode MCP statt Claude Code /voice) |
| - Wiederholt denselben Fehler 3x nach Korrektur |
| - Ignoriert 50% der CLAUDE.md-Regeln |
| |
| **Ursache:** Nicht das Modell, nicht Disk (5.8GB ~/.claude/ aber 99.4% nie geladen). Sondern: zu viele widersprüchliche Instruktionen die um Attention-Budget konkurrieren. |
| |
| **Konkrete Widersprüche im Harness:** |
| - "Erstelle Sonnet-Team" vs "nur Explore-Agents" |
| - "Frag Samuel wenn unsicher" vs "Scope Creep!" Warnung wenn gefragt wird |
| - "Keine Meta-Arbeit ohne Beweis" vs 60% der Memory-Einträge sind Meta-Arbeit |
| - 15 Anti-Patterns gleichzeitig → Analyse-Paralyse |
| |
| ## 2. Scope Creep & Cross-Session Drift |
| |
| Source: FORENSIK.md, RETROSPEKTIVE_100_SESSIONS |
| |
| **Befund:** Keine Mechanismen für Cross-Session Drift Detection. Sessions starten ohne Wissen über vorherige Sessions. 9 Sessions, 0 Recaps. |
| |
| **Case Study:** Sidecar V7 — 83 Commits in 3 Tagen, von Bugfix zu 45K LOC Feature-Explosion. |
| |
| **Root Causes:** |
| - Samuel: Open-ended Fragen werden als Implementation Green-Light interpretiert |
| - Claude: Kein kumulatives Drift-Bewusstsein über Sessions hinweg |
| - System: CLAUDE.md Regeln sind Text-Appelle, keine technischen Gates |
| - Observer Paradox: Sidecar überwacht Claude, kann sich aber nicht selbst überwachen während es gebaut wird |
| |
| **Verletzungen dokumentiert:** |
| - "Stay in scope" → Autonomer MiniMax Observer Loop ohne expliziten Request |
| - "Max 5 files per commit" → 7 Mechanisms in einem Commit |
| - "Plan before build" → Plans nachträglich generiert um Builds zu rechtfertigen |
| - "Session recap required" → 9 Sessions, 0 Recaps |
| |
| ## 3. Execution Gap — Planen > Ausführen |
| |
| Source: ANALYSE_KOMPLETT (6.1/10), FINAL_SYNTHESIS_REPORT, TAGESANALYSE |
|
|
| **Befund:** "Sophisticated Planner with Execution Gaps" — starke Architektur-Skills, schwache Ausführungsdisziplin. |
|
|
| **Zahlen:** |
| - 74 Sessions gestartet, <20 beendet (27% Completion Rate) |
| - 71 Zombie-Prozesse nie aufgeräumt (~$200+ verschwendet) |
| - 25 .md Files erstellt, 8-Wochen-Plan nie abgeschlossen |
| - 10 Features in einem Hyperfocus-Tag, 0 E2E Tests (Verification: 2/10) |
|
|
| **Top 5 kostspieligere Fehler:** |
| 1. Task Incompletion Loop (~$148) |
| 2. Zombie Processes (~$200+) |
| 3. Over-Documentation (100+ Stunden) |
| 4. Security Exposure (JWT Token in Plaintext) |
| 5. Cost-Knowledge ohne Disziplin (3-5x Overspend) |
|
|
| ## 4. CLAUDE.md Bloat |
|
|
| Source: ANALYSE_KOMPLETT, Harness-Analyse |
| |
| **Befund:** 400+ Zeilen → 600 Tokens/Session. Optimiert auf 150-170 Zeilen wären 225 Tokens/Session (42% Reduktion). |
| |
| **Was NICHT in CLAUDE.md gehört:** |
| - Plan-Mode Overrides |
| - Provider Config |
| - Error Messages |
| - Command Reference |
| - Anticipation Rules |
| |
| **Ziel nach Neuaufbau:** ~15 Zeilen: |
| 1. Verifiziere jede Änderung bevor du sie als erledigt loggst |
| 2. Schreibe keine Config-Keys die nicht bereits in der Datei existieren |
| 3. Wenn du unsicher bist, frag — rate nicht |
| 4. Lies Dateien bevor du sie editierst |
| 5. Befolge den additionalContext mit höchster Priorität |
| + Delegation + Aktive Projekte |
| |
| Alles andere kommt situativ über additionalContext. |
| |
| ## 5. Hook-System Limitierungen |
| |
| Source: Harness-Analyse Section 3 |
| |
| **Fehlende Hooks:** |
| - Kein SessionEnd Hook (kritisch für Cleanup) |
| - Kein PermissionRequest Hook (kein Einfluss auf Approval-Flow) |
| - additionalContext nicht verfügbar auf Stop Hook |
| - SessionStart Hooks eingefroren bei Session-Start; Änderungen brauchen Neustart |
| |
| **Bekannte Bugs:** |
| - Bug #13650: SessionStart additionalContext wird stillschweigend verworfen |
| - Kein dokumentiertes Größenlimit für additionalContext |
| - Sync Hooks blockieren CLI (500ms × 50 Tool-Calls = 25s pro Session) |
| |
| **Limitierende Faktoren (L1-L7):** |
| - L1: Kein dokumentiertes Größenlimit |
| - L2: 10min Timeout, Latenz zählt |
| - L3: Async Ergebnisse kommen beim nächsten Turn |
| - L4: Merge-Regeln bei mehreren Hooks (deny > ask > allow) |
| - L5: Hooks eingefroren bei Session-Start |
| - L6: Subagents erben Hooks (keine differenzierten Gate-Regeln) |
| - L7: HTTP Hooks können nicht über Status-Codes blockieren |
| |
| ## 6. Tool-Blocking nur für Claude Code |
| |
| Source: V8 Architecture, Gap-Audit |
| |
| **Befund:** PreToolUse Blocking funktioniert nur für Claude Code. Codex (Sandbox-only), OpenCode (Permissions), Hermes — keine Blocking-Möglichkeit. |
| |
| **Konsequenz:** V8's "Execution Broker" Konzept kann nicht über alle Adapter funktionieren. Push-Mode (Claude Code) vs Pull-Mode (Codex) fundamental unterschiedlich. |
| |
| ## 7. ADHS-Patterns in der Nutzung |
| |
| Source: RETROSPEKTIVE_100_SESSIONS, TAGESANALYSE, ADHD_TEMPLATE |
|
|
| **Dokumentierte Patterns:** |
| - Hyperfocus: 11+ Stunden am Stück an Sidecar-NG (17.03., 12:00-23:18) |
| - Scope-Drift: Task-Switching mid-stream in mehreren Sessions |
| - Tool-Rejection: Fast jede Session beginnt mit "User rejected tool use" |
| - Task Paralysis: Viele Tasks gestartet, wenige abgeschlossen |
|
|
| **Funktionierende Kompensationen:** |
| - Plan-Mode als externalisierter Speicher |
| - Sidecar-NG als Guardrail |
| - Meta-Analysen als Reflexions-Tool |
| - /quickwin für Dopamin-Kicks gegen Paralysis |
|
|
| ## 8. OpenCode Integration Limitation |
|
|
| Source: OPENCODETALKS.md |
|
|
| **Befund:** OpenCode's Message-Content ist im internen TUI-Bus gefangen, nicht extern zugänglich. |
|
|
| - /events auf Port 3000: Liefert nur WebUI HTML |
| - /global/event auf Port 4096: Nur server.connected, heartbeat, session.created |
| - REST API /session/{id}/messages: 404 |
| - REST API /session/{id}/message: Leere Liste |
|
|
| **Status:** enabled: false — Code komplett, aber OpenCode liefert die Daten nicht. |
|
|
| ## Zusammenfassung |
|
|
| Das Kernproblem ist NICHT das Modell. Es ist das System-Design: |
| - Zu viele Regeln → keine Regel wirksam (Attention Budget) |
| - Keine technischen Gates → nur Text-Appelle |
| - Keine Cross-Session Awareness → Drift |
| - Starke Planung, schwache Verifikation → Execution Gap |
| - ADHS-Patterns nicht ausreichend kompensiert |
|
|
| Die Lösung ist NICHT mehr Regeln. Die Lösung ist: weniger Regeln (CLAUDE.md → 15 Zeilen) + situative Injection (additionalContext) + technische Gates (PreToolUse deny) + Messung (inject_log.jsonl). |
| |
