AGENTS.md

An open file format for giving coding agents consistent instructions inside each software project.

What it helps with

AGENTS.md is a simple convention: place a Markdown file in a repository to explain build steps, tests, style, architecture, and other instructions to compatible coding agents. It is useful for agencies because the guidance travels with the code and can be reviewed like any other file. This repository mainly implements the website/spec; it is not a package to install. The hard work is writing accurate, concise instructions and keeping them current.

Best fit

Best for any team using Codex or another compatible agent across shared repositories; not a substitute for tests, access control, or onboarding.

Setup reality

Needs developer judgment but no software installation: create and maintain the instruction file in the correct repository paths.

License context

Permissive licenseBusiness use and modification are generally allowed. Keep required notices and review trademarks, dependencies, and hosted-service terms.

MIT for the website/repository. The project instructions your company writes remain your own content.

Resource facts

Use case
AI Agent Frameworks & Skills
Industries
Developers
Setup
One-click
Audience
Some technical experience
Capabilities
No catalog chips

Last verified . Source: github.com