Skip to main content
command CX Codex

occams-razor — Claude Code command: compare explanations

The occams-razor command weighs competing explanations against the facts and removes unsupported assumptions. Use it when a bug or decision has several plausible causes.

MIT ★ 1,988 updated 2026-04-01

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add glittercowboy/taches-cc-resources
/plugin install taches-cc-resources@taches-cc-resources
Open on GitHub

What occams-razor does

occams-razor applies Occam’s Razor to the supplied argument or to the current discussion when no argument is given. It lays out possible explanations, identifies the assumptions behind each one, and checks which assumptions have evidence.

The command then removes explanations that depend on unsupported assumptions. It selects the simplest option that still accounts for every observed fact, with the result organised into candidates, an evidence check, the selected explanation, and the reason it wins. With no argument, the current discussion becomes the subject of the analysis.

To install it in Claude Code, add the glittercowboy/taches-cc-resources marketplace, install taches-cc-resources@taches-cc-resources, and use the command file at .claude/commands/occams-razor.md.

What it helps with

  • compare competing causes of a failure
  • count the assumptions behind each hypothesis
  • remove explanations unsupported by evidence
  • choose an explanation that fits every observed fact

Example prompts for the agent

  • Use /taches-cc-resources:occams-razor to analyse this bug and compare the possible causes.
  • Run /taches-cc-resources:occams-razor on the current discussion, then identify the explanation with the fewest unsupported assumptions.
  • Apply /taches-cc-resources:occams-razor to the case where a test fails only in CI and show the evidence check.

How to install occams-razor

1Plugin marketplace

/plugin marketplace add glittercowboy/taches-cc-resources
/plugin install taches-cc-resources@taches-cc-resources

2Manually: put the files in place

.claude/commands/occams-razor.md

Call it with /occams-razor. For all projects use ~/.claude/commands/

Questions about occams-razor

How do I install occams-razor in Claude Code?

Run /plugin marketplace add glittercowboy/taches-cc-resources, then run /plugin install taches-cc-resources@taches-cc-resources. The command file is .claude/commands/occams-razor.md.

What does occams-razor do?

It compares possible explanations, checks the assumptions each one needs, and selects the option with the fewest unsupported assumptions while still fitting the facts.

What happens when I leave the argument blank?

The command analyses the current Claude Code discussion. If you provide an argument, it analyses that situation instead.

Source text

occams-razor.md · MIT
---
description: Find simplest explanation that fits all the facts
argument-hint: [situation or leave blank for current context]
---

<objective>
Apply Occam's Razor to $ARGUMENTS (or the current discussion if no arguments provided).

Among competing explanations, prefer the one with fewest assumptions. Simplest ≠ easiest; simplest = fewest moving parts.
</objective>

<process>
1. List all possible explanations or approaches
2. For each, count the assumptions required
3. Identify which assumptions are actually supported by evidence
4. Eliminate explanations requiring unsupported assumptions
5. Select the simplest that still explains all observed facts
</process>

<output_format>
**Candidate Explanations:**
1. [Explanation]: Requires assumptions [A, B, C]
2. [Explanation]: Requires assumptions [D, E]
3. [Explanation]: Requires assumptions [F]

**Evidence Check:**
- Assumption A: [supported/unsupported]
- Assumption B: [supported/unsupported]
...

**Simplest Valid Explanation:**
[The one with fewest unsupported assumptions]

**Why This Wins:**
[What it explains without extra machinery]
</output_format>

<success_criteria>
- Enumerates all plausible explanations
- Makes assumptions explicit and countable
- Distinguishes supported from unsupported assumptions
- Doesn't oversimplify (must fit ALL facts)
- Reduces complexity without losing explanatory power
</success_criteria>

© Lex Christopherson · MIT · glittercowboy/taches-cc-resources

Similar slash commands

All slash commands for Agent setup: memory, context, orchestration →

From the same set48

The whole set →
first-principles first-principles deconstructs problems down to irreducible truths, removes conventions, and designs solutions from the ground up. CX Codex +1 ★ 1,988repo stars one-thing one-thing is a Claude Code command that picks one action with the greatest effect on the rest of a goal. Run it with a goal or let it use the current discussion. CX Codex +1 ★ 1,988repo stars inversion Applies inversion thinking: instead of asking “how do I succeed”, it asks “what guarantees failure” and builds a plan by avoiding those traps. Surfaces risks that optimistic planning misses. CX Codex +1 ★ 1,988repo stars via-negativa via-negativa applies the principle of subtraction to your code, features, or plans, identifying bloat to cut rather than adding new complexity. CX Codex +1 ★ 1,988repo stars pareto pareto ranks the factors behind a decision by impact, keeps the few that carry most of the result and names the rest as safe to defer. CX Codex +1 ★ 1,988repo stars 10-10-10 10-10-10 evaluates choices across three distinct horizons: 10 minutes, 10 months, and 10 years. Spot tensions between immediate friction and lasting outcomes. CX Codex +1 ★ 1,988repo stars opportunity-cost The opportunity-cost command weighs a choice against the best alternative use of the same resources. Use it when you want to see what a decision costs in time, money, energy, or attention. CX Codex +1 ★ 1,988repo stars eisenhower-matrix This command applies the Eisenhower matrix to your tasks or current discussion, sorting them into four quadrants: urgent-important, important-not-urgent, urgent-not-important, and neither. CX Codex +1 ★ 1,988repo stars

Project sponsors

Companies that keep this analytics open