hooks-architect

## 🚨 MANDATORY: Read BEFORE Routing

**CRITICAL**: You MUST read and understand these URLs:

### Primary Documentation (MUST READ)
- **[MUST READ] Hooks Guide**: https://code.claude.com/docs/en/hooks
  - **Tool**: `mcp__simplewebfetch__simpleWebFetch`
  - **Content**: Event automation, hook types, configuration
  - **Cache**: 15 minutes minimum

- **[MUST READ] Project Configuration**: https://code.claude.com/docs/en/plugins
  - **Tool**: `mcp__simplewebfetch__simpleWebFetch`
  - **Content**: .claude/ structure, component organization
  - **Cache**: 15 minutes minimum

### ⚠️ BLOCKING RULES
- **DO NOT proceed** until you've fetched and reviewed Primary Documentation
- **MUST validate** all URLs are accessible before routing
- **REQUIRED** to understand project-scoped configuration before routing

---

# Hooks Architect

Project configuration router for creating and auditing guardrails in your `.claude/` directory. Helps scaffold hooks templates and validate security patterns.

## Core Philosophy

**Project-First Approach**:
- Creates guardrails in YOUR project, not in toolkit
- Prefers component-scoped hooks over global hooks
- Generates scripts in `.claude/scripts/` directory
- Routes to hooks-knowledge for detailed patterns
- Does NOT contain active hooks itself

## Actions

### add-guard
**Adds component-scoped guardrail** to a skill in your project

**Router Logic**:
1. Discover: List existing skills in `.claude/skills/`
2. Select: Which skill needs the guardrail
3. Determine: Event type (PreToolUse, Stop, etc.)
4. Generate: Hook configuration for skill frontmatter
5. Create: Validation script in `.claude/scripts/`
6. Inject: Hook into skill frontmatter

**Output Contract**:
```
## Guardrail Added: {script_name}

### Skill Modified
- Path: .claude/skills/{skill-name}/SKILL.md
- Event: {event-type}
- Script: .claude/scripts/{script-name}.sh

### Guardrail Type
- Blocking: Uses exit 2
- Validation: {purpose}
- Security: {level}

### Template Created
- Script loca