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
morlutoAGENTS.md

rea

morluto/rea/AGENTS.md

owning boundary using format-aware parsers. Remove superseded representations, aliases, wrappers, and redundant tests after verifying affected consumers. Introduce abstractions only when they remove observed complexity. When fixing

Steady26 mentions in 2 weeks

No other project uses it yet

442k16d agoReviewMountCreate a free account to mount
moltbotAGENTS.md

clawdbot

moltbot/clawdbot/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. - Create

6 projects use a version of this

394k4d agoReviewMountCreate a free account to mount
moltbotAGENTS.md

clawdbot / extensions

moltbot/clawdbot/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`. Core/core tests needing bundled

6 projects use a version of this

394k4d agoReviewMountCreate a free account to mount
moltbotAGENTS.md

clawdbot / scripts

moltbot/clawdbot/scripts/AGENTS.md

Scripts Guide Own local tooling, script wrappers, generated-artifact helper rules. ## 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 runtime

4 projects use a version of this

394k4d agoReviewMountCreate a free account to mount
moltbotAGENTS.md

clawdbot / test

moltbot/clawdbot/test/AGENTS.md

Test Rules - Fake timers: call `vi.useFakeTimers()` directly in the test file; the unit-fast classifier routes on that call into `vitest.unit-fast-fake-timers`. Parallel `unit-fast` uses `isolate: false

6 projects use a version of this

394k4d agoReviewMountCreate a free account to mount
moltbotAGENTS.md

clawdbot / ui

moltbot/clawdbot/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

4 projects use a version of this

394k4d agoReviewMountCreate a free account to mount
clawdbotAGENTS.md

clawdbot / scripts

clawdbot/clawdbot/scripts/AGENTS.md

Scripts Guide Own local tooling, script wrappers, generated-artifact helper rules. ## 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 runtime

1 project uses a version of this

394k12d agoReviewMountCreate a free account to mount
clawdbotAGENTS.md

clawdbot / ui

clawdbot/clawdbot/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

1 project uses a version of this

394k12d 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

No other project uses it yet

391k36d 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

2 projects use a version of this

391k36d 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

391k36d 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

391k36d 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

391k36d 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

Steady9 mentions in 2 weeks

No other project uses it yet

314k5mo 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

Steady3 mentions in 2 weeks

No other project uses it yet

276k3mo 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

Steady3 mentions in 2 weeks

No other project uses it yet

276k3mo 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

Steady3 mentions in 2 weeks

1 project uses a version of this

276k3mo 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

Steady3 mentions in 2 weeks

No other project uses it yet

276k3mo 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

Steady3 mentions in 2 weeks

No other project uses it yet

276k3mo 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

Steady3 mentions in 2 weeks

No other project uses it yet

276k3mo 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.