[DOCS] Documentation Error: Incorrect description for `SubagentStart` hook event
Documentation Type
Unclear/confusing documentation
Documentation Location
https://code.claude.com/docs/en/hooks
Section/Topic
The "Hook Events" section, specifically the entry for SubagentStart (often found just before SubagentStop).
Current Documentation
SubagentStart Runs when a Claude Code subagent (Task tool call) has finished responding.
What's Wrong or Missing?
The description for SubagentStart appears to be a copy-paste error from the SubagentStop event. It incorrectly states that the event fires when the subagent has finished responding. Since this is a "Start" event, it should fire when the subagent begins or is spawned.
Suggested Improvement
Update the description to reflect the start of the lifecycle.
Suggested text:
SubagentStart Runs when a Claude Code subagent (Task tool call) is spawned or begins execution.
Impact
High - Prevents users from using a feature
Additional Context
This mirrors the correct behavior described in the "Input" section for SubagentStart later in the same document, which correctly identifies fields like agent_type. Correcting this summary will prevent confusion regarding the event lifecycle.
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗