AGENTS.md examples from real projects

statelyaiAGENTS.md

xstate

statelyai/xstate/docs/agents.md

Author, inspect and test XState with the installed version's contracts.

No other project uses it yet

MicrosoftAGENTS.md

agent-skills / commands

microsoft/agent-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.md

hve-core / references

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

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

No other project uses it yet

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

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

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

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

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

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

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

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

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

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

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

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

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

No other project uses it yet

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

No other project uses it yet

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

No other project uses it yet

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