---
title: "Je länger du Claude nutzt, desto schlechter wird es — so löst du das."
description: "Ein kostenloser Claude-Skill hält nach jeder Aufgabe die Nachbesprechung der US Army: vier Fragen, eine prüfbare Lektion, ein Fix-Plan mit Zieldatei und wörtlichem Text. Nach deinem Ja landet die Regel in CLAUDE.md oder der passenden SKILL.md, und jede Lektion in einer LESSONS.md, die die nächste Sitzung liest."
category: guides
date: 2026-11-16
canonical: https://thanisch.co/wissen/guides/reflexion-skill
url: https://thanisch.co/wissen/guides/reflexion-skill
---

# Je länger du Claude nutzt, desto schlechter wird es — so löst du das.

- Den kostenlosen Reflexion-Skill in zwei Minuten installieren, ohne Programmierkenntnisse

- Die vier Fragen des After Action Review, übertragen auf eine Sitzung mit Claude

- Wie der Fix-Plan Zieldatei und wörtlichen Text nennt und erst nach deinem Ja schreibt

- Wie LESSONS.md Dubletten abfängt und von der nächsten Sitzung gelesen wird

- Was der Skill nicht kann: Er schreibt Dateien und trainiert kein Modell

> **Kurz gesagt**
> Claude erinnert sich zwischen zwei Sitzungen an nichts, außer an das, was in Dateien steht, die es beim Start liest. Der Reflexion-Skill hält nach jeder Aufgabe eine Nachbesprechung mit vier Fragen, zieht daraus eine prüfbare Lektion und schreibt die nötige Regel nach deiner Freigabe in genau diese Dateien. *Was du einmal korrigiert hast, steht beim nächsten Mal schon da.*

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](https://arxiv.org/abs/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.

> **Zur oft zitierten Zahl 97,6 auf 2,4 Prozent**
> 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](https://github.com/Ultra-Smashed/reflexion-skill) setzt genau dort an. Er ist kostenlos, Open Source unter MIT-Lizenz und für Deutsch geschrieben.

## Was du baust

### 1. Die Nachbesprechung

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.

### 2. Der Fix-Plan

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.

### 3. Das Logbuch

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.

> **Bevor du startest**
> 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:

```text
/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:

```bash
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.

**Claude**

```
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.

> **In Claude im Browser oder in der Desktop-App**
> 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.

## 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.

### 1. Was war geplant?

Auftrag, Plan und erwartetes Ergebnis, schlicht benannt.

### 2. Was ist tatsächlich passiert?

Das echte Ergebnis, mit halben Lösungen, stillen Fehlschlägen, Umwegen und den Stellen, an denen du korrigieren musstest.

### 3. Warum weicht das eine vom anderen ab?

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“.

### 4. Was behalten wir bei, und was machen wir anders?

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.

> **Merke**
> Die vierte Antwort entscheidet, ob sich etwas ändert. „Sorgfältiger arbeiten“ verhindert nichts. „Vor `git tag` immer `git status` prüfen“ kann ein anderer Agent in einem halben Jahr befolgen, ohne selbst abzuwägen. Eine Lektion ohne Datei, Befehl, Zahl, Werkzeug oder Bedingung lässt der Skill weg.

## 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.

### 1. Eine echte Zieldatei

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.

### 2. Der wörtliche Text

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.

### 3. Erst nach deinem Ja

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.

### 4. Danach geprüft

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.

> **Nicht jede Lektion braucht einen Fix**
> „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:

```bash
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:

```text
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](/wissen/guides/agent-files).

## So rufst du die Nachbesprechung auf

Du musst keinen Befehl kennen. Direkt nach einer Aufgabe reicht einer dieser Sätze:

Soll Claude den Fix-Plan ohne Rückfrage umsetzen:

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.

## 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.

> **Was das heißt und was nicht**
> 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](https://arxiv.org/abs/2303.11366) (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.

> **Merke**
> Army und Forschung teilen dieselbe Idee: Plan und Ergebnis vergleichen, die Lücke aufschreiben und beim nächsten Mal etwas anders machen. Das ist eine Ähnlichkeit in der Form, keine gemeinsame Herkunft.

## Grenzen

- Der Skill trainiert kein Modell und ändert keine Gewichte. Er schreibt Text in Dateien, die Claude beim nächsten Start liest.

- Ein Fix wirkt ab der nächsten Sitzung, nicht mitten in der laufenden Aufgabe.

- Ein Fix hilft nur, wenn du ihn freigibst und die Zieldatei beim nächsten Mal wirklich geladen wird. Fehlt die Lese-Zeile in `CLAUDE.md`, bleibt `LESSONS.md` ein Tagebuch.

- Eine vage Lektion oder ein vager Fix ändert nichts. Prüf vor dem Ja, ob Datei und Text konkret genug sind.

- Der Skill hilft nur bei den Sitzungen, nach denen du ihn aufrufst.

- In Claude im Browser kann er keine Dateien auf deinem Rechner ändern. Dort trägst du Lektionen und Fixes selbst ins Projekt ein.

- Die Drift-Studie misst eine Aufgabe bei einem Modell aus dem Jahr 2023. Sie ist ein Datenpunkt, kein Gesetz für jedes Modell.

## Quellen

- Der Skill, MIT-Lizenz: [Ultra-Smashed/reflexion-skill](https://github.com/Ultra-Smashed/reflexion-skill)
- Chen, Zaharia, Zou: [How Is ChatGPT's Behavior Changing over Time?](https://arxiv.org/abs/2307.09009), arXiv:2307.09009, überarbeitete Fassung
- Shinn u. a.: [Reflexion: Language Agents with Verbal Reinforcement Learning](https://arxiv.org/abs/2303.11366), 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)](https://en.wikipedia.org/wiki/Paul_Gorman_(general)), Wikipedia

## Dein Aktionsplan

Hak ab, was du erledigt hast:

- [ ] Skill als Plugin installiert oder den Ordner nach `~/.claude/skills/` kopiert

- [ ] Nach einer Aufgabe mit Reibung `/reflexion` aufgerufen

- [ ] Die Antwort auf Frage 4 geprüft: Nennt sie eine Datei, einen Befehl, eine Zahl oder eine Bedingung?

- [ ] Den Fix-Plan gelesen und nur die Nummern freigegeben, deren Text du so willst

- [ ] „Lies LESSONS.md, bevor du mit einer Aufgabe beginnst.“ in `CLAUDE.md` oder `AGENTS.md` eingetragen

- [ ] Nach einer Woche mit `lessons.py liste --status offen` nach liegengebliebenen Fixes gesucht
