Schleifengedächtnis
Reflexion-ähnliches verbales Gedächtnis: Der Agent reflektiert schriftlich über jeden Versuch, speichert die Reflexion und liest vor dem Handeln aktuelle Reflexionen. Forschung (Shinn et al., 2023) zeigt, dass dieser Mechanismus — Reflektieren, Speichern, Erneutes Lesen — blinde Wiederholungen mit großen Margen übertrifft (+22% bei Entscheidungsaufgaben über 12 Testdurchläufe, +11% bei Code) und Gedächtnis ohne Reflexion um 8 Punkte übertrifft. Der Gewinn resultiert aus geschriebenen Gründen, nicht aus härterem Wiederholen.
Das Protokoll
Vor dem Handeln (jede Aufgabe)
- Lies
.loop/LESSONS.md. - Wende den Abschnitt Standing rules (dauerhafte Regeln) bedingungslos an.
- Lies die 3 neuesten Einträge. Wenn einer für die aktuelle Aufgabe relevant ist, gib in einer Zeile an, wie er deine Vorgehensweise ändert. Wenn keiner relevant ist, fahre fort — erzwinge nichts.
Nach dem Handeln (jeder Versuch, bestanden oder fehlgeschlagen)
Füge genau einen Eintrag im Format der Datei hinzu:
## [Datum] — [Aufgabe, max. 5 Wörter] — BESTANDEN|FEHLGESCHLAGEN
- Was passiert ist: [eine Zeile]
- Grundursache / warum es funktioniert hat: [eine Zeile]
- Nächstes Mal: [eine spezifische, überprüfbare Anweisung]
Qualitätsmaßstab für „Nächstes Mal“:
- ❌ „Sei vorsichtiger mit der Datenbank“ — nicht überprüfbar
- ✅ „Führe
npx prisma migrate deployvor jedem Seed-Skript aus“ — überprüfbar - ❌ „Denke daran, dass die API knifflig ist“ — vage
- ✅ „Der /users-Endpunkt paginiert bei 50; übergib immer ?page= beim Zählen“
Fehlerreflexion, speziell
Wenn ein Versuch fehlgeschlagen ist, muss die Reflexion beantworten: Was habe ich fälschlicherweise angenommen, das falsch war? Fehlgeschlagene Versuche entstehen meist aus einer falschen Annahme, nicht aus einem Tippfehler. Benenne die Annahme. Das ist die Lektion.
Wartung (wenn die Datei ~30 Einträge überschreitet)
- Lies alle Einträge vom ältesten zum neuesten.
- Jede Lektion, die 2+ Mal vorkommt, wird in die Standing rules (dauerhafte Regeln) aufgenommen, umgeschrieben als eine einzige imperative Zeile.
- Lösche die ältesten 20 Einträge nach der Übernahme.
- Lösche niemals dauerhafte Regeln ohne Zustimmung des Benutzers.
Was NICHT gespeichert werden soll
- Geheimnisse, Schlüssel, Token, persönliche Daten — niemals, selbst wenn sie den Fehler verursacht haben.
- Erzählungen („Ich habe dann X versucht, woraufhin Y …“) — speichere nur Schlussfolgerungen.
- Doppelte Lektionen — wenn sie bereits vorhanden sind, füge sie nicht erneut hinzu; erwäge stattdessen ihre Übernahme in die dauerhaften Regeln.
- Schuldzuweisungen oder Selbstkritik — Lektionen sind Anweisungen, keine Gefühle.
Zu vermeidende Fehlermodi
- Gedächtnistheater: Einträge schreiben, aber nie lesen. Der Leseschritt ist der Wert; der Schreitschritt allein ist ein Tagebuch.
- Überanpassung an einen einzelnen Vorfall: Ein einmaliger Umgebungshänger ist keine Lektion. Wenn es nicht wiederkehren kann, zeichne es nicht auf.
- Unbegrenztes Wachstum: Eine Datei mit 200 Einträgen, die niemand liest, ist totes Gedächtnis. Komprimiere sie.