CC-HK-018: Matcher on UserPromptSubmit/Stop - Claude Hooks

Summary

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

Applicability

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

Evidence Sources

• https://code.claude.com/docs/en/hooks

Test Coverage Metadata

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

Examples

The following examples are illustrative snippets for this rule category.

Invalid

{
  "hooks": [
    {
      "event": "PreToolUse",
      "matcher": "*"
    }
  ]
}

Valid

{
  "hooks": [
    {
      "event": "PreToolUse",
      "matcher": "Write",
      "command": "./scripts/validate.sh",
      "timeout": 30
    }
  ]
}