AGENTS.md examples from real projects

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

Best matches · from page 25Worked for most · soon

PydanticAGENTS.md

monty / limitations

pydantic/monty/docs/limitations/AGENTS.md

asyncio.md`, `re.md`). Add a section to an existing file when the feature is already documented; create a new file only when there is no fit. A new file also needs

8.4k27d agoDiscuss

MicrosoftAGENTS.md

Mastering-GitHub-Copilot-for-Paired-Programming

microsoft/Mastering-GitHub-Copilot-for-Paired-Programming/AGENTS.md

coding partner — from beginner to advanced topics including Agent Mode. The repository is **documentation-centric**: most content is Markdown-based lesson guides. A small number of code samples exist within

8.1k15mo agoDiscuss

osaurus-aiAGENTS.md

osaurus

osaurus-ai/osaurus/AGENTS.md

cause and fix the real function/path. If the root cause is not fixed yet, document the row as `PARTIAL` or `BLOCKED` with exact evidence instead of forcing behavior in prompts

8k18d agoDiscuss

OpenCoworkAIAGENTS.md

open-codesign

OpenCoworkAI/open-codesign/AGENTS.md

files in that workspace; the preview runtime turns those sources into a rendered web document; exporters turn the rendered/source document into standard outputs such as HTML, PDF, PPTX

8k5mo agoPipes a download into a shellDiscuss

logancyangAGENTS.md

obsidian-copilot

logancyang/obsidian-copilot/AGENTS.md

same-callable groups only when a material test-lifecycle constraint makes merging misleading, and document that reason next to the groups. Write `it(...)` descriptions that state the observable behavior without

7.8k8d agoDiscuss

VercelAGENTS.md

native

vercel-labs/native/AGENTS.md

schema.native-sdk.dev`. - `examples/` — the showcase apps, many predating the JSON default (`app.zon` + `src/`). - `docs/` — the documentation site; `docs/AGENTS.md` has its MDX conventions. - `skills/` and `skill-data/` — the agent skills

7.7k44d agoDiscuss

mufeedvhAGENTS.md

code2prompt

mufeedvh/code2prompt/AGENTS.md

crates/code2prompt-core/**` → `verify-core` - `crates/code2prompt/**` → `verify-cli` - `crates/code2prompt-python/**` → `verify-python` - `website/**` → `verify-website` - Public behavior/docs/comments → `documentation` A change can require several verification skills. Root `cargo test` does not exercise the Python

7.7k24d agoDiscuss

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.