mcpField
P
principle-redesign-from-first-principles

principle-redesign-from-first-principles

github.com/potetoDevelopment161102 installsUpdated 22w ago
Repository

About principle-redesign-from-first-principles

principle-redesign-from-first-principles is a development skill for integrating changes by reconsidering the design as a whole, rather than adding a bolt-on. It guides developers to trace a requirement through affected code, documentation, and examples.

Key features

  1. 01Reassess the design from scratch
  2. 02Read affected files holistically
  3. 03Propagate changes across references
  4. 04Plan holistically, deliver incrementally

Use cases

  1. 01Integrate a new requirement into an existing design
  2. 02Update related types, docs, and examples
  3. 03Preserve design flexibility during changes

Install

Copy the command and run it in a terminal.

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

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

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 there from the start. The result should look like what we would have built if we'd known on day one.

  • Read all affected files and understand the current design holistically
  • 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 redesign holistically, then deliver it incrementally

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

Comments

Markdown supported