Documentation
README
Doc cleanup
Remove context rot from Markdown without erasing load-bearing rules or useful history. Treat every doc claim as a hypothesis and the repository as evidence.
Work in two passes: diagnose and report without editing, then execute only after the user approves the proposed cleanup. Approval to edit does not imply approval to commit.
1. Inventory the full scope
Enumerate every in-scope *.md file, excluding generated, dependency, VCS, and
user-excluded paths. Record each file's line count and role:
- entry:
AGENTS.md,CLAUDE.md, or equivalent - required: an entry doc instructs agents to read it
- reference: consulted conditionally
- historical: retained for lookup, not current guidance
This is the opening of the README. Read the full README on GitHub.