manifesto.md

ConventionAgentic StackRepo Conventions

AGENTS.md

A Markdown file at the root of a repository that gives AI coding agents the context and instructions a new teammate would need, kept separate from the human README.

Canonical text: https://agents.md/. In use on this site: github.com/manifesto-md/manifesto.md/blob/main/AGENTS.md.

How to use AGENTS.md

  1. A simple, open format for guiding coding agents.
  2. Think of AGENTS.md as a README for agents, a dedicated, predictable place to provide the context and instructions to help AI coding agents work on your project.
  3. README.md files are for humans, quick starts, project descriptions, and contribution guidelines; AGENTS.md complements this by containing the extra, sometimes detailed context coding agents need.
  4. Create an AGENTS.md file at the root of the repository.
  5. Cover what matters; add sections that help an agent work effectively with your project, such as project overview, build and test commands, code style guidelines, testing instructions and security considerations.
  6. Commit messages or pull request guidelines, security gotchas, large datasets, deployment steps, anything you'd tell a new teammate belongs here too.
  7. Large monorepo? Use nested AGENTS.md files for subprojects; agents automatically read the nearest file in the directory tree, so the closest one takes precedence.
  8. There are no required fields; AGENTS.md is just standard Markdown.
  9. The closest AGENTS.md to the edited file wins; explicit user chat prompts override everything.
  10. Will the agent run testing commands found in AGENTS.md automatically? Yes, if you list them.
  11. Treat AGENTS.md as living documentation.
  12. One AGENTS.md works across many agents.

Facts

Maintainer
Agentic AI Foundation, under the Linux Foundation
Repository
https://github.com/agentsmd/agents.md
Licence of the text
MIT
Status of the text
stable
Listing
listed, not yet claimed

Read with

Badge

manifesto.md: listed

[![manifesto.md](https://img.shields.io/endpoint?url=https://manifesto.md/badge/agents-md.json)](https://manifesto.md/agents-md/)

Maintainers claim a listing with a pull request setting listing: claimed, or a yes on the listing issue.