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

waterfox

BrowserWorks/waterfox/AGENTS.md

Do not remove existing comments unless they are directly related to what you are changing. If you see a good first bug that isn't directly related to your work, don't…

1 project uses a version of this

6.4k5mo agoReviewMountCreate a free account to mount
BrowserWorksAGENTS.md

waterfox / js

BrowserWorks/waterfox/js/AGENTS.md

This directory is SpiderMonkey, the JavaScript engine inside the Firefox/Gecko monorepo in the parent directly. Project-wide instructions live in ../AGENTS.md (referenced from ../CLAUDE.md). Notes below cover what is specific to…

1 project uses a version of this

6.4k5mo 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.