Jonas Fackelmeyer Projekt · Eigenes Projekt
agentic-workflow
Meine Regeln für Coding-Agents als installierbares Claude-Code-Plugin. Ein Guard-Hook setzt durch, was sich mechanisch prüfen lässt, statt den Agenten nur darum zu bitten.
- Organisation
- Eigenes Projekt
- Rolle
- Autor
- Zeitraum
- 10/2026
- Team
- allein
- Status
- Öffentlich auf GitHub
- Stack
- Claude Code Plugin · Node.js · Hooks · Codex CLI
Zuletzt aktualisiert:
Problem
Regeln in einer AGENTS.md sind Bitten. Ein Agent, der einen Test grün bekommen will, greift trotzdem zu --no-verify oder @ts-ignore.
Lösung
Ein Guard-Hook läuft vor jedem Shell-Befehl und jeder Dateiänderung:
- Blockiert: umgangene Prüfungen (
--no-verify,@ts-ignore,eslint-disable…), Secrets im Code und.env-Dateien. - Fragt nach: vor Produktiv-Abhängigkeiten, Lockfiles, CI und Infrastruktur, Löschen, Force-Push, Commits und Pushes.
Dazu kommen ein Subagent, der Aufgaben in einem isolierten Worktree an Codex delegiert, meine globalen Agent-Regeln und eine Vorlage für Projekt-Regeln.
Wie ich es geprüft habe
Die Regeln sind reine Funktionen mit Tests für beides: was sie fangen müssen und welche Fehlalarme sie nicht auslösen dürfen. Eine Commit-Nachricht, die --no-verify nur erwähnt, wird zum Beispiel nicht blockiert. Ein Ende-zu-Ende-Test mit Claude Code zeigt den Unterschied: Mit dem Plugin wird git commit --no-verify abgelehnt, ohne Plugin läuft der Befehl durch. Die CI läuft auf Linux und macOS mit Node 20 und 24. Sie hat zwei Fehler gefunden, die den Guard sonst still wirkungslos gemacht hätten.
Grenzen
Der Guard ist eine Leitplanke, keine Sandbox: Er erkennt Muster, ein Agent kann ihn über Umwege umgehen. Er ersetzt nicht, jeden Diff zu lesen.