Der Agent schreibt Unbrauchbares

Lernziele

Du prüfst bei einer schlechten Seite zuerst das Original in raw/ und erst danach den Seitenvertrag.
Du verbesserst den Seitenvertrag mit einer vollständigen Beispielseite.
Du nimmst einen schlechten Lauf mit git revert oder git restore --source vollständig zurück und arbeitest neu ein.

Manche Seiten handeln vom richtigen Thema und sind trotzdem nutzlos. Sie bleiben vage, wiederholen die Quelle oder erklären nichts, was du nicht schon wusstest. Die Ursache findest du schneller, wenn du in einer festen Reihenfolge suchst.

Die Quelle. Ist der Text in raw/ lesbar?
Der Seitenvertrag. Sagt die CLAUDE.md, was jede Seite enthält?
Ein Beispiel. Steht eine gute Seite als Ziel in der CLAUDE.md?
Die Rückfrage. Woraus hat der Agent gearbeitet?
Zurückrollen. Vertrag reparieren, Lauf zurücknehmen, neu einarbeiten.

Erst die Quelle prüfen

Bevor du an den Anweisungen drehst, prüf die Eingabe. Öffne die Datei in raw/ und lies sie.

Die Hälfte der schlechten Seiten, die Leute dem Agenten anlasten, stammt nach unserer Einschätzung aus einer schlechten Extraktion. Ein PDF, dessen Spalten ineinanderlaufen. Ein automatisches YouTube-Transkript ohne Satzzeichen. Ein Webclip, der das Cookie-Banner erwischt hat und den Artikel verpasst.

Aus verstümmeltem Text schreibt kein Agent eine gute Seite. Wie du PDFs und Transkripte sauber herausholst, steht in PDFs, Papers und Bücher und YouTube und Podcasts.

Ob der Agent meldet, dass er mit dem Text kämpft, ist unzuverlässig. In unserem Test bekam er eine Buchseite, deren zwei Spalten Zeile für Zeile ineinanderliefen: links der Fließtext, rechts eine Tabelle, Seitenzahl und ein Copyright-Vermerk. Haiku sortierte das richtig auseinander und schrieb auf die Quellenseite, dass die Tabelle nicht ausdrücklich zur Studie im Text gehört. Auf der Konzeptseite standen die Zahlen dann ohne diese Einschränkung, als feste Tatsache. Gelesen wird später die Konzeptseite.

Dann die CLAUDE.md

Ist die Quelle sauber, liegt das Problem im Seitenvertrag in der CLAUDE.md.

Vier Lücken führen zu vagen Seiten:

Es fehlt eine Beschreibung, was jeder Seitentyp enthält.
Irgendwo steht das Wort „zusammenfassen“.
Es fehlt die Anweisung, für jemanden zu schreiben, der die Quelle nicht kennt.
Es fehlt die Pflicht zu verlinken.

Schreib den Vertrag neu und buchstabier die Form jeder Seite aus. Wie die vier Seitentypen aussehen, zeigt Die vier Seitentypen.

Quelle oder Vertrag?

Wo setzt du bei diesem Befund an: beim Original in raw/ oder beim Seitenvertrag in der CLAUDE.md?

Noch offen (6)

Die Quellenseite zitiert Sätze, die mitten im Wort abbrechen und mit Tabellenzahlen weitergehen.
Die Seite zu einem Vortrag besteht aus einem einzigen Absatz ohne Satzzeichen.
Eine Webseite im Vault handelt von Cookies und Datenschutzeinstellungen.
Jede Konzeptseite beginnt mit „Dieser Artikel beschreibt …“.
Die Seiten setzen Fachbegriffe voraus, die nur in der Quelle erklärt sind.
Neue Seiten haben keinen einzigen Link.

Quelle in raw/ (0)

Seitenvertrag (0)

Eine Musterseite als Beispiel

Das ist nach unserer Einschätzung der wirksamste Hebel, und er wird am wenigsten genutzt. Leg eine gute Konzeptseite vollständig in die CLAUDE.md, als Ziel.

Regeln beschreiben das Ergebnis abstrakt, und jede neue Regel wirkt mit den anderen zusammen. Ein Beispiel zeigt das Ziel direkt. So würdest du es auch bei einem Menschen machen, der einen Stil treffen soll: Du gibst ihm ein Muster.

## Beispiel einer guten Konzeptseite

---
type: concept
created: 2026-11-03
tags: [lernen, methode]
---
# Abrufübung

Wer Wissen aus dem Kopf hervorholt, behält es länger als jemand,
der denselben Stoff noch einmal liest. …

Quellen: [[Roediger 2006]], [[Artikel Abrufübung 2026]]
Siehe auch: [[Spaced Repetition]], [[Freies Erinnern]]

Nimm eine echte Seite aus deinem Vault, die du gut findest. Die drei Punkte im Beispiel oben stehen für den Rest der Seite. In deiner CLAUDE.md steht die Seite vollständig.

Fragen, woraus er gearbeitet hat

Du hast [[Seite]] geschrieben. Welche Teile der Quelle hast du benutzt,
und was hast du weggelassen?

Die Antwort zeigt das Problem meist sofort. Der Agent hat nur ein Bruchstück gelesen. Er konnte nicht unterscheiden, was die Quelle behauptet und was sie nur berichtet. Oder die Anweisungen haben ihn zum Zusammenfassen gezogen.

Wir haben die Frage in derselben Session gestellt, in der die Buchseite eingearbeitet wurde:

Rückfrage nach dem Import1/5

DuDu hast [[Schlaf und Gedächtnis]] ergänzt. Welche Teile der Quelle hast du benutzt, und was hast du weggelassen?

Die Rückfrage brachte zwei Sätze ans Licht, die der Agent selbst ergänzt hatte. Ohne die Frage wären sie als Inhalt der Quelle im Vault geblieben. Dass die Tabelle womöglich nicht zur Studie gehört, nannte er dagegen nicht mehr. Lies die Antwort also neben der Quelle.

Zurückrollen und neu einarbeiten

Repariere den Vertrag, nimm die schlechten Seiten zurück und arbeite die Quellen neu ein.

Flicke die schlechten Seiten nicht von Hand. War der Vertrag falsch, hat jede Seite aus diesem Lauf denselben Fehler. Reparierst du die drei, die dir aufgefallen sind, bleiben die übrigen kaputt.

Für das Zurücknehmen nennen viele Anleitungen diesen Befehl:

git checkout HEAD~1 -- wiki/

Wir haben ihn getestet. Ein schlechter Lauf hatte zwei Seiten geändert und eine neue angelegt. Der Befehl stellte die beiden geänderten Seiten wieder her. Die neue Seite blieb liegen, denn git checkout mit einem Pfad löscht keine Dateien, die es im älteren Stand nicht gab.

git checkout HEAD~1 -- wiki/

Geänderte Seiten: zurückgesetzt
Neue Seiten des Laufs: bleiben liegen
Voraussetzung: Der schlechte Lauf ist der letzte Commit

git revert oder git restore --source

Geänderte Seiten: zurückgesetzt
Neue Seiten des Laufs: entfernt
git revert <commit>: nimmt genau einen Lauf zurück, auch wenn danach gute Läufe kamen

Liegt der schlechte Lauf als eigener Commit vor, nimm ihn mit git revert zurück. Ist er der letzte und du willst nur wiki/ zurücksetzen, nimm git restore --source=HEAD~1 --staged --worktree -- wiki/. Beide Befehle erklärt Versionieren mit Git. Sie funktionieren nur, wenn jeder Lauf mit einem eigenen Commit endet.

Merksätze

Eine schlechte Seite untersuchst du in fester Reihenfolge: Quelle, Vertrag, Beispiel, Rückfrage, Zurückrollen.
Ein großer Teil der schlechten Seiten stammt aus verstümmelten Quellen in raw/.
Eine vollständige Beispielseite in der CLAUDE.md zeigt das Ziel direkter als jede weitere Regel.
Die Frage „Was hast du benutzt, was weggelassen?“ deckt eigene Zusätze des Agenten auf.
git checkout HEAD~1 -- wiki/ lässt neue Seiten des Laufs liegen. git revert nimmt den ganzen Lauf zurück.

Prüf dich selbst

Denkfrage

Fünf Seiten aus einem Import sind vage. Drei davon hast du schon von Hand verbessert. Warum ist das keine gute Lösung?

Denkfrage

Warum hilft eine Beispielseite oft mehr als eine zusätzliche Regel?

Quellen

git-restore · Git, Stand: Nov. 2026
--source, --staged, --worktree. Standard ist der No-Overlay-Modus: Dateien, die es im Quellstand nicht gibt, werden entfernt.
git-checkout · Git, Stand: Nov. 2026
Overlay-Modus: Mit Pfadangabe werden keine Dateien entfernt.