principle-redesign-from-first-principles SKILL.md skillA

This file is byte-identical to the first copy the registry indexed, one of 4 indexed copies. Same content hash, so the same checks give both the same grade.

principle-redesign-from-first-principles from backnotprop/pstack is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add backnotprop/pstack/principle-redesign-from-first-principles@git:20261012.f3afb70

Pins git:20261012.f3afb70 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
backnotprop/pstack
Path
skills/principle-redesign-from-first-principles/SKILL.md
Versions recorded
3
Latest version
git:20261012.f3afb70, committed Oct 12, 2026
First version recorded
May 27, 2026
Size
758 bytes
Repository stars
3,337
License
MIT

Apply when integrating a new requirement into an existing design.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Redesign From First Principles

When integrating a change, don't bolt it onto the existing design. Redesign as if the requirement had been a foundational assumption from the start.

- Read all affected files and understand the current design
- Ask: "if we were writing this from scratch with this new requirement, what would we build?"
- Propagate the change through every reference: types, docs, examples, rationale sections
- Think about the whole redesign, then deliver it incrementally

This is the method for preserving option value when integrating changes into an existing design.

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add backnotprop/pstack/principle-redesign-from-first-principles@sha256:170e0a658783e43f

The line at the top of this page pins the label git:20261012.f3afb70, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_j6o3lekxiy3u2nmx.svg)](https://markdownregistry.com/a/art_j6o3lekxiy3u2nmx)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between May 27, 2026 and Oct 12, 2026, about one every 69 days.

versioncommittedcommitsizeaudit
git:20261012.f3afb70 latest2026-10-12 f3afb70 758 BA view · diff
git:20260914.55bfdc22026-09-14 55bfdc2 844 BA view · diff
git:20260527.b3eabf12026-05-27 b3eabf1 943 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (758 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

GitHub

backnotprop/pstack · 3,337 stars · license MIT · pushed 2026-10-28 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_j6o3lekxiy3u2nmx
GET https://markdownregistry.com/api/v1/resolve?ref=backnotprop/pstack/principle-redesign-from-first-principles
GET https://markdownregistry.com/api/v1/blob/170e0a658783e43fee8ec5a8c2422a4abb8f69cef621dd1819a95910b8207034

Your AI assistant 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.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from backnotprop/pstack

reproduce-and-fix-issues SKILL.md skill
backnotprop/pstack · automations/benny/skills/reproduce-and-fix-issues/SKILL.md · Reproduce triaged Slack bugs through a configured app-control adapter, verify existing fixes, and open a bounded draft…
git:20260819.4b32d9d · audit A · 3,337 stars
setup-benny SKILL.md skill
backnotprop/pstack · automations/benny/skills/setup-benny/SKILL.md · Configure Benny and prepare its triage and repro automations. Use when installing Benny or changing its Slack, tracker…
git:20260819.4b32d9d · audit A · 3,337 stars
triage-issue-reports SKILL.md skill
backnotprop/pstack · automations/benny/skills/triage-issue-reports/SKILL.md · Triage Slack issue reports with one thread-only verdict, evidence review, cause-aware routing, tracker dedupe, and…
git:20260819.4b32d9d · audit A · 3,337 stars
architect SKILL.md skill
backnotprop/pstack · skills/architect/SKILL.md · Sketch types, signatures, and module structure before code, then stay in the loop while implementation fills in. Use…
git:20261020.e44668c · audit A · 3,337 stars
arena SKILL.md skill
backnotprop/pstack · skills/arena/SKILL.md · Spawn N parallel candidates at the same task, pick a base, graft the strongest parts of the losers into it. Use for…
git:20261028.23ef874 · audit A · 3,337 stars
automate-me SKILL.md skill
backnotprop/pstack · skills/automate-me/SKILL.md · Use for "automate me", "create/update/refresh my -mode skill", "turn/capture my preferences or working style into a…
git:20261015.6f131f1 · audit A · 3,337 stars
benchmark-checklist SKILL.md skill
backnotprop/pstack · skills/benchmark-checklist/SKILL.md · Vet a perf measurement (limiter, tuning, limits, errors, repeatability, relevance, and whether the work happened)…
git:20261012.f3afb70 · audit A · 3,337 stars
blast-radius SKILL.md skill
backnotprop/pstack · skills/blast-radius/SKILL.md · Find what a change could break somewhere else before it ships, beyond the diff, and prove the one fact it's safe…
git:20261008.4aed5af · audit A · 3,337 stars
bro SKILL.md skill
backnotprop/pstack · skills/bro/SKILL.md · Restate the last message in plain human language, with no jargon.
git:20260819.4b32d9d · audit A · 3,337 stars
correct SKILL.md skill
backnotprop/pstack · skills/correct/SKILL.md · Find the mistakes agents keep repeating in this repo and make each one impossible. Try architecture first, then types…
git:20261015.df856f4 · audit A · 3,337 stars
create-formal-verification-skill SKILL.md skill
backnotprop/pstack · skills/create-formal-verification-skill/SKILL.md · Generate a project-local skill that formally verifies the code where a bug costs the most and tests reach the least, in…
git:20261027.0410d4b · audit A · 3,337 stars
create-verification-skill SKILL.md skill
backnotprop/pstack · skills/create-verification-skill/SKILL.md · Generate a project-local verification skill that drives your app the way a user does — any language, framework, or…
git:20261012.fce11a3 · audit A · 3,337 stars

Every file in backnotprop/pstack

Other files named principle-redesign-from-first-principles

principle-redesign-from-first-principles SKILL.md skill
cursor/plugins · harness/pstack/claude-code/skills/principle-redesign-from-first-principles/SKILL.md · Apply when integrating a new requirement into an existing design.
git:20261016.182f2ce · audit A · 15,125 stars
principle-redesign-from-first-principles SKILL.md skill
cursor/plugins · pstack/skills/principle-redesign-from-first-principles/SKILL.md · Apply when integrating a new requirement into an existing design.
git:20261010.00b14f1 · audit A · 15,125 stars
principle-redesign-from-first-principles SKILL.md skill
nightly-labs/openbot · marketplace/production-catalog/bundles/pstack/skills/principle-redesign-from-first-principles/SKILL.md · Apply when integrating a new requirement into an existing design.
git:20261013.9e6954c · audit A · 5,267 stars
principle-redesign-from-first-principles SKILL.md skill
michael-denyer/pstack-claude · plugins/pstack/skills/principle-redesign-from-first-principles/SKILL.md · Apply when integrating a new requirement into an existing design.
git:20261013.058a348 · audit A · 3,776 stars
principle-redesign-from-first-principles SKILL.md skill
iap/pstack-hermes · skills/principle-redesign-from-first-principles/SKILL.md · Apply when integrating a new requirement into an existing design. Redesign as if the requirement had been a…
git:20261031.336cc57 · audit A · 32 stars
principle-redesign-from-first-principles SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/engineering-principles/redesign-from-first-principles/SKILL.md · Apply when integrating a new requirement into an existing design. Redesign as if the requirement had been a…
git:20260821.1b830a3 · audit A · 26 stars
principle-redesign-from-first-principles SKILL.md skill
barbieri/local-openfinance · .agents/skills/principle-redesign-from-first-principles/SKILL.md · Apply when integrating a new requirement into an existing design. Redesign as if the requirement had been a…
git:20261005.32edae5 · audit A · 24 stars
principle-redesign-from-first-principles SKILL.md skill
theonlyfusioncube/potetos-for-everyone · skills/principle-redesign-from-first-principles/SKILL.md · Design the shape you would choose if the requirement had existed from day one, then migrate toward that shape. Use when…
git:20260908.ec65ed5 · audit A · 20 stars

Browse by kind, by grade A, or by owner.