AGENTS.md examples from real projects

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

Best matches · from page 23Worked for most · soon

WorldFlowAIAGENTS.md

everything-claude-code / rules

WorldFlowAI/everything-claude-code/rules/agents.md

2k9mo agoDiscuss

xu-xiangAGENTS.md

everything-claude-code-zh

xu-xiang/everything-claude-code-zh/AGENTS.md

用途 | 何时使用 | |-------|---------|-------------| | planner | 实现规划 | 复杂功能、重构 | | architect | 系统设计与可扩展性 | 架构决策 | | tdd-guide | 测试驱动开发 | 新功能、错误修复 | | code-reviewer | 代码质量与可维护性 | 编写/修改代码后 | | security-reviewer | 漏洞检测 | 提交前、敏感代码 | | build-error-resolver | 修复构建/类型错误 | 构建失败时

1.9k7mo agoDiscuss

xu-xiangAGENTS.md

everything-claude-code-zh

xu-xiang/everything-claude-code-zh/.codex/AGENTS.md

Workflow） - `agents/openai.yaml` — Codex 接口元数据可用技能： - tdd-workflow — 测试驱动开发（TDD），包含 80% 以上的覆盖率 - security-review — 全面的安全自查清单 - coding-standards — 通用编码规范 - frontend-patterns — React/Next.js 模式 - frontend-slides — 视口安全（Viewport-safe）的 HTML 演示文稿及

1.9k7mo agoDiscuss

xu-xiangAGENTS.md

everything-claude-code-zh / rules

xu-xiang/everything-claude-code-zh/rules/agents.md

1.9k7mo agoDiscuss

SentryAGENTS.md

sentry-php

getsentry/sentry-php/AGENTS.md

formatting, lint, and test commands for the code you changed. - Before handing back substantive code changes, run `composer check` when feasible and call out anything you could

1.9k3mo agoDiscuss

the-open-engineAGENTS.md

zeroshot

the-open-engine/zeroshot/AGENTS.md

files. Review instructions prohibit repairs and warn that other nodes may execute concurrently; this is an instructional boundary. Missing dependencies are reported with environment evidence rather than unrelated code repair

1.9k13d agoReads credentialsDiscuss

MicrosoftAGENTS.md

vscode-mssql

microsoft/vscode-mssql/AGENTS.md

layer. - `extension-toolkit/vscode` may depend on `base` and the VS Code API. - Production code must not import `extension-toolkit/vscode/testing`. - Import an explicit toolkit layer; do not import from

1.9k31d agoDiscuss

xenodiumAGENTS.md

agent-shell

xenodium/agent-shell/AGENTS.md

human-written summaries save the maintainer from having to parse lengthy generated text. - Review all code in your PR yourself and vouch for its quality. ## Contributing This is an Emacs

1.9k7mo agoDiscuss

hanshuaikangAGENTS.md

nezha

hanshuaikang/nezha/AGENTS.md

而是退化到 `Math.max(MINIMUM_COLS=2, Math.floor(0/cell)) = 2`。放过 → `resize_pty` → `SIGWINCH` → Claude Code / Codex 等全屏 TUI 按 `cols=2` 重排，buffer **永久打散成一字一行不可恢复**。 - **后端 `resize_pty` 必须保留畸形尺寸兜底**——前端三层防御漏掉的话也得在这里挡住，防御纵深不允许只剩前端一层。 ### 禁止方向

1.9k3mo agoDiscuss

NVIDIA-AI-BlueprintsAGENTS.md

video-search-and-summarization / helm-sync

NVIDIA-AI-Blueprints/video-search-and-summarization/.github/helm-sync/AGENTS.md

chart that retains an immutable `nvcr.io/nvstaging/vss-core/*` default, ignores either global override, or hard-codes a managed image in an umbrella profile as drift. - Continue to flag every other semantic

1.9k3mo agoReads credentialsDiscuss

NVIDIA-AI-BlueprintsAGENTS.md

video-search-and-summarization / skill-eval

NVIDIA-AI-Blueprints/video-search-and-summarization/.github/skill-eval/AGENTS.md

links there, and (e) flag that this is an **auto-generated adapter for the reviewer to check**. The fork comment (`adapter-note-…md`) instead says the bot can't push

1.9k3mo agoReads credentialsDiscuss

CloudflareAGENTS.md

workers-oauth-provider

cloudflare/workers-oauth-provider/AGENTS.md

never displaces `latest`. Both release workflows share the `npm-publish` concurrency group. ### Bonk (AI code review) Mention `/bonk` or `@ask-bonk` in PR comments to get AI-powered code review

1.9k6d agoDiscuss

ShenSeanChenAGENTS.md

waku-agent

ShenSeanChen/waku-agent/AGENTS.md

brand file there, never copy one into `examples/`, and **do not move code between `hosted/` and `waku/` without saying which license it lands under.** 8. **Don't edit the copied

1.9k14d agoReads credentialsDiscuss

Microsoft AzureAGENTS.md

azure-sdk-for-go

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

Verify compatibility**: Ensure changes don't break backward compatibility without explicit approval ### For Code Reviews When assisting with code reviews: 1. Check compliance with [Azure Go SDK Guidelines](https://azure.github.io

1.9k6mo agoReads credentialsDiscuss

ReScienceLabAGENTS.md

opc-skills

ReScienceLab/opc-skills/.factory/AGENTS.md

Example: ```yaml --- name: domain-hunter description: Search domains, compare registrar prices, and find promo codes triggers: - domain - registrar - buy domain dependencies: - twitter - reddit --- ``` ## Skill Development Patterns ### Creating a New Skill

1.8k8mo agoDiscuss

trpc-groupAGENTS.md

trpc-agent-go

trpc-group/trpc-agent-go/AGENTS.md

configuration, or recommended usage changes. ## Go design conventions Follow Effective Go and the Go Code Review Comments, while preserving established APIs when compatibility requires it. - Use `gofmt` and `goimports

1.8k4mo agoDiscuss

SentryAGENTS.md

sentry-react-native

getsentry/sentry-react-native/AGENTS.md

review`, `gha-security-review`, `span-convention-review`, and more) — invoke those for depth beyond the local pass. ## Nested AGENTS.md Files - [`packages/core/AGENTS.md`](packages/core/AGENTS.md) — TypeScript/JavaScript code style, testing, patterns - [`packages/core/android/AGENTS.md`](packages/core/android/AGENTS.md) — Java/Kotlin

1.8k29d agoDeletes or force-pushesDiscuss

DicklesworthstoneAGENTS.md

pi_agent_rust

Dicklesworthstone/pi_agent_rust/AGENTS.md

verification succeeds against the public release. --- ## Compiler and Test Checks (CRITICAL) **After any substantive code changes, use the one authoritative quality entry point:** ```bash dsr quality --tool pi_agent_rust

1.8k6d agoDeletes or force-pushesDiscuss

kubb-labsAGENTS.md

kubb

kubb-labs/kubb/AGENTS.md

open `SKILL.md` format, cross-provider). Shared skills, convention rules, `/create-pr`, `/create-changeset`, `/create-branch`, `/create-issue`, the `code-reviewer` subagent, and the `house` output style come from the `agents` plugin ([stijnvanhulle/agents](https://github.com

1.8k4mo agoDiscuss

zzetAGENTS.md

gortex

zzet/gortex/docs/agents.md

have to review; only per-community skills, which describe that specific codebase, are written into the repo. | Host | Skills | Slash commands | Sub-agents | Enforcement hooks | | --- | --- | --- | --- | --- | | Claude Code | `~/.claude/skills/` | `~/.claude/commands/` | `~/.claude/agents

1.8k6mo 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.