Source Code

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

Configure hooks during project initialization
Use clear memory key namespaces
Enable auto-formatting for consistency
Train patterns continuously
Monitor hook execution times
Set appropriate timeouts
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

hooks-automation