AGENTS.md examples from real projects

How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.

Most stars first · from page 2Worked for most · soon

GitHubAGENTS.md

spec-kit-copilot

github/spec-kit-copilot/AGENTS.md

This file captures the design decisions behind these integrations so they are not accidentally reverted when revving or regenerating it. Read this before adding, removing, or regenerating skills. The Copilot integration hub for Spec Kit. It can contain independently versioned Copilot CLI/App plugins, skills, extensions, canvases, hooks, and workflow surfaces. Do not assume every integration belongs in the core skills plugin. A GitHub Copilot CLI plugin (plugin.json + skills/<name>/SKILL.md) that exposes the Spec Kit specify CLI to the Copilot agent.…

166d agoDiscuss

About AGENTS.md

What is AGENTS.md?

An open format for instructions to coding agents, read by Codex, Cursor and others. Think of it as a README written for agents.

Where does it go?

At the repository root, with more specific files in subdirectories. Agents read the one closest to the file they're editing.

What should it contain?

Setup and test commands, code style, and the rules a new contributor would need to know.

Does Claude Code read it?

Claude Code reads CLAUDE.md. A one-line CLAUDE.md that points at AGENTS.md covers both.