[DOCS] Hooks docs missing `TaskCreated` hook event documentation

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/hooks

Section/Topic

Hook lifecycle event table and the task-related event reference entries (TaskCompleted exists, but TaskCreated does not).

Current Documentation

The hooks reference currently lists task-related lifecycle events as:

| TeammateIdle | When an agent team teammate is about to go idle | | TaskCompleted | When a task is being marked as completed | | InstructionsLoaded | When a CLAUDE.md or .claude/rules/*.md file is loaded into context. Fires at session start and when files are lazily loaded during a session |

Later on the same page, the only task-specific hook reference section is:

### TaskCompleted Runs when a task is being marked as completed. This fires in two situations: when any agent explicitly marks a task as completed through the TaskUpdate tool, or when an agent team teammate finishes its turn with in-progress tasks.

The hooks guide repeats the lifecycle table without any TaskCreated row:

| TeammateIdle | When an agent team teammate is about to go idle | | TaskCompleted | When a task is being marked as completed | | InstructionsLoaded | When a CLAUDE.md or .claude/rules/*.md file is loaded into context. Fires at session start and when files are lazily loaded during a session |

The plugins reference also says:

Plugin hooks respond to the same lifecycle events as user-defined hooks: | TaskCompleted | When a task is being marked as completed |

No documentation currently exists for the new TaskCreated hook event.

What's Wrong or Missing?

Claude Code v2.1.84 added a new hook event: TaskCreated, which fires when a task is created via TaskCreate.

The current docs do not document that event anywhere in the hook reference or the duplicated lifecycle-event tables. As a result:

• Users cannot reliably discover that a hook can run at task-creation time unless they happen to read the changelog.
• The hooks reference has no TaskCreated section explaining when it fires, what input it receives, whether matchers are supported, or what output/decision behavior applies.
• The hooks guide and plugins reference both present lifecycle-event inventories that are already incomplete for v2.1.84.

Suggested Improvement

Add TaskCreated everywhere the docs enumerate hook lifecycle events, with wording consistent with the changelog:

| TaskCreated | When a task is created via TaskCreate |

On the main hooks reference page, also add a dedicated ### TaskCreated section parallel to TaskCompleted that documents:

• when the event fires
• its input schema
• whether matchers are supported
• any supported output / decision-control behavior

Update the duplicated event tables in the Hooks Guide and Plugins reference so they stay aligned with the main hooks reference.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/hooks | Primary hook reference: lifecycle table and per-event reference section are missing TaskCreated |
| https://code.claude.com/docs/en/hooks-guide | Guide-level lifecycle event table omits TaskCreated |
| https://code.claude.com/docs/en/plugins-reference | Plugin hooks event table omits TaskCreated while claiming to list the same lifecycle events as user-defined hooks |

Total scope: 3 pages affected

Source: Changelog v2.1.84

Added TaskCreated hook that fires when a task is created via TaskCreate