git:20260507.8dfdcb4 to git:20260507.9f5be95

---

name: hook-management

description: Session-scoped hook lifecycle management with enable/disable/status controls, execution profiling, and color-coded performance alerts.

allowed-tools: Read, Bash, Grep, Glob

graph:

domains: [domain:software-engineering]

skillAreas: [skill-area:agentic-loops, skill-area:orchestration-loop]

workflows: [workflow:feature-development]

topics: [topic:developer-experience]

roles: [role:tech-lead, role:backend-engineer]

- **file-guard**: Blocks sensitive file access (195+ patterns)

### PostToolUse Hooks

- **typecheck-changed**: Type checking on modified files

- **lint-changed**: Linting on modified files

- **test-changed**: Testing related to modified files

- **check-comment-replacement**: Detects code replaced with comments

- **check-unused-parameters**: Detects unused function parameters

### UserPromptSubmit Hooks

- **codebase-map**: Invisible project context injection

- **thinking-level**: Reasoning enhancement (4 levels)

### Stop/SubagentStop Hooks

- **create-checkpoint**: Git-backed state snapshot

- **typecheck-project**: Full project type checking

- **lint-project**: Full project linting

- **test-project**: Full test suite execution

- **self-review**: Comprehensive change review

## Session Isolation

All hook changes are session-scoped. Disabling a hook only affects the current session and does not persist.

## Profiling

- Red alert: execution time > 5s

- Yellow warning: execution time > 3s

- Green: execution time < 3s

- Output size monitoring: flag > 10KB

## Commands

- `/hook:enable [hookName]` -- Enable a disabled hook

- `/hook:disable [hookName]` -- Disable a hook for this session

- `/hook:status` -- Show all hook states and profiling data

## When to Use

- When a hook is causing issues during a session

- To check performance of hook executions

- To temporarily bypass a hook for a specific operation

## Processes Used By

- `claudekit-orchestrator` (hook pipeline setup)

- `claudekit-safety-pipeline` (hook profiling)