Handbücher · Loop Engineering
Muster
Lernziele
- Du beschreibst fünf Loop-Muster mit ihrem Einsatz und ihren typischen Fehlern.
- Du rechnest für Best-of-n aus, was n Versuche kosten und was sie bringen.
- Du wählst für eine Aufgabe das einfachste Muster mit echtem Prüfer und begründest, wann ein aufwendigeres sich lohnt.
Fünf Formen von 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 tauchen unter wechselnden Namen immer wieder auf. Jede lohnt sich für eine bestimmte Art von Arbeit. Jede hat Fehlerbilder, die ihre Befürworter gern kleinreden. Hier stehen beide Seiten.
Run-in-a-loop (Ralph)
Geoffrey Huntleys Original vom Juli 2025 ist eine einzige Zeile:
while :; do cat PROMPT.md | claude-code ; done
Es gibt keine Orchestrierung. Endet eine 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, startet die nächste kalt, liest dieselbe Prompt-Datei und dasselbe Repository und macht über die Dateien auf der Platte dort weiter, wo die letzte aufgehört hat. Ralph zeigt in Reinform, dass frischer Kontext plus dauerhafte Dateien eine lange Session schlägt, die immer schlechter wird.
Anthropic bietet eine Variante als Plugin · engl. community pluginEine Erweiterung für Obsidian, die du in den Einstellungen unter Community plugins installierst. Plugins stammen meist von Dritten und erweitern, was Obsidian kann.Im Glossar an. Es hieß zuerst ralph-wiggum und liegt heute als ralph-loop im offiziellen Plugin-Verzeichnis claude-plugins-official (Stand: Nov. 2026). Es arbeitet anders als das Original: Ein Stop-HookEin Befehl, den der Harness bei einem festen Ereignis automatisch ausführt, etwa vor oder nach jedem Tool-Aufruf. Ein Hook vor dem Aufruf kann ihn blockieren und dem Modell den Grund melden.Im Glossar hindert Claude am Beenden und gibt denselben Prompt in derselben Session erneut ein. Der Kontext bleibt also erhalten. Die Zahl der Durchläufe ist ohne --max-iterations unbegrenzt. Die Anleitung des Plugins rät, diese Option immer zu setzen.
Die Fehlerbilder benennt Huntley selbst:
- Platzhalter-Implementierungen, die den Compiler zufriedenstellen und sonst nichts,
- ein Morgen mit einer Codebasis, die nicht mehr kompiliert,
- eine Eignung vor allem für neue Projekte. In einer bestehenden Codebasis würde Huntley Ralph nach eigener Aussage nie einsetzen.
Ralph bringt dich nach Huntleys Erwartung zu etwa 90 % einer ersten Version. Die einzige Bremse ist ein Mensch, der auf Stopp drückt.
Planen, ausführen, prüfen
Der Lauf zerfällt in Phasen. Ein Durchgang erzeugt eine Plan-Datei, die folgenden führen Schritte aus, ein Prüfer gibt jeden Schritt frei. Das Muster passt zu Arbeit mit vielen Schritten, bei der ein einzelner Prompt · engl. promptDer Text, den du einem Sprachmodell bei einem Aufruf schickst. In einem Agenten setzt er sich aus Systemprompt, Tool-Definitionen, Verlauf und aktueller Anfrage zusammen.Im Glossar abdriftet.
Fehlerbild: Pläne veralten beim ersten Kontakt mit der Wirklichkeit. Ein Loop, der einen veralteten Plan treu ausführt, vervielfacht den Fehler. Der Prüfer muss deshalb nach jedem Schritt laufen.
Generator und Kritiker
Ein 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 erzeugt, ein getrennter Durchgang beurteilt nach einer engen Rubrik, die Mängel gehen in den nächsten Versuch. Der Sinn liegt in der Trennung von Macher und Prüfer: Wer umsetzt, bewertet sich nicht selbst.
Zwei Fehlerbilder:
- Eine vage Rubrik macht den 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 zum Rauschgenerator.
- Teilen Generator und Kritiker Modell und Kontext, teilen sie auch ihre blinden Flecken und winken sich gegenseitig durch.
Details stehen in Kritiker und Prüfung. Die Verdrahtung baust du in Build: Der Kritiker.
Turnier (Best-of-n)
Du startest n Versuche parallel und lässt einen Prüfer den Sieger wählen. Git-Worktree · engl. git worktreeEin zusätzliches Arbeitsverzeichnis desselben Git-Repositorys auf einem eigenen Branch. Ein Agent arbeitet darin, ohne deinen Checkout oder main zu berühren.Im Glossar machen es billig, die Versuche voneinander zu trennen. Das Muster ist stark, wenn die Versuche stark schwanken und die Prüfung billig ist.
Fehlerbilder: Die Kosten vervielfachen sich mit n, ob ein guter Versuch dabei ist oder nicht. Und ohne wirklich starken Auswähler hast du n-mal für selbstsicheren Ausschuss bezahlt und am Ende den selbstsichersten davon gewählt. Ob du dir dieses Muster leisten kannst, entscheidet die Prüf-Asymmetrie aus der Lektion über Kritiker.
Was n Versuche kosten und bringen
- Kosten des Turniers
- 3,20 $
- Chance auf mindestens einen guten Versuch
- 76 %
Beispielwerte. Annahmen: Die Versuche sind unabhängig, und der Prüfer erkennt einen guten Versuch sicher. Ohne starken Prüfer gilt die zweite Zahl nicht.
Nachtläufe mit Morgenbericht
Budgetierte Läufe mit Ratchet · engl. ratchetEine Sperrklinke für Fortschritt: Jeder Versuch muss den besten bisherigen Messwert schlagen, etwa die Zahl bestandener Tests. Sonst setzt der Loop den Versuch zurück und hält an.Im Glossar auf einem eigenen Branch · engl. branchEin Seitenzweig in Git, auf dem du Änderungen ausprobierst, ohne den Hauptstand zu berühren. Danach führst du ihn zusammen oder löschst ihn.Im Glossar arbeiten, während du schläfst. Am Morgen liegt ein Bericht in Markdown bereit: was besser wurde, was den Loop gestoppt hat, was eine Entscheidung braucht. Das ist der Endpunkt der Disziplin und das Muster mit den strengsten Voraussetzungen. Es braucht jede Bremse aus Stoppbedingungen und dazu Leitplanken, die den schlimmsten Fall langweilig machen.
Fehlerbild: Unbeaufsichtigte Loops machen unbeaufsichtigte Fehler. Die Schuld landet als Verständnisschuld bei dir. Osmani nennt sie „comprehension debt“: Die ausgelieferten Änderungen wachsen schneller als dein Verständnis davon. Osmanis Warnung gilt: Bau den Loop wie jemand, der vorhat, der Engineer zu bleiben.
Die Wahl
Fang mit dem einfachsten Loop an, der einen echten Prüfer hat: dem einfachen Retry-Loop aus Build: Der Zieltest. Nimm einen Kritiker dazu, wenn „grün, aber hässlich“ dein häufigster Fehler wird. Geh erst parallel oder über Nacht, wenn der einfache Loop jedes Mal nachvollziehbar anhält. Die aufwendigeren Muster verstärken die Disziplin, die du schon hast, und ebenso ihr Fehlen.
Welches Muster passt?
Ordne jede Lage dem Muster zu, das du als Nächstes wählst.
Noch offen (5)
- Dein erster Loop für drei rote Tests, noch ohne Erfahrung mit Bremsen
- Die Tests werden grün, aber die Diffs ändern regelmäßig Dateien außerhalb der Aufgabe
- Eine Optimierung, deren Ergebnis von Versuch zu Versuch stark schwankt, ein Benchmark misst in Sekunden
- Ein Backlog aus 40 Lint-Fehlern, dein Loop hält seit Wochen jedes Mal sauber an
- Ein Bug mit Reproduktionsskript, das bei Erfolg 0 zurückgibt
Einfacher Retry-Loop (0)
Generator und Kritiker (0)
Best-of-n (0)
Nachtlauf (0)
Merksätze
- Ralph startet jede Runde kalt und lebt von Dateien. Er taugt für neue Projekte und hat nur den Menschen als Bremse.
- Planen-ausführen-prüfen braucht einen Prüfer nach jedem Schritt, weil Pläne veralten.
- Generator und Kritiker brauchen eine enge Rubrik und getrennte Kontexte, sonst winken sie sich durch.
- Best-of-n kostet n-mal und lohnt sich nur mit starkem, billigem Auswähler.
- Nachtläufe brauchen jede Bremse und erzeugen Verständnisschuld, wenn niemand liest, was der Loop gebaut hat.
Prüf dich selbst
Denkfrage
Worin unterscheidet sich das Plugin ralph-loop vom ursprünglichen Ralph-Loop?
Huntleys Bash-Schleife startet jede Runde als neue Session mit frischem Kontext. Das Plugin hält Claude per Stop-Hook in derselben Session und gibt denselben Prompt erneut ein, der Kontext bleibt also erhalten. Ohne --max-iterations läuft es unbegrenzt.
Denkfrage
Warum kann Best-of-n teurer Ausschuss sein?
Die Kosten steigen mit jedem Versuch, egal ob einer gut ist. Ohne starken Prüfer wählst du am Ende den selbstsichersten Versuch. Ob er stimmt, weißt du dann nicht. Dann hast du n-mal bezahlt und nichts gewonnen.
Denkfrage
Wann ist ein Loop reif für den Nachtlauf?
Wenn der einfache Loop mit echtem Prüfer jedes Mal nachvollziehbar anhält und der Fortschritt messbar ist. Dazu kommen alle Bremsen aus den Stoppbedingungen, ein eigener Branch und ein Morgenbericht. Die aufwendigeren Muster verstärken nur die Disziplin, die schon da ist.
Prüf dich selbst
Quellen
- Ralph Wiggum as a „software engineer“
Das Original mit Fehlerbildern und der 90-%-Erwartung.
- ralph-loop (Plugin)
Stop-Hook-Variante in derselben Session, früher ralph-wiggum. Stand: Nov. 2026.
- Loop Engineering
Comprehension debt und die Warnung, Engineer zu bleiben.