Skip to main content
Version: 0.11.1

CC-AG-011: Invalid Hooks in Agent Frontmatter

Summary​

  • Rule ID: CC-AG-011
  • Severity: HIGH
  • Category: Claude Agents
  • Normative Level: MUST
  • Auto-Fix: No
  • 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​

---
name: my-agent
description: Agent with invalid hooks
hooks:
  InvalidEvent:
    - matcher: Bash
      hooks:
        - type: command
          command: echo ok
---
Agent instructions.

Valid​

---
name: my-agent
description: Agent with valid hooks
hooks:
  PreToolUse:
    - matcher: Bash
      hooks:
        - type: command
          command: echo ok
---
Agent instructions.