first-principles-review

Identify irreducible outcomes and non-negotiable constraints for high-risk decisions.

968|43|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/GanyuanRan/Aegis --skill first-principles-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: first-principles-review
Source: https://github.com/GanyuanRan/Aegis/tree/main/skills/first-principles-review
Command: npx skills add https://github.com/GanyuanRan/Aegis --skill first-principles-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Cleanly identifies irreducible outcomes and non-negotiable constraints to guide difficult decisions, reducing ad-hoc reasoning and scope drift.

Core Features & Use Cases

  • Structured decision surfaces: Five-Line Review, Decision Hygiene Review, and Architecture Integrity Lens to surface risks and dependencies.
  • Escalation readiness: clear signals for when to escalate to higher authority or ADRs, retirement paths, or redesign needs.
  • Composable with other method-pack skills to reinforce governance during design and planning.

Quick Start

Provide a concise five-line assessment of the current decision surface, identifying non-negotiables, conflicting constraints, and a recommended next step.

Frequently Asked Questions about first-principles-review

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

FAQPage Schema
How do I make architectural decisions with ambiguous goals and conflicting constraints?

Architectural decisions with ambiguous goals require identifying irreducible outcomes and non-negotiable constraints. This approach applies first-principles thinking to high-risk design choices, delivering an auditable assessment that reduces ad-hoc reasoning and prevents scope drift.

What is the best way to assess risk for a software framework redesign?

Risk assessment for a software framework redesign is best handled by applying a structured decision hygiene review. It surfaces dependencies and high-risk factors, providing clear escalation signals for when to trigger retirement paths or full redesign needs.

How do I conduct a first-principles review for product choices?

Conducting a first-principles review for product choices involves generating a compact Five-Line Review. It identifies non-negotiables, conflicting constraints, and a recommended next step, cleanly separating irreducible outcomes from ad-hoc reasoning.

When should I escalate architecture decisions to higher authority or ADRs?

You should escalate architecture decisions to higher authority or ADRs when repetitive fix cycles indicate deeper structural flaws. The review process provides clear escalation readiness signals, particularly when conflicting constraints block standard design choices.

Can I use this first-principles method for repetitive fix cycles in software engineering?

Yes, you can apply this method to repetitive fix cycles in software engineering. By focusing on irreducible outcomes and non-negotiable constraints, it breaks the cycle of ad-hoc reasoning and delivers an auditable assessment to guide high-risk decision making.

Does architecture review require any specific dependencies or component frameworks?

No, this architecture review process requires no specific dependencies or component frameworks. It is a composable method-pack skill that uses structured decision surfaces like the Architecture Integrity Lens to evaluate risks independently of specific platforms.