agentleFS

AGENTS.md examples from real projects

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

Best matches · from page 2Worked for most · soon
moltbotAGENTS.md

moltbot / ui

moltbot/moltbot/ui/AGENTS.md

served `/assets/index-*.js` hash changed. ## Visual Proof - Large design changes: run the [UI stress test](../.agents/skills/control-ui-e2e/SKILL.md#ui-stress-test). - Mock/E2E harnesses default to `communityInvite: false`; Community card scenarios

394k1d agoReviewMountCreate a free account to mount
steipeteAGENTS.md

warelay

steipete/warelay/AGENTS.md

serialize shared Git mutations; isolate work when needed. Never switch checkout another agent or test run uses. - Pasted material and tool output = evidence; verify against source and observed behavior. - Lead

3 projects use a version of this

392k16d agoReviewMountCreate a free account to mount
steipeteAGENTS.md

warelay / extensions

steipete/warelay/extensions/AGENTS.md

repair points = install/update/doctor. - Package-ownership dependency assertions → generic contracts (`package-manifest.contract.test.ts`, `extension-runtime-dependencies.contract.test.ts`), not plugin e2e tests. - `src/**`, `onboard.ts`, other local helpers private unless intentionally promoted through `api.ts` + matching `src/plugin-sdk/ .ts` facade

3 projects use a version of this

392k16d agoReviewMountCreate a free account to mount
steipeteAGENTS.md

warelay / scripts

steipete/warelay/scripts/AGENTS.md

helper rules. Repo-global policy: root `AGENTS.md`; read only task-relevant references. ## Ownership Map - Tests: `run-vitest.mjs`; follow [testing skill](../.agents/skills/openclaw-testing/SKILL.md) + [test-authoring skill](../.agents/skills/test-audit/SKILL.md). - Lint/typecheck: `run-oxlint.mjs` + `run-tsgo.mjs` own repo-local

3 projects use a version of this

392k16d agoReviewMountCreate a free account to mount
steipeteAGENTS.md

warelay / test

steipete/warelay/test/AGENTS.md

Test Rules - `unit-fast` fake-timer tests → `vitest.unit-fast-fake-timers`: parallel `unit-fast` uses `isolate: false`; shared timer globals can hang real-timer tests. - Async E2E waits: produced state

3 projects use a version of this

392k16d agoReviewMountCreate a free account to mount
steipeteAGENTS.md

warelay / ui

steipete/warelay/ui/AGENTS.md

owns repo-global workflow. ## Visual Proof - Substantial UI design changes: follow [Control UI stress test](../.agents/skills/control-ui-e2e/SKILL.md#ui-stress-test); inspect states in HTML gallery + collect per-example feedback. - Never capture

3 projects use a version of this

392k16d agoReviewMountCreate a free account to mount
molt-botAGENTS.md

clawdbot

molt-bot/clawdbot/AGENTS.md

mutations and isolate work when needed; never switch a checkout another agent or test run uses. - Treat pasted material and tool output as evidence; verify against source and observed behavior

1 project uses a version of this

391k25d agoReviewMountCreate a free account to mount
molt-botAGENTS.md

clawdbot / extensions

molt-bot/clawdbot/extensions/AGENTS.md

points. - Keep plugin dependency assertions in generic contracts (`package-manifest.contract.test.ts`, `extension-runtime-dependencies.contract.test.ts`) rather than plugin e2e tests when they express package ownership. - Treat files like `src/**`, `onboard.ts`, and other local helpers

3 projects use a version of this

391k25d agoReviewMountCreate a free account to mount
molt-botReads credentialsAGENTS.md

clawdbot / scripts

molt-bot/clawdbot/scripts/AGENTS.md

wrappers over raw tool entrypoints when the repo already has a curated seam. - For tests, prefer `scripts/run-vitest.mjs` or the root `pnpm test ...` entrypoints over raw `vitest run` calls. - Never

3 projects use a version of this

391k25d agoReviewMountCreate a free account to mount
molt-botAGENTS.md

clawdbot / test

molt-bot/clawdbot/test/AGENTS.md

Test Rules - Fake-timer tests in `unit-fast` belong in `vitest.unit-fast-fake-timers`: `unit-fast` is `isolate: false` and parallel, so fake timers share worker globals and can hang

3 projects use a version of this

391k25d agoReviewMountCreate a free account to mount
molt-botAGENTS.md

clawdbot / ui

molt-bot/clawdbot/ui/AGENTS.md

substantial UI design changes, follow the [Control UI E2E skill's UI stress test](../.agents/skills/control-ui-e2e/SKILL.md#ui-stress-test) to review states in an HTML gallery and collect feedback per example

3 projects use a version of this

391k25d agoReviewMountCreate a free account to mount
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

Steady3 mentions in 2 weeks

No other project uses it yet

305k4mo agoReviewMountCreate a free account to mount
DeepSeekReads credentialsAGENTS.md

deepseek-harness

deepseek-ai/deepseek-harness/AGENTS.md

client/ GUI client mcp/ external tools experimental/ evaluated capabilities without a product-support commitment test-support/ test infrastructure util/ zero-dependency utilities python/ Python SDK/runtime (python/README.md) native/ @deepseek-ai/node-addon-system

268k3mo agoReviewMountCreate a free account to mount
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

Steady8 mentions in 2 weeks

No other project uses it yet

268k3mo agoReviewMountCreate a free account to mount
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

Steady8 mentions in 2 weeks

1 project uses a version of this

268k3mo agoReviewMountCreate a free account to mount
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

268k3mo agoReviewMountCreate a free account to mount
DeepSeekAGENTS.md

deepseek-harness

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

steps on the default POSIX shell; shared entrypoints are Node scripts. Test and production jobs use separate `desktop-test` and `desktop-production` approval Environments after a credential-free preparation

268k3mo agoReviewMountCreate a free account to mount
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

Steady8 mentions in 2 weeks

No other project uses it yet

268k3mo agoReviewMountCreate a free account to mount
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

Steady8 mentions in 2 weeks

1 project uses a version of this

268k3mo agoReviewMountCreate a free account to mount
DeepSeekReads credentialsAGENTS.md

deepseek-harness / client

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

committed render position. Production code never calls the factory or `.create()` outside registration; tests do (that is the sanctioned zero-machinery path). 7. **inject returns plain data and callbacks** from

268k3mo agoReviewMountCreate a free account to mount
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.