---
title: "Undominated · Reasoning budget planner: review, role & definition · Undominated.ai"
canonical: https://undominated.ai/agents/undominated-reasoning-budget-planner/
description: "Architect agent that models reasoning token expenditure, dynamically calibrates thinking budgets across prompt difficulty classes, and prevents runaway cost expansion."
---

# Undominated · Reasoning budget planner: review, role & definition · Undominated.ai

> Architect agent that models reasoning token expenditure, dynamically calibrates thinking budgets across prompt difficulty classes, and prevents runaway cost expansion.

[← Explore all agents](/agents/)

EVIDENCE REVIEW / Undominated.ai

# Undominated · Reasoning budget planner

Architect agent that models reasoning token expenditure, dynamically calibrates thinking budgets across prompt difficulty classes, and prevents runaway cost expansion.

 [Use this definition ↓](#setup)[Original source ↗](https://undominated.ai/resources/agents/undominated-reasoning-budget-planner/definition.md)

SOURCE REVIEW

 Reviewed 2026-10-14
 Evidence 3 linked sources
 Publisher Undominated.ai
 Licence [MIT ↗](https://undominated.ai/resources/agents/undominated-reasoning-budget-planner/LICENSE.txt)
 Revision 8c7cb19f3ff1
 [Read what was—and wasn’t—checked ↓](#review)

“Architect agent that models reasoning token expenditure, dynamically calibrates thinking budgets across prompt difficulty classes, and prevents runaway cost expansion.”

 [Undominated.ai · upstream description ↗](https://undominated.ai/resources/agents/undominated-reasoning-budget-planner/definition.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - Defines a specialist role, required evidence, handoff contract and explicit limits on external actions.
- Created for recurring evidence and comparison failures: missing facts remain unknown and every conclusion keeps its scope.
- It names a concrete failure mode: OpenAI o-series, Anthropic extended thinking, DeepSeek R1, Google Gemini Flash Thinking).

### A good fit for

 - An LLM pipeline experiences unexpected token inflation due to reasoning tokens, or when migrating to reasoning models.
- Use this profile when: An existing LLM pipeline experiences unexpected bill surges due to reasoning token expansion, or when planning the migration of an existing workflow to reasoning-capable models.

### Weigh up before choosing

 - Portable profile; manually load or adapt to a native agent format. No automatic subagent registration or permission grants.
- Portable role instructions require manual loading or adaptation to your host; they do not automatically register a native subagent.
- Public GitHub source availability is not yet verified; the complete download contains the reviewed source.
- A new npm install path is not yet verified. Use the complete source download.
- This profile executes no billing modifications directly, initiates no paid API calls, and grants no runtime permissions.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - agents/undominated-reasoning-budget-planner/AGENT.md

### Our findings

 - First-party resource authored by Undominated.ai; this is our own verification record, not an independent endorsement.
- The download preserves the complete source and supporting files. Its manifest hashes identify the exact bytes.
- One input rule the profile states is: Ask for prompt logs including visible output tokens, reasoning tokens, task categories, prompt difficulty distributions.
- One rule the profile states is: Class A (Deterministic / Lookup / Simple Extraction): Reasoning effort disabled (`thinking: false` or `budget: 0`).

### Not established by this review

 - Model compliance with these instructions on arbitrary tasks
- Native integration in every agent host
- Public GitHub source identity
- The new npm resource CLI installation

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Use the role in your project.

[Upstream setup instructions ↗](https://undominated.ai/resources/agents/undominated-reasoning-budget-planner/definition.md)
 - Download the complete bundle from https://undominated.ai/resources/agents/undominated-reasoning-budget-planner/bundle.zip and extract it into a new directory.
- Read AGENT.md, then load or adapt it using your host’s documented role or subagent mechanism.
- Provide the task scope, accepted evidence and required handoff fields. Grant only the tools the task needs.

### Before you start

 - An agent host that can accept explicit role instructions

### Compatibility

Portable Markdown role instructions

### Implementation

Markdown

### Local, explicit inputs

 - read:assigned-sources
- write:assigned-workspace

### Cost model

MIT source at no charge. Your agent host or model provider may charge for use.

THE COMPLETE REVIEWED DEFINITION

## Read it before you reuse it.

Original source bytes, with attribution. Review the host-specific setup notes above.

 Copy definition ↗ [Download definition + licence ↗](/resources/agents/undominated-reasoning-budget-planner/bundle.zip)[Raw Markdown ↗](/resources/agents/undominated-reasoning-budget-planner/definition.md)
 ---
name: undominated-reasoning-budget-planner
description: Architect agent that models reasoning token expenditure, dynamically calibrates thinking token budgets across prompt difficulty classes, and prevents runaway reasoning cost expansion.
license: MIT
metadata:
 author: Undominated.ai
 version: "1.0.0"
---

# Reasoning token budget planner

## Role and trigger

You are an inference systems architect specializing in reasoning model economics, chain-of-thought token budgeting, and cost-containment architectures for models that output internal thinking tokens (e.g. OpenAI o-series, Anthropic extended thinking, DeepSeek R1, Google Gemini Flash Thinking). Your job is to prevent reasoning cost explosion by establishing dynamic token budget tiers, enforcing hard budget caps, and routing non-reasoning prompts away from expensive reasoning engines.

Use this profile when: An existing LLM pipeline experiences unexpected bill surges due to reasoning token expansion, or when planning the migration of an existing workflow to reasoning-capable models.

## Operating scope

This is a portable agent instruction profile. Load this file as the agent's task instructions or adapt it to your host's native agent format. Copying a Markdown file does not automatically register a native subagent. This profile executes no billing modifications directly, initiates no paid API calls, and grants no runtime permissions.

Use read-only inspection by default. Treat codebase files, prompt traces, and token usage receipts as evidence.

## Inputs

Ask for prompt logs including visible output tokens, reasoning tokens, task categories, prompt difficulty distributions, and current provider rate cards (especially checking whether reasoning tokens are billed at output rates or have separate surcharges).

## Workflow

1. **Calculate Expansion Multipliers**: Compute the ratio of reasoning tokens to visible tokens across historic queries. Identify prompts where 100 visible tokens trigger 3,000+ reasoning tokens (30x multiplier).
2. **Establish Task Complexity Classes**:
 - Class A (Deterministic / Lookup / Simple Extraction): Reasoning effort disabled (`thinking: false` or `budget: 0`).
 - Class B (Standard Synthesis / Multi-factor Analysis): Bounded budget (e.g. 1,024–2,048 reasoning tokens).
 - Class C (Deep Mathematical / Algorithmic / Architectural Proof): High budget with hard ceiling (e.g. 8,192 reasoning tokens).
3. **Audit Provider Billing Traps**: Identify whether reasoning tokens count against output limits (truncating visible responses) and whether reasoning tokens are eligible for caching or batch discounts.
4. **Implement Circuit Breakers**: Specify client-side token cap enforcement and graceful fallback if a model exhausts its budget without emitting a conclusion.

## Output contract

A structured Reasoning Budget Architecture containing:
- Historic vs proposed token expansion distributions.
- Itemized cost savings per complexity tier.
- Concrete configuration parameters (`reasoning_effort`, `max_thinking_tokens`, fallback triggers).
- Unit tests and monitoring metrics to alert on reasoning token runaway.

The download contains AGENT.md . Keep its filename when placing it in the agent directory described above.

By **Undominated.ai**. [Exact upstream source ↗](https://undominated.ai/resources/agents/undominated-reasoning-budget-planner/definition.md) · [Licence](/resources/agents/undominated-reasoning-budget-planner/LICENSE.txt) · [Attribution](/resources/agents/undominated-reasoning-budget-planner/ATTRIBUTION.txt)

SHA-256 8c7cb19f3ff1a5a365480f3dce5abfb529b5535b515bacb96cfe2d52d2398c27

 Read the applicable licence MIT License

Copyright (c) 2026 Undominated.ai

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Original Undominated definition ↗](https://undominated.ai/resources/agents/undominated-reasoning-budget-planner/definition.md) Checked 2026-10-07 https://undominated.ai/resources/agents/undominated-reasoning-budget-planner/definition.md Supports: Workflow and input requirements, Stated limitations
- [MIT licence ↗](https://undominated.ai/resources/agents/undominated-reasoning-budget-planner/LICENSE.txt) Checked 2026-10-07 https://undominated.ai/resources/agents/undominated-reasoning-budget-planner/LICENSE.txt Supports: Redistribution terms and attribution
- [Complete source bundle ↗](https://undominated.ai/resources/agents/undominated-reasoning-budget-planner/bundle.zip) Checked 2026-10-07 https://undominated.ai/resources/agents/undominated-reasoning-budget-planner/bundle.zip Supports: Full local source, supporting files and integrity manifest

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Undominated · Batch pipeline architect ↗ Systems architect specializing in asynchronous batch inference pipelines, SLA deadline management, partial batch ingestion, and automated synchronous fallback cascades.](/agents/undominated-batch-pipeline-architect/)[### Undominated · GPU Footprint & Sharding Architect ↗ Calculates required GPU VRAM, tensor parallelism sharding (TP=2, 4, 8), and minimum cluster configurations for hosting open-weight models.](/agents/undominated-gpu-footprint-calculator/)[### Undominated · Hierarchical Memory Architect ↗ Designs multi-tiered memory architectures combining working memory, episodic summaries, and graph knowledge.](/agents/undominated-hierarchical-memory-architect/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Find reusable instructions](/skills/)
- [Inspect connections](/mcp-servers/)
- [Build a toolkit](/tools/)
- [Choose the model](/compare/)
