Stop-Hook
Ein Stop-Hook ist eine hinterlegte Anweisung, die automatisch ausgeführt wird, sobald ein KI-Assistent seine Arbeit an einer Aufgabe beendet. Damit lassen sich Abschlussprüfungen, Aufräumarbeiten oder Benachrichtigungen anstoßen, ohne dass ein Mensch sie jedes Mal anstoßen muss.
Moderne KI-Assistenten schreiben nicht nur Text, sondern erledigen ganze Arbeitsaufträge. Sie ändern Dateien, führen Programme aus und melden am Ende: fertig. Genau an diesem Schlusspunkt setzt ein Stop-Hook an. Ein Hook ist ein Einhängepunkt: eine Stelle im Ablauf, an der man eigene Befehle hinterlegen kann. Der Stop-Hook ist der Einhängepunkt für das Ende. Sobald der Assistent seine Antwort abschließt, wird der hinterlegte Befehl automatisch gestartet. Der Name kommt vom englischen „stop“, also anhalten oder aufhören.
Warum das Ende einer Aufgabe der kritische Moment ist
KI-Assistenten neigen dazu, Arbeit für erledigt zu erklären, die noch nicht erledigt ist. Sie schreiben Code, der nicht kompiliert. Sie ändern eine Datei und vergessen eine zweite, die davon abhängt. Ein Mensch würde das beim Nachschauen merken. Bei hunderten automatischen Durchläufen pro Tag schaut aber niemand jedes Mal nach.
Ein Stop-Hook macht diese Kontrolle verbindlich. Er ist nicht als Bitte im Prompt formuliert, sondern als feste Regel im System. Ein Prompt ist eine Anweisung in normaler Sprache, an die sich das Modell halten kann oder auch nicht. Ein Hook dagegen wird von der Software ausgeführt, unabhängig davon, was das Modell gerade für sinnvoll hält. Das ist der entscheidende Unterschied: Bitten kann man ignorieren, Hooks nicht.
Viele Stop-Hooks können das Ergebnis sogar zurückweisen. Findet die Prüfung einen Fehler, geht die Meldung zurück an den Assistenten, und der arbeitet weiter. So entsteht eine Schleife aus Arbeiten, Prüfen und Nachbessern. Der Assistent darf erst dann wirklich aufhören, wenn die Prüfung zufrieden ist.
Vom Auslöser zum ausgeführten Befehl
Technisch hinterlegt man den Stop-Hook in einer Konfigurationsdatei. Das ist eine einfache Textdatei mit Einstellungen, die das Programm beim Start liest. Dort steht, bei welchem Ereignis der Hook greifen soll und welcher Befehl dann laufen muss. Der Befehl ist meist ein kleines Skript, also eine kurze Liste von Kommandos für den Computer.
Der Ablauf ist immer gleich. Der Assistent beendet seinen Arbeitsschritt. Die Software fängt dieses Ereignis ab, bevor die Antwort an den Nutzer geht. Sie startet das hinterlegte Skript und übergibt ihm Informationen über den Vorgang, etwa welche Dateien verändert wurden. Das Skript liefert am Ende einen Rückgabewert: null bedeutet in Ordnung, alles andere bedeutet Problem.
Ein typisches Beispiel aus der Softwareentwicklung: Der Stop-Hook startet die automatischen Tests des Projekts. Laufen alle durch, ist die Sitzung beendet. Schlägt ein Test fehl, bekommt der Assistent die Fehlermeldung und muss nachbessern. Wichtig ist dabei eine Obergrenze für die Wiederholungen. Sonst kann der Assistent in einer Endlosschleife hängen bleiben und sich selbst immer wieder aufwecken.
Stop-Hooks in Entwicklungswerkzeugen und Agentensystemen
Am häufigsten begegnet man Stop-Hooks in KI-Programmierwerkzeugen wie Claude Code, Cursor oder ähnlichen Assistenten. Dort nutzen Entwickler sie für Formatierung, Tests und Sicherheitsprüfungen. Manche lassen sich am Ende auch einfach eine Nachricht aufs Handy schicken, wenn ein langer Auftrag durchgelaufen ist.
Der Begriff taucht außerdem im Zusammenhang mit sogenannten Agenten auf. Das sind KI-Systeme, die über längere Zeit selbstständig Aufgaben abarbeiten. Je selbstständiger ein System handelt, desto wichtiger werden feste Kontrollpunkte. Stop-Hooks gehören zu den einfachsten davon und werden deshalb oft als Beispiel für praktische KI-Sicherheit genannt.
Ein verbreiteter Irrtum ist, ein Stop-Hook würde den Assistenten stoppen. Das Gegenteil stimmt eher. Er reagiert auf das Anhalten und kann die Arbeit sogar wieder in Gang setzen. Wer ein Werkzeug sucht, das eine laufende KI-Aktion vorher abbricht, braucht einen anderen Einhängepunkt, der vor der Ausführung greift.