Hooks Management

Goal: Create, update or troubleshoot Claude Code hook scripts

Workflow

• Read hook documentation from .claude/skills/hooks-management/references/hooks.md
• Read hook input patterns from .claude/skills/hooks-management/references/input-patterns.md
• Review existing hooks in .claude/hooks/ and settings in .claude/settings.local.json
• Create or update the hook script following the input patterns
• Troubleshoot the hook script if needed
• Verify hook execution using echo to pipe JSON input
• Review for security and performance issues
• Provide report to main agent

Rules

• NEVER hardcode credentials or modify critical system files
• NEVER write hooks that can cause infinite loops
• NEVER bypass security validations
• DO NOT use multiline comments in hook scripts. Only use single line comments.
• MUST include proper error handling
• MUST prefer readability over performance
• MUST prefer Python over shell scripts
• MUST write semantic and idiomatic code

Acceptance Criteria

• Hook executes successfully on target event
• Hook handles invalid/malformed input gracefully
• No security vulnerabilities
• Hook follows dispatcher pattern (for new hook logic)