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
/plugin marketplace add glittercowboy/taches-cc-resources
/plugin install taches-cc-resources@taches-cc-resourcesWhat 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-resources2Manually: put the files in place
.claude/commands/first-principles.mdCall it with /first-principles. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/first-principles.mdCall it with /prompts:first-principles. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/first-principles.prompt.mdManually: put the files in place
.gemini/commands/first-principles.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
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