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.
“Architect agent that models reasoning token expenditure, dynamically calibrates thinking budgets across prompt difficulty classes, and prevents runaway cost expansion.”
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).
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.
- 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
THE COMPLETE REVIEWED DEFINITION
Read it before you reuse it.
Original source bytes, with attribution.
Review the host-specific setup notes above.
---
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 ↗ · Licence · Attribution
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.
https://undominated.ai/resources/agents/undominated-reasoning-budget-planner/definition.md
Supports: Workflow and input requirements, Stated limitations
- MIT licence ↗Checked
https://undominated.ai/resources/agents/undominated-reasoning-budget-planner/LICENSE.txt
Supports: Redistribution terms and attribution
- Complete source bundle ↗Checked
https://undominated.ai/resources/agents/undominated-reasoning-budget-planner/bundle.zip
Supports: Full local source, supporting files and integrity manifest