Skip to content
Productivity
Skill

/thinking-first-principles

When a constraint is treated as fixed, separate physics from convention, keep only independently supported primitives, and rebuild the simplest solution that satisfies real constraints.

From plugin
thinking-skills
1.7k28 skills

Claude Code

$ npx -y skills add tjboudreaux/cc-thinking-skills --skill thinking-first-principles --agent claude-code

SKILL.md

thinking-first-principles.SKILL.md
name: thinking-first-principles
description: When a constraint is treated as fixed, separate physics from convention, keep only independently supported primitives, and rebuild the simplest solution that satisfies real constraints.
disable-model-invocation: true

First Principles

Strip assumed constraints to independently supported primitives, then rebuild. Escape analogy when convention fails or looks artificially expensive.

When to Use

  • A constraint is treated as fixed ("too expensive," "impossible," "always done this way") without independent support.
  • Convention or analogy has failed, stalled, or only yields weak incremental variants.
  • Greenfield design where industry defaults may smuggle false requirements.
  • Cost or feasibility claims rest on pricing, precedent, or authority rather than physics, math, or measured need.

When NOT to Use

  • The constraint is verified physics, hard regulation, or measured capacity → accept it and optimize within it.
  • A proven standard library, protocol, or known-good pattern already fits → use it; do not re-derive.
  • Time-critical incidents → act on the most likely cause first; reserve first-principles rebuild for post-incident redesign.
  • Incremental polish of a working system with no false-constraint signal → skip.

Procedure

1. **State the problem and claimed constraints.** List every limit treated as fixed (cost, scale, stack, process, "must use X"). 2. **Classify each constraint.** Tag as `physics/math`, `regulation/contract`, `measured fact`, or `convention/analogy/authority`. Keep only the first three as binding unless evidence upgrades a convention. 3. **Decompose to primitives.** Required inputs, conservation/complexity bounds, true non-negotiables. Demand independent support (measurement, derivation, primary requirement)—not vendor pricing or competitor precedent. 4. **Discard unsupported assumptions.** For each convention tag, state a falsifier. Drop or renegotiate anything lacking support. 5. **Rebuild from remaining primitives only.** Simplest solution that satisfies binding constraints and ignores artificial ones. Prefer commodity inputs and fewer moving parts over analogy. 6. **Validate and stop.** Check against real physics, contracts, and measured needs. Define the cheapest kill test. Stop when a coherent rebuild plus discriminating validation exists, or when only verified hard constraints remain.

Output

Emit a first-principles rebuild:

  • `claimed_constraints`: list with classification tags
  • `primitives`: independently supported truths only
  • `discarded_assumptions`: conventions dropped and why
  • `rebuild`: solution derived only from primitives
  • `binding_residuals`: real limits that remain
  • `kill_test`: cheapest check that would falsify the rebuild

Verification

  • **Independence check:** every primitive must cite measurement, derivation, or primary requirement—not precedent alone.
  • **No smuggled analogy:** if the rebuild still depends on "how others do it" without a primitive, strip it.
  • **Constraint honesty:** verified physics/regulation must remain; do not wish them away.
  • **Over-application guard:** if a standard solution is already optimal under verified constraints, do not rebuild for novelty.
  • **Stop:** one decompose → classify → rebuild → kill-test pass; do not recurse without new evidence.
Read more
@tjboudreaux
Ships withthinking-skills

28 portable Agent Skills for structured reasoning in Claude Code, GitHub Copilot, Codex, Cursor, and other compatible tools Claude Code Thinking Skills is a public catalog of Agent Skills.

Stars on GitHub

Momentum

stars in total
1.7k
Star history of tjboudreaux/cc-thinking-skills on GitHub, a chart by star-history.com

Other skills on thinking-skills.

More skills from other plugins.

i-have-adhd

i-have-adhd

Shape output for a reader with ADHD: lead with the next action, number multi-step work, restate state across turns, suppress…

@ayghri@ayghriInstall Skill
ab-test-analysis

ab-test-analysis

Analyze A/B test results with statistical significance, sample size validation, confidence intervals, and ship/extend/stop…

@phuryn@phurynInstall Skill
distilly

distilly

Set up the owner profile so a personal agent knows who it works for (first-run setup, \"get to know me\"), or distill colleague,…

Questions about thinking-first-principles.

Which coding agents can use thinking-first-principles?
thinking-first-principles 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.