← ClaudeAtlas

prunelisted

Write and prune documents that agents read: skills, CLAUDE.md, AGENTS.md, NOTES.local.md and anything reached by a pointer. Finds duplicated meaning, stale lines, no-ops and sprawl, and cuts them. Use when creating or editing a skill, changing CLAUDE.md or AGENTS.md, when two documents say different things about one subject, when a document has grown long, or when instructions are being ignored.
Udhay-Adithya/skills · ★ 0 · Data & Documents · score 70
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