agents-md
Installation
SKILL.md
AGENTS.md Audit
- IS: auditing, scoring, refactoring, and writing AGENTS.md / CLAUDE.md / CLAUDE.local.md files agents load at session start.
- IS NOT: authoring SKILL.md files (use
agent-skills-creator), project docs or READMEs (usedocs-writingorreadme-creator), or mining session history (use the externalcadence-adviseskill where installed; this skill audits the file as-is).
AGENTS.md files are execution contracts, not knowledge bases. Litmus test per line: "Would removing this cause the agent to make a mistake?" If no, cut it; bloat makes agents ignore the rules that matter.
AGENTS.md is the tool-agnostic source of truth. Claude Code loads AGENTS.md, CLAUDE.md, and CLAUDE.local.md natively at any directory level, no symlinks. If only a CLAUDE.md exists, recommend mv CLAUDE.md AGENTS.md.
Reference Files
| File | Read when |
|---|---|
references/quick-checklist.md |
Every audit; default 10-check triage |
references/quality-criteria.md |
Quick audit fails, file is high-risk, or full scoring requested |
references/refactor-workflow.md |
File is bloated (root over ~150 lines), stale, or below target |
references/root-content-guidance.md |
Root vs @import; file placement hierarchy |
references/templates.md |
Drafting or rebuilding a file from scratch |