[DOCS] Hooks reference is missing the `InstructionsLoaded` hook event
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/hooks
Section/Topic
Hook event catalog and per-event schema documentation.
Current Documentation
The hook event table lists events such as:
ConfigChange,WorktreeCreate,WorktreeRemove,PreCompact,SessionEnd
There is no InstructionsLoaded event in the event list.
What's Wrong or Missing?
Changelog v2.1.64 adds an InstructionsLoaded hook event that fires when CLAUDE.md or .claude/rules/*.md files are loaded into context. This event is absent from the hooks reference, including:
- Event description/trigger timing
- Input JSON schema
- Matcher behavior (if applicable)
- Practical examples
Suggested Improvement
Add a new InstructionsLoaded section under Hook Events with:
- Trigger semantics (which files, when it fires, and frequency).
- Input payload schema and example JSON.
- Decision/output behavior (if any).
- Example automation use cases (audit/logging/policy checks).
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/hooks | 34-45 | Hook event table lacks InstructionsLoaded |
| https://code.claude.com/docs/en/hooks-guide | 1-220 | Hook guide has no section describing InstructionsLoaded behavior |
| https://platform.claude.com/docs/en/agent-sdk/hooks | n/a | Agent SDK cross-reference |
Total scope: 3 pages affected
Source: Changelog v2.1.64
- Added
InstructionsLoadedhook event that fires when CLAUDE.md or.claude/rules/*.mdfiles are loaded into context.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗