# Make AGENTS.md a useful guide to your codebase.

> Explain project setup, checks and code conventions in AGENTS.md, and verify which instructions each coding tool actually reads.

Canonical page: https://prompterjack.com/guides/agents-md

## What is AGENTS.md?

AGENTS.md is a Markdown convention for instructions intended for coding agents. It complements documentation for humans by making repository setup, validation and working rules easy for a tool to find.

## Write for the repository

State where work belongs, which package manager and checks to use, and which generated files should not be edited directly. Name real modules and commands. Keep examples short enough to review as part of a pull request.

## Verify scope and precedence

Different coding tools can load instructions differently. Check the documentation for the tool and version you use, including any nested instruction files. Do not assume that CLAUDE.md and AGENTS.md are automatically interchangeable.

## Keep one set of facts

If several tools need separate instruction files, maintain shared facts together and review generated differences. A changed test command should not leave one tool following the old workflow.

## Does AGENTS.md enforce security policy?

No. Written instructions help guide behavior, but access controls, sandboxing, review gates and server-side authorization must enforce sensitive boundaries.

## References

- [AGENTS.md specification and examples](https://agents.md/)

## Next step

[Review your AI context](https://prompterjack.com/codebase)