create-hook

Create Hook Command

Creates new hooks through a structured workflow: iron-law → brainstorm → design → scaffold → validate. Uses Socratic questioning to refine rough ideas into well-designed, secure hooks before generating any files.

When To Use

Use this command when you need to:

• Creating a new hook from scratch
• Need security-first design guidance
• Want structured workflow for hook development with Socratic questioning

When NOT To Use

Avoid this command if:

• Evaluating existing hooks - use /hooks-eval instead
• Deciding where to place hooks - use hook-scope-guide skill
• Validating hook security - use /validate-hook instead

Usage

# Start with brainstorming (recommended)
/create-hook "detect when user shares sensitive files"

# Skip brainstorming if design is clear
/create-hook secret-detector --skip-brainstorm --event PreToolUse

# Create in specific plugin
/create-hook "auto-format on save" --plugin sanctum --event PostToolUse

Hook Event Types

Event	When It Fires	Common Use Cases
UserPromptSubmit	User submits a prompt	Input validation, context injection
PreToolUse	Before tool execution	Security checks, blocking dangerous ops
PostToolUse	After tool completes	Logging, post-processing, notifications
Notification	Claude sends notification	Custom alerts, sound effects
Stop	Session/task ends	Cleanup, summaries, checkpoints
SubagentStop	Subagent completes	Aggregation, reporting
TeammateIdle	Teammate agent becomes idle	Work assignment, load balancing
TaskCompleted	Task finishes execution	Coordination, chaining, reporting
PreCompact	Before context compaction	Backup, preservation
SessionStart	Session begins	Context loading, initialization

Workflow

Phase -1: Iron Law Interlock (Blocking)

This phase is required and cannot be skipped.

Quick Reference

1. Create test file FIRST: tests/hooks/test_${hook_name}.py
2. Write structural tests: Hook file exists, valid JSON/Python, registered correctly
3. Run tests - capture RED state:

   pytest tests/hooks/test_${hook_name}.py -v
   # Expected: FAILED (hook does not exist)
   

4. Capture evidence:

   [E1] Command: pytest tests/hooks/test_${hook_name}.py -v
   Output: FAILED - FileNotFoundError
   Status: RED - Interlock satisfied