Contact Us
Webflow Premium Partner Ehab Fayez
Back to MCP & Tools
Content & Documentation Featured

AGENTS.md

The unified standard for agent instructions — write your project rules once for every tool.

Claude Code Codex Copilot Cursor Gemini CLI Windsurf

Overview

AGENTS.md is the open standard that unified how projects give instructions to coding agents. Instead of one file per tool (CLAUDE.md, .cursorrules and friends), a single file at the repo root tells the agent how to build and test the project, which code and style rules apply, and which boundaries it must not cross.

The standard is backed by OpenAI, Google and dozens of tools, and became the most common shared format for project context. It is plain Markdown: a commands section, an architecture section, a rules section — read automatically at the start of every session.

Writing a good AGENTS.md is the highest-ROI hour in agent-assisted development: it eliminates repeated corrections in every session and makes any new agent productive from minute one.

Who Is This For?

  • Teams using multiple coding agents that want one source of truth
  • Open-source projects that want agent contributions to follow their rules
  • Developers repeating the same corrections to the agent every session
  • Standardizing build and test commands so agents verify their own work

Installation

Setup for Claude Code
Create AGENTS.md in the repo root. Claude Code reads CLAUDE.md — keep one source of truth:
ln -s AGENTS.md CLAUDE.md

Configuration

# AGENTS.md
## Build
- npm run build
## Rules
- TypeScript strict, no any
- Tests required for new features

Subscribe on YouTube

138K+ subscribers

Subscribe