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

mstuder-slalom

mstuder-slalomAGENTS.md

everything-claude-code

mstuder-slalom/everything-claude-code/docs/AGENTS.md

Complete reference for all specialized agents available in Everything Claude Code. Agents are specialized subagents that handle delegated tasks with focused expertise. Each agent has: - Specific tools they can use - Model selection (Opus for complex reasoning, Sonnet for general work) - Domain expertise for particular tasks Trophy Testing specialist that verifies implementations against OpenSpec specs. Purpose: - Ingest OpenSpec artifacts (spec.md files with WHEN/THEN scenarios) - Ingest source code implementation - Ingest code map (CODEMAP.md) for context -…

19mo agoReviewMount

mstuder-slalomAGENTS.md

everything-claude-code / rules

mstuder-slalom/everything-claude-code/rules/agents.md

Located in ~/.claude/agents/: No user prompt needed: 1. Complex feature requests - Use planner agent 2. Code just written/modified - Use code-reviewer agent 3. Implementation complete - Use trophy-guide agent 4. Architectural decision - Use architect agent ALWAYS use parallel Task execution for independent operations: For complex problems, use split role sub-agents: - Factual reviewer - Senior engineer - Security expert - Consistency reviewer - Redundancy checker When verifying implementations: 1. Use /deps to analyze dependencies 2. Use /trophy to…

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