reducing-entropy
Agent skill fromsoftaworks/agent-toolkit
Manual-only skill for minimizing total codebase size. Only activate when explicitly requested by user. Measures success by final code amount, not effort. Bias toward deletion.
How to install reducing-entropy
install reducing-entropy
# install the agent-toolkit pack with the skills CLI
npx skills add softaworks/agent-toolkit# or add only this skill to Claude Code: copy the folder
skills/reducing-entropy/
# into
~/.claude/skills/reducing-entropy/ (all projects)
.claude/skills/reducing-entropy/ (one project)
1# Reducing Entropy23More code begets more code. Entropy accumulates. This skill biases toward the smallest possible codebase.45**Core question:** "What does the codebase look like *after*?"67## Before You Begin89**Load at least one mindset from `references/`**10111. List the files in the reference directory122. Read frontmatter descriptions to pick which applies133. Load at least one144. State which you loaded and its core principle1516**Do not proceed until you've done this.**1718## The Goal1920The goal is **less total code in the final codebase** - not less code to write right now.2122- Writing 50 lines that delete 200 lines = net win23- Keeping 14 functions to avoid writing 2 = net loss24- "No churn" is not a goal. Less code is the goal.2526**Measure the end state, not the effort.**2728## Three Questions2930### 1. What's the smallest codebase that solves this?3132Not "what's the smallest change" - what's the smallest *result*.3334- Could this be 2 functions instead of 14?35- Could this be 0 functions (delete the feature)?36- What would we delete if we did this?3738### 2. Does the proposed change result in less total code?3940Count lines before and after. If after > before, reject it.4142- "Better organized" but more code = more entropy43- "More flexible" but more code = more entropy44- "Cleaner separation" but more code = more entropy4546### 3. What can we delete?4748Every change is an opportunity to delete. Ask:4950- What does this make obsolete?51- What was only needed because of what we're replacing?52…
Excerpt shown under the repository's MIT license.
