agents-md
Installation
SKILL.md
Manage AGENTS.md
AGENTS.md gives coding agents scoped, current, repo-specific instructions. It is not a README, runbook, architecture doc, changelog, tutorial, or evidence log. Good guidance is evidence-backed, concise, scoped to the file's directory tree, and behavioral: it tells agents what to do differently in this repository.
When to Use
- Create, update, review, split, move, or repair a repository
AGENTS.md. - Capture verified local commands, repo contracts, path ownership, or recurring agent mistakes.
- Convert repo evidence into rules that future agents can follow.
When NOT to Use
- Standalone skills, prompts, global instructions, READMEs, architecture docs, changelogs, or runbooks.
- Broad documentation rewrites where
AGENTS.mdis not an explicit deliverable. - Aspirational process guidance that is not supported by current repo evidence.