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

benchmark

google/benchmark/AGENTS.md

[!NOTE] The modern (as of 2026-06) AI is a misnomer, - it is not conscious / not a consciousness, - it is not sentient, - it is not intelligent, - it does not think, - it does not understand the code, - it is merely a next-token guesser, ... therefore it is merely an (hyper-) advanced IDE. [!NOTE] A contribution is any externally-observable interaction with a project. [!CAUTION] Failure to follow the following rules may result in repercussions, possibly without…

11k6mo agoReviewMountCreate a free account to mount
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'…

10k31d agoReviewMountCreate a free account to mount
NVIDIAAGENTS.md

auto-ontology

NVIDIA/auto-ontology/AGENTS.md

Skills that teach an agent how to set up the current Auto-Ontology implementation and use its ontology layer. They live in skills/ (repo root), one directory per skill, under the durable nvidia-ontology* namespace. This file is for developers bringing Auto-Ontology up and partners embedding it in an agent harness. Auto-Ontology maintainers (build, test, schema, frontend conventions) stay on CLAUDE.md. Do not fold those conventions into these skills. - skills/nvidia-ontology-setup/ — Helm (the official install), local Compose, developer --dev / --ds,…

9.9k46d agoReviewMountCreate a free account to mount
NVIDIAAGENTS.md

auto-ontology / frontend

NVIDIA/auto-ontology/frontend/AGENTS.md

This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in node_modules/next/dist/docs/ (resolved from this file's directory; in monorepos the next package may not be visible from the repo root) before writing any code. Heed deprecation notices. This block is written and re-added by next dev — verify at node_modules/next/dist/server/lib/generate-agent-files.js. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree…

9.9k46d agoReviewMountCreate a free account to mount
NVIDIAAGENTS.md

garak

NVIDIA/garak/AGENTS.md

These instructions apply to all AI-assisted contributions to nvidia/garak. Breaching these guidelines can result in automatic banning. This is tooling for adversarial assessment of LLMs and LLM-powered tools. It's open source software, used in production environments, with an active and skilled community As such, the code needs to be robust, precise, and responsible. Due to the nature of the project, there is a lot of potentially harmful or dangerous data associated with the repository. Always add the needs-triage label to…

Steady5 mentions in 2 weeks

No other project uses it yet

9.9k3mo agoReviewMountCreate a free account to mount
AWSAGENTS.md

mcp / dynamodb-mcp-server

awslabs/mcp/src/dynamodb-mcp-server/AGENTS.md

This is the AWS DynamoDB MCP Server - an official AWS Labs Model Context Protocol (MCP) server that provides DynamoDB expert design guidance and data modeling assistance. The project is built with Python 3.10+ and uses uv for dependency management. Current Version: See version in pyproject.toml Project URLs: - Homepage: https://awslabs.github.io/mcp/ - Documentation: https://awslabs.github.io/mcp/servers/dynamodb-mcp-server/ - Repository: https://github.com/awslabs/mcp.git - Changelog: https://github.com/awslabs/mcp/blob/main/src/dynamodb-mcp-server/CHANGELOG.md Package Information: - PyPI Package: awslabs.dynamodb-mcp-server - License: Apache-2.0 Note: This project includes pre-commit as a dev dependency but does…

No other project uses it yet

9.9k3mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

computer

cloudflare/computer/AGENTS.md

- README.md — what this repo is and how the pieces fit together. - CONTRIBUTING.md — public contribution paths. - COLLABORATORS.md — setup, checks, commit and pull request conventions. The canonical source for the day-to-day workflow. - docs/README.md — design specification. Forward- looking; treat as intent, not as a description of main. - docs/08_capnweb_interface.md — the RPC contract between the Durable Object and computerd. Required reading before touching packages/rpc or packages/computer. - Each package's own README.md — implementation status and…

Steady2 mentions in 2 weeks

No other project uses it yet

9.9k3mo agoReviewMountCreate a free account to mount
Model Context ProtocolAGENTS.md

modelcontextprotocol

modelcontextprotocol/modelcontextprotocol/AGENTS.md

This repository contains the MCP specification, documentation, and blog. If you are an AI agent (Claude, GitHub Copilot, Codex, or similar), do not create an issue, open a pull request,…

9.6k10d agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

vinext / app-route-file-collision

cloudflare/vinext/tests/fixtures/app-route-file-collision/agents.md

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

Steady6 mentions in 2 weeks

No other project uses it yet

9.3k12d agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

workerd

cloudflare/workerd/AGENTS.md

Subdirectory AGENTS.md files provide component-specific context (key classes, where-to-look tables, local conventions and anti-patterns). - Suggest updates to AGENTS.md when you find new high-level information - You should always determine if the current repository was checked out standalone or as a submodule of the larger workers project. - If checked out as a submodule, be aware that there is additional documentation and context in the root of that repository that is not present here. Look for the ../../README.md, ../../AGENTS.md, and…

9.1k8mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

workerd / build

cloudflare/workerd/build/AGENTS.md

Custom Bazel rules (wd_* macros) for C++, TypeScript, Rust, Cap'n Proto, and test orchestration. Uses bzlmod (MODULE.bazel), not WORKSPACE. This is build system definitions, NOT build output (bazel-bin/). Conventions: //tools/clang-tidy:workerd-lint builds a shared-object clang-tidy plugin that adds workerd-specific static checks: - jsg-visit-for-gc: flags JSG resource types whose visitable fields (jsg::Ref, jsg::JsRef, jsg::V8Ref, jsg::Function, jsg::Promise, jsg::Value, etc., plus kj::Maybe/Array/Vector/ OneOf and jsg::Optional wrappers thereof) are missing from visitForGc(). - workerd-angled-includes - requires includes of workers/capnproto code from different directories to use…

9.1k8mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

workerd / streams

cloudflare/workerd/src/bench/streams/AGENTS.md

Comparative benchmarks of the two streams implementations, the legacy C++ one (src/workerd/api/streams/) and the TypeScript one (src/per_isolate/webstreams/), organized like src/tests/streams/: one subdirectory per functional area. Every benchmark runs the same code under both implementations, so the two reports compare case by case. Correctness and parity are src/tests/streams/'s job; these suites only measure. - Each named export of main.js is an entrypoint with a bench() handler, which registers a group of cases with b.run(). The report names a group <service>:<export> (streams-readable-ts:readLoop).…

9.1k8mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

workerd / body

cloudflare/workerd/src/bench/streams/body/AGENTS.md

Where the runtime's bodies meet streams, under both implementations: the runtime reading JavaScript streams as bodies, JavaScript reading bodies the runtime produces, and the APIs built on bodies. Suite rules: src/bench/streams/AGENTS.md. The JavaScript stream shapes are 256 x 64 B, 64 x 4 KiB and 16 x 64 KiB (SHAPES in helpers.js). Bodies and writes copy their bytes, so each size's buffer is shared. The configs bind SELF to the worker itself. main.js's default export is service-binding.js's fetch handler, which…

9.1k8mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

workerd / compression

cloudflare/workerd/src/bench/streams/compression/AGENTS.md

CompressionStream and DecompressionStream, under both implementations. Suite rules: src/bench/streams/AGENTS.md. The payload (PAYLOAD in helpers.js) is 64 KiB of markup-like text, which compresses to about 9 KiB. - Both implementations drive the same native zlib codec, so the small chunks isolate the cost of the streams around it. - Under the compression-rs autogate (@all-autogates), the codec is zlib-rs, whose output depends on how its input is split. The expected compressed sizes therefore come from compressing the same chunks once in bench(),…

9.1k8mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

workerd / digest

cloudflare/workerd/src/bench/streams/digest/AGENTS.md

crypto.DigestStream, under both implementations. Suite rules: src/bench/streams/AGENTS.md. The byte shapes are 256 x 64 B, 64 x 4 KiB and 16 x 64 KiB (SHAPES in helpers.js). Each case checks the digest's size and the stream's bytesWritten. - Both implementations drive the same native digest context, so the small chunks isolate the cost of the stream around it.

9.1k8mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

workerd / encoding

cloudflare/workerd/src/bench/streams/encoding/AGENTS.md

TextEncoderStream and TextDecoderStream, under both implementations. Suite rules: src/bench/streams/AGENTS.md. The shapes are 256 x 16, 64 x 4 Ki and 16 x 64 Ki characters or bytes (SHAPES in helpers.js): a stream of short chunks, like generated tokens, and longer ones. TEXT names the text: ASCII, and two- and three-byte characters in UTF-8. - Both TextDecoderStreams decode with TextDecoder's native decoder, so the decoder differences are in the streams around it. - The TextEncoderStreams encode differently. The TypeScript one calls…

9.1k8mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

workerd / identity

cloudflare/workerd/src/bench/streams/identity/AGENTS.md

IdentityTransformStream and FixedLengthStream, under both implementations. Suite rules: src/bench/streams/AGENTS.md. The byte shapes are 256 x 64 B, 64 x 4 KiB and 16 x 64 KiB (SHAPES in helpers.js). Writes copy their bytes, so each size's chunk is one shared buffer. - The implementations split and merge writes into reads differently, so the cases count bytes, not reads. Over several queued writes, a BYOB read takes one write's bytes under C++ (stopping once a minimum is met), while the TypeScript…

9.1k8mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

workerd / piping

cloudflare/workerd/src/bench/streams/piping/AGENTS.md

pipeTo() and pipeThrough(), under both implementations. Suite rules: src/bench/streams/AGENTS.md. Pipes into identity streams are in identity/, and pipes of Response bodies are in body/.

9.1k8mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

workerd / readable

cloudflare/workerd/src/bench/streams/readable/AGENTS.md

ReadableStream with the default controller, under both implementations. Suite rules: src/bench/streams/AGENTS.md. - A tee branch's cancel() settles only once the source finishes or the other branch cancels too under the TypeScript implementation, as in the spec; C++ settles it at once. read one branch, cancel the other awaits the cancel together with the other branch's read, which both implementations complete. - Once a source has called close(), C++ cancels the stream without running the source's cancel(), even while chunks are…

9.1k8mo 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.