← Explore all 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.

“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.

Upstream setup instructions ↗
  1. Download the complete bundle from https://undominated.ai/resources/agents/undominated-reasoning-budget-planner/bundle.zip and extract it into a new directory.
  2. Read AGENT.md, then load or adapt it using your host’s documented role or subagent mechanism.
  3. 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.

  1. https://undominated.ai/resources/agents/undominated-reasoning-budget-planner/definition.md

    Supports: Workflow and input requirements, Stated limitations

  2. MIT licence ↗Checked

    https://undominated.ai/resources/agents/undominated-reasoning-budget-planner/LICENSE.txt

    Supports: Redistribution terms and attribution

  3. Complete source bundle ↗Checked

    https://undominated.ai/resources/agents/undominated-reasoning-budget-planner/bundle.zip

    Supports: Full local source, supporting files and integrity manifest

Evidence & Ask