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

codeql / unified

github/codeql/unified/AGENTS.md

This is a CodeQL extractor that maps a language's parse tree onto a shared AST using the yeast desugaring engine. Swift, the only language so far, is parsed by Apple's swift-syntax rather than by tree-sitter. - The raw parse tree's shape is described by extractor/swift_node_types.yml, which is generated from swift-syntax by swift-syntax-rs/schemagen. Do not edit it by hand; regenerate it with scripts/regenerate-node-types.sh after changing the pinned swift-syntax version, then review the diff alongside the mapping in extractor/src/languages/swift/swift.rs. - To run…

10k4y agoReviewMountCreate a free account to mount
MongoDBAGENTS.md

node-mongodb-native

mongodb/node-mongodb-native/AGENTS.md

This is the official MongoDB Node.js driver (mongodb npm package). It provides a TypeScript/JavaScript interface for applications to interact with MongoDB deployments. The driver implements the cross-driver MongoDB specifications. Do not hand-edit: lib/ (build output), mongodb.d.ts (generated), HISTORY.md (release-please managed), test/spec/ (vendored from specifications repo). Integration tests require a running MongoDB instance (unit tests do not). To start one locally: If VERSION is omitted, run-orchestration.sh defaults to latest-stable (the newest stable release). Set VERSION='latest' explicitly to test against nightly. VERSION='latest'…

No other project uses it yet

10k32d 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.