agentleFS

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
sgl-projectAGENTS.md

sglang

sgl-project/sglang/docs/AGENTS.md

Build and maintain the SGLang documentation site and integrated cookbook using Mintlify. Use when

39k6d agoReviewMountCreate a free account to mount
morlutoAGENTS.md

rea

morluto/rea/AGENTS.md

unmeasured costs. Fewer bytes alone do not establish fewer tokens or faster analysis. ## Development Documentation ownership and authoring conventions live in [docs/development/documentation.md](docs/development/documentation.md). A feature uses `docs/specs/ / /spec.md`, one `plan.md

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

only at egress (logs.tail, diagnostics/support bundles, remote/OTel export); never log message/tool content. - Plugins use documented `openclaw/plugin-sdk/*` contracts, manifest metadata, public/local barrels; never core internals or another plugin's private files

6 projects use a version of this

394k4d agoReviewMountCreate a free account to mount
moltbotAGENTS.md

clawdbot / ui

moltbot/clawdbot/ui/AGENTS.md

pointer cursors; state-changing controls: default arrow. - Colors: use `src/styles/base.css` tokens. - `main.runtime.ts` injects `components/kbd.css` document-wide; renderers never import it. Never JS-import a sheet `styles.css` already ships from

4 projects use a version of this

394k4d agoReviewMountCreate a free account to mount
clawdbotAGENTS.md

clawdbot / ui

clawdbot/clawdbot/ui/AGENTS.md

pointer cursors; state-changing controls: default arrow. - Colors: use `src/styles/base.css` tokens. - `main.runtime.ts` injects `components/kbd.css` document-wide; renderers never import it. Never JS-import a sheet `styles.css` already ships from

1 project uses a version of this

394k12d agoReviewMountCreate a free account to mount
molt-botAGENTS.md

clawdbot

molt-bot/clawdbot/AGENTS.md

beta, and nightly code are not shipped contracts. ## Runtime and code safeguards - Plugins use documented `openclaw/plugin-sdk/*` contracts, manifest metadata, and public/local barrels, never core internals or another plugin's private

No other project uses it yet

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

clawdbot

molt-bot/clawdbot/docs/AGENTS.md

root `AGENTS.md`. - CI verifies JSON5 and JSON config fences that look like whole `openclaw.json` documents against the schema. `pnpm docs:check-config-examples` runs that verification. Deliberately partial or legacy

2 projects use a version of this

391k36d agoReviewMountCreate a free account to mount
obraAGENTS.md

superpowers

obra/superpowers/AGENTS.md

what produced a change in order to weigh it: agent-generated content reasoned from documentation is held to a different bar than work grounded in a real session. Contributions that

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

plugin Cordis agent harness. Read [docs/architecture.md](docs/architecture.md) before changing `packages/`; follow [docs/AGENTS.md](docs/AGENTS.md) for documentation. ## Pre-stable APIs and released Session data Public APIs are pre-stable; update every consumer

Steady3 mentions in 2 weeks

No other project uses it yet

276k3mo agoReviewMountCreate a free account to mount
DeepSeekAGENTS.md

deepseek-harness / notes

deepseek-ai/deepseek-harness/.agents/notes/AGENTS.md

proposals and decision records that preserve rationale, alternatives, consequences, and required verification. Follow the [documentation standard](../../docs/AGENTS.md) and the [Agent Note rules](README.md). **Every new Agent Note triggers a supersession

Steady3 mentions in 2 weeks

9 projects use a version of this

276k3mo agoReviewMountCreate a free account to mount
DeepSeekAGENTS.md

deepseek-harness / archived

deepseek-ai/deepseek-harness/.agents/notes/archived/AGENTS.md

repair, delete, or move a sealed artifact; use an active Agent Note or current documentation for new decisions and facts. The archival change may only relocate a complete English/Chinese/sidecar triplet

Steady3 mentions in 2 weeks

2 projects use a version of this

276k3mo agoReviewMountCreate a free account to mount
DeepSeekAGENTS.md

deepseek-harness / implemented

deepseek-ai/deepseek-harness/.agents/notes/implemented/AGENTS.md

Implemented Agent Notes These Agent Notes describe shipped decisions. Follow the [root instructions](../../../AGENTS.md), [documentation standard](../../../docs/AGENTS.md), and [Agent Note format](../README.md#the-file-format); `verify-agent-note-format` gates

Steady3 mentions in 2 weeks

9 projects use a version of this

276k3mo agoReviewMountCreate a free account to mount
DeepSeekAGENTS.md

deepseek-harness

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

AGENTS.md — The documentation standard This file defines document structure, Markdown tiers, writing rules, and `verify-doc-budgets` ceilings. Use [dsh-doc](../.agents/skills/dsh-doc/SKILL.md) for placement and validation, and [dsh-prose-standard

Steady3 mentions in 2 weeks

No other project uses it yet

276k3mo agoReviewMountCreate a free account to mount
DeepSeekAGENTS.md

deepseek-harness / packages

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

subsystem ownership through a canonical English page link or justified [exemption](../scripts/verify-subsystem-pages.ts). - Package READMEs document model, token, and KV-cache effects using the [canonical Model Experience format](../docs/cookbook/adding-a-package.md#4-write

Steady3 mentions in 2 weeks

1 project uses a version of this

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

deepseek-harness / client

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

Definition republishes the block when an observed answer changes. Transient file-read and document-preview content may also carry `Uint8Array`: published buffers are borrowed read-only, copied before Worker transfer

Steady3 mentions in 2 weeks

No other project uses it yet

276k3mo agoReviewMountCreate a free account to mount
DeepSeekAGENTS.md

deepseek-harness / experimental

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

through `devDependencies`; examples may load them explicitly. - Experimental status does not relax engineering, security, documentation, lifecycle, testing, or snapshot requirements. - Publishing an experimental package does not promote

Steady3 mentions in 2 weeks

No other project uses it yet

276k3mo agoReviewMountCreate a free account to mount
DeepSeekAGENTS.md

deepseek-harness / website

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

AGENTS.md — Documentation website adapter Follow the [root instructions](../AGENTS.md), the [documentation standard](../docs/AGENTS.md), and the [documentation workflow](../.agents/skills/dsh-doc/SKILL.md). ## Keep documentation content out of this tree `website/` owns only VitePress configuration

Steady3 mentions in 2 weeks

No other project uses it yet

276k3mo agoReviewMountCreate a free account to mount
NousResearchAGENTS.md

hermes-agent / plugins

NousResearch/hermes-agent/plugins/AGENTS.md

VERSION`, a manifest-wide native `api:` match, or version literals on unrelated payloads. Documented surfaces stay additive: - Hook payload data is added as **keyword fields**; callbacks are signature-inspected

262k41d agoReviewMountCreate a free account to mount
affaan-mAGENTS.md

ECC

affaan-m/ECC/AGENTS.md

Playwright testing | Critical user flows | | refactor-cleaner | Dead code cleanup | Code maintenance | | doc-updater | Documentation and codemaps | Updating docs | | cpp-reviewer | C/C++ code review | C and C++ projects | | cpp-build

Steady17 mentions in 2 weeks

No other project uses it yet

246k2mo agoReviewMountCreate a free account to mount
n8n-ioReads credentialsAGENTS.md

n8n

n8n-io/n8n/AGENTS.md

voice, and one instruction for each sentence - **JSDoc on `@Env(...)` config properties is public documentation.** The docs team exports these comments into the environment variable reference on docs.n8n.io. Write them

No other project uses it yet

210k10d 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.