[DOCS] Contradictory information regarding "Extended Thinking" activation via keywords

Documentation Type

Unclear/confusing documentation

Documentation Location

• https://code.claude.com/docs/en/common-workflows#use-extended-thinking-thinking-mode - https://code.claude.com/docs/en/slash-commands#thinking-mode

Section/Topic

• The "Use extended thinking (thinking mode)" subsection in Common Workflows. - The "Thinking mode" subsection under Custom Slash Commands.

Current Documentation

• Common Workflows section: "Phrases like 'think', 'think hard', 'ultrathink', and 'think more' are interpreted as regular prompt instructions and don't allocate thinking tokens."
• Slash Commands section: "Slash commands can trigger extended thinking by including [extended thinking keywords]."

What's Wrong or Missing?

The documentation explicitly contradicts itself. The "Common Workflows" page states that keywords like "ultrathink" are just regular text and do not trigger the actual technical "Extended Thinking" mode (which requires a token budget allocation). However, the "Slash Commands" documentation states that these commands can trigger the mode using those exact keywords.

This leaves the user unsure if they should use keywords to activate thinking for specific prompts or if they must rely exclusively on the Alt+T toggle and /config settings.

Suggested Improvement

Standardize the explanation of how Thinking Mode is activated. If keyword-based activation has been deprecated in favor of the session toggle (Alt+T) and the MAX_THINKING_TOKENS environment variable, the reference to "extended thinking keywords" should be removed from the Slash Commands section.

Suggested text for Slash Commands:
"Slash commands follow the session-wide thinking setting. To use extended thinking with a slash command, ensure thinking mode is toggled on (Alt+T) before invoking the command."

Suggested text for Common Workflows:
Keep the note that keywords are "regular prompt instructions," but clarify that the model might simulate thinking in text without using actual thinking tokens unless the mode is enabled via the UI/Config.

Impact

High - Prevents users from using a feature

Additional Context

• Related Links:
• Common Workflows - Extended Thinking
• Slash Commands - Thinking Mode
• Historical Context: Earlier versions of the tool (v0.2.44) explicitly encouraged using "think" or "ultrathink" to trigger the mode. The documentation seems to have been partially updated to reflect the new toggle-based system but contains "ghost" instructions from the previous keyword-based implementation.