How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.
MicrosoftAGENTS.mdmicrosoft/skills/.github/plugins/deep-wiki/commands/agents.md
Generate AGENTS.md files for pertinent repository folders — only where missing. Provides coding agents with build commands, testing instructions, code style, project structure, and boundaries.
MicrosoftAGENTS.mdmicrosoft/hve-core/.github/skills/hve-core/vally-tests/references/agents.md
Nine conformance checks the vally-tests skill emits for .agent.md artifacts (including consolidated subagent structural template), with contract citations, stimulus shapes, and Vally grader recommendations
eyssetteAGENTS.mdeyssette/js-template/AGENTS.md
General Rules to Follow : coding, tests, build, lint, i18n, docs, release notes, and commit conventions.
launchapp-devAGENTS.mdlaunchapp-dev/animus-cli/.agents/skills/rust-skills/AGENTS.md
Comprehensive Rust coding guidelines with 179 rules across 14 categories. Use when writing, reviewing, or refactoring Rust code. Covers ownership, error handling, async patterns, API design, memory optimization, performance, testing, and common anti-patterns. Invoke with /rust-skills.
chasebuildAGENTS.mdchasebuild/fuelcheck-cli/.agents/skills/rust-skills/AGENTS.md
Comprehensive Rust coding guidelines with 179 rules across 14 categories. Use when writing, reviewing, or refactoring Rust code. Covers ownership, error handling, async patterns, API design, memory optimization, performance, testing, and common anti-patterns. Invoke with /rust-skills.
obraAGENTS.mdobra/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
NousResearchAGENTS.mdNousResearch/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
NousResearchAGENTS.mdNousResearch/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
NousResearchAGENTS.mdNousResearch/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
affaan-mAGENTS.mdaffaan-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
DeepSeekAGENTS.mddeepseek-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
DeepSeekAGENTS.mddeepseek-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
DeepSeekAGENTS.mddeepseek-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
DeepSeekAGENTS.mddeepseek-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
DeepSeekAGENTS.mddeepseek-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
DeepSeekAGENTS.mddeepseek-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
DeepSeekAGENTS.mddeepseek-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
DeepSeekAGENTS.mddeepseek-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
DeepSeekAGENTS.mddeepseek-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
MicrosoftAGENTS.mdmicrosoft/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
An open format for instructions to coding agents, read by Codex, Cursor and others. Think of it as a README written for agents.
At the repository root, with more specific files in subdirectories. Agents read the one closest to the file they're editing.
Setup and test commands, code style, and the rules a new contributor would need to know.
Claude Code reads CLAUDE.md. A one-line CLAUDE.md that points at AGENTS.md covers both.
