[DOCS] Missing documentation for 'EnterPlanMode' tool

Resolved 💬 3 comments Opened Dec 29, 2025 by coygeek Closed Feb 28, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

docs/en/settings docs/en/agent-sdk/typescript docs/en/agent-sdk/python

Section/Topic

"Tools available to Claude" table and SDK "Tool Input/Output Types"

Current Documentation

Currently, the Settings > Tools available to Claude table lists ExitPlanMode:

ExitPlanMode | Prompts the user to exit plan mode and start coding | Yes

However, there is no corresponding entry for EnterPlanMode.

Similarly, in the Agent SDK Reference (TypeScript & Python), the ExitPlanModeInput and ExitPlanModeOutput types are documented, but the types for entering plan mode are absent.

What's Wrong or Missing?

The EnterPlanMode tool is actively used by the model to initiate the planning phase and the Plan subagent (as evidenced by session logs), but it is completely missing from the documentation.

This creates confusion for:

  1. SDK Developers: Who need to know the schema for all tools the model might invoke.
  2. Permission Configuration: Users configuring allow or deny lists in settings.json might not know the exact tool name to target if they want to explicitly allow/block entering plan mode.
  3. Consistency: It is inconsistent to document the "Exit" tool but not the "Enter" tool.

Suggested Improvement

  1. Update docs/en/settings:

Add EnterPlanMode to the "Tools available to Claude" table.

  • Name: EnterPlanMode
  • Description: Initiates the planning phase and activates the Plan subagent.
  • Permission Required: Yes
  1. Update docs/en/agent-sdk/*:

Add EnterPlanMode input/output type definitions to the TypeScript and Python SDK references.

Impact

High - Prevents users from using a feature

Additional Context

The tool is clearly active in the current version of Claude Code. When a user prompts the model to "use the EnterPlanMode tool," the model successfully invokes it, but developers have no reference for its schema or existence in the official docs.

View original on GitHub ↗

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