# AGENTS.md & CLAUDE.md Repository Audit Checklist

Use this 18-point checklist from a clean checkout. Record evidence beside each item and review instruction changes through a pull request.

## 1. Inventory and scope

- [ ] Find every AGENTS.md, CLAUDE.md, CLAUDE.local.md, tool-specific rule file, and nested instruction file.
- [ ] Map the precedence and directory scope used by each supported coding agent.
- [ ] Choose one committed file as the shared, cross-tool contract.

## 2. References and commands

- [ ] Verify that every referenced file, directory, script, fixture, and architecture document exists with the correct casing.
- [ ] Run the documented setup from a clean checkout.
- [ ] Run every named lint, typecheck, test, build, and formatting command.
- [ ] Resolve package-manager, workspace-filter, flag, and test-command disagreements.

## 3. Conflicts and context quality

- [ ] Compare positive and negative directives for contradictions.
- [ ] Remove duplicated shared rules from tool-specific overlays.
- [ ] Replace vague preferences with observable expectations.
- [ ] Delete stale background that no longer changes an agent's decision.

## 4. Safety and delivery

- [ ] State where secrets may live and which production systems require approval.
- [ ] Enforce non-optional boundaries with CI, permissions, hooks, or branch protection.
- [ ] Name destructive actions that require confirmation.
- [ ] Define the tests, build evidence, migrations, documentation, and handoff needed for “done.”

## 5. Multi-agent maintenance

- [ ] Run the same small repository task with every supported coding agent.
- [ ] Keep tool overlays thin and limited to genuine agent-specific behavior.
- [ ] Assign an instruction-file owner and review when commands, directories, CI, deployment, or supported agents change.

Free browser checker: https://agentsmdchecker.com/

Full web version: https://agentsmdchecker.com/checklist