[DOCS] Documentation Error: Incorrect description for `SubagentStart` hook event

Resolved 💬 2 comments Opened Jan 23, 2026 by coygeek Closed Feb 7, 2026

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.

View original on GitHub ↗

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