first-principles-review

Solid

Use when the user explicitly asks for first principles, first-principles review, Occam's razor, or when a complex decision has ambiguous goals, competing constraints, repeated fixes, fallback growth, duplicate owners, or architecture/product direction risk.

Code & Development 400 stars 16 forks Updated today MIT

Install

View on GitHub

Quality Score: 89/100

Stars 20%
87
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# First Principles Review ## Purpose Use this as a lightweight decision review before another Aegis workflow makes a directional choice. It is a compositional skill, not a standalone workflow. Do not replace `brainstorming`, `systematic-debugging`, `writing-plans`, `requesting-code-review`, or `verification-before-completion`. Use it to clean the decision surface those skills will act on. ## Use When - The user asks for first principles, first-principles thinking, or Occam's razor. - A design, plan, or fix has multiple plausible paths and unclear selection criteria. - The task has ambiguous goals, competing constraints, or product/architecture direction risk. - Debugging is drifting into repeated fixes, fallback growth, duplicate owners, consumer-side patches, or "just add another branch" reasoning. - A review finds that the implementation may be locally correct but directionally wrong. ## Do Not Use - Simple Q&A, status checks, tiny wording/config edits, or clearly bounded single-owner changes. - Mechanical execution of an approved plan unless a new directional conflict appears. - As a required step for every task, every turn, or every TDD cycle. ## Five-Line Review Answer only what is needed, usually in five short lines: ```text First Principle: What irreducible outcome must this satisfy? Non-negotiables: What constraints cannot be broken? Assumptions to Drop: What is habit, inherited shape, or unproven preference? Smallest Sufficient Path: What is t...

Details

Author
GanyuanRan
Repository
GanyuanRan/Aegis
Created
1 months ago
Last Updated
today
Language
Shell
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

Code & Development Listed

code-review

Use to review diffs and PRs for bugs, regressions, edge cases, proof, and merge readiness.

0 Updated yesterday
kreek
AI & Automation Listed

first-principles

Use when facing complex problems requiring innovative solutions, when conventional approaches fail, when breaking down assumptions, or when user asks to 'think from first principles', 'get to the root', 'fundamentally rethink', 'what's the essence', 'strip away assumptions'.

4 Updated today
konglong87
AI & Automation Listed

thinking-first-principles

Break complex problems into fundamental truths by questioning assumptions and rebuilding from irreducible components. Use for innovation, challenging status quo, or when conventional solutions fail.

1 Updated today
babypochi06
AI & Automation Listed

doubt-driven-review

Adversarial fresh-context review for non-trivial decisions before they stand. Use for production-impacting logic, security-sensitive changes, unfamiliar code, or high-blast-radius architecture choices.

15 Updated yesterday
charlieviettq
Code & Development Listed

review-work

Independent post-implementation review — an agent with no sunk-cost bias checks just-written code or an artifact against its requirements, then resolves the issues found (max 2 rounds). Use to verify a change before shipping, get a second opinion, or check what you missed; auto-triggers for security-sensitive and data-mutation code. Not for code refactoring (use clean-code) or decision analysis (use debate-agents).

10 Updated 2 days ago
hungv47