rules/hooks.md

# Hooks System

## Hook Types

- **PreToolUse**: Before tool execution (validation, parameter modification)
- **PostToolUse**: After tool execution (auto-format, checks)
- **Stop**: When session ends (final verification)

## Current Hooks (in ~/.claude/settings.json)

### PreToolUse
- **tmux reminder**: Suggests tmux for long-running commands (npm, pnpm, yarn, cargo, etc.)
- **git push review**: Opens Zed for review before push
- **doc blocker**: Blocks creation of unnecessary .md/.txt files

### PostToolUse
- **PR creation**: Logs PR URL and GitHub Actions status
- **Prettier**: Auto-formats JS/TS files after edit
- **TypeScript check**: Runs tsc after editing .ts/.tsx files
- **console.log warning**: Warns about console.log in edited files

### Stop
- **console.log audit**: Checks all modified files for console.log before session ends

## Auto-Accept Permissions

Use with caution:
- Enable for trusted, well-defined plans
- Disable for exploratory work
- Never use dangerously-skip-permissions flag
- Configure `allowedTools` in `~/.claude.json` instead

## TodoWrite Best Practices

Use TodoWrite tool to:
- Track progress on multi-step tasks
- Verify understanding of instructions
- Enable real-time steering
- Show granular implementation steps

Todo list reveals:
- Out of order steps
- Missing items
- Extra unnecessary items
- Wrong granularity
- Misinterpreted requirements
Initial release: Complete Claude Code configuration collection Battle-tested configs from 10+ months of daily Claude Code usage. Won Anthropic x Forum Ventures hackathon building zenith.chat. Includes: - 9 specialized agents (planner, architect, tdd-guide, code-reviewer, etc.) - 9 slash commands (tdd, plan, e2e, code-review, etc.) - 8 rule files (security, coding-style, testing, git-workflow, etc.) - 7 skills (coding-standards, backend-patterns, frontend-patterns, etc.) - Hooks configuration (PreToolUse, PostToolUse, Stop) - MCP server configurations (15 servers) - Plugin/marketplace documentation - Example configs (project CLAUDE.md, user CLAUDE.md, statusline) Read the full guide: https://x.com/affaanmustafa/status/2012378465664745795 2026-01-17 17:49:33 -08:00			`# Hooks System`

			`## Hook Types`

			`- PreToolUse: Before tool execution (validation, parameter modification)`
			`- PostToolUse: After tool execution (auto-format, checks)`
			`- Stop: When session ends (final verification)`

			`## Current Hooks (in ~/.claude/settings.json)`

			`### PreToolUse`
			`- tmux reminder: Suggests tmux for long-running commands (npm, pnpm, yarn, cargo, etc.)`
			`- git push review: Opens Zed for review before push`
			`- doc blocker: Blocks creation of unnecessary .md/.txt files`

			`### PostToolUse`
			`- PR creation: Logs PR URL and GitHub Actions status`
			`- Prettier: Auto-formats JS/TS files after edit`
			`- TypeScript check: Runs tsc after editing .ts/.tsx files`
			`- console.log warning: Warns about console.log in edited files`

			`### Stop`
			`- console.log audit: Checks all modified files for console.log before session ends`

			`## Auto-Accept Permissions`

			`Use with caution:`
			`- Enable for trusted, well-defined plans`
			`- Disable for exploratory work`
			`- Never use dangerously-skip-permissions flag`
			- Configure `allowedTools` in `~/.claude.json` instead

			`## TodoWrite Best Practices`

			`Use TodoWrite tool to:`
			`- Track progress on multi-step tasks`
			`- Verify understanding of instructions`
			`- Enable real-time steering`
			`- Show granular implementation steps`

			`Todo list reveals:`
			`- Out of order steps`
			`- Missing items`
			`- Extra unnecessary items`
			`- Wrong granularity`
			`- Misinterpreted requirements`