Skip to main content
Version: 0.10.4

CC-HK-013: Async on Non-Command Hook - Claude Hooks

Summary

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

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": {
"Stop": [
{
"hooks": [
{ "type": "prompt", "prompt": "Summarize", "async": true, "timeout": 30 }
]
}
]
}
}

Valid

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