What is AGENTS.md?
AGENTS.md is an open, markdown-based format designed to guide AI coding agents. Similar to a README for humans, it provides structured, predictable instructions for agents, covering build steps, testing commands, code style, and project-specific workflows. By keeping this separate from README.md, it ensures human contributors get concise guidance while agents receive precise, actionable context to work effectively across diverse projects and tools.
Features
- Provides clear instructions for AI coding agents
- Separates human and agent-focused documentation
- Supports build, test, and style guidelines
- Works across multiple coding agents and tools
- Scales to monorepos with nested AGENTS.md files
Use Cases
- Define setup and test steps for agents
- Guide AI on project code style
- Provide PR and commit guidelines
- Support large monorepos with tailored instructions
