prunelisted
Install: claude install-skill Udhay-Adithya/skills
# Prune
A document an agent reads is not prose. It is a program whose purpose is to make the agent
take the same process every run. The levers that make it predictable are the same whether
it is a skill, a `CLAUDE.md`, or a note reached by a pointer.
Most of the work is removal. Adding feels safe and removing feels risky, so the default
fate of any instruction file is **sediment**: stale layers that settle until you have to
core down through them to find what is still live. Two statements about one subject where
one has gone stale is the sediment showing.
## The four cuts
Walk the document four times, once per cut. Each pass finds things the others do not.
### 1. Duplicated meaning
Each meaning gets **one source of truth**, one authoritative place, so changing the
behaviour is a one-place edit.
Duplication costs twice: maintenance, and a false signal of importance, because a meaning
stated three times reads as more important than it is.
**Where two statements of one meaning disagree, that is the finding.** Do not merge them
into something that splits the difference. Work out which is current, delete the other,
and say which was dropped so the decision can be reversed.
This is the opposite of repeating a **term** on purpose. Repeating one word to anchor a
behaviour is a technique. Repeating the meaning in three paragraphs is the bug.
### 2. Stale lines
A line goes stale when the behaviour or the world it describes changes. Check anything
naming a version, a file pat