---
name: self-annealing
description: >
  Systematischer Self-Improvement Loop: Fehler erkennen → Fix → Pattern extrahieren →
  Wissen speichern → Schutz aktivieren. System wird mit jedem Fehler stärker.
  Trigger bei: Fehler, Bug, Workaround, "das ging schief", "funktioniert nicht",
  "self-anneal", "fix and learn", "Pattern speichern", "wiederkehrender Fehler".
---

# Self-Annealing Loop — Fehler → Permanente Verbesserung

## Konzept
Wie Metall durch Erhitzen und kontrolliertes Abkühlen härter wird, härtet dieser Loop
das System durch jeden Fehler-Zyklus. Gleicher Fehler passiert nie zweimal.

## Der Loop (5 Schritte)

### Schritt 1: Fehler erkennen
Sofort loggen:
```
WAS: [Beschreibung]
WANN: [Task/Funktion]
WARUM (Root Cause): [Eigentliche Ursache, NICHT Symptom]
Kontext: [Dateien, Config, Inputs]
```

### Schritt 2: Fix implementieren
- **Minimal-invasiv**: Kleinste nötige Änderung
- **Verifizieren**: Fix explizit testen
- **Kein Over-Engineering**: Kein Refactoring wegen Einzelfehler

### Schritt 3: Pattern extrahieren
```
WENN [Situation/Trigger]
DANN [Korrekte Aktion]
WEIL [Begründung / Root Cause]
```

| Fehlertyp | Ziel-Datei | Aktion |
|-----------|-----------|--------|
| Konfiguration | directives/ | Directive updaten |
| Code/Script | execution/ | Fix + Kommentar |
| Workflow | SOP in directives/ | Schritt präzisieren |
| Annahme falsch | CLAUDE.md | Korrekte Fakten eintragen |

### Schritt 4: Wissen speichern (3-fach!)
1. **Obsidian** → `02_Knowledge/ai-dev/TechPatterns.md` (sofort)
2. **Antigravity KB** → `ag-learn --topic "pattern-name"` (cross-IDE)
3. **pgvector** → `knowledge_pipeline.py` (permanent, durchsuchbar)

### Schritt 5: Schutz aktivieren
- Bekanntes Fehlermuster in CLAUDE.md oder Skill-Datei eintragen
- Bei ähnlicher Aktion: Warnung ausgeben
- Checkliste in relevanter Directive erweitern

## Wann anwenden (PFLICHT)
- Unerwarteter Fehler bei Task-Ausführung
- Manueller Workaround nötig
- User-Feedback auf wiederkehrendes Problem
- Widerspruch zwischen Konfigurationsdateien

## NICHT anwenden
- Triviale Tippfehler
- Externe Ausfälle (NAS down, API timeout)
- Experimenteller/temporärer Code

## Metriken (pro Session)
| Metrik | Ziel |
|--------|------|
| Annealing-Zyklen | Transparent tracken |
| Wiederholungsrate | 0% (gleicher Fehler = Root Cause nicht gefixt) |
| Pattern-Extraktion | Innerhalb gleicher Session |
| Hook-Abdeckung | >80% der Patterns mit Schutz |

## MPE-Beispiel
```
Fehler:   Kaltakquise-Email behauptete 8,4s Ladezeit — Website war nur Platzhalter
Root:     B0-Regel verletzt, keine Verifikation vor Pitch
Pattern:  WENN Datenpunkt für Lead → DANN Tool-Output prüfen → WEIL Halluzination teuer
Fix:      browse-audit Skill mit Doppel-Check Pflicht
Schutz:   B0-Regel in CLAUDE.md + council-skill für Gegenprüfung
```