Skip to main content
command CX Codex

first-principles — Claude Code command: what it does and how to install

first-principles deconstructs problems down to irreducible truths, removes conventions, and designs solutions from the ground up.

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 first-principles does

This command applies first principles thinking to your prompt or the current conversation history. It takes an optional problem statement as an argument; omitting it directs the model to evaluate the ongoing context.

The underlying instruction guides the model through five stages: stating the premise, listing assumptions, testing their validity, isolating core truths, and reassembling a proposal. Output comes neatly divided into tested assumptions, fundamental truths, rebuilt logic, and newly emerged paths. Reasoning by analogy is strictly avoided.

What it helps with

  • surface hidden assumptions in system designs
  • separate hard constraints from team habits
  • identify irreducible technical truths for a problem
  • discover fresh architecture options without relying on analogies

Example prompts for the agent

  • /first-principles Why do we need an external message broker here?
  • /first-principles Can we eliminate caching entirely for this endpoint?
  • /first-principles

How to install first-principles

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/first-principles.md

Call it with /first-principles. For all projects use ~/.claude/commands/

Questions about first-principles

How to install first-principles in Claude Code?

Run /plugin marketplace add glittercowboy/taches-cc-resources followed by /plugin install taches-cc-resources@taches-cc-resources.

What does first-principles do?

It breaks down a topic to its root truths, challenges assumptions, and reconstructs a viewpoint from foundational premises.

Can I run the command without arguments?

Yes. Leaving the argument empty makes the command examine the current conversation context.

Source text

first-principles.md · MIT
---
description: Break down to fundamentals and rebuild from base truths
argument-hint: [problem or leave blank for current context]
---

<objective>
Apply first principles thinking to $ARGUMENTS (or the current discussion if no arguments provided).

Strip away assumptions, conventions, and analogies to identify fundamental truths, then rebuild understanding from scratch.
</objective>

<process>
1. State the problem or belief being examined
2. List all current assumptions (even "obvious" ones)
3. Challenge each assumption: "Is this actually true? Why?"
4. Identify base truths that cannot be reduced further
5. Rebuild solution from only these fundamentals
</process>

<output_format>
**Current Assumptions:**
- Assumption 1: [challenged: true/false/partially]
- Assumption 2: [challenged: true/false/partially]

**Fundamental Truths:**
- Truth 1: [why this is irreducible]
- Truth 2: [why this is irreducible]

**Rebuilt Understanding:**
Starting from fundamentals, here's what we can conclude...

**New Possibilities:**
Without legacy assumptions, these options emerge...
</output_format>

<success_criteria>
- Surfaces hidden assumptions
- Distinguishes convention from necessity
- Identifies irreducible base truths
- Opens new solution paths not visible before
- Avoids reasoning by analogy ("X worked for Y so...")
</success_criteria>

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

Similar slash commands

All slash commands for Notes, tasks and projects →

From the same set48

The whole set →
audit-slash-command Invokes a subagent to audit slash command files for compliance. Checks YAML syntax, arguments, dynamic context, tool restrictions, and content quality. CX Codex +1 ★ 1,988repo stars audit-subagent audit-subagent — a Claude Code command that runs a configuration audit for subagents: checks XML structure, settings, tool selection, and compliance with standards. Takes a path to the subagent .md file as argument. CX Codex +1 ★ 1,988repo stars audit-skill audit-skill is a Claude Code command that checks a skill against YAML, XML, and progressive disclosure requirements before structural changes or publication. CX Codex +1 ★ 1,988repo stars 5-whys 5-whys runs the five whys technique on the problem you hand it and returns a root cause with one action to take. Useful when a bug keeps coming back after a fix. 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 occams-razor 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. CX Codex +1 ★ 1,988repo stars

Project sponsors

Companies that keep this analytics open