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

MicrosoftAGENTS.md

ai-agents-for-beginners / zh-HK

microsoft/ai-agents-for-beginners/translations/zh-HK/AGENTS.md

預期輸出在 markdown 儲存格中 ### 部署代理人的冒煙測試對於作為 Microsoft Foundry 主機代理人部署的課程（01、04、05、16）中，存儲庫提供在 `tests/` 下的冒煙測試目錄，該目錄由 `.github/workflows/smoke-test.yml` 工作流程通過 [AI Smoke Test](https://github.com/marketplace/actions/ai-smoke-test) 操作運行。這是輕量級的部署後檢查（代理人是否可連接且符合基本提示預期？），輔助第

75k3mo agoReads credentialsDiscuss

MicrosoftAGENTS.md

ai-agents-for-beginners / zh-MO

microsoft/ai-agents-for-beginners/translations/zh-MO/AGENTS.md

配置載入 - 範例代理人實作 - Markdown 儲存格中的預期輸出 ### 對已部署代理人進行初步測試對於以 Microsoft Foundry 托管代理人方式部署的課程（01、04、05、16），儲存庫提供位於 `tests/` 下的初步測試目錄，透過 `.github/workflows/smoke-test.yml` 工作流程使用 [AI Smoke Test](https://github.com/marketplace/actions/ai-smoke-test) 操作執行。這是一個簡易的部署後檢查（代理是否可達且基本提示是否符合預期？），用以補充第

75k3mo agoReads credentialsDiscuss

MicrosoftAGENTS.md

ai-agents-for-beginners / zh-TW

microsoft/ai-agents-for-beginners/translations/zh-TW/AGENTS.md

範例代理人實作 - 預期輸出（Markdown 單元格） ### 部署代理人的冒煙測試對於以 Microsoft Foundry 託管代理人形式部署的課程（01、04、05、16），此儲存庫提供了位於 `tests/` 下的冒煙測試目錄，並由 `.github/workflows/smoke-test.yml` 工作流程透過 [AI Smoke Test](https://github.com/marketplace/actions/ai-smoke-test) 操作執行。這是一種輕量的部署後檢查（代理人是否可訪問且符合基本提示預期？），補充第10與16課的評估管線。詳見

75k3mo agoReads credentialsDiscuss

ruvnetAGENTS.md

ruflo

ruvnet/ruflo/AGENTS.md

point. Codex agents are the executors. Coordination records do not write code or run tests. Use `guidance_brain({ mode: "recommend", task: "..." })` to select Ruflo capabilities from the live MCP registry

73k21d agoReads credentialsDiscuss

career-ops-hqAGENTS.md

career-ops / web

career-ops-hq/career-ops/web/AGENTS.md

matches tailored CVs and canonicalises statuses: call it, or mirror it behind a parity test. A second implementation of the same rule is how the two halves start disagreeing

73k35d agoDiscuss

colbymchenryAGENTS.md

codegraph

colbymchenry/codegraph/AGENTS.md

colbymchenry/codegraph` on npm; same binary serves as installer, indexer, and MCP server. ## Build, Test, Run ```bash npm run build # tsc + copy schema.sql and *.wasm + build the viewer into dist/; chmods

72k57d agoDeletes or force-pushesDiscuss

diegosouzapwAGENTS.md

OmniRoute

diegosouzapw/OmniRoute/AGENTS.md

clean) npm run typecheck:noimplicit:core # Strict check (no implicit any) npm run test:coverage # Unit tests + coverage gate (60/60/60/60 — statements/lines/functions/branches) npm run check # lint + test combined npm run check

71k13d agoReads credentialsDiscuss

code-yeongyuAGENTS.md

oh-my-openagent

code-yeongyu/oh-my-openagent/.agents/AGENTS.md

isolated `CODEX_HOME` + local mock model, hook-fired assertions; helper scripts each ship `--self-test` | | `opencode-qa/` | no | opencode CLI/TUI/event-stream QA: hook-fired assertions via SSE, session DB inspection, tmux

70k11d agoDiscuss

code-yeongyuAGENTS.md

oh-my-openagent

code-yeongyu/oh-my-openagent/AGENTS.md

SKIP". THERE IS NO "IT OBVIOUSLY WORKS".** **"It typechecks" is NOT QA. "`bun test` is green" is NOT QA.** YOU MUST DRIVE THE REAL HARNESS, and then **YOU MUST WRITE

70k11d agoReads credentialsDiscuss

code-yeongyuAGENTS.md

oh-my-openagent / assets

code-yeongyu/oh-my-openagent/assets/AGENTS.md

bash bun run build:schema bun run build:omo-schema bun run script/build-help-schemas.ts bun test tests/omo-schema-freshness.test.ts ``` ## CONVENTIONS - Regenerate after changing the corresponding source schema or help definition. - Commit generated output

70k11d agoDiscuss

code-yeongyuAGENTS.md

oh-my-openagent / bin

code-yeongyu/oh-my-openagent/bin/AGENTS.md

70k11d agoDiscuss

code-yeongyuAGENTS.md

oh-my-openagent / packages

code-yeongyu/oh-my-openagent/packages/AGENTS.md

PACKAGES | Package | Layout | Purpose | |---------|--------|---------| | `lsp-tools-mcp/` | Vendored standalone project (`.github/`, `CHANGELOG.md`, `LICENSE`, `src/`, `test/`, `biome.json`, `vitest.config.ts`) | Serves the 8 aliases `lsp_status`, `lsp_diagnostics`, `lsp_goto_definition`, `lsp_find

70k11d agoDiscuss

code-yeongyuAGENTS.md

oh-my-openagent / scripts

code-yeongyu/oh-my-openagent/scripts/AGENTS.md

pack --dry-run --json` manifests | | `third-party-notice-requirements.mjs` | Declarative notice requirements and path/package matching | | `check-third-party-notices.test.mjs` | Node test coverage for spawn invocation resolution (Windows/non-Windows) and `parseNpmPackJson` (npm 11 array, npm 12 keyed, malformed

70k11d agoDiscuss

code-yeongyuAGENTS.md

oh-my-openagent / tests

code-yeongyu/oh-my-openagent/tests/AGENTS.md

tests/ - Repository-Level Integration Tests ## OVERVIEW Cross-package invariants and integration fixtures that do not belong to one package's co-located unit suite. ## STRUCTURE ``` tests/ ├── omo-config-category-drift.test.ts # Config/category contract stays

70k11d agoReads credentialsDiscuss

ClineAGENTS.md

cline

cline/cline/AGENTS.md

ANTHROPIC_API_KEY`, `CLINE_API_KEY`, `OPENROUTER_API_KEY`); see `apps/cli/README.md`. ### Build / Lint / test - SDK packages (`@cline/shared|llms|agents|core|sdk`) resolve each other through compiled `dist/` (their `exports` point

69k5mo agoReads credentialsDiscuss

ClineAGENTS.md

cline / sdk

cline/cline/sdk/AGENTS.md

Development reference for the Cline SDK workspace.

69k5mo agoDiscuss

ClineAGENTS.md

cline / llms

cline/cline/sdk/packages/llms/AGENTS.md

Development guidance for the @cline/llms package.

69k5mo agoDiscuss

MicrosoftAGENTS.md

AI-For-Beginners

microsoft/AI-For-Beginners/AGENTS.md

bash cd etc/quiz-app npm run serve # Hot-reload development server at http://localhost:8080 ``` ## Testing Instructions This is an educational repository focused on learning content rather than software testing. There

69k12mo agoDeletes or force-pushesDiscuss

MicrosoftAGENTS.md

AI-For-Beginners / da

microsoft/AI-For-Beginners/translations/da/AGENTS.md

Dette er et uddannelsesrepository fokuseret på læringsindhold frem for softwaretest. Der er ingen traditionel test-suite. ### Valideringsmetoder: 1. **Jupyter Notebooks:** Udfør celler sekventielt for at verificere, at kodeeksempler fungerer

69k12mo agoDeletes or force-pushesDiscuss

MicrosoftAGENTS.md

AI-For-Beginners / de

microsoft/AI-For-Beginners/translations/de/AGENTS.md

Dieses Repository ist auf Lerninhalte ausgerichtet und nicht auf Softwaretests. Es gibt keine traditionelle Test-Suite. ### Validierungsansätze: 1. **Jupyter Notebooks:** Zellen nacheinander ausführen, um sicherzustellen, dass die Codebeispiele funktionieren

69k12mo agoDeletes or force-pushesDiscuss

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.