Definition
AGENTS.md is a plain Markdown file placed in a software repository that gives AI coding agents project-specific instructions, such as how to build, test and style the code. OpenAI released it in August 2025, and it is now stewarded by the Agentic AI Foundation under the Linux Foundation. It is not a file you publish on your website.
Why it matters
AGENTS.md comes up often next to llms.txt, and the two are easy to mix up. They do different jobs. llms.txt is a public file on your website for AI tools that read your site. AGENTS.md lives inside a code repository and is read by AI coding tools that edit that code.
If you run a store, you do not need an AGENTS.md on your website. If you or your developer work on your store's code with an AI coding assistant, an AGENTS.md in that code can help the assistant follow your project's rules.
How it works
The project's site calls it "a README for agents" and "A simple, open format for guiding coding agents." You "Create an AGENTS.md file at the root of the repository" and write normal Markdown. Suggested contents include a project overview, build and test commands, code style rules, testing instructions and security notes. Large projects can add more AGENTS.md files in sub-folders.
The agents.md site says the format is "used by over 60k open-source projects" and lists many tools that read it, including OpenAI Codex, Google Jules, Cursor, GitHub Copilot's coding agent, Gemini CLI and VS Code.
OpenAI released AGENTS.md in August 2025. On December 9, 2025, the Linux Foundation announced the Agentic AI Foundation (AAIF), with OpenAI contributing AGENTS.md alongside Anthropic's Model Context Protocol and Block's goose. The release describes AGENTS.md as "a simple, universal standard that gives AI coding agents a consistent source of project-specific guidance".
Example
A developer building a custom storefront adds this to the repository:
# AGENTS.md
## Setup
- Install with `npm install`. Start with `npm run dev`.
## Tests
- Run `npm test` before every commit.
## Rules
- Never commit API keys. Prices are stored in cents.
When they ask an AI coding agent to add a discount feature, the agent reads the file first, runs the tests and stores the price in cents. For the website file that AI tools read, see llms.txt for online stores.
Sources
- AGENTS.md · checked 17 Nov 2026
- Linux Foundation: Linux Foundation announces the formation of the Agentic AI Foundation · checked 17 Nov 2026