Stats
Actions
Tags
How this command is triggered — by the user, by Claude, or both
Slash command
/pokayokay:hooks list|history|toggleThe summary Claude sees in its command listing — used to decide when to auto-load this command
# Hook Management
View and manage the yokay hook system.
**Action**: `$ARGUMENTS` (default: list)
## Actions
### list (default)
Show all configured hooks and their status.
### history
Show recent hook execution history.
### toggle
Enable/disable specific hooks for debugging.
yaml
hooks:
pre-commit:
enabled: false # Disable linting for debugging
post-task:
actions:
- sync
# Remove commit to skip auto-commits
## Hook Reference
### Lifecycle Hooks
| Hook | Trigger | Default Actions |
|------|---------|-----------------|
| pre-session | Session start | ve...View and manage the yokay hook system.
Action: $ARGUMENTS (default: list)
Show all configured hooks and their status.
## Active Hooks
| Hook | Enabled | Actions |
|------|---------|---------|
| pre-session | yes | verify-clean |
| pre-task | yes | check-blockers, suggest-skills |
| post-task | yes | sync, commit, detect-spike, capture-knowledge |
| post-story | yes | test, mini-audit, audit-gate |
| post-epic | yes | full-audit, audit-gate |
| on-error | yes | log-error, block-task, recover |
| on-blocker | yes | notify, suggest-next |
| pre-commit | yes | lint |
| post-session | yes | final-sync, summary |
Current mode: supervised
Show recent hook execution history.
## Recent Hook Executions
| Time | Hook | Actions | Status | Duration |
|------|------|---------|--------|----------|
| 10:45 | post-task | sync, commit | success | 0.8s |
| 10:44 | pre-task | check-blockers, suggest-skills | success | 0.3s |
| 10:30 | pre-session | verify-clean | warning | 0.2s |
Enable/disable specific hooks for debugging.
## Toggle Hooks
To temporarily disable a hook, create/update `.yokay/hooks.yaml`:
```yaml
hooks:
pre-commit:
enabled: false # Disable linting for debugging
post-task:
actions:
- sync
# Remove commit to skip auto-commits
Note: Toggle changes are session-scoped unless saved to config.
## Hook Reference
### Lifecycle Hooks
| Hook | Trigger | Default Actions |
|------|---------|-----------------|
| pre-session | Session start | verify-clean |
| pre-task | Task moved to in_progress | check-blockers, suggest-skills |
| post-task | Task marked done | sync, commit, detect-spike, capture-knowledge |
| post-story | All tasks in story done | test, mini-audit, audit-gate |
| post-epic | All stories in epic done | full-audit, audit-gate |
| on-error | Error during task | log-error, block-task, recover |
| on-blocker | Blocker set on task | notify, suggest-next |
| pre-commit | Before git commit | lint |
| post-session | Session ends | final-sync, summary |
### Mode-Specific Behavior
| Hook | Supervised | Semi-Auto | Auto |
|------|-----------|-----------|-----------|
| post-task | sync only | sync, commit | sync, commit, quick-test |
| post-story | — | test, audit | test, audit |
| post-epic | audit | audit | audit |
### New Hook Actions (v1.1)
| Action | Hook | Purpose |
|--------|------|---------|
| suggest-skills | pre-task | Suggest relevant skills based on task content |
| detect-spike | post-task | Detect uncertainty signals, suggest spike conversion |
| capture-knowledge | post-task | Auto-suggest docs for spike/research tasks |
| audit-gate | post-story, post-epic | Check quality thresholds at boundaries |
## Configuration
### Project-Level Override
Create `.yokay/hooks.yaml` in your project:
```yaml
hooks:
post-task:
actions:
- sync
- commit
- my-custom-action # Add custom action
pre-commit:
enabled: false # Disable for this project
| Variable | Description |
|---|---|
| TASK_ID | Current task ID |
| TASK_TITLE | Current task title |
| TASK_TYPE | feature|bug|chore|spike|test|research |
| TASK_NOTES | Notes from task completion |
| STORY_ID | Current story ID |
| EPIC_ID | Current epic ID |
| BOUNDARY_TYPE | story|epic (for audit-gate) |
| SESSION_MODE | supervised|semi-auto|auto |
.claude/settings.json for hooks configuration.claude/hooks.log for details/pokayokay:work - Main work loop using hookshooks/HOOKS.md - Full hook system documentationnpx claudepluginhub srstomp/pokayokay --plugin pokayokay/create-hookCreates and configures Claude Code hooks for events like PreToolUse with matcher and command, including ESLint/Prettier templates. Outputs status and hook file path.
/doctorRuns health check for the great_cto pipeline, reporting missing required files, PROJECT.md format issues, hook status, last run per agent, and permission-denied tails. Optional --fix flag outputs remediation commands.
/create-hookInvokes create-hooks skill to provide expert guidance on developing hooks for Claude Code.
/hookify-configureInteractively toggle hookify rules on or off: lists .claude/hookify.*.local.md files with status, prompts for selection, updates enabled field, and confirms changes.
/new-hookCreates and configures Claude Code hooks from a natural language description, setting up events, matchers, and shell commands for workflow automation, notifications, formatting, and behavior control.
/helpDisplays Hookify documentation: overview, quick start, commands (/hookify, /list, /configure), rule syntax in markdown, event types (bash, file, stop, prompt, all), actions (warn, block), and support links.