[DOCS] Contradictory statements about Prompt-based hooks supported events

Documentation Type

Unclear/confusing documentation

Documentation Location

https://code.claude.com/docs/en/hooks#prompt-based-hooks

Section/Topic

Prompt-Based Hooks

Current Documentation

The Hooks reference page contains contradictory statements about Prompt-based hooks support:

• Statement 1 (in "Prompt-Based Hooks" section):

"Prompt-based hooks are currently only supported for Stop and SubagentStop hooks, where they enable intelligent, context-aware decisions."

• Statement 2 (in "Supported hook events" subsection):

"Prompt-based hooks work with any hook event, but are most useful for: - Stop - SubagentStop - UserPromptSubmit - PreToolUse - PermissionRequest"

What's Wrong or Missing?

These two statements contradict each other:

• The first statement says Prompt-based hooks are "currently only supported for Stop and SubagentStop"
• The second statement says they "work with any hook event"

It's unclear which statement is accurate, making it difficult for users to know which hook events actually support Prompt-based hooks.

Suggested Improvement

Clarify the documentation by either:

• If Prompt-based hooks now work with all events: Update the first statement to remove "currently only supported for Stop and SubagentStop hooks"
• If Prompt-based hooks are still limited to Stop/SubagentStop: Update the second statement to reflect this limitation

Impact

Medium - Makes feature difficult to understand

Additional Context

_No response_