first-principles

Audit inherited assumptions and verify ground-truth before acting.

Updated May 18, 2026
One-click install
npx skills add https://github.com/solitude6060/Yao-skills --skill first-principles-solitude6060
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: first-principles
Source: https://github.com/solitude6060/Yao-skills/tree/main/skills/first-principles
Command: npx skills add https://github.com/solitude6060/Yao-skills --skill first-principles-solitude6060

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents costly mistakes caused by inherited or convenient assumptions that go unverified, especially when “the obvious fix” skips ground-truth checks during incidents and hotfixes.

Core Features & Use Cases

  • 5-question assumption audit that distinguishes underlying need vs proposed solution, inherited vs verified claims, and symptoms vs root causes.
  • Ground-truth verification protocol that forces per-item, minimally invasive checks instead of trusting LLM summaries, hearsay, or sub-agent aggregates.
  • Hotfix dual/triple review gate that blocks “urgency overrides review” failure modes and produces a structured audit note for follow-ups.

Quick Start

Run the first-principles audit for the request or incident you were given, answering all five questions and then verifying each factual claim with the smallest direct probe available.

Frequently Asked Questions about first-principles

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit inherited assumptions during root cause analysis?

To audit inherited assumptions during root cause analysis, apply a five-question audit distinguishing underlying need versus proposed solution, inherited versus verified claims, and symptoms versus root causes.

How do I verify ground truth before deploying a hotfix?

Verify ground truth before deploying a hotfix by executing a per-item, minimally invasive direct check instead of trusting LLM summaries, hearsay, or sub-agent aggregates for factual claims.

How do I block urgency overrides review failure modes during incident triage?

Block urgency overrides review failure modes during incident triage by enforcing a hotfix dual/triple review gate that distinguishes workaround from root-cause fixes and produces a structured audit note.

What is the best way to review assumptions before a code refactor?

The best way to review assumptions before a code refactor is running a five-question assumption audit to separate proposed solutions from underlying needs and verify inherited claims against ground truth.

When do I need an assumption audit for proactive build or incident work?

You need an assumption audit for proactive build or incident work when urgency or a too good to be true signal creates high error risk by skipping ground truth verification checks.