understand-hooks

name	understand-hooks
description	WHAT: Claude Code hooks — 29 events, 5 handler types, metahook pattern WHEN: Understanding or creating hooks

Understand Hooks

Pure Claude Code hooks — no external systems.

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

What's Here

• The 29 hook events across 8 categories
• 5 hook handler types (command, http, mcp_tool, prompt, agent)
• Skill/agent-scoped hooks
• The metahook pattern (state across hooks)
• Architecture enforcement
• Exit code 2 blocking behavior

Read reference.md for full details.