AGENTS.md examples from real projects

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

Best matches · from page 11Worked for most · soon

CloudflareAGENTS.md

cloudflare-os

cloudflare/cloudflare-os/AGENTS.md

kernel**: it defines the architecture and is held to a higher bar than UI/gatekeeper code. Reviewers read *every line* of `workshop-backend` and of API changes in `workshop-shared

10k10d agoDiscuss

GitHubAGENTS.md

hand; regenerate it with `scripts/regenerate-node-types.sh` after changing the pinned swift-syntax version, then review the diff alongside the mapping in `extractor/src/languages/swift/swift.rs`. ## AST Mapping - The target AST shape is described

10k4y agoDiscuss

open-gsdAGENTS.md

gsd-core

open-gsd/gsd-core/docs/AGENTS.md

agents** detailed in this section. Thirteen additional shipped agents (pattern-mapper, debug-session-manager, code-reviewer, code-fixer, ai-researcher, domain-researcher, eval-planner, eval-auditor, framework-selector, intel-updater

9.9k29d agoDiscuss

AWSAGENTS.md

mcp / dynamodb-mcp-server

awslabs/mcp/src/dynamodb-mcp-server/AGENTS.md

Commit with conventional commit format (commitizen is configured) 6. Submit pull request or create code review ### Commit Message Format Follow [Conventional Commits](https://www.conventionalcommits.org/): ``` [optional scope]: [optional body] [optional

9.7k30d agoDiscuss

NVIDIAAGENTS.md

garak

NVIDIA/garak/AGENTS.md

thread. ### Accountability - Pure code-agent PRs are **not allowed**. A human submitter must understand and defend the change end-to-end. - The submitting human must review every changed line

9.4k47d agoDiscuss

ibelickAGENTS.md

ui-skills

ibelick/ui-skills/AGENTS.md

headings. - Keep headings `font-medium` with `tracking-tight` where appropriate. - Use `JetBrains Mono` for code, commands, and monospace UI. - Keep labels and link text in sentence case. - Prefer light borders

9.2k2mo agoReads credentialsDiscuss

openstatusHQAGENTS.md

openstatus

openstatusHQ/openstatus/AGENTS.md

reasoning from the code alone. - When debugging a failure, start from the incident or issue Polylane recorded: it carries the evidence an investigation already gathered. - Polylane reviews pull requests

9.1k7mo agoDiscuss

MervinPraisonAGENTS.md

PraisonAI

MervinPraison/PraisonAI/AGENTS.md

packages plus the TypeScript SDK: core protocols in `praisonaiagents/`, agentic terminal CLI in `praisonai-code/`, bots/gateway in `praisonai-bot/`, LLM fine-tuning + agent training in `praisonai-train/`, browser automation

9.1k35d agoDiscuss

backnotpropAGENTS.md

plannotator

backnotprop/plannotator/AGENTS.md

ExitPlanMode` via hooks, letting users approve or request changes with annotated feedback. Also provides code review for git diffs and annotation of arbitrary markdown files. > **Reusing the document UI (theme

9k10d agoReads credentialsDiscuss

CloudflareAGENTS.md

vinext

cloudflare/vinext/AGENTS.md

bash git clone --depth 1 --single-branch --branch canary https://github.com/vercel/next.js.git .nextjs-ref ``` --- ## Code Style & Dependencies ### Prefer Node.js Built-in APIs Always use Node.js built-in modules and APIs

8.9k4d agoReads credentialsDiscuss

GoogleAGENTS.md

adk-go

google/adk-go/AGENTS.md

session, or hand the diff to a subagent that did not write the code. An agent reviewing work it produced in the same session re-reads its own intent rather

8.8k21d agoReads credentialsDiscuss

NVIDIAAGENTS.md

OpenShell

NVIDIA/OpenShell/AGENTS.md

first. We design systems and use agents to implement them — this is not vibe coding. The product provides safe, sandboxed runtimes for autonomous AI agents, and the project itself

8.8k6d agoReads credentialsDiscuss

CloudflareAGENTS.md

workerd

cloudflare/workerd/AGENTS.md

upstream code. These patches are stored in the `patches/` directory and are applied during the build process. When updating these dependencies, it's important to review and update the corresponding

8.8k7mo agoDiscuss

CloudflareAGENTS.md

workerd / streams

cloudflare/workerd/src/workerd/api/streams/AGENTS.md

become dangling See `README.md` §Safety Pattern Catalog for detailed When/Why/How for each pattern. ## CODE REVIEW RULE When reviewing changes to streams code, check whether the change requires updates

8.8k7mo agoDiscuss

CloudflareAGENTS.md

workerd / jsg

cloudflare/workerd/src/workerd/jsg/AGENTS.md

unvisited fields across the codebase, enforcing invariants 1 and 2 at build time. ## CODE REVIEW RULE When reviewing changes to JSG code, check whether the change requires updates

8.8k7mo agoDiscuss

apifyAGENTS.md

apify-mcp-server

apify/apify-mcp-server/AGENTS.md

handle similar cases. Ask: "Am I adding code, or fixing the code that's already there?" - **Self-review your diff.** Before declaring done, review: Is this the minimal

8.8k52d agoDiscuss

freecodexyzAGENTS.md

free-code

freecodexyz/free-code/AGENTS.md

MUST** review every stored reference and asynchronous callback for lifetime, every resource for one clear owner, and every interface for explicit copy/move/ borrow semantics. - **MUST NOT** approve code merely because

8.7k4mo agoDiscuss

MongoDBAGENTS.md

mongo-go-driver

mongodb/mongo-go-driver/AGENTS.md

AGENTS.md This file provides guidance to AI agents when working with code in this repository. ## Project Official MongoDB Go Driver (`go.mongodb.org/mongo-driver/v2`). Correctness, backward compatibility, and conformance to [MongoDB Driver

8.5k5mo agoDiscuss

strands-agentsAGENTS.md

harness-sdk

strands-agents/harness-sdk/AGENTS.md

writer`, `pr-feedback`), docs (`docs-writer`, `docs-reviewer`, `docs-audit`, `docs-planner`), and code review (`strands-review`). See [`.agents/skills/README.md`](./.agents/skills/README.md) for what each does and when

8.5k26d agoDiscuss

strands-agentsAGENTS.md

harness-sdk / site

strands-agents/harness-sdk/site/AGENTS.md

work", "what docs need writing" | When authoring or reviewing documentation pages, follow the voice guide and the terminology lock. When verifying code examples in docs, follow the tiered procedure

8.5k26d 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.