AGENTS.md examples from real projects

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

Best matches · from page 24Worked for most · soon

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

MicrosoftAGENTS.md

BotFramework-WebChat

microsoft/BotFramework-WebChat/AGENTS.md

pass all linting process - Add changelog entry to `CHANGELOG.md`, follow our existing format ## Code review - Code should use as much immutable (via `Object.freeze()`) as possible, DO NOT trust `readonly

1.8k4mo agoDiscuss

open-mercatoAGENTS.md

open-mercato

open-mercato/open-mercato/AGENTS.md

release changes | `.ai/skills/om-refresh-standalone-harness/SKILL.md` + `packages/create-app/agentic/shared/ai/skills/om-evolve-harness/SKILL.md` | | **Spec & PR Automation** | | | Spec lifecycle (pre-implement → implement → write/update), code review, DS review | `.agents/skills/{om-spec-writing,om-code-review}/SKILL.md` + `.ai/skills/{om-pre-implement-spec

1.8k4mo agoReads credentialsDiscuss

ginlix-aiAGENTS.md

LangAlpha

ginlix-ai/LangAlpha/AGENTS.md

code indexes it). - **⚠️ Third-party MCP servers launch isolated**: any stdio MCP server whose code we don't own runs via `uvx`/`npx` with pinned versions, never from the shared

1.8k6d agoReads credentialsDiscuss

memorax-aiAGENTS.md

memorax-code

memorax-ai/memorax-code/AGENTS.md

diagnostics); review and redact any diagnostic excerpt before sharing it. MemoraX receives only documented query/add/writeback payloads; local trace provenance and transcript paths stay local. - Keep the shared `memorax-code` Skill

1.8k25d agoDiscuss

happier-devAGENTS.md

happier

happier-dev/happier/AGENTS.md

commit. - `.agents/skills/happier-review` is the only general Happier review/QA orchestrator. The archived `review-protocol` and `code-reviewer` skills must not be invoked. - `.agents/skills/happier-pr-steward` for user-requested pull-request stewardship; it composes

1.8k9d agoDiscuss

mex-memoryAGENTS.md

mex

mex-memory/mex/.mex/AGENTS.md

Always-loaded project anchor. Read this first. Contains project identity, non-negotiables, commands, and pointer to ROUTER.md for full context.

1.7k22d agoDiscuss

MicrosoftAGENTS.md

rnx-kit

microsoft/rnx-kit/AGENTS.md

TypeScript configs yarn update-readme # Regenerate API docs ``` CI uses `suggestion-bot` to post code review suggestions for format, constraints, align-deps, and readme issues. ## Platform-Specific Notes - **Test apps

1.7k7mo agoDiscuss

Google CloudAGENTS.md

scion

GoogleCloudPlatform/scion/AGENTS.md

force-add files into them (`git add -f`). - **No PR review artifacts.** Code-review notes (`pr-*-review*.md`) belong in the PR discussion thread, not as committed files. - **The `downloads

1.7k3mo agoDiscuss

Google CloudAGENTS.md

scion / web

GoogleCloudPlatform/scion/web/AGENTS.md

agents working on the Scion Web Frontend. ## Design Documents Before making changes, review the relevant design documentation: - **[Web Frontend Design](../.design/hosted/web-frontend-design.md)** - Architecture, technology stack, component patterns ## Architecture Overview

1.7k3mo agoDiscuss

feigeCodeAGENTS.md

navop

feigeCode/navop/AGENTS.md

显示与数据不一致 - 根因不明的问题说明： - 对真实 bug / 异常排查，不直接猜测式修补 - 先稳定复现或收集足够证据，再建立假设并逐项验证 - 确认根因后再决定修复方案，并补最贴近故障表面的回归保护 ### Review 类任务适用： - review - code review - reviewer output - spec compliance - 合并前审查 - 阶段性交付审查审查要求： - Review 应检查规格符合性、正确性、边界条件、错误路径、回归风险

1.7k30d agoDiscuss

MicrosoftAGENTS.md

edgeai-for-beginners

microsoft/edgeai-for-beginners/AGENTS.md

works - Check compatibility with Foundry Local ### Review Process - Educational content changes are reviewed for accuracy and clarity - Code samples are tested for functionality - Translation updates are handled automatically by GitHub

1.7k11mo agoReads credentialsDiscuss

MicrosoftAGENTS.md

edgeai-for-beginners / en

microsoft/edgeai-for-beginners/translations/en/AGENTS.md

1.7k11mo agoReads credentialsDiscuss

MicrosoftAGENTS.md

edgeai-for-beginners / my

microsoft/edgeai-for-beginners/translations/my/AGENTS.md

handling သည် မှန်ကန်စွာ လုပ်ဆောင်မှုရှိစေရန် စစ်ဆေးပါ - Foundry Local နှင့် အညီဖြစ်မှုကို စစ်ဆေးပါ ### Review Process - Educational content ပြင်ဆင်မှုများကို တိကျမှုနဲ့ ရှင်းလင်းမှုအတွက် ပြန်လည်သုံးသပ်သည် - Code sample များကို functionality အတွက် စမ်းသပ်သည် - Translation update များကို GitHub Actions မှ

1.7k11mo agoReads credentialsDiscuss

MicrosoftAGENTS.md

edgeai-for-beginners / nl

microsoft/edgeai-for-beginners/translations/nl/AGENTS.md

nieuwe branch aan vanuit `main` 2. **Breng je wijzigingen aan** volgens de richtlijnen voor code-stijl 3. **Test grondig** met behulp van de testinstructies hierboven 4. **Commit met duidelijke berichten

1.7k11mo agoReads credentialsDiscuss

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.