Keine Zeit gerade? Schick dir den Artikel ins Postfach.
Du bekommst den Guide als PDF, damit du später in Ruhe weiterliest. Zusätzlich bekommst du kostenlos regelmäßig wertvolle KI-Tipps zugeschickt. Jederzeit mit einem Klick abbestellbar.
Das lernst du
Starte hier
Lass Claude das mit dir einrichten
Tippe auf den Button und kopiere eine Nachricht für Claude. Füge sie in Claude ein, dann geht Claude jeden Schritt mit dir durch, einen nach dem anderen.
Kurzanleitung in drei Schritten: 1. Kopieren 2. Claude öffnen 3. Einfügen und senden
Du korrigierst Claude in einer Sitzung: „Nimm die Rubrik aus der Datei, nicht deine eigene.“ Claude bedankt sich, macht es richtig, und zwei Tage später passiert in einer neuen Sitzung genau derselbe Fehler. So fühlt es sich an, als würde Claude mit der Zeit schlechter. Meist stand die Korrektur aber nur im Chat, und der Chat ist beim nächsten Start weg.
Dazu kommt, dass sich das Modell selbst ändert, ohne dass du es merkst. Forscher aus Stanford und Berkeley haben zwei Versionen von GPT-4 aus März und Juni 2023 mit denselben Aufgaben getestet. Bei der Frage, ob eine Zahl prim ist, fiel die Trefferquote von 84,0 auf 51,1 Prozent (arXiv:2307.09009). Das ist eine Aufgabe in einer Studie und kein Beleg dafür, dass jedes Modell schlechter wird. Es zeigt aber, worauf du dich nicht verlassen kannst: dass das Modell von selbst bei dem bleibt, was gestern funktioniert hat. Verlassen kannst du dich auf Dateien, die du selbst kontrollierst.
Die stammt aus der ersten Fassung derselben Studie. Dort bestand der Test nur aus Primzahlen, und das Modell hatte von „fast immer prim“ auf „fast immer nicht prim“ gewechselt. Die Autoren haben den Test danach mit 500 Primzahlen und 500 anderen Zahlen wiederholt. Daraus kommen die 84,0 und 51,1 Prozent.
Der Reflexion-Skill setzt genau dort an. Er ist kostenlos, Open Source unter MIT-Lizenz und für Deutsch geschrieben.
Was du baust
Du tippst /reflexion oder schreibst „Was haben wir gelernt?“. Claude beantwortet vier Fragen zur Aufgabe, die gerade zu Ende ging, und zieht null bis drei Lektionen heraus, die man prüfen kann.
Für jede Lektion, die sich sonst wiederholt, nennt Claude die Datei, die beim nächsten Mal geladen wird, und den wörtlichen Text der Änderung. Geschrieben wird erst nach deinem Ja.
Jede Lektion landet in LESSONS.md, mit oder ohne Fix. Vorher prüft ein kleines Python-Programm, ob es dieselbe Lektion in anderen Worten schon gibt.
Am besten wirkt der Skill in Claude Code, weil Claude dort deine Projektdateien wie CLAUDE.md und LESSONS.md direkt ändern kann und sie beim nächsten Start wieder liest. Der Skill ist kostenlos, du brauchst keinen API-Schlüssel und kein zusätzliches Konto. Wie es in Claude im Browser geht, steht weiter unten.
Installation
In Claude Code installierst du den Skill als Plugin. Öffne Claude Code im Terminal und gib nacheinander ein:
/plugin marketplace add Ultra-Smashed/reflexion-skill
/plugin install reflexion-skill@reflexion-skill
Als Plugin heißt der Befehl danach /reflexion-skill:reflexion. Willst du den kurzen Befehl /reflexion, kopierst du den Ordner direkt in deine persönlichen Skills:
git clone https://github.com/Ultra-Smashed/reflexion-skill.git
cp -r reflexion-skill/skills/reflexion ~/.claude/skills/
Ohne Terminal geht es auch: Füg diesen Text in Claude Code oder in einen Claude-Chat ein, und Claude installiert den Skill selbst.
https://github.com/Ultra-Smashed/reflexion-skill installiere den Skill
Das Werkzeug im Skill braucht Python 3.8 oder neuer und keine weiteren Pakete. Auf einem Mac ist das meist schon da, in Claudes Umgebung im Browser ebenfalls.
Mit einem bezahlten Plan und eingeschalteter Codeausführung läuft der Skill auch dort. Die vier Fragen und die Lektionen funktionieren genauso. Claude kann aber keine Dateien auf deinem Rechner ändern, und LESSONS.md liegt nur in der Umgebung dieses einen Chats. Lade die Datei am Ende herunter und leg sie in die Projektdateien deines Claude-Projekts. Fixes trägst du dann selbst in die Projektanweisungen ein.
Nachbesprechung zum Mitnehmen
Hol dir den vollständigen Guide als PDF.
Die komplette Anleitung als PDF — inkl. Installation, der vier Fragen, eines Fix-Plans, der Logbuch-Befehle und Checkliste. Damit du sie nicht noch einmal suchen musst.
Die vier Fragen
Die US Army stellt nach jeder Übung dieselben vier Fragen, in derselben Reihenfolge. Der Skill übernimmt sie für eine Sitzung mit Claude. Claude beantwortet sie aus eigener Sicht, also für das, was es selbst getan hat, und nicht mit Vermutungen über dich.
Auftrag, Plan und erwartetes Ergebnis, schlicht benannt.
Das echte Ergebnis, mit halben Lösungen, stillen Fehlschlägen, Umwegen und den Stellen, an denen du korrigieren musstest.
Der Mechanismus, kein Gefühl. „Der Changelog war noch nicht committet, und git tag nimmt den letzten Commit“ ist eine Ursache. „Ich war nicht gründlich genug“ ist keine. Kennt Claude die Ursache nicht, schreibt es „unbekannt“.
Die Regel, die die Lücke verhindert hätte, und das Vorgehen, das funktioniert hat und bleiben soll.
Lief alles nach Plan, ist das eine gültige Antwort. Dann hält die vierte Frage fest, warum es geklappt hat. Du kannst den Skill also auch nach einer guten Sitzung aufrufen, damit ein Vorgehen, das noch nicht selbstverständlich ist, beim nächsten Mal wieder so läuft.
Ein Beispiel
So sieht eine Antwort aus. Der Fall stammt aus der README des Repos: Claude sollte ein Release taggen, und der Tag zeigte auf den falschen Commit.
REFLEXION · Release 1.4 taggen 1. Was war geplant? Version hochzählen, Changelog schreiben, Tag v1.4.0 setzen und pushen. 2. Was ist tatsächlich passiert? Tag und Push liefen durch, aber der Tag zeigte auf den Commit vor dem Changelog. Der Nutzer hat es im Release auf GitHub bemerkt. 3. Warum weicht das eine vom anderen ab? Der Changelog lag noch ungesichert im Arbeitsverzeichnis. git tag nimmt den letzten Commit, nicht den Stand der Dateien. 4. Was behalten wir bei, und was machen wir anders? Vor jedem Tag git status prüfen und bei ungesicherten Änderungen abbrechen. Beibehalten: Version und Changelog im selben Commit. LEKTIONEN - Vor git tag immer git status prüfen; bei ungesicherten Änderungen erst committen, dann taggen. (angewendet) FIX-PLAN 1. Ziel: skills/release/SKILL.md, nach Schritt 4 Änderung: „Vor dem Tag git status ausführen. Sind Dateien geändert, abbrechen und zuerst committen.“ (angewendet) Logbuch: ./LESSONS.md
Der Fix-Plan
Eine Lektion im Logbuch hilft nur, wenn jemand sie liest. Deshalb stellt der Skill bei jeder Lektion eine Frage: Macht die nächste Sitzung denselben Fehler, wenn sich an dem, was sie lädt, nichts ändert? Wenn ja, schlägt er einen Fix vor, als nummerierte Liste, bevor er etwas anfasst.
FIX-PLAN 1. Ziel: CLAUDE.md, Abschnitt „Tests“ Neue Zeile: „Tests immer mit python3 -m unittest discover -s tests starten, nie eine Testdatei direkt.“ 2. Ziel: .cursor/rules/migrationen.mdc Neue Regel: „Migrationsdateien mit date +%Y%m%d%H%M%S benennen. Bestehende Migrationen nie ändern, stattdessen eine neue anlegen.“ Freigeben? Antworte mit „ja“ oder nenne die Nummern.
Die Datei, die beim nächsten Mal wirklich geladen wird: CLAUDE.md oder AGENTS.md im Projekt, eine Cursor-Regel unter .cursor/rules/, ein Schritt in einer bestimmten SKILL.md, eine Checkliste. „Der Prozess“ ist keine Zieldatei.
Was genau dazukommt oder ersetzt wird, mit Stelle. „Den Deploy verbessern“ ist keine Änderung. „Nach Schritt 4 einfügen: Vor dem Tag git status prüfen“ ist eine.
Ohne ausdrückliche Freigabe ändert Claude nichts. Schweigen oder ein Themenwechsel heißt „noch nicht“. Gibst du nur Nummer 2 frei, wird nur Nummer 2 umgesetzt.
Nach jeder Änderung liest Claude die Datei noch einmal und bestätigt, dass der Text an der richtigen Stelle steht.
Willst du nicht jedes Mal gefragt werden, sag es gleich beim Aufruf: „/reflexion anwenden“ oder „Reflexion, und wende den Fix an“. Dann setzt Claude den Plan direkt um und berichtet danach, was es geändert hat.
„Die Staging-Datenbank ist montags langsam, das ist normal“ ist Wissen und keine Regel. So etwas kommt nur ins Logbuch. Wer jede Erkenntnis in CLAUDE.md schreibt, begräbt die wichtigen Regeln unter den unwichtigen.
Das Logbuch
Jede Lektion bekommt in LESSONS.md einen Eintrag mit Datum, den vier Antworten, dem Fix und einem Status. Den Status gibt es in drei Stufen:
- notiert: nur Wissen, kein Fix nötig
- vorgeschlagen: der Fix-Plan steht, ist aber noch nicht freigegeben
- angewendet: die Änderung steht in der Zieldatei
So siehst du später, welche Ursachen wirklich behoben sind und welche nur aufgeschrieben wurden. Den Überblick bekommst du mit einem Satz an Claude („Zeig mir alle offenen Fixes aus LESSONS.md“) oder direkt im Terminal:
cd skills/reflexion
python3 lessons.py liste # alle Lektionen
python3 lessons.py liste --tag git # nur ein Thema
python3 lessons.py liste --status offen # vorgeschlagen, nie umgesetzt
Bevor eine neue Lektion dazukommt, sucht lessons.py nach ähnlichen. Es vergleicht die Kernwörter, lässt Füllwörter weg, kürzt Wortendungen und zerlegt zusammengesetzte Wörter wie „Batch-Upload“ in ihre Teile. Ab 40 Prozent Ähnlichkeit zeigt es die Treffer. Ab 70 Prozent schreibt es keine neue Lektion, sondern verlangt, die vorhandene zu ergänzen. So wird aus dem Logbuch nach drei Monaten keine Liste mit fünf Varianten derselben Regel.
Standard ist LESSONS.md im aktuellen Projekt. Lektionen, die überall gelten, schreibt Claude mit --global nach ~/.claude/LESSONS.md.
Damit die nächste Sitzung es liest
Ein Logbuch, das niemand öffnet, ist ein Tagebuch. Die Schleife schließt sich erst mit dieser einen Zeile in CLAUDE.md oder AGENTS.md deines Projekts:
Lies LESSONS.md, bevor du mit einer Aufgabe beginnst.
Fehlt sie, nimmt der Skill sie beim ersten Lauf von selbst in den Fix-Plan auf. In Cursor-Projekten geht das auch als Regel mit alwaysApply: true unter .cursor/rules/. Wie du CLAUDE.md und den Rest des Ordners aufbaust, steht im Guide Agent Files.
So rufst du die Nachbesprechung auf
Du musst keinen Befehl kennen. Direkt nach einer Aufgabe reicht einer dieser Sätze:
/reflexion
Lass uns eine Nachbesprechung machen. Was haben wir gelernt?
Soll Claude den Fix-Plan ohne Rückfrage umsetzen:
/reflexion anwenden
Wird der Skill mitten in einer Aufgabe aufgerufen, bespricht Claude den Teil bis dahin. Am meisten bringt er nach Sitzungen mit Reibung: wenn du korrigieren musstest, wenn etwas still fehlgeschlagen ist oder wenn ein Umweg viel Zeit gekostet hat.
Nachbesprechung zum Mitnehmen
Hol dir den vollständigen Guide als PDF.
Die komplette Anleitung als PDF — inkl. Installation, der vier Fragen, eines Fix-Plans, der Logbuch-Befehle und Checkliste. Damit du sie nicht noch einmal suchen musst.
Woher die Methode kommt
Nach dem Vietnamkrieg hat die US Army ihre Ausbildung neu aufgebaut. Einer der Köpfe dahinter war General Paul F. Gorman, von 1973 bis 1977 für die Ausbildung im Training and Doctrine Command zuständig. Aus seiner Arbeit entstand das National Training Center in Fort Irwin, Kalifornien. Dort kämpfen Einheiten seit 1981 simulierte Gefechte gegen eine erfahrene Gegenseite, verlieren oft und setzen sich danach als Erstes zur Nachbesprechung zusammen. Gorman ist am 19. Januar 2026 mit 98 Jahren gestorben.
Die Methode selbst stammt aus Trainingsprogrammen der Army aus den mittleren 1970er-Jahren. Im September 1993 wurde sie als Ausbildungsvorschrift TC 25-20 festgeschrieben, „A Leader's Guide to After-Action Reviews“. Zwei Sätze daraus erklären, warum sie funktioniert: Ein After Action Review ist keine Kritik, und es benotet nicht Erfolg oder Misserfolg. Es gibt immer Schwächen, die man verbessert, und Stärken, die man beibehält.
Der Skill nutzt die öffentlich beschriebene Struktur der Army und überträgt sie auf eine Sitzung mit Claude. Er ist kein offizielles Werkzeug der Army, und kein KI-Labor arbeitet nach Gormans Unterlagen.
Dasselbe Muster in der KI-Forschung
Forscher, die Sprachmodelle aus eigenen Fehlern lernen lassen wollten, sind unabhängig davon bei einer ähnlichen Form gelandet. In Reflexion (Shinn u. a., 2023) schreibt ein Agent nach einem Fehlversuch in eigenen Worten auf, was schiefging, und nimmt diese Notiz beim nächsten Versuch mit. An den Gewichten des Modells ändert sich nichts. Beim Programmier-Benchmark HumanEval kam der Ansatz so auf 91 Prozent gelöste Aufgaben im ersten Anlauf, GPT-4 allein auf 80 Prozent.
Der Unterschied zum Skill: Im Paper reflektiert der Agent automatisch, zwischen Versuchen an derselben Aufgabe, gestützt auf Testergebnisse. Der Skill macht dasselbe über Sitzungen hinweg, mit dir als Freigabe und mit LESSONS.md als Gedächtnis. Die Zahlen aus dem Paper gelten für den Benchmark, nicht für deine Sitzungen.
Grenzen
CLAUDE.md, bleibt LESSONS.md ein Tagebuch.Quellen
- Der Skill, MIT-Lizenz: Ultra-Smashed/reflexion-skill
- Chen, Zaharia, Zou: How Is ChatGPT's Behavior Changing over Time?, arXiv:2307.09009, überarbeitete Fassung
- Shinn u. a.: Reflexion: Language Agents with Verbal Reinforcement Learning, arXiv:2303.11366, NeurIPS 2023
- Headquarters, Department of the Army: TC 25-20, A Leader's Guide to After-Action Reviews, 30. September 1993
- Paul Gorman (general), Wikipedia
Dein Aktionsplan
Hak ab, was du erledigt hast:
Weißt du, was noch spannender ist?
Wenn KI nicht nur etwas für dich erstellt, sondern dir dauerhaft Arbeit abnimmt.
Genau darum geht es in meinem nächsten kostenlosen Live‑Workshop.
In 90 Minuten zeige ich dir live:
- 01Wie du Claude oder ChatGPT so einrichtest, dass die Ergebnisse wirklich zu dir passen.
- 02Wie du eine echte Aufgabe aus deinem Arbeitsalltag an KI abgibst.
- 03Wie daraus ein System entsteht, das wiederkehrende Aufgaben selbstständig erledigt.
Ganz ohne Programmierkenntnisse und mit konkreten Beispielen.
Der Termin steht noch nicht fest. Wenn du dich auf die Warteliste setzt, erfährst du als Erstes davon.
Kostenlos und unverbindlich
Mit dem Absenden bekommst du eine Mail zur Bestätigung. Datenschutzerklärung
Passt dazu

Christopher Thanisch
Ich übersetze KI in brauchbare Systeme für den Arbeitsalltag — Systeme statt Hypes.