simplification

Remove unnecessary code using Chesterton's Fence, dead-code removal, and YAGNI principles.

3|1|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/deandum/claude-resources --skill simplification-deandum
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: simplification
Source: https://github.com/deandum/claude-resources/tree/main/skills/core/simplification
Command: npx skills add https://github.com/deandum/claude-resources --skill simplification-deandum

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Chesterton's Fence, dead-code removal, and YAGNI discipline. Use when proposing to delete code, extract a function/class/interface, or introduce a new abstraction. Trigger on PRs that add indirection, wrapper layers, or single-caller helpers; pair with core/code-review and core/style to maintain discipline.

Core Features & Use Cases

  • Chesterton's Fence — understand why the code exists before removing or altering it.
  • Prefer deletion over premature abstraction and extract only when necessary to reduce coupling.
  • Remove, don't comment out; rely on version control to preserve history and rationale.
  • Use during reviews to keep codebases maintainable and comprehensible.

Quick Start

Explain the problem you're considering changing, apply Chesterton's Fence questions, and delete only code proven unnecessary by tests.

Frequently Asked Questions about simplification

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

FAQPage Schema
How do I safely remove dead code without breaking hidden dependencies?▼

To safely remove dead code, apply Chesterton's Fence by first understanding why the code exists, then prove its removal is safe through explicit criteria, guardrails, and tests before deleting it entirely.

What is the best way to prevent premature abstraction during a code refactor?▼

The best way to prevent premature abstraction during a code refactor is to apply YAGNI principles, preferring deletion over extraction and introducing new wrappers or interfaces only when strictly necessary to reduce coupling.

How does Chesterton's Fence apply to code cleanup and refactoring?▼

Chesterton's Fence applies to code cleanup by enforcing that you fully understand the original purpose and rationale of existing code before altering or removing it, ensuring changes are justified and comprehensible.

When should I avoid extracting a function or interface in a PR review?▼

You should avoid extracting a function or interface during a PR review when the extraction introduces unnecessary indirection, creates single-caller helpers, or violates YAGNI discipline by adding abstractions not yet required.

Should I comment out unused code or delete it during refactoring?▼

You should delete unused code rather than commenting it out during refactoring, relying on version control to preserve history and rationale, which keeps the codebase lean and maintainable.

Can I use this simplification process for architectural decisions?▼

Yes, you can use this simplification process for architectural decisions, applying YAGNI and dead-code removal to evaluate new abstractions and wrappers to keep the architecture lean and justified.