Don’t Make the Model Think Harder Than the Problem

Reasoning Effort Is a Search Budget, Not an Intelligence Slider

Tiny pink-haired Milim sits peacefully on a wooden bench in a vast, sunlit neoclassical drafting cathedral and horology archive, holding a brass magnifying lens amid blueprint tables and suspended brass pendulums.

You ask an AI coding agent to rename a config field. You give it max reasoning. It reads 70 files, investigates an abandoned migration, questions the architecture, considers backward compatibility, and nine minutes later your rename has become a design review.

An hour later, you run the other direction. A production service has a subtle race condition. You give the agent low reasoning. It changes three lines, runs one test, and declares victory. The bug survives.

Same mistake, opposite directions: The amount of thinking didn't match the amount of uncertainty.

That is the single most useful mental model for reasoning effort in autonomous agents.

The goal isn't to make the model think as hard as possible. It is to find the sweet spot: Minimum Sufficient Deliberation.


Search Budget vs. The Intelligence Slider

When reasoning models entered developer tools, most interfaces framed effort as a linear ladder:

nonelowmediumhighxhighmax\text{none} \longrightarrow \text{low} \longrightarrow \text{medium} \longrightarrow \text{high} \longrightarrow \text{xhigh} \longrightarrow \text{max}

The common misconception is that this ladder represents an intelligence slider:

dumb⟷̸genius\text{dumb} \not\longleftrightarrow \text{genius}

A reasoning model does not possess a secret dial for IQ. When you dial up reasoning effort, you are granting the model a larger token budget for search across frozen weights:

little searchdeep search\text{little search} \longleftrightarrow \text{deep search}

Reasoning Effort: A Search Budget, Not an Intelligence SliderA comparison between the flawed misconception of reasoning effort as an intelligence slider from dumb to genius versus the true mental model: reasoning effort as a test-time search budget across effort levels none, low, medium, high, xhigh, and max over frozen weights.REASONING EFFORT: A SEARCH BUDGET, NOT AN INTELLIGENCE SLIDERDeliberation time increases tree exploration depth across frozen weights — not intrinsic model IQ✕ FLAWED MENTAL MODEL"The Intelligence Slider""Dumb" Fast ModeFlawed Premise"Genius" Slow ModeIQ Stays FixedWeights are frozen✓ GROUND-TRUTH REALITYReasoning Effort = Test-Time Search BudgetLittle searchDeep searchnone0 tokens1 passDirect PassZero thinking tokenslow~1k tokensprunedLocal Fork1-2 branch checksmedium~4k tokensBacktrack & FixMulti-step verifyhigh~16k tokensDeep Multi-PathBranch explorationxhigh~32k tokensDeep ExplorationExtended CoT budgetmax~64k+ tokensFrontier SearchExhaustive budgetIllustrative · Conceptual search depth analogues across test-time compute tiers over frozen parametric weights.
Reasoning Effort: A Search Budget, Not an Intelligence SliderMobile vertical breakdown showing reasoning effort as a test-time search budget across frozen weights rather than an intelligence slider.REASONING EFFORT: SEARCH BUDGETDeliberation depth over frozen weights — not an intelligence slider✕ FLAWED MODEL"The Intelligence Slider"IQ Fixed"Dumb" Fast ModeMYTH"Genius" Slow Mode✓ GROUND TRUTHTest-Time Search Budget0k64k+1 direct passnone0 tokensGreedyDirect PassZero thinking tokens · Single forward passInstant output without deliberative searchacceptprunelow~1k tokens1-2 ChecksLocal Fork1–2 shallow branch checks · Quick sanity filterValidates ambiguities on prompt alternativesbacktrack ✓medium~4k tokensOptimal ROIBacktrack & FixMulti-step verification · Branch self-correctionRolls back failed paths to locate viable fixesdeep branchhigh~16k tokensParallel TreeDeep Multi-PathParallel path exploration · Hypothesis refutationPrunes flawed hypotheses across competing branchesextended searchxhigh~32k tokensDeep CoTDeep ExplorationExtended CoT budget · Complex multi-file logicExhaustive branch validation across interrelated modulesfrontier searchmax~64k+ tokensFrontierFrontier SearchExhaustive deliberation budget · Deepest searchFull tree expansion across frozen model weightsPRINCIPLE: DELIBERATION SCALES DEPTH, NOT IQWeights are frozen · Search tokens purchase branch verificationIllustrative · Conceptual search depth analogues · Gaia Research

Different providers expose this control through different levers. OpenAI's API exposes a discrete categorical parameter (reasoning_effort: "low" | "medium" | "high"). Anthropic exposes an explicit token count budget (thinking: { type: "enabled", budget_tokens: 1024..64000 }), while Google uses thinking_budget. Modern agent harnesses normalize these mechanics into a continuous operational ladder.

In every case, the underlying dynamic is identical: you are adjusting the ceiling on exploratory search tokens—allowing the model to sample candidate paths, simulate execution traces, critique intermediate steps, and backtrack when a hypothesis fails.


The Triad: Facts, Inference, and Confidence

Before increasing reasoning effort on any failing agent turn, ask one question: What is actually missing?

Every agent impasse traces back to one of three distinct deficiencies:

  1. Facts (Missing Evidence): The model lacks current repository context, recent API changes, or runtime output. Thinking harder cannot deduce a file that hasn't been read. The fix is retrieval.
  2. Inference (Unresolved Logic): The model has gathered all necessary facts, but needs multi-step deduction to resolve dependencies, race conditions, or invariant conflicts. The fix is reasoning.
  3. Confidence (Unverified Ground Truth): The model has synthesized a candidate patch, but internal self-rumination cannot prove correctness. The fix is verification.
Triage the Bottleneck: What Is Actually Missing?A triage decision tree mapping three missing elements (Facts, Inference, Confidence) to their distinct root bottlenecks, anti-pattern traps, and correct engineering actions (Retrieve, Reason, Verify).TRIAGE THE BOTTLENECK: WHAT IS ACTUALLY MISSING?Isolate whether the gap is missing evidence, logical deduction, or empirical proof before allocating computeWHAT'S MISSING?Identify the limiting factor first1. FACTSMissing EvidenceROOT BOTTLENECK:Model lacks current state,repo context, or runtime output.⚠️ Thinking harder cannot invent repo filesACTION: RETRIEVETools: grep, read, API, fetch, lsCost: Fast deterministic read (0 tokens)2. INFERENCEMulti-Step LogicROOT BOTTLENECK:Model has evidence but needsmulti-step logical deduction.⚠️ Dumping more context won't solve mathACTION: REASONTools: Reasoning tokens, CoT, searchCost: Compute-intensive test-time tokens3. CONFIDENCEEmpirical ProofROOT BOTTLENECK:Candidate solution exists, butempirical validity is uncertain.⚠️ Internal self-rumination ≠ ground truthACTION: VERIFYTools: Compiler, test runner, linterCost: Deterministic execution (stops early)Engineering Rule: Retrieve facts first · Reason over constraints · Verify in runtimeIllustrative · conceptual framework for agent deliberation allocation
Triage the Bottleneck: What Is Actually Missing?Mobile vertical triage flow mapping facts, inference, and confidence to their root bottlenecks, anti-pattern traps, and proper engineering actions.WHAT'S MISSING? TRIAGE THE GAPIsolate evidence, deduction, or proof before allocating computeIDENTIFY THE LIMITING FACTOR FIRSTMatch the bottleneck to the exact execution tool1. FACTSMissing EvidenceRETRIEVEROOT BOTTLENECK:Model lacks current repo files, schemas, or docs.⚠️ Trap: Thinking harder cannot invent unobserved filesACTION: RETRIEVE VIA TOOLS0 Tokens · FastTools: grep, read, bash, git, file inspectionAcquires ground truth before any CoT reasoning beginsEVIDENCE IN HAND ▼2. INFERENCEMulti-Step LogicREASONROOT BOTTLENECK:Evidence present, but multi-step deduction required.⚠️ Trap: Dumping more raw context won't solve logicACTION: REASON VIA TOKENSCompute-BoundTools: Reasoning tokens, Chain-of-Thought, searchSpends search budget to solve constraints and edge casesPLAN DRAFTED ▼3. CONFIDENCEEmpirical ProofVERIFYROOT BOTTLENECK:Candidate solution exists, but validity is unverified.⚠️ Trap: Self-rumination ≠ deterministic ground truthACTION: VERIFY IN RUNTIMEDeterministicTools: Compiler (tsc), test runner (vitest), linterExecutes real assertions to prove code before shippingRetrieve Facts ➔ Reason Constraints ➔ Verify in RuntimeNever deliberate on what can be cheaply read or testedIllustrative · Conceptual triage framework · Gaia Research

This diagnostic triad resolves a surprising number of agent failures. If an agent hallucinates a function signature, cranking the reasoning dial from Medium to High simply produces a 12,000-token justification for a fictitious interface. Give it a tool instead.

Only when facts are in context and verification gates are ready should you move up the reasoning ladder.


Two Engines: Learned Priors vs. Test-Time Search

In his 2019 essay The Bitter Lesson, Richard Sutton observed that seventy years of AI research point to one foundational rule: general methods that leverage computation—specifically learning and search—consistently outperform human-crafted heuristics.

Modern coding agents inherit this exact duality:

The Dual-Engine Architecture of Machine DeliberationAn architecture diagram grounded in Richard Sutton's Bitter Lesson: Engine 1 represents pre-trained parametric knowledge (What I Know Already), Engine 2 represents test-time search and verification compute (What I Must Work Out Now), converging into minimum sufficient deliberation for an optimal answer.THE DUAL-ENGINE ARCHITECTURE OF MACHINE DELIBERATIONSutton's Bitter Lesson in Agentic Systems: Learning (Parametric Priors) vs. Search (Test-Time Compute)PROBLEM INPUTTask prompt & constraintsPARAMETRICNON-PARAMETRICENGINE 1: LEARNINGWHAT I KNOW ALREADYZero test-time compute · Instant parametric recall• Priors & training weights (language syntax, idioms, standard APIs)• Architectural heuristics & recognized domain patterns• System 1 immediate associative recall (fast, low latency, $0 search)• Fixed boundary: cannot invent missing facts or verify edge casesENGINE 2: SEARCHWHAT I MUST WORK OUT NOWScalable test-time compute · Grounded runtime exploration• Search budget & reasoning effort (CoT tokens, branch exploration)• Active tool executions (retrieval, grep, file reads, runtime inspection)• Deterministic runtime verification (test suites, linters, compiler)• Elastic depth: scales compute dynamically to task complexityMINIMUM SUFFICIENT DELIBERATION → OPTIMAL ANSWERRely on priors where solid · Search only where uncertain · Halt the instant tests passGrounded in Richard Sutton's Bitter Lesson (2019): computation scales through search and learning.Illustrative · conceptual framework for balancing parametric memory with test-time search
The Dual-Engine Architecture (Mobile)Vertical architecture stack showing Engine 1 (Learning / Priors) and Engine 2 (Search / Test-time compute) converging into Minimum Sufficient Deliberation.THE DUAL-ENGINE ARCHITECTURESutton's Bitter Lesson: Learning Priors vs. Test-Time SearchPROBLEM INPUTTASK CONTRACTTask prompt, codebase constraints & specifications1. PARAMETRIC RECALL ↓ENGINE 1: LEARNINGWHAT I KNOW ALREADYParametric Priors · System 1 Recall · $0 Search CostPriors & training weightsLanguage syntax, standard idioms & memorized patternsFast associative recallInstant recognition across standard architectural shapesFixed boundary: 0 test-time search computeCannot invent missing repo facts or verify edge casesIF UNRESOLVED UNCERTAINTY ↓ENGINE 2: SEARCHWHAT I MUST WORK OUT NOWTest-Time Search Budget · CoT Tokens · Tool VerificationSearch budget & CoT tokensDynamic deliberation compute to explore alternativesActive tool inspection & environment retrievalGrep, file reads & runtime checks replace speculationDeterministic runtime verificationTest suites and compiler checks validate solutionsMINIMUM SUFFICIENT DELIBERATIONRely on priors · Search only where uncertainHalt the instant test runner confirms passMAX EFFICIENCY · ZERO DECISION CHURNRichard Sutton (2019) · The Bitter LessonMethods that scale with search and learning consistently dominate hand-crafted heuristics.Illustrative · Dual-engine deliberation architecture · Gaia Research

In modern software agents, that search engine has an unfair advantage Sutton didn't have in pure reinforcement learning: external environment feedback.

A good agent does not search everything from scratch. Its learned priors tell it where to look. And external tools tell it when it can stop searching.


Tools Are Search Pruning Devices

Consider the difference between debugging inside pure reasoning tokens versus debugging in an interactive terminal loop.

Without tools, the agent enters an ungrounded speculative cycle:

hypothesisimagine executionspeculate failurethink harderhallucinated root cause\text{hypothesis} \longrightarrow \text{imagine execution} \longrightarrow \text{speculate failure} \longrightarrow \text{think harder} \longrightarrow \text{hallucinated root cause}

Now give the agent a terminal:

hypothesisinspect coderun testobserve realitypatchrun test{passSTOPfailinvestigate\text{hypothesis} \longrightarrow \text{inspect code} \longrightarrow \text{run test} \longrightarrow \text{observe reality} \longrightarrow \text{patch} \longrightarrow \text{run test} \begin{cases} \text{pass} \longrightarrow \textbf{STOP} \\ \text{fail} \longrightarrow \text{investigate} \end{cases}

Debugging Loops: Speculative Deliberation vs. Deterministic Ground TruthA side-by-side comparison between debugging without tools (open-loop speculation resulting in 5,000 wasted reasoning tokens and hallucinated root causes) versus debugging with tools (closed-loop reality resulting in a 300-token verified pass).DEBUGGING CYCLES: INTERNAL SPECULATION VS. DETERMINISTIC GROUND TRUTHDeliberation cannot replace observation: why spending reasoning tokens on observable facts is an anti-patternOPEN-LOOP SPECULATIONDEBUGGING WITHOUT TOOLSModel simulates the runtime inside reasoning tokens (unguided drift)1. Hypothesis:"Maybe auth token expired in middleware?"2. Imagine Path:Mentally simulates clock skew without reading code3. "Think Harder":Burns 5,000 tokens inventing race conditions4. Speculate:Proposes rewrite of network stack for phantom bug✕ RESULT: HALLUCINATED ROOT CAUSE• 5,000 reasoning tokens wasted on unverified assumptions• Real bug in code remains completely untouched and unfixedStatus: FAILED — Open-loop speculation loopCLOSED-LOOP REALITYDEBUGGING WITH TOOLSModel queries ground truth with cheap deterministic tool calls1. Hypothesis:"Check why auth test is failing"2. Inspect Code:cat auth.ts | grep verify → missing return statement3. Run Test & Observe:vitest stderr confirms exact line 42 assertion4. Patch & Re-run Test:Applies 1-line return fix → vitest passes in 110ms✓ PASS [STOP] — VERIFIED GROUND TRUTH• 300 tokens used (94% compute discount vs internal simulation)• Zero guesswork: backed by deterministic test runner receiptStatus: RESOLVED — Execution halted immediately on greenPRINCIPLE: "When reality can cheaply answer the question, ask reality."Illustrative · scenario comparison between ungrounded internal deliberation and tool-augmented debugging
Debugging Cycles: Speculation vs. Ground Truth (Mobile)Mobile vertical comparison of debugging without tools (5,000 wasted tokens on ungrounded speculation) versus debugging with tools (300 tokens on closed-loop deterministic verification).DEBUGGING: SPECULATION VS. GROUND TRUTHInternal Simulation (No Tools) vs. Closed-Loop Reality (With Tools)OPEN-LOOP SPECULATIONWITHOUT TOOLSModel simulates runtime inside reasoning tokens (unguided drift)1. Hypothesis:"Maybe auth token expired in middleware?"2. Imagine Path:Mentally simulates clock skew without reading code3. "Think Harder":Burns 5,000 tokens inventing race conditions4. Speculate:Proposes rewrite of network stack for phantom bug✕ RESULT: HALLUCINATED ROOT CAUSE• 5,000 reasoning tokens wasted on unverified guesswork• Real bug in code remains untouched and unfixed• Status: FAILED — Open-loop speculation churnCOST: 5,000 TOKENS WASTED · VERIFICATION: 0% · UNRESOLVEDVSCLOSED-LOOP REALITYWITH TOOLSModel queries ground truth with cheap deterministic tool calls1. Hypothesis:"Check why auth test is failing in CI"2. Inspect Code:grep auth.ts → locates missing return on line 423. Run Test:vitest stderr confirms assertion failure4. Patch & Run:Applies 1-line return fix → vitest passes in 110ms✓ PASS [STOP] — VERIFIED GROUND TRUTH• 300 tokens used (94% compute discount vs simulation)• Zero guesswork: backed by deterministic test runner receipt• Status: RESOLVED — Deliberation halts immediately on greenCOST: 300 TOKENS · 94% COMPUTE DISCOUNT · GREEN VERIFIED"When reality can cheaply answer the question, ask reality."THE GROUNDING INVARIANT · OBSERVATION BEATS SPECULATIONIllustrative · Speculation vs. tool-augmented debugging · Gaia Research

Tools are not merely peripheral interfaces for interacting with the outside world. Tools are search pruning devices.

A compiler answers in 100 milliseconds a question the model might otherwise debate across 3,000 reasoning tokens. A unit test collapses five plausible hypotheses into one verified reality. Repository search replaces speculation about what the codebase contains.

«When reality can cheaply answer the question, ask reality.»


The Inverted-U: Diminishing Returns and the Overthinking Cascade

In machine learning, test-time compute refers to the computational budget a model spends thinking after receiving a prompt—generating internal reasoning tokens, exploring search trees, and critiquing candidate paths before emitting its visible response.

Test-time compute scaling research (Snell et al., 2024) demonstrates that additional deliberation can dramatically improve problem-solving on complex, verifiable benchmarks. But returns are not infinite.

Without deterministic verification, test-time deliberation follows an inverted-U curve:

The Inverted-U Curve of Reasoning EffortSolution quality versus reasoning effort inverted-U curve with under-thinking on the left, the sweet spot of minimum sufficient deliberation at the peak, and the overthinking cascade on the right.The Inverted-U Curve of Reasoning EffortWhy test-time compute follows diminishing and negative returns without empirical groundingZONE 1: TOO LITTLEUnder-Deliberation• Shallow single-pass execution• Undetected race conditions• Premature victory biasZONE 2: SWEET SPOTMinimum Sufficient• Verified against facts & tests• Branch synthesis complete• Highest compute ROIZONE 3: OVERTHINKINGNegative Compute Returns• Ruminates on already-settled decisions• Hallucinates phantom edge cases• Paralyzing self-doubt scraps working code▲ Solution Quality & ReliabilityReasoning Effort / Search Budget ►NoneLowMedium (Optimal)HighMax★ SWEET SPOT: Minimum Sufficient DeliberationTHE OVERTHINKING CASCADEHow excessive reasoning tokens unseat correct solutions without external test verification1. Correct IdeaDiscovers soundlogic & invariantTokens: ~5002. Double-CheckAudits codeand constraintsTokens: ~1.2k3. Still CorrectSolution holds;optimal exit pointOptimal Exit4. "But What If..."Unpromptedself-doubt beginsTokens: ~4k5. Phantom EdgeInvents phantomimpossible bugsTokens: ~8k6. Reopen ChoiceReopens settleddecision & codeDecision Churn7. Wrong AnswerSubmits fragile,regressed patchTokens: ~16kIllustrative · Test-time compute scaling dynamics and reasoning saturation · Gaia Research
The Inverted-U Curve of Reasoning EffortSolution quality versus reasoning effort inverted-U curve with under-thinking on the left, the sweet spot of minimum sufficient deliberation at the peak, and the overthinking cascade on the right.THE INVERTED-U OF REASONING EFFORTWhy test-time compute follows diminishing & negative returnsUNDER-THINKPremature Exit• Shallow pass• Missed racesSWEET SPOTSufficient Delib.• Tests verified• Max compute ROIOVERTHINKINGNegative Returns• Phantom bugs• Decision churn▲ QualityReasoning Effort ►NoneLowOptimal (~2k)HighMax★ SWEET SPOT: Minimum Sufficient DeliberationTHE OVERTHINKING CASCADE7 stages of reasoning saturation without external test verification1Correct IdeaDiscovers sound logic & core invariant~500 tokens2Double-CheckAudits code and spec constraints~1.2k tokens3Still CorrectSolution holds cleanly; optimal stopping point★ OPTIMAL EXIT4"But What If..."Unprompted self-doubt begins~4k tokens5Phantom EdgeInvents impossible phantom failure modes~8k tokens6Reopen ChoiceScraps settled architecture & codeDecision Churn7Wrong AnswerSubmits fragile, regressed patch~16k tokensEach ungrounded step increases token spend and latency while degrading accuracyIllustrative · Test-time compute scaling & reasoning saturationGaia Research · Minimum Sufficient Deliberation

Early reasoning rapidly resolves uncertainty. But past the sweet spot, ungrounded deliberation frequently triggers self-correction degradation (Huang et al., 2024; Chen et al., 2024):

correct ideadouble-checkstill correct"but what if..."invent edge casereopen decisionwrong answer\text{correct idea} \longrightarrow \text{double-check} \longrightarrow \text{still correct} \longrightarrow \text{"but what if..."} \longrightarrow \text{invent edge case} \longrightarrow \text{reopen decision} \longrightarrow \textbf{wrong answer}

The model begins doubting its own sound deductions, manufactures phantom edge cases that cannot occur in the codebase, and abandons working code in favor of fragile, over-engineered rewrites.

The lesson isn't "reason less." It is:

«Keep reasoning while it is reducing uncertainty. Stop the instant uncertainty is resolved.»


The Effort Ladder: Evidence First, Escalation Second

For everyday software agents, medium is the correct default operating point. It provides enough search depth for multi-file edits and standard debugging without slipping into self-doubt spirals.

Effort TierProvider Implementation AnalogueRecommended Engineering Scope
noneZero thinking tokens / direct samplingExtraction, formatting, AST transforms, deterministic docstring generation
lowOpenAI low · Anthropic ~1k tokensTiny edits, typos, syntax errors, familiar single-line fixes
mediumOpenAI medium · Anthropic ~4k tokensStandard feature work, multi-file refactoring, debugging with tool assistance
highOpenAI high · Anthropic ~16k tokensRoot-cause analysis, subtle race conditions, complex distributed architecture
xhigh / maxAnthropic ~32k–64k+ tokens · deep rolloutGenuinely capability-bound proofs, compiler optimization, cryptographic protocols

When an agent hits an obstacle, follow a strict escalation sequence:

The Reasoning Escalation Ladder: Empirical Decision FlowFlowchart showing how agents should allocate reasoning effort: retrieve external facts first, select a search budget rung based on uncertainty, and only escalate to high or max with empirical compiler/eval evidence.The Reasoning Escalation Ladder: Empirical Decision FlowEvidence first. Escalation second. Allocate search budget based on residual uncertainty.PHASE 1: GROUNDING GATENEW TASK / SPECIFICATIONNeed externalinformation?YESRETRIEVE (Tool Use)read_file · grep · docs · bashAcquire ground truth factsNOPHASE 2: CALIBRATE SEARCH BUDGETHow much inferential uncertainty is unresolved?LOWShallow Uncertainty0 – 1k tokensTiny edits, typos, syntax fixes, routine boilerplateMEDIUMModerate Uncertainty1k – 4k tokensMulti-file features, standard debugging, unit testsHIGHDeep Uncertainty4k – 16k tokensRoot-cause analysis, complex concurrency & architectureRule: Default to lowest sufficient rung · escalate only with causePHASE 3: EMPIRICAL GATERUN TESTS & COMPILERStill stuck afterempirical run?[NO]STOP & SHIPVerified CleanDo not overthink[YES]XHIGH / MAXEscalate EffortFeed error traceEVIDENCE FIRST. ESCALATION SECOND.Never escalate to high/max effort on intuition. Ground the model with compiler errors, tests, or docs first.Illustrative · Autonomous agent search budget escalation policy · Gaia Research
The Reasoning Escalation Ladder: Empirical Decision FlowFlowchart showing how agents allocate reasoning effort: retrieve external facts first, select a search budget rung based on uncertainty, and only escalate to high or max with empirical compiler evidence.THE REASONING ESCALATION LADDEREmpirical decision flow for autonomous agent reasoning budgetsPHASE 1: GROUNDING GATEVerify external facts before spending inferential reasoning tokensNEW TASK / SPECIFICATIONNeed externalinformation?YESRETRIEVE (Tools)read · grep · bashAcquire ground truthNO✓ ALL FACTS GROUNDED IN WORKSPACEState and constraints verified · Proceed to inference sizingDeterministic foundation ready (0 reasoning tokens spent)PHASE 2: CALIBRATE SEARCH BUDGETHow much inferential uncertainty is unresolved?LOWShallow Uncertainty0 – 1k tokensTiny edits, typo & syntax fixes, routine boilerplateSingle-turn deterministic resolutionMEDIUMModerate Uncertainty1k – 4k tokensMulti-file features, standard debugging, unit test suites★ Sweet spot default for 80% of agent tasksHIGHDeep Uncertainty4k – 16k tokensRoot-cause isolation, concurrency bugs, architectural shiftsRequires hard hypothesis branch pruningRule: Default to lowest sufficient rung · escalate only with causePHASE 3: EMPIRICAL GATEValidate with real runtime output before ending or escalatingRUN TESTS & COMPILERStill stuck afterempirical run?NO[NO]STOP & SHIPVerified CleanDo not overthinkYES[YES]XHIGH / MAXArmed EscalationFeed error traceEVIDENCE FIRST. ESCALATION SECOND.Never escalate to high/max effort on intuition. Ground the modelwith compiler diagnostics, failing tests, or API traces first.Illustrative · Autonomous agent search escalation policy · Gaia Research

Notice the non-negotiable rule: Evidence first. Escalation second.

Never escalate to high or max effort on intuition. Ground the model with compiler errors, failing test assertions, or documentation first.


Allocating Intelligence: The Three Agents

To see how these dynamics play out in practice, consider an illustrative scenario: three agents encounter an unfamiliar API.

Three Agents Encounter an Unfamiliar APIComparison of three agent strategies: Agent A with unchecked confidence produces a broken build; Agent B with 12,000 blind reasoning tokens creates an expensive failure; and Agent C with grounded deliberation passes on the first try.Three Agents Encounter an Unfamiliar APIWhy blind reasoning effort cannot substitute for missing empirical contextAGENT A · UNCHECKED CONFIDENCELow Effort · Zero Retrieval"I probably know this API. Let me justwrite the code directly."1. Skip docs, grep, and tools2. Single-pass generation (0 reasoning)3. Hallucinate fictitious API methodBROKEN BUILDInstant Runtime CrashLatency: 1.2s · Tokens: 350 · Cost: $0.001TypeError: client.fetchTree is not a functionConfidence without facts guarantees failure.AGENT B · BLIND COMPUTE WASTEMax Effort · Zero Retrieval"I should think harder! Let me deducethe API shape from first principles."1. Spend 12,000 reasoning tokens2. Deduce complex phantom interfaces3. Hallucinate API, but thoughtfullyEXPENSIVE FAILUREThoughtful HallucinationLatency: 32.5s · Tokens: 12,400 · Cost: $0.18Error: Module has no exported member 'v2'Reasoning cannot fabricate absent facts.AGENT C · GROUNDED DELIBERATIONCalibrated Effort + Tool Retrieval"Do I know the API? Nope. Let mefetch docs & verify the version first."1. Tool: read_file & docs (250ms)2. Calibrated reasoning (1.2k tokens)3. Implement & run compiler checkPASSES FIRST TRYClean Verified ExecutionLatency: 4.2s · Tokens: 1,600 · Cost: $0.015Status: 14/14 tests pass · 0 regressionsEmpirical facts + calibrated reasoning wins.Key Takeaway: Agent C didn't have more raw intelligence. It allocated intelligence better.Illustrative · Grounded retrieval vs. blind deliberation scaling scenario · Gaia Research
Three Agents Encounter an Unfamiliar API (Mobile)Comparison of three agent strategies: Agent A with unchecked confidence produces a broken build; Agent B with 12,000 blind reasoning tokens creates an expensive failure; and Agent C with grounded deliberation passes on the first try.THREE AGENTS ENCOUNTER AN APIWhy blind reasoning cannot substitute for missing contextAGENT A · UNCHECKED CONFIDENCELow Effort · Zero Retrieval350 tokens · 1.2s"I probably know this API. Let me justwrite the code directly."1. Skip docs, grep, and tools2. Single-pass generation (0 reasoning)3. Hallucinate fictitious API methodBROKEN BUILDInstant Runtime CrashLatency: 1.2s · Tokens: 350 · Cost: $0.001TypeError: client.fetchTree is not a functionConfidence without facts guarantees failure.AGENT B · BLIND COMPUTE WASTEMax Effort · Zero Retrieval12.4k tokens · 32.5s"I should think harder! Let me deducethe API shape from first principles."1. Spend 12,000 reasoning tokens2. Deduce complex phantom interfaces3. Hallucinate API, but thoughtfullyEXPENSIVE FAILUREThoughtful HallucinationLatency: 32.5s · Tokens: 12,400 · Cost: $0.18Error: Module has no exported member 'v2'Reasoning cannot fabricate absent facts.AGENT C · GROUNDED DELIBERATIONCalibrated Effort + Retrieval1.6k tokens · 4.2s"Do I know the API? Nope. Let mefetch docs & verify the version first."1. Tool: read_file & docs (250ms)2. Calibrated reasoning (1.2k tokens)3. Implement & run compiler checkPASSES FIRST TRYClean Verified ExecutionLatency: 4.2s · Tokens: 1,600 · Cost: $0.015Status: 14/14 tests pass · 0 regressionsEmpirical facts + calibrated reasoning wins.Agent C didn't have more intelligence.It allocated intelligence better.Illustrative · Grounded retrieval vs. blind deliberation · Gaia Research

Agent A: Unchecked Confidence

Agent B: Blind Compute Waste

Agent C: Grounded Deliberation

Agent C didn't possess superior model weights. It allocated intelligence better.


The 30-Second Triage Rule

Whenever your coding agent spins out or fails a task, do not immediately crank the reasoning slider to max. Run this operational checklist:

  1. Did it lack a ground-truth fact?
    If it guessed a file path, an API parameter, or runtime state, give it a tool (grep, read_file, curl, docs) or paste the excerpt. Reasoning will not deduce a fact it cannot see.
  2. Did it verify against reality?
    If it guessed whether its patch worked, give it a test command or compiler check. Reality is cheaper than 5,000 reasoning tokens.
  3. Is it genuinely blocked on deduction?
    If the evidence is in context, the test failure is reproducible, and the root cause involves multi-component invariants, that is when you escalate effort from Medium to High.

The Deliberation Lifecycle

The entire operational policy distills into a five-step loop:

The Whole Article in One Diagram: The Deliberation LifecycleFive-step sequential policy flow: Step 1 Missing Fact triggers Retrieve; Step 2 Hard Inference triggers Reason; Step 3 Not Sure triggers Verify; Step 4 Still Stuck triggers Increase Effort; Step 5 Resolved triggers Stop and Ship.The Deliberation Lifecycle: The Whole Article in One DiagramA five-step operational policy for allocating search budget, tools, and verificationRetry with Empirical Error TraceSTEP 01MISSING FACT?RETRIEVETool Use & GrepNever deliberateon what can beread from disk.Ground truth firstSTEP 02HARD INFERENCE?REASONReasoning TokensSpend search budgeton logic branches& edge invariants.Targeted computeSTEP 03NOT SURE?VERIFYCompilers & TestsLet deterministictooling confirm orrefute hypothesis.Deterministic checkSTEP 04STILL STUCK?ESCALATEEscalate LadderOnly bump effortwhen armed witherror diagnostics.Armed escalationSTEP 05RESOLVED?STOP & SHIPShip ImmediatelyDeliberation endsinstantly. Zerotoken rumination.Deliberation doneMINIMUM SUFFICIENT DELIBERATIONThe best agent isn't the one that thinks the most.It is the one that knows when another unit of thinking is still worth buying.Illustrative · Test-time compute allocation policy · Gaia Research
The Deliberation Lifecycle (Mobile)Five-step sequential operational policy: Step 01 Missing Fact triggers Retrieve; Step 02 Hard Inference triggers Reason; Step 03 Not Sure triggers Verify; Step 04 Still Stuck triggers Escalate; Step 05 Resolved triggers Stop and Ship.THE DELIBERATION LIFECYCLEFive-step operational policy for test-time compute⮡ RETRY W/ TRACESTEP 01MISSING FACT?→ RETRIEVETools & GrepZero deliberation costNever deliberate on what can be read from disk.Empirical grounding before thinking · Ground truth firstFACTS RETRIEVEDSTEP 02HARD INFERENCE?→ REASONReasoning TokensTargeted search budgetSpend search budget on logic branches & invariants.Deliberate only when problem requires logical deductionCODE GENERATEDSTEP 03NOT SURE?→ VERIFYCompiler & TestsDeterministic checkLet deterministic tooling confirm or refute code.Never trust unverified internal model confidence over testsIF NOT VERIFIEDSTEP 04STILL STUCK?→ ESCALATEArmed w/ Error TraceBump effort + evidenceOnly bump effort when armed with error diagnostics.⮡ Feeds back up to Step 02 Reason with new traceBlind retries without new empirical facts will fail againWHEN TESTS PASSSTEP 05RESOLVED?→ STOP & SHIPImmediate HaltZero token ruminationTests pass green. Deliberation halts immediately.Never buy another unit of thinking once verified greenMINIMUM SUFFICIENT DELIBERATIONThe best agent isn't the one that thinks the most.It is the one that knows when another unit of thinkingis still worth buying.RETRIEVALAbsent facts → grep/tools (100x cheaper)REASONINGHard inference → search budget on logicHALT RULETests green → stop & ship immediatelyIllustrative · Test-time compute allocation policy · Gaia Research

That is the sweet spot. Not maximum thought. Not minimum thought.

Minimum Sufficient Deliberation.

The best agent isn't the one that thinks the most. It is the one that knows when another unit of thinking is still worth buying.


Sources & Foundational Literature: