Hooks Automation

Intelligent automation system that coordinates, validates, and learns from Claude Code operations through hooks integrated with MCP tools and neural pattern training.

References

• configuration.md - Detailed configuration options and settings
• examples.md - Workflow examples (full-stack, debugging, multi-agent)

Quick Start

# Initialize hooks system
npx claude-flow init --hooks

# Pre-task hook (auto-spawns agents)
npx claude-flow hook pre-task --description "Implement authentication"

# Post-edit hook (auto-formats and stores in memory)
npx claude-flow hook post-edit --file "src/auth.js" --memory-key "auth/login"

# Session end hook (saves state and metrics)
npx claude-flow hook session-end --session-id "dev-session" --export-metrics

Prerequisites

Required:

• Claude Flow CLI (npm install -g claude-flow@alpha)
• Claude Code with hooks enabled
• .claude/settings.json with hook configurations

Optional:

• MCP servers (claude-flow, ruv-swarm, flow-nexus)
• Git repository
• Testing framework

Available Hooks

Pre-Operation Hooks

Hook	Purpose
pre-edit	Validate and assign agents before file modifications
pre-bash	Check command safety and resource requirements
pre-task	Auto-spawn agents and prepare for complex tasks
pre-search	Prepare and optimize search operations

Options:

• --auto-assign-agent - Assign best agent based on file type
• --validate-syntax - Pre-validate syntax
• --backup-file - Create backup before editing
• --check-conflicts - Check for merge conflicts

Post-Operation Hooks

Hook	Purpose
post-edit	Auto-format, validate, and update memory
post-bash	Log execution and update metrics
post-task	Performance analysis and decision storage
post-search	Cache results and improve patterns

Options:

• --auto-format - Language-specific formatting
• --memory-key <key> - Store context in memory
• --train-patterns - Train neural patterns
• --analyze-performance - Generate metrics

Session Hooks

Hook	Purpose
session-start	Initialize new session
session-restore	Load previous session state
session-end	Cleanup and persist state
notify	Custom notifications with swarm status

MCP Integration Hooks

Hook	Purpose
mcp-initialized	Persist swarm configuration
agent-spawned	Update agent roster and memory
task-orchestrated	Monitor task progress
neural-trained	Save pattern improvements

Memory Coordination Hooks

Hook	Purpose
memory-write	Triggered when agents write to memory
memory-read	Triggered when agents read from memory
memory-sync	Synchronize memory across agents

Key Capabilities

• Pre-Operation Hooks: Validate, prepare, auto-assign agents
• Post-Operation Hooks: Format, analyze, train patterns
• Session Management: Persist state, restore context
• Memory Coordination: Sync knowledge across agents
• Git Integration: Automated commit hooks with verification
• Neural Training: Learn from successful patterns

Benefits

• Automatic agent assignment for file types
• Consistent code formatting (Prettier, Black, gofmt)
• Continuous learning via neural patterns
• Cross-session memory persistence
• Performance tracking and metrics
• Smart agent spawning based on task analysis
• Quality gates for pre-commit validation

Best Practices

1. Configure hooks during project initialization
2. Use clear memory key namespaces
3. Enable auto-formatting for consistency
4. Train patterns continuously
5. Monitor hook execution times
6. Set appropriate timeouts
7. Handle errors gracefully with continueOnError

Related Commands

npx claude-flow init --hooks        # Initialize hooks
npx claude-flow hook --list         # List available hooks
npx claude-flow hook --test <hook>  # Test specific hook
npx claude-flow memory usage        # Manage memory
npx claude-flow agent spawn         # Spawn agents

Integration

Works with:

• SPARC Methodology
• Pair Programming
• Verification Quality
• GitHub Workflows
• Performance Analysis
• Swarm Advanced