kbarbel640-del 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 settingsexamples.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.jsonwith 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