agentleFS
Sign inStart free

AGENTS.md examples from real projects

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

Popular:code reviewtestingpdfMCP serverfrontendsecuritydocumentation
Worked for most · soon
molt-bot remove filter10k+ stars remove filter
molt-botAGENTS.md

clawdbot

molt-bot/clawdbot/AGENTS.md

The task defines scope and authorization; its chosen workflow owns execution, review, publication, recovery, and cleanup. Explicit user instructions take precedence over skill guidelines and workflow defaults; host limits and required authorization boundaries still apply. Read the nearest scoped AGENTS.md and the matching references below, including when changing callers outside an owner's directory. Update instructions at their owner instead of adding competing rules here.

1 project uses a version of this

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

clawdbot

molt-bot/clawdbot/docs/AGENTS.md

This directory owns docs authoring, published link rules, and docs i18n policy.

3 projects use a version of this

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

clawdbot / extensions

molt-bot/clawdbot/extensions/AGENTS.md

This directory contains bundled plugins. Treat it as the same boundary that third-party plugins see. - Extension production code should import from openclaw/plugin-sdk/* and its own local barrels such as ./api.ts and ./runtime-api.ts. - Do not import core internals from src/, src/channels/, src/plugin-sdk-internal/, or another extension's src/. - Do not use relative imports that escape the current extension package root. - Keep plugin metadata accurate in openclaw.plugin.json and the package openclaw block so discovery and setup work without executing plugin…

3 projects use a version of this

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

clawdbot / scripts

molt-bot/clawdbot/scripts/AGENTS.md

This directory owns local tooling, script wrappers, and generated-artifact helper rules.

3 projects use a version of this

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

clawdbot / test

molt-bot/clawdbot/test/AGENTS.md

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

3 projects use a version of this

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

clawdbot / ui

molt-bot/clawdbot/ui/AGENTS.md

This directory owns Control UI-specific guidance that should not live in the repo root. - The Gateway owns shared state that other clients or channels can change. Renderer copies are caches; local presentation state belongs to the view. Reuse the owning store or controller and Gateway contract instead of implementing session, configuration, or authorization decisions again in the UI. - Scope cached data and in-flight requests to the actual connection, agent, and session they concern. Before publishing a result, check…

3 projects use a version of this

391k24d 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.