YeonGyu-Kim
797f46be21
- Regenerated root AGENTS.md with overview, structure, and complexity hotspots
- Regenerated all 7 subdirectory AGENTS.md files: hooks, tools, features, agents, cli, auth, shared
- Used 11 background explore agents for comprehensive feature and architecture analysis
- All files within size limits (root: 112 lines, subdirs: 57-68 lines)
- Includes where-to-look guide, conventions, anti-patterns, and agent model information
🤖 Generated with assistance of oh-my-opencode
67 lines
2.9 KiB
Markdown
67 lines
2.9 KiB
Markdown
# HOOKS KNOWLEDGE BASE
|
|
|
|
## OVERVIEW
|
|
|
|
22 lifecycle hooks intercepting/modifying agent behavior. Context injection, error recovery, output control, notifications.
|
|
|
|
## STRUCTURE
|
|
|
|
```
|
|
hooks/
|
|
├── anthropic-context-window-limit-recovery/ # Auto-compact at token limit (554 lines)
|
|
├── auto-slash-command/ # Detect and execute /command patterns
|
|
├── auto-update-checker/ # Version notifications, startup toast
|
|
├── background-notification/ # OS notify on task complete
|
|
├── claude-code-hooks/ # settings.json PreToolUse/PostToolUse/etc
|
|
├── comment-checker/ # Prevent excessive AI comments
|
|
│ └── filters/ # docstring, directive, bdd, etc
|
|
├── compaction-context-injector/ # Preserve context during compaction
|
|
├── directory-agents-injector/ # Auto-inject AGENTS.md
|
|
├── directory-readme-injector/ # Auto-inject README.md
|
|
├── empty-message-sanitizer/ # Sanitize empty messages
|
|
├── interactive-bash-session/ # Tmux session management
|
|
├── keyword-detector/ # ultrawork/search keyword activation
|
|
├── non-interactive-env/ # CI/headless handling
|
|
├── preemptive-compaction/ # Pre-emptive at 85% usage
|
|
├── ralph-loop/ # Self-referential dev loop
|
|
├── rules-injector/ # Conditional rules from .claude/rules/
|
|
├── session-recovery/ # Recover from errors (430 lines)
|
|
├── think-mode/ # Auto-detect thinking triggers
|
|
├── agent-usage-reminder/ # Remind to use specialists
|
|
├── context-window-monitor.ts # Monitor usage (standalone)
|
|
├── session-notification.ts # OS notify on idle
|
|
├── todo-continuation-enforcer.ts # Force TODO completion
|
|
└── tool-output-truncator.ts # Truncate verbose outputs
|
|
```
|
|
|
|
## HOOK EVENTS
|
|
|
|
| Event | Timing | Can Block | Use Case |
|
|
|-------|--------|-----------|----------|
|
|
| PreToolUse | Before tool | Yes | Validate, modify input |
|
|
| PostToolUse | After tool | No | Add context, warnings |
|
|
| UserPromptSubmit | On prompt | Yes | Inject messages, block |
|
|
| Stop | Session idle | No | Inject follow-ups |
|
|
| onSummarize | Compaction | No | Preserve context |
|
|
|
|
## HOW TO ADD
|
|
|
|
1. Create `src/hooks/my-hook/`
|
|
2. Files: `index.ts` (createMyHook), `constants.ts`, `types.ts` (optional)
|
|
3. Return: `{ PreToolUse?, PostToolUse?, UserPromptSubmit?, Stop?, onSummarize? }`
|
|
4. Export from `src/hooks/index.ts`
|
|
|
|
## PATTERNS
|
|
|
|
- **Storage**: JSON file for persistent state across sessions
|
|
- **Once-per-session**: Track injected paths in Set
|
|
- **Message injection**: Return `{ messages: [...] }`
|
|
- **Blocking**: Return `{ blocked: true, message: "..." }` from PreToolUse
|
|
|
|
## ANTI-PATTERNS
|
|
|
|
- Heavy computation in PreToolUse (slows every tool call)
|
|
- Blocking without actionable message
|
|
- Duplicate injection (track what's injected)
|
|
- Missing try/catch (don't crash session)
|