agent/claude/code/hooks.json

{
  "$schema": "https://claude.ai/schemas/hooks.json",
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/prefer-core.sh"
          }
        ],
        "description": "Block destructive commands (rm -rf, sed -i, xargs rm) and enforce core CLI"
      },
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/block-docs.sh"
          }
        ],
        "description": "Block random .md file creation"
      }
    ],
    "PostToolUse": [
      {
        "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\.go$\"",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/go-format.sh"
          }
        ],
        "description": "Auto-format Go files after edits"
      },
      {
        "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\.php$\"",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/php-format.sh"
          }
        ],
        "description": "Auto-format PHP files after edits"
      },
      {
        "matcher": "tool == \"Edit\"",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/check-debug.sh"
          }
        ],
        "description": "Warn about debug statements (dd, dump, fmt.Println)"
      },
      {
        "matcher": "tool == \"Bash\" && tool_input.command matches \"^git commit\"",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/post-commit-check.sh"
          }
        ],
        "description": "Warn about uncommitted work after git commit"
      }
    ],
    "PreCompact": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/pre-compact.sh"
          }
        ],
        "description": "Save state before auto-compact to prevent amnesia"
      }
    ],
    "SessionStart": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/session-start.sh"
          }
        ],
        "description": "Restore recent session context on startup"
      }
    ]
  }
}