AGENTS.md examples from real projects

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

Best matches · from page 13Worked for most · soon

mem0aiAGENTS.md

mem0 / tests

mem0ai/mem0/tests/AGENTS.md

Python SDK tests (`tests/`) pytest suite for the `mem0/` package. ## Commands ```bash make install_all # optional deps; several tests need them make test # pytest tests/ make test

66k23d agoDiscuss

gsd-buildAGENTS.md

research on user's decisions - Investigates implementation patterns for the specific phase domain - Detects test infrastructure for Nyquist validation mapping --- ### gsd-ui-researcher **Role:** Produces UI design contracts for frontend

65k4mo agoDiscuss

mvanhornAGENTS.md

last30days-skill

mvanhorn/last30days-skill/AGENTS.md

invocation (`python3 scripts/last30days.py ...`) is a fallback for scripting, cron, and dev-time engine testing; label it as such, never as the primary path. - Slash commands don't pass shell mechanics

63k3mo agoReads credentialsDiscuss

tw93AGENTS.md

Pake

tw93/Pake/AGENTS.md

pake skill) ├── llms.txt # Agent-facing contract summary (--json, --config, exit codes) ├── scripts/ # Utility scripts ├── tests/ # Unit, integration, and release-flow tests ├── .github/workflows/ # quality/test and release automation ├── default_app_list.json # Popular apps config

62k12d agoDiscuss

rohitg00AGENTS.md

ai-engineering-from-scratch

rohitg00/ai-engineering-from-scratch/AGENTS.md

Repo layout ``` phases/ NN-phase-slug/ NN-lesson-slug/ docs/en.md # lesson explainer code/ # implementation + tests quiz.json # 6 questions outputs/ # reusable artifact (skill / prompt / agent / MCP server) README.md # public face; lesson

60k6d agoDeletes or force-pushesDiscuss

crewAIIncAGENTS.md

crewAI

crewAIInc/crewAI/AGENTS.md

practices and idiomatic patterns. 2. Maintain existing code structure and organization. 3. Write unit tests for new functionality focusing on behaivor and not implementation. 4. Document public APIs and complex

59k22mo agoDiscuss

calesthioAGENTS.md

OpenMontage / flux-best-practices

calesthio/OpenMontage/.agents/skills/flux-best-practices/AGENTS.md

costs at different resolutions. **Creative Exploration / Ideation:** **Recommended: FLUX.2 [klein]** - Fast iterations - Quick concept testing - Mood board generation - Exploring prompt variations **Production Marketing Assets:** **Recommended: FLUX.2 [pro]** - Consistent quality - Reasonable

59k44d agoDiscuss

aaif-gooseAGENTS.md

goose

aaif-goose/goose/AGENTS.md

Until the migration is complete, changes to agent-loop behavior must be implemented and tested in both paths. When reviewing code, check whether a change to either path also applies

55k6mo agoDiscuss

JetBrainsAGENTS.md

kotlin / analysis

JetBrains/kotlin/analysis/AGENTS.md

ownership with `withValidityAssertion` - Mark experimental APIs with `@KaExperimentalApi`, implementation details with `@KaImplementationDetail` ## Working with Test Data When modifying test data files or running generated tests (`*Generated`) that compare output against

53k29d agoDiscuss

JetBrainsAGENTS.md

kotlin / compiler

JetBrains/kotlin/compiler/AGENTS.md

mostly related to FIR (`compiler/fir/`), use `FIR: ` prefix in the commit subject line. - **Test-before-fix**: When fixing an issue and adding a test, commit the test data

53k29d agoDiscuss

router-for-meAGENTS.md

CLIProxyAPI

router-for-me/CLIProxyAPI/AGENTS.md

build -o cli-proxy-api ./cmd/server # Build go run ./cmd/server # Run dev server go test ./... # Run all tests go test -v -run TestName ./path/to/pkg # Run single test go build

53k4mo agoReads credentialsDiscuss

ChromeDevToolsAGENTS.md

chrome-devtools-mcp

ChromeDevTools/chrome-devtools-mcp/AGENTS.md

scripts from `package.json` to run commands. - Use `npm run build` to run tsc and test build. - Use `npm run test` to build and run tests, run all tests to verify

53k4mo agoDiscuss

coreyhaines31AGENTS.md

marketingskills

coreyhaines31/marketingskills/AGENTS.md

integration guides per tool │ └── REGISTRY.md # Tool index with capabilities ├── CONTRIBUTING.md ├── LICENSE └── README.md ``` ## Build / Lint / Test Commands **Skills** are content-only (no build step). Verify manually: - YAML frontmatter is valid - `name

50k5mo agoDiscuss

AstralAGENTS.md

ruff

astral-sh/ruff/AGENTS.md

nitpicky. Report not only bugs and regressions, but also architectural and maintenance risks, weak test coverage, unclear code, unnecessary complexity, and meaningful style or consistency issues. Order findings by severity

50k4mo agoDiscuss

ayghriAGENTS.md

i-have-adhd

ayghri/i-have-adhd/AGENTS.md

49k4mo agoDiscuss

QuantumNousAGENTS.md

new-api

QuantumNous/new-api/AGENTS.md

appropriate when it represents reusable behavior, a required interface/framework callback, an exported API, a test fixture, or complex business logic that deserves direct tests. - If a single-use helper

49k13d agoDiscuss

QuantumNousAGENTS.md

new-api / web

QuantumNous/new-api/web/AGENTS.md

跨域与 Cookie 使用 `withCredentials` 并按后端要求处理 CSRF。 ### 3.14 测试 - 工具函数与纯逻辑优先单元测试（Vitest），测试文件 `*.test.ts`；组件用 React Testing Library 测交互与行为，避免测实现细节。 - 新增功能、修复缺陷或修改现有行为时，必须同步新增或更新测试；Bug 修复必须先编写能够稳定复现问题的失败用例，再实现修复并确认用例转为通过。 - 修改前端组件的布局、尺寸、滚动定位、焦点管理、键盘操作、选中状态

49k13d agoReads credentialsDiscuss

HKUDSAGENTS.md

nanobot

HKUDS/nanobot/AGENTS.md

provider, executes tools, and manages session memory. ## Development Commands ```bash # Python: run single test / lint pytest tests/test_openai_api.py::test_function -v ruff check nanobot/ # Strict type checking (matches CI) uv sync

49k5mo agoDiscuss

jeecgbootAGENTS.md

JeecgBoot / jeecgboot-vue3

jeecgboot/JeecgBoot/jeecgboot-vue3/AGENTS.md

matching files under `src/`; run it only when broad formatting is intended. - No regular test script is configured in `package.json`; a Jest config exists, but there is no `test` script

48k12mo agoReads credentialsDiscuss

git-df-scottAGENTS.md

claude-skills / get-shit-done

git-df-scott/claude-skills/get-shit-done/AGENTS.md

agents/`; docs are in `docs/`; logos and terminal images are in `assets/`. Root tests are in `tests/*.test.cjs`. The TypeScript SDK is isolated under `sdk/`, with source and Vitest tests

04mo 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.