hook-authoring

## Table of Contents - [Overview](#overview) - [Key Capabilities](#key-capabilities) - [Quick Start](#quick-start) - [Your First Hook (JSON - Claude Code)](#your-first-hook-json-claude-code) - [Your First Hook (Python - Claude Agent SDK)](#your-first-hook-python-claude-agent-sdk) - [Hook Event Types](#hook-event-types) - [Claude Code vs SDK](#claude-code-vs-sdk) - [JSON Hooks (Claude Code)](#json-hooks-claude-code) - [Python SDK Hooks](#python-sdk-hooks) - [Security Essentials](#security-essentials) - [Critical Security Rules](#critical-security-rules) - [Example: Secure Logging Hook](#example-secure-logging-hook) - [Performance Guidelines](#performance-guidelines) - [Performance Best Practices](#performance-best-practices) - [Example: Efficient Hook](#example-efficient-hook) - [Scope Selection](#scope-selection) - [Decision Framework](#decision-framework) - [Scope Comparison](#scope-comparison) - [Common Patterns](#common-patterns) - [Validation Hook](#validation-hook) - [Logging Hook](#logging-hook) - [Context Injection Hook](#context-injection-hook) - [Testing Hooks](#testing-hooks) - [Unit Testing](#unit-testing) - [Module References](#module-references) - [Tools](#tools) - [Related Skills](#related-skills) - [Next Steps](#next-steps) - [References](#references) # Hook Authoring Guide ## Overview Hooks are event interceptors that allow you to extend Claude Code and Claude Agent SDK behavior by executing custom logic at specific points in the agent lifecycle. They ena...