hook-scope-guide
Hook Scope Decision Guide
This skill helps you choose the right location for Claude Code hooks based on their purpose, audience, and persistence needs.
Important: Auto-Loading Behavior
hooks/hooks.jsonis automatically loaded by Claude Code when the plugin is enabled. Do NOT add"hooks": "./hooks/hooks.json"to yourplugin.json- this causes duplicate load errors. Thehooksfield inplugin.jsonis only needed for additional hook files beyond the standardhooks/hooks.json.
The Three Scopes
| Scope | Location | Audience | Committed? | Persistence |
|---|---|---|---|---|
| Plugin | hooks/hooks.json in plugin |
Plugin users | With plugin | When plugin enabled |
| Project | .claude/settings.json |
Team members | Yes (repo) | Per project |
| Global | ~/.claude/settings.json |
Only you | Never | All sessions |
Decision Framework
More from athola/claude-night-market
project-planning
Turn a specification into a phased implementation plan with dependency ordering.
125code-quality-principles
KISS, YAGNI, and SOLID code quality principles for clean code, reducing complexity and preventing over-engineering.
93project-brainstorming
Guide project ideation via Socratic questioning to generate project briefs.
91doc-generator
Generate or remediate documentation with human-quality writing and style.
80rigorous-reasoning
Anti-sycophancy reasoning checklist.
78project-specification
Transform project briefs into testable specifications with user stories, acceptance criteria, and measurable outcomes.
77