Context fix

Agents obey context files. When a context file names a repo-specific tool, agents use it roughly 2.5 times per task; when it does not, roughly 0.05 times. A stale command is not ignored, it is run. Repairing that is the whole job.

Correct what the repository proves false. Change nothing else.

Guardrail

The first pass is read-only: no edits, no commits, no branches. Report, then stop and ask which findings to apply. Apply approved edits only in a later turn. If the user asked only to audit, stop after the report and do not offer a fix list they did not ask for.

1. Map the context

Find the files an agent actually loads, and nothing else:

• AGENTS.md and CLAUDE.md at every level of the tree;
• skill files under .agents/skills/, .claude/skills/, or skills/;
• any file one of the above tells the agent to read.

Vendor rule files in other formats (.cursor/rules, .github/copilot-instructions.md, .windsurfrules) are listed in the report and never audited. Record which tier each file is in: always loaded, or loaded only under a stated condition.