[DOCS] Documentation Inconsistency: `SubagentStop` schema missing fields on code.claude.com vs platform.claude.com
Documentation Type
Unclear/confusing documentation
Documentation Location
https://code.claude.com/docs/en/hooks#stop-and-subagentstop-input
Section/Topic
The "Stop and SubagentStop Input" section code example.
Current Documentation
The JSON example provided at code.claude.com for SubagentStop is identical to the one for Stop:
{
"session_id": "abc123",
"transcript_path": "~/.claude/projects/.../00893aaf-19fa-41d2-8238-13269b9b3ca0.jsonl",
"permission_mode": "default",
"hook_event_name": "Stop",
"stop_hook_active": true
}
What's Wrong or Missing?
The CLI documentation (code.claude.com) has not been synced with the SDK documentation (platform.claude.com). While the latter correctly lists agent_id and agent_transcript_path in its tables, the CLI site's reference example omits them entirely. This is confusing for CLI users who rely on the code examples to build their hook scripts.
Suggested Improvement
Separate the Stop and SubagentStop examples on code.claude.com. The SubagentStop example should explicitly show the agent_id and agent_transcript_path fields introduced in v2.0.42.
Impact
High - Prevents users from using a feature
Additional Context
Syncing these examples will ensure that developers working across the CLI and the SDK have a unified understanding of the data available to their hooks.
This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗