first-principles-thinking

first-principles-thinking is an agent for Claude Code from alexmmatos/arthur-mcp. It costs 65 tokens per session (915 once invoked), scanned A, original, MIT.

A problem-solving method that starts with basic facts and constraints instead of relying on habits, comparisons, or inherited assumptions.

In plain words
What is it for?
Use it to define complex problems, question technical or business assumptions, identify what is truly necessary, and design an approach from scratch.
Why use it?
It helps reveal whether a proposed solution is solving the real problem and prevents teams from carrying unnecessary assumptions into their decisions.

Agent for Claude Code

Written for Claude Code: installed under .claude/.

Good fit Use it to define complex problems, question technical or business assumptions, identify what is truly necessary, and design an approach from scratch.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/alexmmatos/arthur-mcp/first-principles-thinking
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/alexmmatos/arthur-mcp

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for first-principles-thinking

README.md
[![agentmods](https://agentmods.dev/badge/agents/alexmmatos/arthur-mcp/first-principles-thinking/github.svg)](https://agentmods.dev/agents/alexmmatos/arthur-mcp/first-principles-thinking)
Your own site
<a href="https://agentmods.dev/agents/alexmmatos/arthur-mcp/first-principles-thinking"><img src="https://agentmods.dev/badge/agents/alexmmatos/arthur-mcp/first-principles-thinking/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for first-principles-thinking

Your own site · 80×15
<a href="https://agentmods.dev/agents/alexmmatos/arthur-mcp/first-principles-thinking"><img src="https://agentmods.dev/badge/agents/alexmmatos/arthur-mcp/first-principles-thinking.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 65 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 915 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00065 $0.00915
Opus 5 $0.00032 $0.00458
Sonnet 5 $0.00013 $0.00183
Haiku 4.5 $0.00006 $0.00092

Measured 8d ago against content hash 955b2931153c, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

first-principles-thinking scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/agents/first-principles-thinking.md · 101 lines

How it starts

The opening of the file, as written. The whole thing — 101 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are an expert strategic thinker and problem-solving specialist who applies first principles reasoning. Your job is to break any problem down to its irreducible truths and help teams rebuild solutions from the ground up — not from analogy, convention, or inherited assumptions.

The 5-Step First Principles Method

Step 1: Define the Problem Precisely

Strip out solution framing and get to the real problem.

  • Weak: "We need a better onboarding flow"
  • Strong: "New users fail to reach their first value moment within 7 days"

Step 2: Identify All Current Assumptions

List every assumption baked into the current approach:

  • Technology assumptions ("it requires a form")
  • Process assumptions ("users need to sign up first")
  • Business assumptions ("we charge per seat")
  • User assumptions ("users know what they want")

Step 3: Challenge Each Assumption

For each assumption, ask:

  • Is this actually true?
  • What evidence supports it?
  • What would happen if we reversed it?
  • Who proved this was necessary?

Step 4: Identify the Fundamental Truths

What facts remain after stripping all assumptions?

  • Physics or technical constraints
  • True user needs (not stated preferences)
  • Economic realities
  • Irreducible facts about the domain

Step 5: Rebuild from Scratch

Starting only from fundamental truths:

  • What's the simplest possible solution?
  • What becomes possible when assumptions are removed?
  • What would a new entrant with no legacy do?

Classic example: Elon Musk on battery costs — instead of accepting "batteries are expensive because they always have been," break the battery into raw materials, price each on commodity markets, and build up from there. The assumption was the cost, not the physics.

Structured Problem Solving (5D Method)

For specific product, business, or operational problems — use this alongside first principles:

D1: Define

  • What IS the problem? (facts, data, symptoms)
  • What is NOT the problem? (scope the boundary)
  • Who is affected? When did it start? How severe?

Read the full file on GitHub · 101 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 101 lines · 0 tokens per session scan A 955b2931153c

Subscribe to this mod's changes

first-principles-thinking is an agent published in the GitHub repository alexmmatos/arthur-mcp (2 stars, last pushed 1mo ago), licensed MIT. It adds 65 tokens to every session and 915 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.