AGENTS.md examples from real projects

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

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Worked for most · soon

EveryInc 1k+ stars

EveryIncAGENTS.md

compound-engineering-plugin

EveryInc/compound-engineering-plugin/AGENTS.md

This repository is the root of the compound-engineering coding-agent plugin and the marketplace/catalog metadata used to distribute it. It also contains: - the Bun/TypeScript CLI that converts Claude Code plugins into other agent platform formats - shared release and metadata infrastructure for the CLI, marketplace, and plugin AGENTS.md is the canonical repo instruction file. Root CLAUDE.md is a symlink to AGENTS.md so Claude Code and other tools that look for CLAUDE.md still find it at the expected path. Keep that…

26k3mo agoReviewMount

EveryIncAGENTS.md

compounding-engineering-plugin

EveryInc/compounding-engineering-plugin/AGENTS.md

26k3mo agoReviewMount

CLAUDE.md vs AGENTS.md

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.