AGENTS.md Guide 2026: How to Write AI Agent Instructions for Every Tool
AGENTS.md is a markdown file placed at your repository root that gives AI coding agents the project-specific instructions they need to work effectively — build commands, code style rules, testing conventions, and git workflow — without reading your entire codebase first. What Is AGENTS.md? The Open Standard Explained AGENTS.md is an open standard for AI agent instructions, stewarded by the Agentic AI Foundation (AAIF) under the Linux Foundation alongside MCP (Anthropic) and Goose (Block). It is a plain markdown file placed at the root of a code repository that tells AI coding agents how your project works — how to build it, test it, what style conventions to follow, and where the important parts live. Unlike README.md, which explains a project to humans, AGENTS.md speaks directly to AI tools. As of 2026, over 60,000 open-source repositories contain the file, and 20+ AI coding agents — including OpenAI Codex, Cursor, Claude Code, Windsurf, Devin, Gemini CLI, and Aider — read it natively. The Agentic AI market is projected to reach $10.86 billion in 2026, with 57% of developers already reporting AI agents in production. AGENTS.md has become the connective tissue between human intent and machine execution. The key takeaway: it is a living operational manual for AI, not documentation for humans. ...