Skip to main content
Version: 0.49.0

CC-HK-001: Invalid Hook Event - Claude Hooks

Summary​

  • Rule ID: CC-HK-001
  • Severity: HIGH
  • Category: Claude Hooks
  • Normative Level: MUST
  • Auto-Fix: Yes (safe/unsafe)
  • Verified On: 2026-07-26

Applicability​

  • Tool: claude-code
  • Version Range: unspecified
  • Spec Revision: unspecified

Evidence Sources​

Test Coverage Metadata​

  • Unit tests: true
  • Fixture tests: true
  • E2E tests: false

Examples​

The following examples demonstrate what triggers this rule and how to fix it.

Invalid​

{
  "hooks": {
    "OnBeforeTool": [
      {
        "matcher": "Bash",
        "hooks": [
          { "type": "command", "command": "echo hello", "timeout": 30 }
        ]
      }
    ]
  }
}

Valid​

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          { "type": "command", "command": "echo pre-tool", "timeout": 30 }
        ]
      }
    ]
  }
}