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

wayfarer35

wayfarer35AGENTS.md

ccs

wayfarer35/ccs/AGENTS.md

CLI 工具 — 基于 Node.js ESM + TypeScript 构建。版本号单一真源是 package.json 的 version，发版统一走 standard-version，日常提交不自动 bump： standard-version 自增版本号、生成/更新 CHANGELOG.md 并打 v* tag。推送 tag 后 .github/workflows/release.yml 校验 tag 与 package.json 版本一致，构建并发布到 npm，同时创建 GitHub Release。 These instructions are for AI assistants working in this project. This project is managed by Trellis. The working knowledge you need lives under .trellis/: If a Trellis command is available on your platform (e.g. /trellis:finish-work, /trellis:continue), prefer it over manual steps. Not every platform exposes every command. If…

05mo 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.