first-principles-review skillA
first-principles-review is agent-read markdown (skill) from ganyuanran/aegis: Use when asked for first-principles or Occam's-razor review, or when high-risk decisions involve competing constraints, fallback growth, duplicate owners, or architecture direction risk. Ordinary bug fixes stay on the fast path..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# 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. When this review materially changes the direction, surface `Aegis Visibility` in natural prose: name the first principle, dropped assumption, smallest sufficient path, or owner / retirement falsifier that changed the decision. Keep it advisory and task-specific; do not turn the lens into approval authority or a generic skill trace. ## 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. …
Read the whole file at its exact version.
How to install
mdr add ganyuanran/aegis/first-principles-review@git:20260905.878cac9mdr add ganyuanran/aegis/first-principles-review@sha256:6ca49ee3e0bd44e9Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_d6xbjl2wx6roh2hm)
1 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260905.878cac9 latest | 2026-09-05 | 878cac9 | 9,940 B | A | view · diff |
| git:20260901.e71b85a | 2026-09-01 | e71b85a | 8,481 B | A | view · diff |
| git:20260830.8e0cee3 | 2026-08-30 | 8e0cee3 | 8,222 B | A | view · diff |
| git:20260823.4a281c2 | 2026-08-23 | 4a281c2 | 7,272 B | A | view · diff |
| git:20260809.f62395b | 2026-08-09 | f62395b | 6,975 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (9940 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
ganyuanran/aegis · 1,280 stars · license MIT · pushed 2026-09-24 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_d6xbjl2wx6roh2hm GET https://markdownregistry.com/api/v1/resolve?ref=ganyuanran/aegis/first-principles-review GET https://markdownregistry.com/api/v1/blob/6ca49ee3e0bd44e9b6fa98ef3af1cf43c38af99c34895b9fe02ce8d29d969e90
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.