self-improving-agent

Self-Improving Agent

Ein autonomer Improvement-Loop fuer Claude Code Projekte. Der Agent zerlegt Ziele in Teilaufgaben, arbeitet sie sequentiell ab, analysiert seine eigenen Session-Logs und generiert Verbesserungsvorschlaege fuer die Projekt-Instruktionen (CLAUDE.md).

Warum

Claude Code Agenten machen wiederholt die gleichen Fehler — besonders ueber Session-Grenzen hinweg, wo der Context verloren geht. Dieses Projekt schliesst die Feedback-Schleife: Fehler werden systematisch erfasst, aggregiert und in konkrete Instruktions-Aenderungen uebersetzt.

Kernprinzipien:

• Der Agent verbessert nicht sich selbst direkt, sondern generiert Vorschlaege die ein Mensch reviewed. CLAUDE.md wird nie automatisch geaendert.
• Arbeit wird an spezialisierte Subagenten delegiert (Planner/Worker/Judge-Pattern), nicht von einem einzelnen Agent inline erledigt.

Architektur

Subagenten-Modell (Planner / Worker / Judge)

┌──────────────────────────────────────────────────────────────┐
│                    PLANNER-AGENT                              │
│           (orchestrator-prompt.md, claude -p)                 │
│                                                               │
│   Phase 1: Kontext laden (session-bootstrap)                  │
│   Phase 2: Naechsten Task waehlen (task-decomposer)           │
│   Phase 3: Worker spawnen ──────────────────┐                 │
│   Phase 4: Judge spawnen ──────────────┐    │                 │
│   Phase 5: Entscheidung + Kontext      │    │                 │
│   Phase 6: Improvement-Zyklus          │    │                 │
│   Phase 7: Lauf beenden                │    │                 │
└────────────────────────────────────────┼────┼─────────────────┘
                                         │    │
                    ┌────────────────────┘    │
                    │                         │
                    ▼                         ▼
          ┌──────────────────┐      ┌──────────────────┐
          │   JUDGE-AGENT    │      │   WORKER-AGENT   │
          │   (claude -p)    │      │   (claude -p)    │
          │                  │      │                  │
          │ Frischer Context │      │ Frischer Context │
          │ Kennt nur Task-  │      │ Fuehrt Task aus  │
          │ Kriterien, nicht │      │ mit zugewiesenen │
          │ den Arbeitsweg   │      │ Skills (tdd,     │
          │                  │      │ code-reviewer..) │
          │ Urteil:          │      │                  │
          │ pass/partial/fail│      │ Output: Code,    │
          │                  │      │ Tests, Commits   │
          └────────┬─────────┘      └────────┬─────────┘
                   │                         │
                   ▼                         ▼
          .agent-memory/             tasks.json (notes)
          judgments/                  .agent-memory/
          judgment_T003.json         iteration logs

                    Im Improvement-Zyklus (Phase 6):

          ┌──────────────────────────────────────────┐
          │         PARALLELE MINING-AGENTEN          │
          │           (je 1 pro Log-Datei)            │
          │                                           │
          │  ┌────────┐ ┌────────┐ ┌────────┐       │
          │  │Agent 1 │ │Agent 2 │ │Agent N │       │
          │  │Log A   │ │Log B   │ │Log N   │       │
          │  │claude-p│ │claude-p│ │claude-p│       │
          │  └───┬────┘ └───┬────┘ └───┬────┘       │
          │      │          │          │              │
          │      ▼          ▼          ▼              │
          │   partials/  partials/  partials/          │
          │   a.jsonl    b.jsonl    n.jsonl            │
          └──────────────────┬───────────────────────┘
                             │ Merge
                             ▼
                    log-analysis/latest.json

Datenfluss

JSONL Logs ──► Mining-Agenten (parallel) ──► log-analysis/latest.json
errors.json ──► pattern-extractor ──► patterns.json
log-analysis + patterns + CLAUDE.md ──► claude-md-optimizer ──► CLAUDE_IMPROVEMENTS.md
CLAUDE_IMPROVEMENTS.md ──► (Human Review) ──► CLAUDE.md

Worker ──► Code-Aenderungen ──► Judge ──► Verdict ──► Planner-Entscheidung

Kommunikation zwischen Agenten

Alle Agenten kommunizieren ausschliesslich ueber das Dateisystem:

Von → Nach	Medium	Datei
Planner → Worker	Task-Beschreibung	tasks.json + Prompt-Parameter
Worker → Planner	Ergebnis	tasks.json (notes), .agent-memory/
Planner → Judge	Bewertungsauftrag	Task-ID als Prompt-Parameter
Judge → Planner	Urteil	.agent-memory/judgments/{task_id}.json
Mining-Agents → Planner	Partial Results	.agent-memory/log-analysis/partials/*.jsonl

Persistenz (.agent-memory/)