Audit Agents

AGENTS.md is read by everyone who will ever work on the project. Picture the next thousand contributors over the next hundred years: a line belongs only if it is still true, and still changes what they do, after every file, tool and dependency has been replaced.

Workflow

1. Read the AGENTS.md and the root readme. This is a document audit: run no builds and no tests.
2. Give every line one verdict, using the tests below.
   • Keep: a principle that passes every test.
   • Rephrase: a lasting lesson worded in today's mechanics, or too vague to act on.
   • Move: a detail someone needs. Name the owner it belongs to: a readme, a manifest, a skill or a spec.
   • Delete: repetition, history, or a line that changes nothing.
3. Check the shape against the example below.
4. Report the findings, highest impact first. Quote each line, give its verdict and the replacement text, and group repeats. Report no finding you can't quote.
5. Edit only when the user asks for a rewrite. Then start from the example, write the file, and reread it as a newcomer with no history of this session.

Tests for a line