[DOCS] Plan-mode docs still say non-read-only Bash always prompts when auto mode is active

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/permission-modes

Section/Topic

“Analyze before you edit with plan mode,” specifically the interaction between useAutoModeDuringPlan and Bash commands that the static analyzer cannot prove read-only.

Current Documentation

The page currently says:

With auto mode active, the classifier approves read-only commands such as searches and file reads without prompting.

The next paragraph says:

Shell commands outside the built-in read-only set, including file-modifying ones such as touch and rm, prompt for approval in plan mode, including when auto mode is active during planning...

What's Wrong or Missing?

Claude Code 2.1.218 changed plan mode with auto so Bash commands that the static analyzer cannot prove read-only are no longer automatically routed to a permission prompt. The auto-mode classifier judges them instead.

The second paragraph therefore describes the old routing too broadly. Users may expect every command outside the built-in read-only set to pause for manual approval, while the current behavior can make the classifier decision without opening that prompt.

Suggested Improvement

Rewrite the plan-mode paragraph to distinguish the built-in read-only fast path from commands that are merely not provably read-only. Explain that with useAutoModeDuringPlan enabled, the latter are evaluated by the auto-mode classifier, while explicit permissions.ask rules and protected operations can still require approval.

Add a small example showing a Bash command that is not statically provable as read-only and state whether auto mode allows, blocks, or falls back to approval based on the classifier result. Retain the separate explanation that edits remain blocked until the plan is approved.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/permission-modes | Plan mode and auto-mode command routing |
| https://code.claude.com/docs/en/auto-mode-config | Classifier evaluation order and fallback behavior |
| https://code.claude.com/docs/en/permissions | Explicit ask/deny rules that remain outside the classifier path |

Total scope: 3 pages should describe the same plan-mode routing rule.

The behavior was changed in Claude Code v2.1.218.