Compost

Compost the docs that restate your code -- tag agent-visible markdown, prove restatement with a blind rediscovery test (a subagent that reads only the code tries to reconstruct each doc's claims), delete or quarantine what fails, promote what survives into the three keepers code cannot carry (ADRs, glossary, navigation roads), and reinvest the savings in code that explains itself. Fires on three branches: a docs-hygiene pass ("clean up docs/", "are these docs stale?", "docs and code disagree", agents citing markdown over source); right after a wave of generated overview or architecture files ("delete this doc spam"); and installing the keeper layer in a repo that has none. Generating the navigation artifact itself is llms-txt's job; a knowledge vault from non-code sources is wiki-it's; polishing human-facing surfaces (README, release story) is burnish's.

lroolle Updated 0 repo stars

File contents

lroolle/skills commit 6d93613ed9

Frequently asked questions

npx get-skill add lroolle/compost