agentleFS

AGENTS.md examples from real projects

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

Worked for most · soon
openclawAGENTS.md

openclaw

openclaw/openclaw/AGENTS.md

Keep this file under 20,000 characters, the size OpenClaw loads whole. Put long rules in the owning guide and leave a one-line pointer here. Design trades correctness against complexity and performance. Choose deliberately; never maximize one axis at others' expense. Task defines scope and authorization; chosen workflow owns execution, review, publication, recovery, and cleanup. Explicit user instructions override skill guidelines and workflow defaults; host limits and required authorization boundaries still apply. Read nearest scoped AGENTS.md and matching guides below in…

394ktodayReviewMountCreate a free account to mount
openclawAGENTS.md

openclaw

openclaw/openclaw/docs/AGENTS.md

Own docs authoring, published links, docs i18n policy.

1 project uses a version of this

394ktodayReviewMountCreate a free account to mount
openclawAGENTS.md

openclaw / extensions

openclaw/openclaw/extensions/AGENTS.md

Bundled plugins. Same boundary as third-party plugins.

394ktodayReviewMountCreate a free account to mount
openclawAGENTS.md

openclaw / scripts

openclaw/openclaw/scripts/AGENTS.md

Own local tooling, script wrappers, generated-artifact helper rules.

394ktodayReviewMountCreate a free account to mount
openclawAGENTS.md

openclaw / test

openclaw/openclaw/test/AGENTS.md

No summary in the file. Open it to read it.

1 project uses a version of this

394ktodayReviewMountCreate a free account to mount
openclawAGENTS.md

openclaw / ui

openclaw/openclaw/ui/AGENTS.md

The Control UI and its plugin views use Solid 2 and native primitives; never add Lit or Web Awesome. Solid route modules expose renderSolid(props) from the existing lazy page import. The outlet mounts that renderer once and supplies live data, loaderPending, and presented props; loader updates must preserve page-local state. Keep page imports inside their route's component loader.

394ktodayReviewMountCreate 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.