TL;DR und Fazit
Wir haben Claude Code echte Features in unserer eigenen kleinen TypeScript-Rechnungs-API bauen lassen (Claude Code 2.1.294, Opus 5.5, Auto-Modus) und das Ergebnis mit einem Copy-Paste-Detektor, Typecheck und Tests geprüft. Danach haben wir pro Regel einen Enforcer installiert: einen Hook oder eine Einstellung, keine Zeile in CLAUDE.md.
- Mit den fünf Regeln als Prosa in CLAUDE.md verletzte Feature A (Gutschriften) keine davon: 0 Klone, 45 bestandene Tests (34 Baseline plus 11), kein Test wurde gelöscht und keine Konfiguration angefasst.
- Ohne geschriebene Regeln hinterließ Feature B1 (wiederkehrende Zeitpläne und ein CSV-Export) 3 exakte Klone. Der Parser für den Rechnungs-Body wurde in den Zeitplan-Parser kopiert, und der Lookup-Boilerplate eines Handlers in einen zweiten Handler. Der Typecheck war grün, und 47 Tests bestanden. Ein zweiter Durchgang, B2, ließ alle 3 Klone stehen.
- Mit den installierten Enforcern haben wir dieselben Prompts wiederholt. Der Klon-Hook sprang auf dem Zeitplan-Handler an (jscpd fand 1 Klon, Baseline 0), und Claude verschob die gemeinsame Prüfung in eine Methode. Der Hook für neue Dateien löste drei Berechtigungsabfragen für die Zeitplan-Module aus, die wir mit Ja beantworteten, und eine für eine Utils-Datei, die wir mit Nein beantworteten, und nichts wurde geschrieben. Beim Enum- und Interface-Prompt änderte Claude nichts und nannte die Lint-Konfiguration und den Hook. Der Stop-Hook lehnte ein Umbenennen per Shell-Befehl mit "Rule 4: tests fail. Not done yet." ab, und Claude korrigierte die zwei Erwartungen. Ein Shell-Befehl auf tsconfig.json wurde vom Harness verweigert.
- Jeder Enforcer bekam außerdem eine fehlerhafte Änderung von Hand eingespeist: Der Klon, die Lint-Verstöße, der rote Build und der gelöschte Test wurden alle abgelehnt.
Fazit: Installiere zuerst den Stop-Hook, dann die Deny-Liste, die kurz ist. Lass das alles bei einem Wegwerf-Prototyp weg. Ein Hook erzwingt, was ein einzelner Tool-Aufruf zeigen kann. Ob eine Abstraktion die richtige ist, bleibt deine Entscheidung.
Quellenbasierte Synthese
CLAUDE.md ist Kontext, keine erzwungene Konfiguration. Die Memory-Docs von Claude Code sagen, CLAUDE.md und Rules würden als Kontext geladen, nicht als erzwungene Konfiguration s2. Die Best-Practices-Seite sagt dasselbe von der anderen Seite: CLAUDE.md ist für Richtlinien, und Claude kann entscheiden, dass eine nicht gilt. Verbindliches Verhalten gehört in einen Hook, eine Deny-Regel oder eine verwaltete Einstellung s1.
Daraus ergeben sich zwei Arten von Anweisungen. Bei der ersten Art schreibst du eine Zeile, und das Modell liest sie: ein Prompt, CLAUDE.md, ein Skill. Bei der zweiten Art konfigurierst du einen Check, und das Harness führt ihn aus: ein Hook, eine Deny-Regel, eine verwaltete Einstellung s1. Die fünf Regeln in diesem Pack gehören alle zur zweiten Art.
Exit 2 bewirkt bei jedem Hook-Event etwas anderes. Bei PostToolUse zeigt Exit 2 Claude den stderr, obwohl das Tool schon gelaufen ist s3. Eine PostToolUse-Warnung muss mit Exit 2 enden, um Claude zu erreichen, denn der stderr eines Hooks, der mit Exit 0 endet, wird nie gesehen s3. Bei PreToolUse blockiert Exit 2 den Aufruf, auch wenn der Hook eine Allow-Entscheidung ausgegeben hat s3. Bei Stop blockiert Exit 2 das Beenden, und was der Befehl auf stderr ausgibt, geht als Grund an Claude zurück, warum es noch nicht fertig sein kann s1.
Ein Stop-Hook braucht einen Guard und hat eine Obergrenze. Stop-Hooks erhalten stop_hook_active, das true ist, wenn Claude gerade wegen eines Stop-Hooks weitermacht. Du prüfst es, um nicht auf eine Bedingung zu blockieren, die sich nie auflösen wird s3. Der dokumentierte Guard endet mit 0, wenn es true ist s18. Claude Code wendet außerdem eine Obergrenze von 8 aufeinanderfolgenden Fortsetzungen an, die sich mit CLAUDE_CODE_STOP_HOOK_BLOCK_CAP anheben lässt s3. Das Changelog zu 2.1.143 sagt, der Zug ende jetzt nach 8 aufeinanderfolgenden Blockaden mit einer Warnung s19.
PreToolUse kennt vier Entscheidungen. Ein PreToolUse-Hook gibt seine Entscheidung in hookSpecificOutput zurück, mit vier Ergebnissen: allow, deny, ask oder defer s3. Der Hook für neue Dateien in diesem Pack antwortet mit ask, was dich als Berechtigungsabfrage zurück in die Schleife holt. Ein PreToolUse-Hook mit Timeout blockiert den Aufruf nicht. Seit 2.1.295 kannst du onFailure: "block" setzen, damit er blockiert s3 s19.
Der Matcher hat einen blinden Fleck. Der Matcher Edit|Write greift nur bei den Tools Edit und Write, nicht bei Bash s18. Änderungen per Bash können ab 2.1.269 in tool_response.bashEditDiff an einen PostToolUse-Hook gelangen, hinter der Einstellung bashEditDiffEnabled s3 s19.
Deny-Regeln: nimm Edit(path) und kenne die Grenze. Eine Deny-Regel Write(path) greift nicht. Nimm Edit(path), das alle eingebauten Datei-Bearbeitungs-Tools abdeckt s4. Deny-Regeln decken außerdem kein Python- oder Node-Skript ab, das die Datei selbst öffnet s4.
Pfadbezogene Rules und die Frontmatter-Falle. Eine pfadbezogene Regel wird geladen, wenn Claude Read, Write oder Edit auf einer passenden Datei nutzt s2. Vor 2.1.288 lud nur Read sie s19. Wenn das YAML zwischen den Markierungen nicht geparst werden kann, ignoriert Claude Code das Frontmatter und lädt die Regel, als hätte sie kein paths, sodass sie überall gilt s2.
jscpd findet nur exakte Klone. Als npx jscpd . gestartet, durchsucht es den Code nach Klonen. Standardläufe melden nur exakte Klone, umbenannte oder knapp daneben liegende Klone sind optional s20. Die Standard-Mindestgröße eines Klons beträgt 50 Tokens s20. Unser Hook senkt sie auf 30 Tokens und 4 Zeilen. In unserem Test wurde eine umgeschriebene Beinahe-Kopie mit anderen Zeilen und gleichem Verhalten nicht gefunden.
Warum Gates bei jeder Änderung und keine längere CLAUDE.md. SlopCodeBench fand heraus, dass der beste Agent 14,8 % der Checkpoints besteht. Das ist eine Bestehensquote, kein Anteil an Slop. Strukturelle Erosion nimmt in 77 % der Verläufe zu und Wortreichtum in 75,5 % s6. Agenten-Code ist 2,3-mal wortreicher und 2,0-mal stärker erodiert als 473 Open-Source-Python-Repositories s6. Explizite Qualitätsvorgaben senken anfänglichen Wortreichtum und Erosion um bis zu ein Drittel, ohne die Degradationsraten zu beeinflussen s6. Vorgaben helfen am Anfang. Ein Gate bei jeder Änderung wirkt auf die Steigung.
Der Stop-Hook, der "nichts tut". Ein Hacker-News-Thread, "Claude is ignoring stop hooks", zeigt ein Skript, das mit cat und Exit 0 endete. Das Harness blockierte nie etwas, denn Blockieren braucht Exit 2 mit dem Grund auf stderr s8.
Was ein Hook nicht beurteilen kann. Ein Claude Code Issue dazu, dass CLAUDE.md-Regeln nicht befolgt werden, nennt PreToolUse-Hooks einen teilweisen Notbehelf. Ein Hook erzwingt, was ein einzelner Tool-Aufruf zeigen kann. "Ist das die richtige Abstraktion?" kann ein Hook nicht entscheiden, und wenn du den Hook abschaltest, kommt das Verhalten zurück s7.
Code
Installationshinweis: settings.json kommt nach .claude/settings.json, die vier Hook-Skripte nach .claude/hooks/, domain.md nach .claude/rules/domain.md und eslint.config.js ins Wurzelverzeichnis des Repos. Füge eslint, typescript-eslint und jscpd als devDependencies hinzu. Lege zwei Baseline-Dateien an: .claude/jscpd-baseline (die Klon-Anzahl) und .claude/test-baseline (die Zahl der bestandenen Tests). Die Hooks nutzen jq, und der Stop-Hook ruft pnpm typecheck und pnpm test auf, daher müssen diese Skripte in deiner package.json existieren.
Die Settings-Datei enthält die Deny-Liste für Regel 5 (tsconfig.json, vitest.config.ts, eslint.config.js und .claude/**) und die Hook-Einträge für die Regeln 1 bis 4. Leg sie in .claude/settings.json ab.
settings.json
{
"permissions": {
"deny": [
"Edit(tsconfig.json)",
"Edit(vitest.config.ts)",
"Edit(eslint.config.js)",
"Edit(.claude/**)"
]
},
"hooks": {
"PreToolUse": [
{ "matcher": "Write", "hooks": [ { "type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/new-file-ask.sh\"", "timeout": 10 } ] }
],
"PostToolUse": [
{ "matcher": "Edit|Write", "hooks": [ { "type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/no-clone.sh\"", "timeout": 60 } ] },
{ "matcher": "Edit|Write", "hooks": [ { "type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/lint-edit.sh\"", "timeout": 60 } ] }
],
"Stop": [
{ "hooks": [ { "type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/done-check.sh\"", "timeout": 120 } ] }
]
}
}
Regel 1, erst wiederverwenden, dann schreiben. Ein PostToolUse-Hook auf Edit|Write. Er startet jscpd auf src/ nach jeder Änderung an einer .ts-Datei, vergleicht die Klon-Anzahl mit der Baseline und beendet sich mit Code 2 und der Fundstelle des Zwillings, wenn die Anzahl steigt. Leg ihn in .claude/hooks/no-clone.sh ab.
no-clone.sh
#!/usr/bin/env bash
# PostToolUse hook (matcher: Edit|Write). Rule 1: reuse before you write.
# Runs the copy-paste detector on src/ after every edit. A clone that was not
# there at the baseline blocks with the twin's location (exit 2 -> stderr reaches Claude).
set -u
INPUT=$(cat)
FILE=$(printf '%s' "$INPUT" | jq -r '.tool_input.file_path // empty')
case "$FILE" in *.ts) ;; *) exit 0 ;; esac
cd "$(printf '%s' "$INPUT" | jq -r '.cwd')" || exit 0
BASE=$(cat .claude/jscpd-baseline 2>/dev/null || echo 0)
OUT=$(mktemp -d)
npx --no-install jscpd src --min-lines 4 --min-tokens 30 --reporters json --output "$OUT" --silent >/dev/null 2>&1
COUNT=$(jq '.statistics.total.clones // 0' "$OUT/jscpd-report.json" 2>/dev/null || echo 0)
if [ "$COUNT" -gt "$BASE" ]; then
echo "Rule 1 (reuse before you write): jscpd found $COUNT clone(s), baseline is $BASE. A helper you just wrote already exists:" 1>&2
jq -r '.duplicates[] | " \(.firstFile.name):\(.firstFile.start)-\(.firstFile.end) == \(.secondFile.name):\(.secondFile.start)-\(.secondFile.end)"' "$OUT/jscpd-report.json" 1>&2
echo "Import and reuse the existing one; do not keep both." 1>&2
rm -rf "$OUT"; exit 2
fi
rm -rf "$OUT"; exit 0
Regel 2, kein Modul, das niemand wollte. Ein PreToolUse-Hook auf Write. Liegt der Pfad unter src/ und existiert die Datei noch nicht, antwortet er mit ask und einer Begründung, und Claude Code zeigt eine Berechtigungsabfrage. Leg ihn in .claude/hooks/new-file-ask.sh ab.
new-file-ask.sh
#!/usr/bin/env bash
# PreToolUse hook (matcher: Write). Rule 2: no module nobody asked for.
# Creating a file that does not exist yet under src/ becomes a permission prompt:
# the human says yes or no, the model does not decide alone.
set -u
INPUT=$(cat)
FILE=$(printf '%s' "$INPUT" | jq -r '.tool_input.file_path // empty')
CWD=$(printf '%s' "$INPUT" | jq -r '.cwd')
case "$FILE" in "$CWD"/src/*) ;; *) exit 0 ;; esac
[ -e "$FILE" ] && exit 0
REL=${FILE#"$CWD"/}
jq -cn --arg r "Rule 2: new module under src/ ($REL). One new file needs a reason: approve only if the task asked for it, otherwise put the code in the module it belongs to." \
'{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"ask",permissionDecisionReason:$r}}'
Regel 3, Konventionen sind Lint. Ein PostToolUse-Hook auf Edit|Write, der ESLint auf der geänderten .ts-Datei startet und sich bei jedem Fehler mit Code 2 beendet. Er prüft nur und korrigiert nie. Leg ihn in .claude/hooks/lint-edit.sh ab.
lint-edit.sh
#!/usr/bin/env bash
# PostToolUse hook (matcher: Edit|Write). Rule 3: conventions are lint, not prose.
# Runs ESLint on the file that was just edited; a violation is a lint error at the
# exact line, every edit (exit 2 -> stderr reaches Claude). Lint only, never --fix.
set -u
INPUT=$(cat)
FILE=$(printf '%s' "$INPUT" | jq -r '.tool_input.file_path // empty')
case "$FILE" in *.ts) ;; *) exit 0 ;; esac
cd "$(printf '%s' "$INPUT" | jq -r '.cwd')" || exit 0
if ! npx --no-install eslint --no-warn-ignored "$FILE" 1>&2; then
echo "Rule 3: the conventions above are enforced by eslint.config.js; fix the file, do not change the config." 1>&2
exit 2
fi
exit 0
Die Lint-Regeln, die er ausführt: type statt interface, kein enum, kein any, keine I/O- oder Store-Imports in src/domain/ und keine direkten Store-Imports in Handlern. Leg die Datei ins Wurzelverzeichnis des Repos.
eslint.config.js
// Conventions as lint rules. Run on every edited file by .claude/hooks/lint-edit.sh.
import tseslint from "typescript-eslint";
export default [
{
files: ["src/**/*.ts", "test/**/*.ts"],
languageOptions: { parser: tseslint.parser },
plugins: { "@typescript-eslint": tseslint.plugin },
rules: {
"no-restricted-syntax": [
"error",
{ selector: "TSInterfaceDeclaration", message: "Use `type`, never `interface` (project convention)." },
{ selector: "TSEnumDeclaration", message: "Use a const object or a union type, never `enum` (project convention)." },
],
"@typescript-eslint/no-explicit-any": "error",
},
},
{
files: ["src/domain/**/*.ts"],
rules: { "no-restricted-imports": ["error", { patterns: [
{ group: ["node:fs", "node:http", "fs", "http"], message: "src/domain has no I/O." },
{ group: ["../store/*", "../http/*", "**/store/*", "**/http/*"], message: "src/domain imports nothing from store or http." },
] }] },
},
{
files: ["src/http/handlers/**/*.ts"],
rules: { "no-restricted-imports": ["error", { patterns: [
{ group: ["../../store/*", "**/store/*"], message: "Handlers reach the store through the app context only." },
] }] },
},
];
Die Worte der Konventionen stehen in einer pfadbezogenen Rules-Datei. Sie wird nur geladen, wenn Claude src/domain/ anfasst. Halte den YAML-Header gültig, sonst wird die Regel überall geladen. Leg sie in .claude/rules/domain.md ab.
domain.md
---
paths:
- "src/domain/**"
---
# src/domain: pure functions, nothing else
- No I/O here: no `node:fs`, no `node:http`, nothing from `src/store/` or `src/http/`.
- `type`, never `interface`; const objects or union types, never `enum`; no `any`.
- Money is an integer number of cents; reuse `money.ts` (`assertCents`, `formatCents`, `sum`) instead of writing a new helper.
- One new file needs a reason the task gives. No class, factory or generic helper for one caller.
These conventions are checked by ESLint on every edit (`.claude/hooks/lint-edit.sh`).
Regel 4, fertig heißt, die Checks sind bestanden. Ein Stop-Hook mit dem Guard stop_hook_active. Er führt Typecheck und Tests aus, vergleicht die Zahl der bestandenen Tests mit .claude/test-baseline und beendet sich mit Code 2 und der fehlschlagenden Ausgabe, solange etwas rot ist oder ein Test verschwunden ist. Leg ihn in .claude/hooks/done-check.sh ab.
done-check.sh
#!/usr/bin/env bash
# Stop hook. Rule 4: done means the checks passed.
# Refuses the end of the turn while typecheck or tests are red, or while the test
# count dropped under the baseline (a suite made green by deleting tests is red).
set -u
INPUT=$(cat)
# Guard: when Claude Code is already continuing because of this hook, let it stop.
[ "$(printf '%s' "$INPUT" | jq -r '.stop_hook_active')" = "true" ] && exit 0
cd "$(printf '%s' "$INPUT" | jq -r '.cwd')" || exit 0
# Nothing changed since the last commit: nothing to check.
[ -z "$(git status --porcelain -- src test 2>/dev/null)" ] && exit 0
LOG=$(mktemp)
if ! pnpm --silent typecheck > "$LOG" 2>&1; then
echo "Rule 4: typecheck fails. Not done yet." 1>&2; tail -30 "$LOG" 1>&2; rm -f "$LOG"; exit 2
fi
if ! pnpm --silent test > "$LOG" 2>&1; then
echo "Rule 4: tests fail. Not done yet." 1>&2; grep -v '^\s*$' "$LOG" | tail -30 1>&2; rm -f "$LOG"; exit 2
fi
BASE=$(cat .claude/test-baseline 2>/dev/null || echo 0)
COUNT=$(grep -oE 'Tests +[0-9]+ passed' "$LOG" | grep -oE '[0-9]+' | head -1)
rm -f "$LOG"
if [ -n "$COUNT" ] && [ "$COUNT" -lt "$BASE" ]; then
echo "Rule 4: $COUNT tests passed, the baseline is $BASE. A test disappeared; restore it." 1>&2; exit 2
fi
exit 0
Das machst du am Montag
- Führe
claude --versionaus und prüfe, dass du auf 2.1.288 oder neuer bist, damit pfadbezogene Rules bei Write und Edit geladen werden s19. - Installiere
eslint,typescript-eslintundjscpdals devDependencies und prüfe, dassjqin deinem PATH liegt. - Kopiere zuerst
done-check.sh, lege.claude/test-baselinemit deiner aktuellen Zahl bestandener Tests an und füge den Stop-Eintrag zu.claude/settings.jsonhinzu. - Füge die Liste
permissions.denymitEdit(...)-Zeilen für deine Compiler-Konfiguration, Test-Konfiguration, Lint-Konfiguration und.claude/**hinzu. Schreib keineWrite(...)-Zeilen. - Kopiere
eslint.config.js, führenpx eslint srcauf dem unberührten Repo aus und behebe oder lege alles als Baseline fest, bevor du den Hook anschließt. - Führe
npx jscpd src --min-lines 4 --min-tokens 30aus, schreibe die Klon-Anzahl nach.claude/jscpd-baselineund füge dannno-clone.shundnew-file-ask.shhinzu. - Kopiere
domain.mdnach.claude/rules/, passe den Pfad an deine eigenen Ordner an und prüfe, dass sich der YAML-Header parsen lässt. - Spiele die Geste nach, für die jede Regel geschrieben wurde, und lies die Ablehnung. Ändere dann eine Datei von Hand, um zu beweisen, dass eine Regel anspringt.
Messungen
Unser Lauf: eine kleine TypeScript-Rechnungs-API mit 34 Tests, Claude Code 2.1.294, Opus 5.5, Auto-Modus, 2026-11-07. Klone gezählt mit jscpd bei --min-lines 4 --min-tokens 30.
| Setup | Gegebene Features | Von jscpd gefundene Klone | Bestandene Tests | Was ansprang |
|---|---|---|---|---|
| Regeln als Prosa in CLAUDE.md | A: Gutschriften (1 min 21 s) | 0 | 45 (34 Baseline + 11) | Nichts, was ansprechen konnte. Keine Regel verletzt |
| Keine Regeln geschrieben | B1: wiederkehrende Zeitpläne und CSV-Export (2 min 27 s) | 3 | 47 (34 + 13) | Nichts installiert. 3 neue Module, 14 geänderte Dateien |
| Keine Regeln geschrieben | B2: Stornierungs-Endpunkt und zwei CSV-Exporte (etwa 1 min 30 s) | 3, dieselben | 55 | Nichts installiert. Claude extrahierte src/http/csv.ts und nutzte es wieder |
| Enforcer an, Live-Replay | B1 noch einmal, dann der Enum-Umbau, ein hastiges Umbenennen, das Entfernen eines Hooks und eine tsconfig-Änderung | 0 am Ende | 54 | Klon-Hook einmal (1 Klon, Baseline 0), 3 Abfragen für neue Dateien plus 1 abgelehnte, Lint-Hook nie nötig, Stop-Hook einmal, Deny einmal |
| Enforcer an, mechanischer Test | Von Hand gemachte fehlerhafte Änderungen | 0 auf der Baseline, 1 nach dem Einfügen einer 5-Zeilen-Kopie von formatCents |
33 von 34 nach dem Löschen eines Tests | Klon-Hook, Ask für neue Dateien, Lint-Hook (4 Fehler), Stop-Hook (Build rot, Testzahl unter Baseline) |
Details zum mechanischen Test. Die ESLint-Konfiguration ergab 0 Probleme auf dem unberührten Repo. lint-edit.sh auf einer Datei mit einem node:fs-Import, einem interface, einem enum und einem any meldete 4 Fehler an ihren Zeilen und beendete sich mit 2. Der Klon-Hook meldete domain/money.ts:21 == http/views.ts:5. Ein Pfad unter src/, der nicht existierte, lieferte ask mit der Begründung. Der Stop-Hook sagte "Rule 4: 33 tests passed, the baseline is 34. A test disappeared; restore it." Eine umgeschriebene Beinahe-Kopie wurde von jscpd nicht gefunden.
Weiterführend
Was wir aus den fünf herausgehalten haben und wohin es jeweils gehört.
Git-Hooks und Lefthook. Ein Git-Hook oder ein Pipeline-Gate ist ein gültiger Ort für dieselben Checks. Er läuft beim Commit, nicht während Claude Änderungen macht, das Feedback kommt also später. Das ist ein anderes Setup als dieses Pack. Wenn deine Suite Minuten braucht, lass den schnellen Teil im Stop-Hook und verschiebe den Rest in deine Pipeline.
Prompt-Hooks auf Agentenebene. Hooks, die ein Modell eine Änderung beurteilen lassen, sind nicht deterministisch und gehören deshalb nicht zu den fünf. Eine Regel, die du mit einem Befehl prüfen kannst, gehört in ein Skript.
Review-Befehle. /simplify und /code-review sind manuell. Sie sind nützlich, aber das Review bleibt deins, und keiner von beiden ist Durchsetzung.
Zahlen aus Vendor-Berichten zu Vorfällen. Berichte von Anbietern zu Vorfallraten pro Pull Request sind ein Korrelationssignal, nicht spezifisch für Claude Code und nicht an unserem Code gemessen. Wir haben sie nicht genutzt. Jede Zahl in diesem Pack stammt aus den oben verlinkten Quellen oder aus unserem eigenen Lauf.
Ein fertiges Regelwerk. Das anti-slop-Repo ist ein vendored Oxlint-Regelwerk mit 18 generischen Regeln und 5 Effect-Regeln. Es ist zum Vendoring gedacht, ohne offizielles npm-Paket s10. Es ist ein gutes Vorbild für eine Regel: ein Lint-Fehler an der genauen Zeile, bei jedem Lauf.
Prosa-Regeln. Sammlungen von CLAUDE.md-Regeln sind nützlich für die Worte einer Konvention. Halte sie in pfadbezogenen Rules-Dateien und lass einen Check die Garantie tragen.
FAQ
Stoppt eine Deny-Regel ein Python-Skript, das die Datei schreibt? Nein. Deny-Regeln decken kein Python- oder Node-Skript ab, das Dateien selbst öffnet s4. Wer die Schlüssel hat, kann die Datei weiterhin von Hand bearbeiten. Die Deny-Liste stoppt die eingebauten Bearbeitungs-Tools des Agenten und die naheliegenden Abkürzungen.
Warum blockiert mein Stop-Hook nie?
Prüfe zuerst den Exit-Code. Blockieren braucht Exit 2 mit dem Grund auf stderr. Ein Skript, das mit cat und Exit 0 endet, blockiert nie s8. Prüfe dann den Guard: Ist stop_hook_active true, sollte der Hook mit 0 enden. Die Obergrenze beendet den Zug außerdem nach 8 aufeinanderfolgenden Blockaden s3.
Fängt der Matcher Edit|Write Bash-Änderungen ab?
Nein. Er greift nur bei den Tools Edit und Write, nicht bei Bash s18. Seit 2.1.269 kann ein Diff der Dateien, die ein Bash-Befehl geändert hat, hinter bashEditDiffEnabled zum Ergebnis des Bash-Tools hinzugefügt werden s19. Unser Stop-Hook fängt das Ergebnis trotzdem ab, weil er am Ende des Zugs Typecheck und Tests ausführt.
Was ist mit Dateien, die per Shell-Befehl angelegt werden?
Eine so angelegte Datei ist kein Write-Tool-Aufruf, also sieht der Hook für neue Dateien sie nie. Füge einen Bash-Matcher hinzu, wenn du das überwachen willst, oder prüfe am Ende des Zugs git status.
Macht der Hook die Änderung rückgängig? Nein. Ein PostToolUse-Hook läuft nach dem Tool, das bereits gelaufen ist. Er zeigt Claude mit Exit 2 den stderr s3. Claude korrigiert dann die Datei. Nur der PreToolUse-Hook und die Deny-Liste stoppen eine Aktion, bevor sie passiert.
AIDive