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

MicrosoftAGENTS.md

Data-Science-For-Beginners / zh-TW

microsoft/Data-Science-For-Beginners/translations/zh-TW/AGENTS.md

自動翻譯（co-op-translator.yml） ## 測試指導 ### 測驗應用程式測試 ```bash cd quiz-app # Run lint checks npm run lint # Test build process npm run build # Manual testing: Start dev server and verify quiz functionality

37k12mo agoDeletes or force-pushesDiscuss

ContinueAGENTS.md

continue / cli

continuedev/continue/extensions/cli/AGENTS.md

this repository. ## Development Commands - **Build**: `npm run build` - Compiles TypeScript to JavaScript in dist/ - **Test**: `npm test` - Runs Vitest tests with ESM support - **Type Check**: `npm run lint` - Runs TypeScript

36k8mo agoDiscuss

BlockAGENTS.md

buzz

block/buzz/AGENTS.md

step, for example for a small change or while iterating. 3. **A human then tested it themselves**: in the app, against the local relay (through the app or `curl

35k4mo agoReads credentialsDiscuss

BlockAGENTS.md

buzz / agents

block/buzz/desktop/src/features/agents/AGENTS.md

target thread root: ```sh buzz messages send --channel --reply-to \ --mention --content '!cancel' ``` ## The tests that enforce this - `lib/agentConfigCore.test.mjs` — field model per harness × scope, clearing policy. Update when the capability

35k4mo agoDiscuss

Hugging FaceAGENTS.md

diffusers

huggingface/diffusers/.ai/AGENTS.md

gotchas. - **Modular pipelines** — see [modular.md](references/modular.md) for modular pipeline conventions, patterns, and gotchas. - **Tests** — see [testing.md](references/testing.md) for test conventions: required test layers, tester mixins, and dummy-component rules. - **Reporting

35k22d agoDiscuss

can1357AGENTS.md

oh-my-pi

can1357/oh-my-pi/AGENTS.md

editing it. Check only verified checklist items; explain skipped or inapplicable checks in `Testing`. ## Code Quality - No `any` unless absolutely necessary. - **NEVER use `ReturnType<>`** — use the actual type name. - **NEVER

34k8mo agoReads credentialsDiscuss

alibabaAGENTS.md

nacos

alibaba/nacos/AGENTS.md

agents MUST analyze the affected `test/openapi-test` coverage and update the API IT scenario matrix, test cases, and coverage registry in the same change set. If the functional path cannot

33k8mo agoDiscuss

iOfficeAIAGENTS.md

AionUi

iOfficeAI/AionUi/AGENTS.md

process communication must go through the IPC bridge (`packages/desktop/src/preload/`). See [docs/architecture/overview.md](docs/architecture/overview.md) for details. ## Testing **Framework**: Vitest 4 (`vitest.config.ts`). Project coverage target is ≥ 80%; ordinary changes should add focused tests

33k6mo agoDiscuss

virgiliojr94AGENTS.md

book-to-skill

virgiliojr94/book-to-skill/AGENTS.md

SECURITY.md` and `SECURITY-NOTICE.md` — when touching parsing, files, subprocesses, generated content, or dependencies. 5. Existing tests closest to the code being changed. For the progressive-disclosure research/evaluation initiative, also read: - `docs/research/progressive-disclosure-evals.md

33k4mo agoDiscuss

VercelAGENTS.md

skills

vercel-labs/skills/AGENTS.md

modules` for skills. ## Architecture ``` src/ ├── cli.ts # Main entry point, command routing, init/check/update ├── cli.test.ts # CLI tests ├── add.ts # Core add command logic ├── add-prompt.test.ts # Add prompt behavior tests ├── add.test.ts # Add command tests ├── constants.ts

32k37d agoReads credentialsDiscuss

OpenAIAGENTS.md

openai-python

openai/openai-python/AGENTS.md

from the OpenAI API schema. Follow `CONTRIBUTING.md` before changing generated files. Handwritten policy, automation, tests, and examples should remain small and should not alter exported SDK APIs unless the change

32k38d agoReads credentialsDiscuss

tirth8205AGENTS.md

code-review-graph

tirth8205/code-review-graph/AGENTS.md

Agent Instructions Project context (architecture, commands, conventions, tests) is in `CLAUDE.md`. This file holds the rules for every coding agent working in this repository. ## Non-Interactive Shell Commands

32k4mo agoDeletes or force-pushesDiscuss

VercelAGENTS.md

agent-skills / react-view-transitions

vercel-labs/agent-skills/skills/react-view-transitions/AGENTS.md

limit. - **Naming an interactive element has a cost:** named participants are skipped by hit-testing while a transition runs ([csswg#10930](https://github.com/w3c/csswg-drafts/issues/10930)) — clicks and hover fall through

31k5mo agoDiscuss

topoteretesAGENTS.md

cognee

topoteretes/cognee/AGENTS.md

work with the cognee repository: how it’s organized, how to build, test, lint, and contribute. It mirrors our actual tooling and CI while providing quick commands for local development

31k14d agoReads credentialsDiscuss

googleworkspaceAGENTS.md

cli

googleworkspace/cli/AGENTS.md

Manager**: Use `pnpm` instead of `npm` for Node.js package management in this repository. ## Build & Test > [!IMPORTANT] > **Test Coverage**: The `codecov/patch` check requires that new or modified lines are covered

31k6mo agoReads credentialsDiscuss

ComposioHQAGENTS.md

composio

ComposioHQ/composio/AGENTS.md

skill references, compatibility mirrors, or validation. - `bug-fixing`: fixing a defect and choosing regression tests. - `cross-sdk-parity`: aligning TypeScript and Python behavior, generated client bumps, or API contract drift

30k10d agoDiscuss

ComposioHQAGENTS.md

composio

ComposioHQ/composio/docs/AGENTS.md

build bun run types:check bun run lint bun run lint:links bun run test bun run test:integration bun run generate:toolkits bun run generate:meta-tools

30k10d agoDiscuss

ComposioHQAGENTS.md

composio / python

ComposioHQ/composio/python/AGENTS.md

Python SDK guidance for AI agents. ## Scope `python/` contains the Python SDK, provider packages, tests, nox sessions, release scripts, and Python docs. ## Skill Routing - Use `python-sdk` for core

30k10d agoDiscuss

ComposioHQAGENTS.md

composio / ts

ComposioHQ/composio/ts/AGENTS.md

agents. ## Scope `ts/` contains the TypeScript SDK packages, examples, CLI, and runtime E2E tests. ## Skill Routing - Use `typescript-sdk` for `@composio/core`, shared TypeScript package behavior, generated SDK surfaces, and modifiers

30k10d agoDiscuss

LangChainAGENTS.md

deepagents

langchain-ai/deepagents/AGENTS.md

duplicating them here: - [`libs/DEVELOPMENT.md`](libs/DEVELOPMENT.md) — repository layout, setup, commands, pre-commit, the edit-test-lint loop, testing, and benchmarks. - [`libs/ARCHITECTURE.md`](libs/ARCHITECTURE.md) — runtime structure and SDK starting points. - [`.github/RELEASING.md`](.github/RELEASING.md) — releases

30k34d 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.