[DOCS] Missing Documentation for AskUserQuestion Tool

Documentation Type

Missing documentation (feature not documented)

Documentation Location

The tool is referenced in the internal system prompt (as seen in the provided cc-prompt.md diff) and its addition is noted in the v2.0.21 changelog, but it is completely absent from the public documentation. The documentation is missing from all relevant sections, including: - https://docs.claude.com/en/docs/claude-code/settings#tools-available-to-claude - https://docs.claude.com/en/api/agent-sdk/typescript#tool-input-types - https://docs.claude.com/en/api/agent-sdk/python#tool-inputoutput-types

Section/Topic

• The "Tools available to Claude" table in the Settings documentation. - The "Tool Input Types" and "Tool Output Types" sections in the TypeScript and Python SDK references. A new entry for the AskUserQuestion tool should be added to all these locations.

Current Documentation

The public documentation currently says nothing about this tool. A search for AskUserQuestion across all provided documentation files returns no results.

However, the tool is referenced in the internal system prompt documentation for the ExitPlanMode tool:
```
#### Handling Ambiguity in Plans
Before using this tool, ensure your plan is clear and unambiguous. If there are multiple valid approaches or unclear requirements:

1. Use the AskUserQuestion tool to clarify with the user

...

1. Initial task: "Add a new feature to handle user authentication" - If unsure about auth method (OAuth, JWT, etc.), use AskUser-Question first, then use exit plan mode tool after clarifying the approach.

```

What's Wrong or Missing?

The documentation for the AskUserQuestion tool is completely missing. While the v2.0.21 changelog mentions "Added an interactive question tool" and the system prompt references it, there is no public documentation explaining what the tool is, what its input/output schema is, how it functions, or when it should be used. This makes it impossible for developers using the SDK or trying to understand Claude Code's capabilities to know about or properly interact with this feature.

Suggested Improvement

A new documentation entry for the AskUserQuestion tool should be created and added to the relevant pages.

Suggested entry for the "Tools available to Claude" table:
| Tool | Description | Permission Required |
| :--- | :--- | :--- |
| AskUserQuestion | Asks the user a clarifying question to resolve ambiguity. | No |

Suggested entry for SDK reference pages (TypeScript/Python):

### AskUserQuestion
Tool name: AskUserQuestion

Asks the user a clarifying question to resolve ambiguity before proceeding with a task. This is useful when requirements are unclear, there are multiple valid approaches, or assumptions need to be verified.

Input:
``json
{
"question": "string" // The question to ask the user.
}
``

Output:
``json
{
"answer": "string" // The user's response to the question.
}
``

Impact

High - Prevents users from using a feature

Additional Context

• The v2.0.21 changelog entry confirms the addition of this feature: Added an interactive question tool.
• The reference to AskUserQuestion within the ExitPlanMode tool's instructions strongly implies it is a core part of the planning and clarification workflow. Adding documentation is crucial for developers to understand this interaction pattern.