From b1523ea23f5d29511398ee7006f37248f61c04d3 Mon Sep 17 00:00:00 2001
From: Eneko Ruiz <196690101+eneekoruiz@users.noreply.github.com>
Date: Tue, 13 Oct 2026 11:35:45 +0200
Subject: [PATCH] docs: use effort controls in adaptive-thinking workarounds

---
 docs/TROUBLESHOOTING.md      | 2 +-
 docs/hook-bug-workarounds.md | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.md
index 7c23b0a54..175c8e15f 100644
--- a/docs/TROUBLESHOOTING.md
+++ b/docs/TROUBLESHOOTING.md
@@ -62,7 +62,7 @@ exit 2
 **What helps:**
 
 - Reduce tool-definition pressure with `ENABLE_TOOL_SEARCH=auto:5` if your setup supports it.
-- Lower `MAX_THINKING_TOKENS` for routine work.
+- Lower the supported effort level (for example, `/effort low`) for routine work on adaptive-reasoning models; `MAX_THINKING_TOKENS` only caps fixed-budget thinking.
 - Route subagent work to a cheaper model such as `CLAUDE_CODE_SUBAGENT_MODEL=haiku` if your setup exposes that knob.
 - Disable unused MCP servers per project.
 - Compact manually at natural breakpoints instead of waiting for auto-compaction.
diff --git a/docs/hook-bug-workarounds.md b/docs/hook-bug-workarounds.md
index ef1d4fbb1..7746dfa6c 100644
--- a/docs/hook-bug-workarounds.md
+++ b/docs/hook-bug-workarounds.md
@@ -61,7 +61,7 @@ What helps:
 What helps:
 
 - Reduce tool-definition pressure with `ENABLE_TOOL_SEARCH=auto:5` if your setup supports it.
-- Lower `MAX_THINKING_TOKENS` for routine work.
+- Lower the supported effort level (for example, `/effort low`) for routine work on adaptive-reasoning models; `MAX_THINKING_TOKENS` only caps fixed-budget thinking.
 - Route subagent work to a cheaper model such as `CLAUDE_CODE_SUBAGENT_MODEL=haiku` if your setup exposes that knob.
 - Disable unused MCP servers per project.
 - Compact manually at natural breakpoints instead of waiting for auto-compaction.