Hooks Automation

Behavioral Classification

Type: Autonomous Execution

This skill provides hooks that execute automatically in response to Claude Code operations. No interactive decisions required.

Trigger Points:

• Pre-operation: Validates and prepares before edits, commands, tasks
• Post-operation: Formats, analyzes, and trains after operations
• Session: Manages state across sessions
• MCP: Coordinates with swarm agents

Overview

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

Key Capabilities:

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

Quick Start

Initialize Hooks System

# Initialize with default hooks configuration
npx claude-flow init --hooks

This creates:

• .claude/settings.json with pre-configured hooks
• Hook command documentation in .claude/commands/hooks/
• Default hook handlers for common operations

Basic Hook Usage

# 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

Sub-Documentation

For detailed information, see the following files:

Available Hooks

Pre-Operation Hooks

Post-Operation Hooks

Session Hooks

MCP Integration Hooks

Quick Reference

Most Common Commands

# Pre-task preparation
npx claude-flow hook pre-task --description "Task description"

# Post-edit with memory storage
npx claude-flow hook post-edit --file "path/to/file" --memory-key "key"

# Session management
npx claude-flow hook session-start --session-id "my-session"
npx claude-flow hook session-end --session-id "my-session" --export-metrics

# Notifications
npx claude-flow hook notify --message "Task completed" --broadcast

Hook Response Format

{
  "continue": true,
  "reason": "All validations passed",
  "metadata": {
    "agent_assigned": "backend-dev",
    "syntax_valid": true
  }
}

Benefits

• Automatic Agent Assignment: Right agent for every file type
• Consistent Code Formatting: Language-specific formatters
• Continuous Learning: Neural patterns improve over time
• Cross-Session Memory: Context persists between sessions
• Performance Tracking: Comprehensive metrics and analytics
• Quality Gates: Pre-commit validation and verification

Performance Tips

1. Keep Hooks Lightweight - Target < 100ms execution time
2. Use Async for Heavy Operations - Don't block the main flow
3. Cache Aggressively - Store frequently accessed data
4. Batch Related Operations - Combine multiple actions
5. Use Memory Wisely - Set appropriate TTLs

Related Skills

• sparc-methodology - Hooks enhance SPARC workflows
• pair-programming - Automated quality in pairing sessions
• verification-quality - Truth-score validation in hooks
• swarm-advanced - Multi-agent coordination via hooks

Version: 2.0.0 Last Updated: 2025-01-24