[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_

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗