pixelheros/.claude/docs/hooks-reference.md

Active Hooks

Hooks are configured in .claude/settings.json and fire automatically:

Hook	Event	Trigger	Action
validate-commit.sh	PreToolUse (Bash)	git commit commands	Validates design doc sections, JSON data files, hardcoded values, TODO format
validate-push.sh	PreToolUse (Bash)	git push commands	Warns on pushes to protected branches (develop/main)
validate-assets.sh	PostToolUse (Write/Edit)	Asset file changes	Checks naming conventions and JSON validity for files in assets/
session-start.sh	SessionStart	Session begins	Loads sprint context, milestone, git activity; detects and previews active session state file for recovery
detect-gaps.sh	SessionStart	Session begins	Detects fresh projects (suggests /start) and missing documentation when code/prototypes exist, suggests /reverse-document or /project-stage-detect
pre-compact.sh	PreCompact	Context compression	Dumps session state (active.md, modified files, WIP design docs) into conversation before compaction so it survives summarization
post-compact.sh	PostCompact	After compaction	Reminds Claude to restore session state from active.md checkpoint
notify.sh	Notification	Notification event	Shows Windows toast notification via PowerShell
session-stop.sh	Stop	Session ends	Summarizes accomplishments and updates session log
log-agent.sh	SubagentStart	Agent spawned	Audit trail start — logs subagent invocation with timestamp
log-agent-stop.sh	SubagentStop	Agent stops	Audit trail stop — completes subagent record
validate-skill-change.sh	PostToolUse (Write/Edit)	Skill file changes	Advises running /skill-test after any .claude/skills/ file is written or edited

Hook reference documentation: .claude/docs/hooks-reference/ Hook input schema documentation: .claude/docs/hooks-reference/hook-input-schemas.md