AGENTS.md examples from real projects

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

Best matches · from page 22Worked for most · soon

Javis603AGENTS.md

token-monitor

Javis603/token-monitor/AGENTS.md

command like `ls src/shared/` over a hand-maintained one); verify claims against the code before writing them; delete anything that has gone stale — an outdated note is worse than none

2.4k7d agoDiscuss

apifyAGENTS.md

agent plugins (coding-agent skills+MCP bundles or OpenClaw/Hermes-style harnesses), AI framework packages (LangChain/LlamaIndex-style), or direct application clients via apify-client. Use when planning, creating, or reviewing an integration that

2.4k9mo agoDiscuss

VercelAGENTS.md

chat / apps

vercel/chat/apps/docs/AGENTS.md

CopyPrompt` when a page should give readers a prompt they can copy into a coding agent. ## Routing and proxy guidelines - Keep App Router route files as thin adapters around package

2.4k57d agoReads credentialsDiscuss

VercelAGENTS.md

chat / adapter-github

vercel/chat/packages/adapter-github/AGENTS.md

public type changed). Sample fixtures and AGENTS.md edits don't. ## Resources - [Ship a GitHub code review bot with Hono and Redis](https://vercel.com/kb/guide/ship-a-github-code-review-bot-with-hono-and-redis) — Walks through building a GitHub

2.4k57d agoDiscuss

QoderAIAGENTS.md

better-harness

QoderAI/better-harness/AGENTS.md

requires them. ## Change Traceability Review - Use `.agents/skills/change-traceability-review/SKILL.md` as the Story/Spec/Test/Risk evidence-chain review guide, not a code-style guide. - Before review, merge, or commit of a non-trivial change

2.3k16d agoDiscuss

SupabaseAGENTS.md

etl

supabase/etl/AGENTS.md

every branch, commit, PR, and review comment as **public**. Never put real secrets, credentials, tokens, private URLs/hostnames, customer data, or production payloads in code, tests, docs, comments, examples, commits

2.3k9d agoDiscuss

VercelAGENTS.md

vgpu / apps

vercel-labs/vgpu/apps/docs/agents.md

/react`. Package-owned Ask AI uses AI SDK v6; migrate local AI SDK code separately from Geistdocs route adapters. - Import source-config helpers from `@vercel/geistdocs/source-config` in `source.config.ts`. Do not import

2.3k7d agoReads credentialsDiscuss

Microsoft AzureAGENTS.md

azure-sdk-for-js

Azure/azure-sdk-for-js/AGENTS.md

Troubleshoot a CI / pipeline failure | `.github/skills/azsdk-common-pipeline-troubleshooting/SKILL.md` | | Create a new package-specific skill | `.github/skills/create-package-skill/SKILL.md` | | Copilot code review (CCR) | `.github/skills/code-review/SKILL.md` (routes to canonical reviewer guidance) | | Review criteria (architecture, perf, security, deps, tests

2.3k19mo agoDiscuss

codejunkie99AGENTS.md

agentic-stack

codejunkie99/agentic-stack/.agent/AGENTS.md

Agent Infrastructure This folder is the portable brain. Any harness (Claude Code, Cursor, Windsurf, OpenCode, OpenClaw, Copilot CLI, Gemini, Hermes, Pi, Codex, standalone Python, Antigravity) can mount

2.3k25d agoDiscuss

Sahir619AGENTS.md

fable-method

Sahir619/fable-method/AGENTS.md

work: the opening paragraph must be readable by someone who never saw the code or the data. Define jargon at first use and translate numbers into meaning ("about twice

2.3k3mo agoDiscuss

numman-aliAGENTS.md

cc-mirror

numman-ali/cc-mirror/AGENTS.md

OPUS_MODEL` - `ANTHROPIC_DEFAULT_HAIKU_MODEL` - Optional: `ANTHROPIC_SMALL_FAST_MODEL`, `ANTHROPIC_MODEL`, `CLAUDE_CODE_SUBAGENT_MODEL` ## Provider Blocked Tools Providers block tools via `settings.json` `permissions.deny` entries (written during variant

2.3k4mo agoReads credentialsDiscuss

jwadowAGENTS.md

kiro-gateway

jwadow/kiro-gateway/AGENTS.md

break compatibility - Clients can ignore added fields - original upstream data is always preserved ### Code Review Reality Check **Your code quality reveals your approach.** Contributions missing tests, using non-English identifiers

2.3k8mo agoReads credentialsDiscuss

777geniusAGENTS.md

agent-teams-ai

777genius/agent-teams-ai/AGENTS.md

src/features/CLAUDE.md](src/features/CLAUDE.md) ## Review guidelines - Treat regressions in agent team messaging, task lifecycle, session parsing, code review UI, and provider/runtime detection as high priority. - For team launch hangs, OpenCode `registered`/`bootstrap

2.2k4mo agoDiscuss

DicklesworthstoneAGENTS.md

mcp_agent_mail

Dicklesworthstone/mcp_agent_mail/AGENTS.md

extracted code snippets. --- ## cass — Cross-Agent Session Search `cass` indexes prior agent conversations (Claude Code, Codex, Cursor, Gemini, ChatGPT, etc.) so we can reuse solved problems. **Rules:** Never run bare

2.2k4mo agoPipes a download into a shellDiscuss

Kritt-aiAGENTS.md

open-kritt

Kritt-ai/open-kritt/AGENTS.md

ESLint/Prettier for JS, Ruff for Python). Match the existing style; don't reformat unrelated code. - **Never commit secrets or local data:** credentials, tokens, `.env`, provider login data, or scan outputs

2.2k2mo agoReads credentialsDiscuss

majidmanzarpourAGENTS.md

threejs-game-skills

majidmanzarpour/threejs-game-skills/AGENTS.md

have to name every specialist skill. The same nine skills serve Codex and Claude Code. The user's requested scope, art style, constraints, and prior decisions take precedence over skill

2.2k3d agoDiscuss

cjo4m06AGENTS.md

mcp-shrimp-task-manager

cjo4m06/mcp-shrimp-task-manager/docs/agents.md

Engineer - Testing → QA Engineer 2. **Consider model strengths**: - Complex reasoning → Advanced models - Code generation → Specialized coding models - Documentation → Language-focused models 3. **Use templates**: - Start with pre-configured templates - Customize based

2.2k18mo agoDiscuss

CloudflareAGENTS.md

templates

cloudflare/templates/AGENTS.md

endpoints** - Each endpoint returns expected status/data 5. **HTML/UI** - Key elements are present in responses --- ## Code Review Patterns ### Logic Bug Detection When reviewing template code, watch for these common issues: **Request

2.1k9mo agoDiscuss

amElnagdyAGENTS.md

delegate-skills

amElnagdy/delegate-skills/AGENTS.md

skills** — skills that let an orchestrating agent drive a separate CLI coding agent as an implementer, then review and land the result. Seventeen implementer skills ship today: `claude-delegate` (Claude

2.1k2mo agoDiscuss

alpic-aiAGENTS.md

skybridge

alpic-ai/skybridge/AGENTS.md

pushing a branch needs no special approval. Only a published GitHub release publishes `latest`. ## Code rules **Biome** handles lint + format (see `biome.json`): - Double quotes, 2-space indent, auto-sorted imports

2.1k28d 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.