Wenn ein Agent eine Regel ignoriert, gehört sie in einen Pre-commit Hook

Geoffrey Huntley beschreibt eine einfache Methode gegen den Drift eines Coding Agenten. Als der Agent seine Diagnosebibliothek umging und Observability Module direkt aufrief, ergänzte Huntley nicht einfach einen weiteren Absatz in AGENTS.md. Er schrieb einen Pre-commit Hook, der die Änderung ablehnt und dem Agenten einen Prompt mit der nötigen Korrektur zurückgibt.

Die Regel wechselte aus dem Dokument in den Weg zum Commit

Der Hook untersucht den git diff auf direkte Aufrufe von Observability Modulen, die Huntleys Diagnoseschicht umgehen. Bei einem Verstoß scheitert der Commit und der Agent erhält konkretes Feedback. Huntley schreibt, das Ergebnis sei dadurch auf zehn von zehn gestiegen.

Das Beispiel stammt aus einem längeren Text, der auf vier Gesprächsfolgen mit Josh Wulf über Loop Engineering basiert. Huntley beschreibt darin auch 48 Stunden Arbeit an einem Refactoring der Diagnostik und argumentiert, dass bloße Anweisungen über spätere Modellläufe hinweg driften. Der Pre-commit Hook machte aus einem veränderlichen Hinweis eine wiederholbare Prüfung.

Teams müssen Vorlieben von Invarianten trennen

AGENTS.md eignet sich für Kontext, Konventionen und die Erklärung einer Absicht. Kritische Architekturgrenzen sollten nicht davon abhängen, ob ein Modell den richtigen Absatz aus einem Prompt erinnert. Muss eine Anwendung eine bestimmte Diagnoseschicht verwenden, gehört diese Anforderung in statische Analyse, einen Test oder einen Hook.

Dadurch verändert sich die Zusammenarbeit eines Entwicklungsteams mit dem Agenten. Menschen müssen nicht jede Zeile prüfen, wenn das System ein verbotenes Muster mechanisch ablehnt und die Korrektur zurück in die Schleife gibt. Das Review kann sich auf Absicht, Risiken und Probleme konzentrieren, die sich nicht als einfache Regel ausdrücken lassen.

Ein einzelner Regex schützt weder Architektur noch Absicht

Ein Hook ist nur so gut wie seine Beschreibung des verbotenen Verhaltens. Ein Agent kann dieselbe Grenze durch einen indirekten Aufruf, einen neuen Wrapper oder eine unbekannte Konfigurationsänderung überschreiten. Eine zu breite Regel blockiert dagegen legitime Änderungen und erzeugt eine Warteschlange falscher Alarme.

Huntley empfiehlt außerdem, alte Skill Packs und AGENTS.md regelmäßig infrage zu stellen, weil neuere Modelle auf dieselben Anweisungen anders reagieren können. Ohne Evals über reale Traces weiß ein Team nicht, ob es dem Agenten hilft oder ihn unbemerkt verschlechtert. Ein mechanisches Tor erzwingt eine konkrete Invariante und garantiert nicht die Gesamtqualität des Systems.

Erkannte und übersehene Verstöße zeigen die Qualität der Schleife

Teams sollten messen, wie viele Verstöße der Hook gestoppt hat, wie viele entkommen sind und wie viele legitime Commits er versehentlich blockiert hat. Außerdem zählt, ob der Agent den Code im nächsten Schritt korrigiert oder nur einen anderen Weg um die Prüfung sucht.

Ein starker agentischer Workflow besitzt mehrere solche Tore: Verhaltenstests, Architekturregeln, Sicherheitsgrenzen und Telemetrie aus der Produktion. Anweisungen geben dem Modell die Richtung. Ausführbare Regeln entscheiden, was tatsächlich passieren darf.

Liliths Urteil

Wenn ein Agent die Diagnostik umgeht, ist ein weiterer Absatz im Handbuch nur ein Schild neben einem offenen Fenster. Ein Pre-commit Hook schließt das Fenster wirklich und schickt den Verursacher zur Reparatur zurück.