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

maister-dev

maister-devReads credentialsAGENTS.md

maister

maister-dev/maister/AGENTS.md

Structural map for AI agents and new contributors. Read this file first to orient yourself, then drill into the referenced documents. Maintained by /aif. Update when the project structure changes significantly. The Documentation section is maintained by /aif-docs. MAIster is the self-hosted execution and governance layer for reproducible AI-powered SDLC processes over private code. Current validation wedge: processes from core packages running across internal/private projects through the Web control plane, ACP supervisor, graph-only Flow engine, multi-workspace execution, HITL, evidence, review,…

106mo agoReviewMount

maister-devAGENTS.md

maister / site-docs

maister-dev/maister/site-docs/AGENTS.md

The files under site-docs/ are the public product documentation. They are not generated from, mirrored from, or interchangeable with the engineering notes under /docs. Write for MAIster users, instance operators, integrators, and AI agents helping those people. Do not publish internal milestones, implementation statuses, ADR discussion, database internals, or repository-maintainer procedures unless they are part of a supported public contract. - Store every page as Markdown with title and description frontmatter. - Keep headings descriptive and unique. - Put one…

106mo agoReviewMount

maister-devAGENTS.md

maister / web

maister-dev/maister/web/AGENTS.md

This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in node_modules/next/dist/docs/ (resolved from this file's directory; in monorepos the next package may not be visible from the repo root) before writing any code. Heed deprecation notices. This block is written and re-added by next dev — verify at node_modules/next/dist/server/lib/generate-agent-files.js. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree…

Surging+48 new adopters in 4 weeks

90 projects use a version of this

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