[DOCS] Stop hook example doesn't work
Resolved 💬 3 comments Opened Feb 1, 2026 by privacyguy123 Closed Mar 2, 2026
Documentation Type
Incorrect/outdated documentation
Documentation Location
https://code.claude.com/docs/en/hooks#example%3A-multi-criteria-stop-hook
Section/Topic
Hooks
Current Documentation
{
"hooks": {
"Stop": [
{
"hooks": [
{
"type": "prompt",
"prompt": "You are evaluating whether Claude should stop working. Context: $ARGUMENTS\n\nAnalyze the conversation and determine if:\n1. All user-requested tasks are complete\n2. Any errors need to be addressed\n3. Follow-up work is needed\n\nRespond with JSON: {\"ok\": true} to allow stopping, or {\"ok\": false, \"reason\": \"your explanation\"} to continue working.",
"timeout": 30
}
]
}
]
}
}
What's Wrong or Missing?
This example Stop hook in the documentation is literally considered INVALID JSON by Claude Code 2.1.29
● Ran 1 stop hook
⎿ Stop hook error: JSON validation failed
Suggested Improvement
Updated to working example.
Impact
High - Prevents users from using a feature
Additional Context
_No response_
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗