How disler/claude-code-hooks-mastery works
This repository is a Claude Code hooks and agent-orchestration demonstration. Its primary workflow is a Claude Code lifecycle event invoking a hook that can validate or enrich activity, provide feedback, and record event data. The README also describes subagents, team validation, status lines, and output styles. The tree includes a separate Bun task-manager CLI; its command-to-repository and repository-to-SQLite relationships are supported by the sampled source. Hook internals were not sampled, so their links reflect README documentation, not inspected implementations.
Main entry points: repository.ts Task repository · index.ts CLI dispatcher · formatter.ts CLI formatting · add.ts Add task
Components 25
Hook lifecycle
- Lifecycle hooks
.claude/hooks - Prompt control
.claude/hooks/user_prompt_submit.py - Tool safeguards
.claude/hooks/pre_tool_use.py - Post-tool processing
.claude/hooks/post_tool_use.py - Event logging
.claude/hooks
Feedback and context
- Speech feedback
.claude/hooks/utils/tts - Completion messages
.claude/hooks/utils/llm - Session context
.claude/hooks/session_start.py - Status lines
.claude/status_lines - Output styles
.claude/output-styles
Agents and teams
- Research agents
.claude/agents - Builder validator
.claude/agents/team
Task manager CLI
- CLI dispatcher
apps/task-manager/src/index.ts - Add task
apps/task-manager/src/commands/add.ts - List tasks
apps/task-manager/src/commands/list.ts - Complete task
apps/task-manager/src/commands/complete.ts - Delete task
apps/task-manager/src/commands/delete.ts - Task statistics
apps/task-manager/src/commands/stats.ts - Input validation
apps/task-manager/src/utils/validation.ts - CLI formatting
apps/task-manager/src/utils/formatter.ts
Task data
- Task repository
apps/task-manager/src/db/repository.ts - Database setup
apps/task-manager/src/db/database.ts - Schema migrations
apps/task-manager/src/db/migrations.ts - SQLite task store
Other components
- Claude Code
Connections 37
- Claude Code → Lifecycle hooks: fires events
README.md - Claude Code → Prompt control: submits prompts
README.md - Claude Code → Tool safeguards: checks tools
README.md - Claude Code → Post-tool processing: reports tool result
README.md - Lifecycle hooks → Event logging: logs events
README.md - Prompt control → Claude Code: enhances prompts
README.md - Tool safeguards → Claude Code: blocks unsafe access
README.md - Post-tool processing → Claude Code: extracts transcript
README.md - Claude Code → Speech feedback: triggers speech
README.md - Claude Code → Completion messages: requests completion text
README.md - Claude Code → Session context: starts session
README.md - Claude Code → Status lines: shows status
README.md - Claude Code → Output styles: applies presentation
README.md - Claude Code → Research agents: spawns agents
README.md - Builder validator → Claude Code: validates work
README.md - CLI dispatcher → Add task: dispatches command
apps/task-manager/src/index.ts - CLI dispatcher → List tasks: dispatches command
apps/task-manager/src/index.ts - CLI dispatcher → Complete task: dispatches command
apps/task-manager/src/index.ts - CLI dispatcher → Delete task: dispatches command
apps/task-manager/src/index.ts - CLI dispatcher → Task statistics: dispatches command
apps/task-manager/src/index.ts - Add task → Input validation: validates input
apps/task-manager/src/commands/add.ts - Add task → Task repository: creates task
apps/task-manager/src/commands/add.ts - Add task → CLI formatting: formats output
apps/task-manager/src/commands/add.ts - List tasks → Task repository: fetches tasks
apps/task-manager/src/commands/list.ts - List tasks → CLI formatting: formats output
apps/task-manager/src/commands/list.ts - Complete task → Input validation: validates ID
apps/task-manager/src/commands/complete.ts - Complete task → Task repository: updates task
apps/task-manager/src/commands/complete.ts - Complete task → CLI formatting: formats output
apps/task-manager/src/commands/complete.ts - Delete task → Input validation: validates ID
apps/task-manager/src/commands/delete.ts - Delete task → Task repository: deletes task
apps/task-manager/src/commands/delete.ts - Delete task → CLI formatting: formats output
apps/task-manager/src/commands/delete.ts - Task statistics → Task repository: gets statistics
apps/task-manager/src/commands/stats.ts - Task statistics → CLI formatting: formats output
apps/task-manager/src/commands/stats.ts - Task repository → Database setup: opens connection
apps/task-manager/src/db/repository.ts - Database setup → Schema migrations: runs schema
apps/task-manager/src/db/database.ts - Task repository → SQLite task store: reads and writes
apps/task-manager/src/db/repository.ts - Database setup → SQLite task store: opens database
apps/task-manager/src/db/database.ts