AGENTS.md examples from real projects

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

Best matchesWorked for most · soon

“testing” 100k+ stars Hiding risky files

obraAGENTS.md

superpowers

obra/superpowers/AGENTS.md

skill philosophy differs from Anthropic's published guidance on writing skills. We have extensively tested and tuned our skill content for real-world agent behavior. PRs that restructure, reword

292k3mo agoDiscuss

NousResearchAGENTS.md

hermes-agent / agent

NousResearch/hermes-agent/agent/AGENTS.md

CHILD_ENV_MARKER` valued as the fenced Kanban board root, not a bare flag. ## Tests Loop/phase tests go in `tests/agent/`; patch the binding the phase actually reads (siblings often `from

250k6mo agoDiscuss

NousResearchAGENTS.md

hermes-agent / plugins

NousResearch/hermes-agent/plugins/AGENTS.md

process warning, documented replacement + migration note, ≥ 2 subsequent minor releases before removal. - Compat tests load **frozen plugins through the real discovery path** and assert outcomes — never exact registry/catalog counts, source

250k6mo agoDiscuss

NousResearchAGENTS.md

hermes-agent / web

NousResearch/hermes-agent/web/AGENTS.md

surface; a new surface is a new `web_routers/ .py`, not a growing `web_server.py`. - Tests: Python in `tests/hermes_cli/` (routers, pty bridge); JS in the `web/` vitest suite. Python tests must

250k6mo agoDiscuss

affaan-mAGENTS.md

ECC

affaan-m/ECC/AGENTS.md

Core Principles 1. **Agent-First** — Delegate to specialized agents for domain tasks 2. **Test-Driven** — Write tests before implementation, 80%+ coverage required 3. **Security-First** — Never compromise on security; validate

246k30d agoDiscuss

DeepSeekAGENTS.md

deepseek-harness / profiles

deepseek-ai/deepseek-harness/apps/cli/tests/profiles/AGENTS.md

AGENTS.md — Profile integration tests This tree owns cross-package behavior of shipped `dsh` profiles. Start product scenarios through `apps/cli/src/bin.ts` with `--profile ` or the ` ` shorthand; a test-only Loader driver

238k51d agoDiscuss

DeepSeekAGENTS.md

deepseek-harness / benchmarks

deepseek-ai/deepseek-harness/benchmarks/AGENTS.md

local diagnostics remain beside their owners and use the `.perf.ts` suffix instead of joining `test:bench`. - Organize benchmarks by measured user path, one directory per path. Do not mirror

238k51d agoDiscuss

DeepSeekAGENTS.md

deepseek-harness

deepseek-ai/deepseek-harness/docs/AGENTS.md

widen that scope. A reference may be exhaustive only about its own subject. Testing mechanisms, fixtures, and harnesses belong at the lowest owning level; higher documents link there. Classify every

238k51d agoDiscuss

DeepSeekAGENTS.md

deepseek-harness / system

deepseek-ai/deepseek-harness/native/system/AGENTS.md

implementation. - Runtime binary selection has no environment-variable overrides. `NALR_REQUIRE_LANDLOCK` is a test-only enforcement requirement. - There is no install-time compile fallback. Missing Landlock binaries probe unusable

238k51d agoDiscuss

DeepSeekAGENTS.md

deepseek-harness / packages

deepseek-ai/deepseek-harness/packages/AGENTS.md

global service store ([postmortem](../docs/postmortem/0001-acp-default-export-drops-inject.md)). - **Product-visible plugins require a non-unit REAL-composition test.** Hand-built `ctx.plugin(...)` suites are insufficient. Boot test-only `cordis.yml` through the Loader and app/process

238k51d agoDiscuss

DeepSeekAGENTS.md

deepseek-harness / experimental

deepseek-ai/deepseek-harness/packages/experimental/AGENTS.md

shipped compositions in CI. Experimental packages may depend on release packages and each other. Tests may use experimental packages through `devDependencies`; examples may load them explicitly. - Experimental status does

238k51d agoDiscuss

DeepSeekAGENTS.md

deepseek-harness / schedule

deepseek-ai/deepseek-harness/packages/schedule/AGENTS.md

shot prompt. - Keep recurrence arithmetic pure. Production uses platform wall time and segmented timers; tests use explicit samples or restored fake timers

238k51d agoDiscuss

DeepSeekAGENTS.md

deepseek-harness / scripts

deepseek-ai/deepseek-harness/scripts/AGENTS.md

ownership gates use syntax-aware discovery, guard against an empty or narrowed corpus, and test every admitted/excluded form that changes their detection boundary. Script specs run in forked workers beside

238k51d agoDiscuss

DeepSeekAGENTS.md

deepseek-harness / snapshots

deepseek-ai/deepseek-harness/snapshots/AGENTS.md

AGENTS.md — Recorded-session snapshots This tree contains only tests whose committed session JSONL is replay input and expected persisted output. Keep non-session ARIA, geometry, generator, CLI, and unit expected

238k51d agoDiscuss

MicrosoftAGENTS.md

vscode / copilotcli

microsoft/vscode/extensions/copilot/src/extension/chatSessions/copilotcli/AGENTS.md

copilotCLIPrompt.ts # Prompt reference extraction and parsing │ ├── customSessionTitleService.ts │ ├── delegationSummaryService.ts │ ├── utils.ts # SessionIdForCLI namespace (URI scheme: 'copilotcli') │ └── test/ │ ├── node/ # Node.js-specific (SDK integration, filesystem, permissions) │ ├── copilotCli.ts # ICopilotCLISDK, CopilotCLIModels, CopilotCLIAgents │ ├── copilotcliSession.ts # CopilotCLISession — main session

193k21d agoDiscuss

MicrosoftAGENTS.md

vscode / prompts

microsoft/vscode/src/vs/platform/agentHost/node/copilot/prompts/AGENTS.md

overridden sections) and the full config at `trace`. Keep new config shapes summarizable there. - **Tests.** `../../../test/node/agentHostPromptRegistry.test.ts` covers the registry/wiring; `../../../test/node/toolInstructions.test.ts` covers the composition/gating. Add cases there, not new harnesses

193k21d agoDiscuss

MicrosoftAGENTS.md

vscode / node

microsoft/vscode/src/vs/platform/agentHost/test/node/AGENTS.md

Agent host unit tests For tests in this area that touch the SessionDatabase, they MUST use an in-memory database, not a real database file on disk. Use `SessionDatabase.open(':memory

193k21d agoDiscuss

Significant-GravitasAGENTS.md

AutoGPT

Significant-Gravitas/AutoGPT/AGENTS.md

Styling**: Tailwind CSS only, use design tokens, Hugeicons only (through the `Icon` atom) 5. **Testing**: Integration tests (Vitest + RTL + MSW) are the default (~90%, page-level). Playwright for E2E critical

188k19d agoDiscuss

Hugging FaceAGENTS.md

transformers

huggingface/transformers/.ai/AGENTS.md

docstrings. - `make check-repo` — `make typing` plus consistency checks. - `RUN_SLOW=1 pytest ...` — many tests are marked slow and skipped in CI. Run `make style` (or `make fix-repo

167k23d agoDiscuss

langgeniusAGENTS.md

dify / api

langgenius/dify/api/AGENTS.md

repository root: - Format and lint: `make lint` - Type check: `make type-check` - Unit tests: `make test` - Targeted tests: `make test TARGET_TESTS=./api/tests/ ` Run direct Python commands through

157k4d agoDiscuss

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.