Kontext-Hygiene · Agentenwerk

Lernziele

Du erklärst, warum alte Tool-Ausgaben in langen Läufen zuerst aus dem Kontext fallen sollten.
Du legst Zustand, der überleben muss, in Dateien außerhalb des Kontextfensters ab.
Du entscheidest für jedes Stück Information, ob es in den nächsten Versuch mitkommt oder wegfällt.

Context Engineering bestimmt, was das Modell · engl. model, LLMDas Sprachmodell (LLM, Large Language Model). Es liest Text, schreibt Text und entscheidet in einem Agenten, was als Nächstes passiert.Im Glossar innerhalb einer Session · engl. sessionEin einzelnes Gespräch mit einem Agenten: der Verlauf aller Nachrichten und Tool-Ergebnisse plus der Arbeitszustand. Endet das Gespräch, endet die Session.Im Glossar sieht, Runde für Runde kuratiert. Das Thema gehört zum Handbuch Agent-Harnesses. Kontext-Hygiene ist dieselbe Disziplin eine Ebene höher, auf Ebene des Loop · engl. agent loopDie Schleife eines Agenten: denken, handeln, beobachten, wiederholen. Zwischen den Durchläufen wird der Kontext des Modells jedes Mal neu gebaut.Im Glossar. Sie bestimmt, was zwischen Runden und zwischen Versuchen überlebt und was du bewusst zerstörst. Der Harness verwaltet ein Fenster, der Loop verwaltet einen Lebenszyklus.

Aufräumen in langen Läufen

Lange Loops sterben meist zuerst am vollen Kontextfenster · engl. context windowAlles, was das Modell bei einem Aufruf liest: Anweisungen, Verlauf, Dateien, Tool-Ergebnisse. Was dort fehlt, existiert für das Modell nicht.Im Glossar. Anthropic setzt mit seiner Arbeit an Context Management genau dort an. Context Editing löscht automatisch veraltete Tool-Aufrufe und deren Ergebnisse, sobald sich das Fenster seiner Grenze nähert. Der Ablauf der Unterhaltung bleibt dabei erhalten.

Anthropic hat dazu Zahlen veröffentlicht (Sept. 2025). In einer Web-Recherche über 100 Runden schlossen Agenten mit Context Editing Abläufe ab, die sonst am vollen Fenster gescheitert wären. Der Token-Verbrauch sank dabei um 84 %. Auf einem internen Testsatz für agentische Suche brachte Context Editing allein 29 % mehr Leistung als die Ausgangslage, zusammen mit dem Memory-Tool 39 %.

Die Lehre gilt über einen Anbieter hinaus. Alte Tool-Ausgaben sind der wertloseste und umfangreichste Teil des Fensters. Ein Loop, der sie nie räumt, zahlt Miete für Müll.

Dateien als Gedächtnis des Loops

Zustand, der überleben muss, gehört ganz aus dem Fenster heraus in einfache Dateien, die der Agent liest und schreibt:

eine plan.md mit dem Plan,
eine TODO.md mit Checkboxen,
eine Ratchet-Datei mit dem besten bisherigen Messwert.

Das Modell vergisst zwischen Läufen, das Repository behält. In Osmanis Anatomie ist das der Gedächtnis-Baustein außerhalb der Unterhaltung, bei ihm knapp: „Der Agent vergisst, das Repo nicht.“ Jedes unbeaufsichtigte Muster beruht auf diesem Trick. Der Nachtlauf, den du in Build: Der Nachtlauf baust, ist im Kern eine Ratchet-Datei und eine Berichtsdatei mit einer Schleife darum.

Wer das Praxisprojekt Second Brain kennt, erkennt den Zug wieder: Arbeitsgedächtnis ist flüchtig, also wird alles Wichtige aufgeschrieben.

Frischer Kontext pro Versuch

Diese Regel wirkt zuerst verkehrt. Die Ralph-Loop-Szene hat sie durch Erfahrung gelernt: Wirf den Verlauf zwischen zwei Versuchen weg. Das Protokoll eines gescheiterten Versuchs dokumentiert vor allem Verwirrung: falsche Hypothesen, Suchen ins Leere, Entschuldigungen. Trägst du es weiter, vergiftet es den nächsten Versuch, der die Verwirrung als gesicherte Tatsache übernimmt.

Geoffrey Huntleys ursprünglicher Loop startet den Agenten in jeder Runde absichtlich kalt. Jede Runde bekommt ein neues Kontextfenster, und dieselben Dateien landen jedes Mal auf dieselbe Weise darin. Die Prompt-Datei und das Repository sind das einzige Gedächtnis. Jeder Versuch bekommt ein sauberes Fenster und das Ziel.

Über die Lücke zwischen zwei Versuchen kommt nur eine Destillation: die Ausgabe des fehlschlagenden Tests, die Mängelliste des Kritiker · engl. criticDie Instanz, die einen Versuch im Loop bewertet: Code wie Tests und Linter oder ein zweiter Modellaufruf mit enger Rubrik. Der Kritiker arbeitet getrennt vom Agenten, der die Arbeit gemacht hat.Im Glossar, der aktuelle Stand der Todo-Liste. Genau das spielt der Build zum Zieltest zurück: die Fehlerausgabe des Zieltests und sonst nichts.

Zwischen zwei Versuchen: Der Verlauf fällt weg, nur die Destillation kommt mit.

Was mitkommt und was wegfällt

Mitnehmen: das Ziel, die Todo-Datei, die letzte Ausgabe des Prüfers, das Urteil des Kritikers, den Ratchet-Wert.
Wegwerfen: Protokolle der Erkundung, große Tool-Ausgaben, den laufenden Kommentar des Agenten und alles, was er darüber gesagt hat, wie gut es läuft.

Der Test für jedes Stück ist schlicht: Würde ein frischer, fähiger AgentEin System, in dem ein Sprachmodell seinen nächsten Schritt selbst wählt: Es ruft Werkzeuge auf, wertet das Ergebnis aus und macht weiter, bis das Ziel erreicht ist.Im Glossar mit diesem Stück vor Augen besser handeln? Die Ausgabe des Prüfers besteht den Test. Ein Protokoll über 40.000 TokenDie Einheit, in der Modelle Text lesen und abrechnen: meist ein Wortteil. Anbieter rechnen pro Million Tokens ab.Im Glossar vom Scheitern des letzten Versuchs besteht ihn nicht. Hygiene heißt, für den nächsten Versuch zu entscheiden. Deshalb gehört sie zum Loop.

Mitnehmen oder wegwerfen?

Versuch 3 ist gescheitert. Was kommt in Versuch 4?

Noch offen (6)

Die Ausgabe des Zieltests: 2 failed, mit Testnamen und Fehlermeldung
Der komplette Verlauf von Versuch 3, rund 40.000 Tokens
Die Mängelliste des Kritikers: zwei Verstöße mit Datei und Zeile
Der Satz des Agenten „Ich bin fast fertig, nur noch ein Detail“
TODO.md mit drei abgehakten und zwei offenen Punkten
Die vollständige Ausgabe von ls -R über das ganze Repository

Mitnehmen (0)

Wegwerfen (0)

Merksätze

Kontext-Hygiene regelt, was zwischen Runden und Versuchen überlebt. Context Engineering regelt das Fenster innerhalb einer Session.
Alte Tool-Ausgaben sind der größte und wertloseste Teil des Fensters. In Anthropics Test sparte das Räumen 84 % der Tokens.
Zustand, der überleben muss, liegt in Dateien: Plan, Todo-Liste, Ratchet-Wert.
Jeder neue Versuch startet mit frischem Kontext. Über die Lücke kommt nur eine Destillation.
Prüffrage für jedes Stück: Handelt ein frischer, fähiger Agent damit besser?

Prüf dich selbst

Denkfrage

Warum startet Huntleys Ralph-Loop jede Runde absichtlich kalt?

Denkfrage

Was unterscheidet Kontext-Hygiene von Context Engineering?

Quellen

Managing context on the Claude Developer Platform · Anthropic, Sept. 2025
Context Editing und Memory-Tool, mit den Zahlen aus dem 100-Runden-Test.
Loop Engineering · Addy Osmani, Juni 2026
Gedächtnis außerhalb der Unterhaltung als Baustein eines Loops.
Ralph Wiggum as a „software engineer“ · Geoffrey Huntley, Juli 2025
Neues Kontextfenster in jeder Runde.