Skip to content
AI & Agents
Skill

/FirstPrinciples

Physics-based reasoning framework (Musk methodology) that deconstructs a problem to irreducible fundamental truths, classifies every element as hard constraint, soft constraint, or assumption, then reconstructs the optimal solution from fundamentals alone. USE WHEN first

From plugin
lifeos
20k97 skills13 agents34 commands

Claude Code

$ npx -y skills add danielmiessler/lifeos --skill FirstPrinciples --agent claude-code

SKILL.md

FirstPrinciples.SKILL.md
name: FirstPrinciples
evals:
  manual:
    reason: "the classification of constraints and assumptions must be judged against the supplied problem domain"
    falsifier: "the reviewer finds a claimed hard constraint unsupported or a material assumption omitted from the reconstruction"
metadata:
  short-description: "Rebuild solutions from fundamental truths by separating hard constraints, soft constraints, and assumptions. Use SystemsThinking for feedback loops."
version: 1.1.21
description: "Physics-based reasoning framework (Musk methodology) that deconstructs a problem to irreducible fundamental truths, classifies every element as hard constraint, soft constraint, or assumption, then reconstructs the optimal solution from fundamentals alone. USE WHEN first principles, fundamental truths, challenge assumptions, real constraint, rebuild from scratch, start over, physics first, question everything, reasoning by analogy. NOT FOR structural feedback loops (use SystemsThinking)."

FirstPrinciples

**Contents:** Ideal State · Intent Routing · Constraint Classification · The Core Distinction · The Load-Bearing Rules · Output Format · Data & Config · Gotchas · Examples

Breaks a problem down to its fundamental truths and rebuilds the solution from there, instead of copying what already exists. Three steps, each an intent: DECONSTRUCT (break it into constituent parts and real values), CHALLENGE (classify every element as hard constraint, soft constraint, or unvalidated assumption; only physics is truly immutable), and RECONSTRUCT (build the optimal solution from the fundamentals alone). Outputs a parts breakdown, a constraint table, and a reconstructed solution. It is analysis, not implementation: a request to fix something is done directly, not through this skill. Other skills call it when inherited assumptions may be limiting the solution space: architecture work asking "constraint or convention?", RedTeam and pentests attacking assumed boundaries, RedTeam building counter-proposals with Reconstruct, and engineering escaping a local maximum.

Ideal State

  • What the analysis calls fundamental is only physics, math, verified fact or a truly immutable requirement; every market price, best practice and policy is shown to be convention and taken apart.
  • The irreducible function of the subject is stated as an outcome, not a mechanism ("pick the right model and effort for a piece of work", not "a router"), and every component under discussion is marked as serving that function or not. Costing from fundamentals appears only when cost is part of the question.
  • Output length matches the request: an inline, brief or terse pass returns the irreducible job, the classification with its evidence, and the key insight in a few lines, without empty template sections; the full templates are for full runs.
  • A full run ends with a solution rebuilt from the hard constraints and compared against the current approach, plus the one assumption that was limiting it.

Intent Routing

| Intent | Trigger | File | |--------|---------|------| | **Deconstruct** | "what is this actually made of", "break it down", "what is X irreducibly for", costs or complexity that seem fixed | `Intents/Deconstruct.md` | | **Challenge** | "challenge assumptions", "is that a real constraint", "hard or inherited", "we can't do X" with no evidence | `Intents/Challenge.md` | | **Reconstruct** | "rebuild from scratch", "start over", escape a local maximum, hard constraints already known | `Intents/Reconstruct.md` |

A full analysis runs them in order, Deconstruct → Challenge → Reconstruct; each also runs alone when its input is already in hand. A standalone Challenge hands its analysis to Reconstruct or back to the requester for a decision.

Constraint Classification

Every intent uses this one classification; Challenge applies it to each constraint. Only hard constraints are truly immutable; soft constraints and assumptions are challenged.

| Type | Definition | Test | Examples | Can Change? | |------|------------|------|----------|-------------| | **HARD** | Physics/math/reality | Would violating this break laws of nature? | Speed of light, thermodynamics, gravity; "Data can't travel faster than light" | No | | **SOFT** | Policy/choice/convention | Could a decision-maker change this? | "We use AWS", "We always use REST APIs", budget limits | Yes | | **ASSUMPTION** | Unvalidated belief | Has this been tested? What's the evidence? | "Users won't accept that UX", "Too expensive" | Maybe false |

The Core Distinction

Most reasoning is reasoning by analogy — "how did we solve something similar," "what do others do" — then copy it with tweaks. That inherits everyone else's assumptions and treats policy and convention as if they were laws of physics, so you optimize the suitcase instead of inventing wheels. First principles forces the split between what's actually immutable and what's merely inherited, then rebuilds from only the parts that can't change.

  • **Reasoning by analogy** (default, often wrong): copies existing solutions with slight variations.
  • **Reasoning from first principles** (this skill): asks "what is this actually made of?" and rebuilds from irreducible facts.

Invoked directly, or by other skills when inherited assumptions may be limiting the solution space — architecture work asking "constraint or convention?", RedTeam and pentests attacking assumed boundaries, engineering escaping local maxima.

The Load-Bearing Rules

  • **Market prices and industry best-practices are NOT fundamental truths.** "Batteries cost $600/kWh" or "hosting costs $10K/mo" are convention, not physics — deconstruct to material/compute cost before accepting them.
  • **Optimize function over form** — what you're trying to accomplish, not how it's traditionally done (improve the wheel, don't polish the suitcase).
  • **Rebuild, don't patch** — when the assumptions are wrong, start from the hard constraints rather than fixing the inheri
Read more
@danielmiessler
Ships withlifeos

⛰️ LifeOS — The universal AI Harness designed to move you from Current to Ideal state in both life and work.

20k97 skills13 agents
Get the whole plugin

Stars on GitHub

Momentum

stars in total
19.7k
Star history of danielmiessler/lifeos on GitHub, a chart by star-history.com

Other skills on lifeos.

AnnualReports

AnnualReports

Aggregate several hundred cybersecurity annual reports from CrowdStrike, Mandiant, IBM, Verizon, Microsoft, CISA, OWASP, Wiz,…

ApertureOscillation

ApertureOscillation

3-pass scope oscillation that holds a question constant while shifting zoom — narrow/tactical, wide/strategic, then synthesis —…

Aphorisms

Aphorisms

Curated aphorism collection with CRUD: content-based matching, themed search, thinker research, and usage tracking to avoid…

ArXiv

ArXiv

Search and retrieve arXiv academic papers by topic, category, or paper ID — with AlphaXiv-enriched AI-generated overviews. Uses…

Art

Art

Static visual content in 20+ formats (diagrams, infographics, comics, icons, wallpaper) via Nano Banana Pro by default, Nano…

ArtDirection

ArtDirection

Directs visual quality across images, films, slides, and site captures through a direction council, two vendors' vision judgments…

More skills from other plugins.

1password

1password

Set up and use 1Password CLI for sign-in, desktop integration, and reading or injecting secrets.

openclaw2w393k
@openclaw@openclawInstall Skill

Questions about FirstPrinciples.

Which coding agents can use FirstPrinciples?
FirstPrinciples installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.