MCPInstall

thinking-bounded-rationality

Use when search or investigation could run forever. Set an explicit good-enough threshold first, then stop at the first option that clears it.

Installs
568
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/tjboudreaux/cc-thinking-skills --skill thinking-bounded-rationality
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads thinking-bounded-rationality automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Bounded Rationality

Under finite tool, context, and time budgets, stop at the first option that meets a predeclared aspiration level. Optimize only when the good-to-best gap is worth the remaining budget.

When to Use

  • Search or option comparison has no natural endpoint and could consume the turn budget.
  • Multiple options would clear the requirement and further comparison has diminishing returns.
  • The decision is reversible or low-stakes relative to more search.
  • You are gathering context beyond what the decision needs to ship.

When NOT to Use

  • Irreversible or high-stakes choices (data loss, security, migrations, public commitments) where the good-to-best gap is material.
  • Correctness gates: tests, security checks, and "did the fix work?" need the right answer, not a sufficient-looking one.
  • One cheap lookup would settle the fact — do it; do not satisfice past it.
  • The aspiration level cannot be stated — clarify the requirement first.

Procedure

  1. State decision and budget. Name the choice, residual tool/context/time budget, and reversibility.
  2. Set aspiration before searching. Write concrete pass/fail criteria for "good enough." Do not evaluate until the threshold is explicit.
  3. Search sequentially. Score options in encounter order against the threshold only. Skip full matrices unless step 1 marked high-stakes/irreversible.
  4. Stop at first adequate. When an option clears every criterion, select it immediately.
  5. Handle search failure without moving the goalposts. If nothing clears after the pre-set cap, preserve the threshold and report no adequate option. Relax only a criterion predeclared as non-load-bearing, record the relaxation, and resume within a new cap; never raise the bar after failure.
  6. Commit. Record choice and residual uncertainty; spend remaining budget on execution, not re-ranking.

Stop condition: First option meets the predeclared aspiration level, or the search cap is exhausted with none adequate.

Output

Decision: <choice>
Aspiration: <pass/fail criteria>
Search: evaluated N; stopped at first adequate | cap exhausted
Selected: <option or none>
Residual risk: <what further search might change>
Next spend: <execution step>

Verification

  • Falsify if you kept comparing after an option cleared the threshold, or invented the threshold after seeing winners.
  • Falsify if a correctness gate or irreversible decision was treated as satisficeable.
  • Over-application guard: if one cheap check settles a fact, look it up — do not invoke this skill.

FAQ

What does the thinking-bounded-rationality skill do?

Use when search or investigation could run forever. Set an explicit good-enough threshold first, then stop at the first option that clears it.

How do I install thinking-bounded-rationality?

Run npx skills add https://github.com/tjboudreaux/cc-thinking-skills --skill thinking-bounded-rationality in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/thinking-bounded-rationality/ (personal) or .claude/skills/thinking-bounded-rationality/ (project).

Which AI agents can use thinking-bounded-rationality?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is thinking-bounded-rationality safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains thinking-bounded-rationality?

It is published by tjboudreaux in tjboudreaux/cc-thinking-skills. It has 568 recorded installs.

More from tjboudreaux/cc-thinking-skills

View all →

thinking-first-principles

tjboudreaux/cc-thinking-skills

When a constraint is treated as fixed, separate physics from convention, keep only independently supported primitives, and rebuild the simplest solution that satisfies real constraints.

thinking-red-team

tjboudreaux/cc-thinking-skills

For authorized security review of code, auth, or APIs you control, model the attacker, map the attack surface, and report only findings with a reproducible exploit path and verified mitigation.

Backend & APIs674 installs

thinking-pre-mortem

tjboudreaux/cc-thinking-skills

Before committing to a plan or launch, assume it already failed and reason backward through concrete causes — convert failure paths into mitigations, gates, and stop checks.

thinking-theory-of-constraints

tjboudreaux/cc-thinking-skills

When throughput or latency is pipeline-limited, identify the single binding constraint and exploit, subordinate, elevate, then recheck—ignore non-constraints.

649 installs

thinking-socratic

tjboudreaux/cc-thinking-skills

When a request is vague, assumption-laden, or "obvious," ask the few load-bearing questions that expose hidden requirements before building or committing.

631 installs

thinking-opportunity-cost

tjboudreaux/cc-thinking-skills

Before committing scarce time, people, or money, name the best forgone use of those resources and the value delta of the chosen path versus that alternative.

616 installs

Popular other skills

View category →

hyperframes-cli

heygen-com/hyperframes

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

1.3M installs

triage

mattpocock/skills

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs