principle-redesign-from-first-principles

Redesigns existing code as if new requirements were foundational assumptions from the start.

4|1|Updated Dec 16, 2023
One-click install
npx skills add https://github.com/Shtian/AuthentiClash --skill principle-redesign-from-first-principles-shtian
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: principle-redesign-from-first-principles
Source: https://github.com/Shtian/AuthentiClash/tree/main/.claude/skills/principle-redesign-from-first-principles
Command: npx skills add https://github.com/Shtian/AuthentiClash --skill principle-redesign-from-first-principles-shtian

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When new requirements are bolted onto an existing design, codebases accumulate patches, inconsistencies, and lost design coherence. This Skill guides the AI to rethink the design holistically instead of layering changes on top. ## Core Features & Use Cases - First-Principles Redesign: Reads all affected files, understands the current design, and asks what would be built from scratch with the new requirement in place. - Full Propagation: Ensures the change flows through every reference including types, docs, examples, and rationale sections. - Incremental Delivery: Thinks through the whole redesign first, then delivers it in incremental steps. - Use Case: When adding a new feature like multi-tenancy to an existing app, use this Skill to restructure the data model and APIs as if multi-tenancy had been a day-one assumption, rather than patching it in. ## Quick Start Ask the AI to integrate a new requirement into the existing design by redesigning from first principles instead of bolting it on.

Frequently Asked Questions about principle-redesign-from-first-principles

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate a new requirement without breaking an existing design?▼

Redesign from first principles: read all affected files, imagine building the system from scratch with the new requirement included, and propagate the change through every reference. Deliver the redesign incrementally rather than as one large change.

What is redesigning from first principles in software engineering?▼

It is a design method where you treat a new requirement as if it had been a foundational assumption from day one, instead of bolting it onto the current design. This preserves design coherence and option value as the codebase evolves.

When should I redesign instead of patching existing code?▼

Redesign when a new requirement conflicts with core assumptions of the current design, such as adding multi-tenancy to a single-tenant app. Patching works for peripheral changes, but foundational shifts benefit from rethinking the whole design.

Does first-principles redesign require rewriting all the code at once?▼

No. The method asks you to think about the whole redesign first, then deliver it incrementally. This keeps changes reviewable and shippable while still moving toward the coherent target design.

What are the limitations of the first-principles redesign approach?▼

It requires reading and understanding all affected files, which takes more upfront effort than a quick patch. For trivial or isolated changes, the full redesign pass may be unnecessary overhead.