AGENTS.md

AGENTS.md provides a dedicated, predictable place to provide context and instructions to help AI coding agents work on a project. It complements READMEs by containing the extra, sometimes detailed context coding agents need, such as build steps, tests, and conventions that might clutter a human-readable README. The format is designed to be adopted by teams building or using coding agents and to fit into existing documentation ecosystems.

AGENTS.md describes a lightweight, Markdown-based file used at the root of a repository to guide automated agents. It emphasizes separation from human-focused READMEs and aims to keep agent instructions concise, while allowing detailed guidance when necessary. The intent is to support a broad ecosystem of AI coding agents and tools by providing a clear, predictable file for agents to read.

AGENTS.md is a general, open format with compatibility across multiple agents and tools. It outlines how the file should be used to provide instruction, build steps, tests, and conventions so agents can operate on a project. The guidance includes practical tips for setup and collaboration with agents while remaining repository-focused.

AGENTS.md outlines how to add and organize agent-focused instructions within a repository and mentions nesting AGENTS.md files for subprojects. It also notes the format’s stewardship and alignment with open development efforts, aiming to benefit developers using various coding agents.