[DOCS] Hooks reference is missing the `InstructionsLoaded` hook event

Resolved 💬 3 comments Opened Mar 4, 2026 by coygeek Closed Mar 7, 2026

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:

  1. Trigger semantics (which files, when it fires, and frequency).
  2. Input payload schema and example JSON.
  3. Decision/output behavior (if any).
  4. 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 InstructionsLoaded hook event that fires when CLAUDE.md or .claude/rules/*.md files are loaded into context.

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗