AGENTS.md Authoring

Use AGENTS.md for concise, non-obvious rules that apply throughout its effective scope. It is not a repository manual.

Decide what belongs

Apply this order to every candidate instruction:

1. Delete it if code, tool help, configuration, or ordinary conventions already reveal it.
2. Enforce it with permissions, tests, schemas, hooks, or linters when deterministic.
3. Put task-specific procedures in a skill and detailed reference material in documentation.
4. Keep it in AGENTS.md only when it is durable, consequential, and broadly applicable.

Useful content often includes unusual commands, architectural boundaries, operational hazards, and a small map to authoritative files. Include examples or escalation guidance only when they prevent a known failure.

Scope and loading