AGENTS.md examples from real projects

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

Best matches · from page 18Worked for most · soon

rohitg00AGENTS.md

awesome-claude-code-toolkit / rules

rohitg00/awesome-claude-code-toolkit/rules/agents.md

Rules ## When to Use Subagents - Use a subagent for tasks that require focused expertise (security audit, performance analysis, test generation). - Use a subagent when the main task would exceed

2.6k8mo agoDeletes or force-pushesDiscuss

yaojingangAGENTS.md

yao-meta-skill

yaojingang/yao-meta-skill/AGENTS.md

skill-ir/`: platform-neutral skill contract and examples. - `agents/interface.yaml`: portable runtime and trust metadata. - `security/`: script, dependency, network, permission, and trust policies. - `registry/`: package metadata, installability evidence, and compatibility metadata

2.6k6mo agoReads credentialsDiscuss

StripeAGENTS.md

stripe-ios

stripe/stripe-ios/AGENTS.md

Dependencies:** - `StripeCore` - Foundational networking, utilities, analytics - `StripeUICore` - Shared UI components and themes - `Stripe3DS2` - 3D Secure 2.0 authentication **Payment Modules:** - `StripePayments` - Core payment APIs (depends on StripeCore, Stripe3DS2) - `StripePaymentsUI` - Payment

2.6k20d agoDiscuss

Microsoft AzureAGENTS.md

azure-sdk-for-java

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

failing tests - Make breaking changes to GA'd APIs without explicit approval - Turn off security checks or introduce security vulnerabilities - Suggest third-party alternatives to Azure SDK packages in official

2.6k19mo agoDiscuss

OpenAIAGENTS.md

openai-openapi

openai/openai-openapi/AGENTS.md

correction in these generated files. - If the upstream source is inaccessible, prepare ordinary, non-security feedback through the README's feedback process with the endpoint/method or schema, expected behavior

2.5k18d agoDiscuss

samanhappyAGENTS.md

mcphub

samanhappy/mcphub/AGENTS.md

Agent-guide maintenance](docs/agents/guide-maintenance.md) - [Domain documentation](docs/agents/domain.md) - [GitHub issue tracker](docs/agents/issue-tracker.md) - [Triage labels](docs/agents/triage-labels.md) - [Security advisory lifecycle](docs/agents/security-advisories.md

2.5k29d agoDiscuss

VercelAGENTS.md

workflow

vercel/workflow/AGENTS.md

already exists on `stable` - Correctness, data-loss, crash, hang, deadlock, and resource-leak fixes - Security fixes, including dependency bumps that address a known vulnerability - Fixes for regressions introduced

2.4k11mo agoReads credentialsDiscuss

FrancyJGLisboaAGENTS.md

agent-skill-creator

FrancyJGLisboa/agent-skill-creator/AGENTS.md

link, a script, a transcript — and this skill builds a complete, validated, security-scanned agent skill with functional code, its own eval suite, and a cross-platform installer. ## Activation Invoke

2.4k29d agoDiscuss

MicrosoftAGENTS.md

Olive

microsoft/Olive/AGENTS.md

Describe your changes" section with a clear summary of what changed and why. ## Security and environment notes - Do not commit secrets, caches, or generated model artifacts. - Some workflows require optional

2.4k13mo agoDiscuss

VercelAGENTS.md

chat / apps

vercel/chat/apps/docs/public/AGENTS.md

Build multi-platform chat bots with Chat SDK (`chat` npm package). Use when developers want to scaffold a bot with create-chat-sdk, build a Slack, Teams, Google Chat, Discord, Telegram, GitHub, Linear, or WhatsApp bot, handle mentions, direct messages, subscribed threads, reactions, slash commands, cards, modals, files, or AI streaming, set up webhook routes or multi-adapter bots, send rich cards or streamed AI responses to chat platforms, or build a custom adapter or state adapter.

2.4k57d agoDiscuss

VercelAGENTS.md

chat / adapter-web

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

stop()` from the React side aborts the handler's iterator. ## Authentication `getUser` is the **security boundary**. Every request comes from a browser with no Slack-style platform signature

2.4k57d agoDiscuss

Microsoft AzureAGENTS.md

azure-sdk-for-js

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

Copilot code review (CCR) | `.github/skills/code-review/SKILL.md` (routes to canonical reviewer guidance) | | Review criteria (architecture, perf, security, deps, tests, docs, mgmt) | `.github/instructions/reviewer/*.instructions.md` | | Test framework, recorder lifecycle, asset-sync | `documentation/Quickstart-on-how-to-write-tests.md` | | TypeSpec / codegen

2.3k19mo agoDiscuss

jwadowAGENTS.md

kiro-gateway

jwadow/kiro-gateway/AGENTS.md

gateway \ kiro-gateway ``` **Docker Features:** - Single-stage optimized build - Non-root user (`kiro`) for security - Health check endpoint monitoring (`/health`) - Volume mounts for credentials and debug logs - Automatic restart

2.3k8mo agoReads credentialsDiscuss

tractorjuiceAGENTS.md

arc-kit

tractorjuice/arc-kit/AGENTS.md

documentation-site changes. Update `CHANGELOG.md` and target-specific docs when behaviour changes. ## Security & Configuration Tips Do not commit secrets, local `.env` files, or generated session memory. Keep project-specific template

2.2k5mo agoReads credentialsDiscuss

phurynAGENTS.md

claude-usage

phuryn/claude-usage/AGENTS.md

just type `/triage` in Claude Code. Hard safety rails (test-passing gates, no security-sensitive auto-merges, no scope-changing merges, Codex sign-off required on closures) live inside `triage.md

2.2k4mo agoDiscuss

Kritt-aiAGENTS.md

open-kritt

Kritt-ai/open-kritt/AGENTS.md

fast, do/don't version. ## What this is open·kritt is an AI-driven security vulnerability scanner. It's a **polyglot monorepo** of cooperating services: | Path | What | Stack | | ---------------- | --------------------------------------------- | ----------------------------- | | `frontend

2.2k2mo agoReads credentialsDiscuss

vibheksoniAGENTS.md

stealth-browser-mcp

vibheksoni/stealth-browser-mcp/AGENTS.md

server runtime paths used by MCP `stdio`. - Use `apply_patch` for manual file edits. ## Security - Default transport is local `stdio`. HTTP is optional and requires auth token. - Never expose unauthenticated

2.2k14mo agoDiscuss

cjo4m06AGENTS.md

mcp-shrimp-task-manager

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

2.2k18mo agoDiscuss

Microsoft AzureAGENTS.md

AKS / website

Azure/AKS/website/AGENTS.md

permalink: /tag-url description: SEO description for tag page ``` **Common tags**: `aks`, `kubernetes`, `ai`, `networking`, `security`, `storage`, `observability`, `troubleshooting`, `gpu`, `istio`, `open-source` **Usage**: `tags: [tag1, tag2]` in front matter ### Navigation

2.1k10mo agoDiscuss

CloudflareAGENTS.md

templates / x402-proxy-template

cloudflare/templates/x402-proxy-template/AGENTS.md

Proxy: Check your origin server logs ### Cookies not persisting - Must be HTTPS (cookies have `Secure` flag) - Check `SameSite=Strict` compatibility with your frontend - Cookies are valid for 1 hour after

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