mcpField
P
principle-redesign-from-first-principles

principle-redesign-from-first-principles

github.com/mdsmithaustinDevelopment8182 installsUpdated today
Repository

About principle-redesign-from-first-principles

A coding skill for integrating changes by redesigning around the new requirement while preserving existing behavior elsewhere. It guides developers to understand affected code and update related references across the project.

Key features

  1. 01Understand affected files and current design
  2. 02Preserve behavior outside the changed requirement
  3. 03Redesign from the new foundational assumption
  4. 04Propagate changes through references
  5. 05Deliver the redesign incrementally

Use cases

  1. 01Restructuring a feature around a new requirement
  2. 02Updating types, documentation, and examples after a redesign

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mdsmithaustin/pstack --skill principle-redesign-from-first-principles

After installing, type/principle-redesign-from-first-principlesin Claude Code to confirm it loaded.

Bundled filesagents/openai.yaml

Details

From the project README

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
  • Treat the current code's behavior as the spec for everything the requirement does not explicitly change. Redesign the structure, and keep that behavior
  • 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.

Comments

Markdown supported