hooks-automation

# Hooks Automation Skill Configure intelligent hooks for automated coordination, formatting, and learning. ## Available Hooks ### PreToolUse Hooks Triggered before Claude Code tools execute. ```json { "PreToolUse": [ { "matcher": "Edit|Write|MultiEdit", "hooks": [{ "type": "command", "command": "npx agentic-flow@alpha hooks pre-edit \"$TOOL_INPUT_file_path\"" }] }, { "matcher": "Bash", "hooks": [{ "type": "command", "command": "npx agentic-flow@alpha hooks pre-command \"$TOOL_INPUT_command\"" }] } ] } ``` ### PostToolUse Hooks Triggered after successful tool execution. ```json { "PostToolUse": [ { "matcher": "Edit|Write|MultiEdit", "hooks": [{ "type": "command", "command": "npx agentic-flow@alpha hooks post-edit \"$TOOL_INPUT_file_path\" --success" }] } ] } ``` ### Session Hooks Triggered at session start/end. ```json { "SessionStart": [{ "hooks": [{ "type": "command", "command": "npx agentic-flow@alpha hooks intelligence stats --json" }] }], "SessionEnd": [{ "hooks": [{ "type": "command", "command": "npx agentic-flow@alpha hooks metrics --session --json" }] }] } ``` ## Hook Commands ```bash # Pre-edit: Check for patterns, validate npx agentic-flow@alpha hooks pre-edit "src/api.ts" # Post-edit: Format, learn pattern npx agentic-flow@alpha hooks post-edit "src/api.ts" --success # Pre-command: Validate safety npx agentic-flow@alpha hooks pre-command "npm install" # Post-command: Track result npx agentic-flow@alpha hooks post-command "npm install" # Intelligence routing npx agentic-flow@alpha hooks route "implement OAuth" # Session metrics npx agentic-flow@alpha hooks metrics --session ``` ## Automation Features ### Auto-Agent Assignment Hooks automatically assign specialized agents based on file type: - `.ts`, `.tsx` → TypeScript agent - `.py` → Python agent - `.md` → Documentation agent - `test.*` → Testing agent ### Command Validation Pre-command hooks validate for: - Dangerous patterns (rm -rf, force push) - Permission requirements - Resource limits ### Pattern Learning Post-edit hooks learn: - Code patterns - Successful solutions - Error recovery strategies ### Metrics Tracking Session hooks track: - Token usage - Tool invocations - Success rates - Performance metrics ## Configuration Full hook configuration in `.claude/settings.json`: ```json { "hooks": { "PreToolUse": [...], "PostToolUse": [...], "PostToolUseFailure": [...], "SessionStart": [...], "SessionEnd": [...], "UserPromptSubmit": [...], "Stop": [...] } } ``` ## Best Practices 1. **Keep hooks fast**: <100ms for interactive experience 2. **Use timeout**: Prevent hanging hooks 3. **Handle failures gracefully**: Use `|| true` for optional hooks 4. **Log metrics**: Track for optimization 5. **Test hooks**: Verify before deployment