principle-subtract-before-you-add

Guides removal of dead code and redundant validators before adding new features.

Updated Jul 29, 2026
One-click install
npx skills add https://github.com/mmdmcy/fluttAIrbar --skill principle-subtract-before-you-add-mmdmcy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: principle-subtract-before-you-add
Source: https://github.com/mmdmcy/fluttAIrbar/tree/main/plugins/pstack/skills/principle-subtract-before-you-add
Command: npx skills add https://github.com/mmdmcy/fluttAIrbar --skill principle-subtract-before-you-add-mmdmcy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When evolving a codebase, teams often add features on top of existing complexity, which compounds technical debt and makes every subsequent change more brittle. This Skill enforces a subtraction-first sequencing principle so additions land on a simpler, smaller base. ## Core Features & Use Cases - Removal-before-construction sequencing: Delete dead weight, redundant validators, and stub references before building anything new. - Anti-speculation guardrails: Blocks speculative validators, parsers, and guards beyond what the spec demands, and cuts out-of-spec features like unneeded persistence or retry logic. - Prompt and reference simplification: Removes redundant instructions, excessive templates, and stub references with no novel content. - Use Case: Before refactoring a module or adding a feature, apply this principle to strip unused code paths first, making the new design smaller and less brittle. ## Quick Start Ask the assistant to apply the subtract-before-you-add principle to review the current module and remove dead code before implementing the planned feature.

Frequently Asked Questions about principle-subtract-before-you-add

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

FAQPage Schema
How do I reduce complexity before adding a new feature?▼

Remove dead weight, redundant validators, and stub references first, then build on the simpler base. Deletion cuts the surface area, reveals the essential structure, and usually makes the next design obvious.

What is the subtract before you add principle in software design?▼

It is a sequencing rule: remove complexity before constructing anything new. Adding to a complex system compounds complexity, while subtraction first makes the next addition smaller and less brittle.

When should I avoid writing speculative validators or guards?▼

Avoid validators, parsers, and guards beyond what the spec demands. Out-of-spec features like persistence, retry-on-startup, and schema migration each drag defensive guards behind them, so cut the feature rather than defend it.

Should I keep stub references that have no content?▼

No. When a reference has no novel content, delete it rather than leaving a stub. Stubs add surface area without value and mislead future readers about the system's actual structure.

When is subtraction-first the wrong approach?▼

It fits additions, refactors, and rewrites where existing complexity is the bottleneck. It is less relevant for greenfield work with no legacy surface, where there is nothing to remove before building.