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

MoizIbnYousaf

MoizIbnYousafReads credentialsAGENTS.md

marketing-cli

MoizIbnYousaf/marketing-cli/AGENTS.md

[!IMPORTANT] For CLI runtime usage, read CONTEXT.md. For /cmo runtime indexes, read skills/cmo/rules/cli-runtime-index.md, skills/cmo/rules/publish-index.md, and skills/cmo/rules/studio-api-index.md. For /axi (AXI catalog router — gh-axi, chrome-devtools-axi, principles), read skills/axi/SKILL.md. For development standards, read CLAUDE.md. This file covers the repository landscape, local runtime, marketing sub-agents, and drop-in contracts. marketing-cli is the public product source of truth. It owns the CLI, /cmo, skills, agents, canonical manifests, publishing adapters, and the shipping Studio app under studio/. - Edit a skill and the canonical manifest here…

336mo agoReviewMount

MoizIbnYousafReads credentialsAGENTS.md

marketing-cli / studio

MoizIbnYousaf/marketing-cli/studio/AGENTS.md

Build the visual studio layer for the mktg marketing CLI. The studio is a local-first Next.js dashboard powered by /cmo — the agent orchestrator with 50 marketing skills. Everything intelligent goes through /cmo. Everything infrastructure goes through the mktg CLI. The studio never calls the Anthropic API directly. One day, someone runs /cmo in a fresh project and /cmo says: "Let me spin up your marketing dashboard." It launches the studio dashboard, creates native publish providers, connects Postiz when external…

336mo agoReviewMount

MoizIbnYousafAGENTS.md

drawmcp

MoizIbnYousaf/drawmcp/AGENTS.md

Build a credible human-agent shared canvas that proves why WebMCP is different from a separately installed MCP server. Preserve the ordinary Excalidraw user experience while giving browser agents a small, reliable, and inspectable tool surface over the same live state. - DrawMCP application code lives in src/. - Project decisions live in docs/ and source-backed analysis in research/. - vendor/excalidraw and vendor/excalidraw-mcp are pinned, read-only Git submodules. Never edit, reformat, or commit changes inside them. - Depend on @excalidraw/excalidraw; do…

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