AGENTS.md examples from real projects

CloudflareAGENTS.md

workerd / writable

cloudflare/workerd/src/tests/streams/writable/AGENTS.md

An informal specification of the JS-backed writable stream classes as implemented in workerd, derived from — and kept in lockstep with — the test suite in this directory. The tests are the normative artifact. Both the C++ implementation (src/workerd/api/streams/writable.{h,c++} over standard.c++'s WritableImpl/WritableStreamJsController) and the TypeScript implementation (src/per_isolate/webstreams/writable.ts, behind typescript_implemented_streams) are covered. The suite COMPLEMENTS WPT (//src/wpt:streams runs writable-streams/ against both implementations): behaviors WPT already asserts identically on both sides are not duplicated here. The WPT C++ expectedFailures for writable-streams/ in…

CloudflareAGENTS.md

workerd / api

cloudflare/workerd/src/workerd/api/AGENTS.md

All JavaScript APIs exposed to Workers: HTTP, crypto, streams, WebSocket, Cache, KV, R2, SQL, encoding, events, timers, scheduled/alarm handlers.

CloudflareAGENTS.md

workerd / crypto

cloudflare/workerd/src/workerd/api/crypto/AGENTS.md

WebCrypto API + Node.js crypto C++ implementations over BoringSSL. crypto.h defines public JSG types (CryptoKey, SubtleCrypto, CryptoKeyUsageSet). impl.h defines internal CryptoKey::Impl base class with per-algorithm static ImportFunc/GenerateFunc dispatch. Algorithm files implement Impl subclasses. OSSLCALL() macro wraps all BoringSSL calls with error translation.

CloudflareAGENTS.md

workerd / node

cloudflare/workerd/src/workerd/api/node/AGENTS.md

C++ implementations of Node.js built-in modules. Each module = JSG-bound class registered via NODEJS_MODULES(V) macro in node.h. TypeScript counterpart lives in src/node/. Exception: diagnostics-channel only forwards messages to tail workers (publishToTracer); the module itself is in src/node/diagnostics_channel.ts. Some node-internal: modules (dns, inspector, url) are implemented in Rust instead, in src/rust/api/, and registered by register_nodejs_modules() in src/rust/api/lib.rs, not in NODEJS_MODULES. See src/rust/AGENTS.md. Tests in tests/. Naming: <module>-test.js + <module>-test.wd-test; -nodejs- infix when needing compat flags. All tests set compatibilityFlags = ["nodejs_compat",…

CloudflareAGENTS.md

workerd / streams

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

Web Streams API: ReadableStream, WritableStream, TransformStream. See README.md for terse reference (classification, state machines, safety patterns). See docs/streams.md for narrative tutorial. NOTE: C++ code outside this directory does not use jsg::Ref<ReadableStream> or jsg::Ref<WritableStream> directly; it goes through the JsReadableStream / JsWritableStream abstractions in src/workerd/api/js-{readable,writable}-stream.{h,c++}, which hide which stream implementation backs a given stream (and provide JsReadableWritablePair + pipeTo/pipeThrough for abstraction-level pipelines). New C++ consumers of streams should use those abstractions, not the types defined here. Allocating the types defined here…

CloudflareAGENTS.md

workerd / io

cloudflare/workerd/src/workerd/io/AGENTS.md

I/O lifecycle, per-request context, worker/isolate management, actor storage, consistency gates, and compatibility flags.

CloudflareAGENTS.md

workerd / jsg

cloudflare/workerd/src/workerd/jsg/AGENTS.md

See README.md for terse reference (type mappings, macro catalog, error catalog). See docs/jsg.md for narrative tutorial. Macro-driven C++/V8 binding layer: declares C++ types as JS-visible resources/structs with automatic type conversion.

CloudflareAGENTS.md

workerd / server

cloudflare/workerd/src/workerd/server/AGENTS.md

The workerd binary and its server. :workerd (workerd.rs, this package) is a Rust binary over three crates in this directory: This package keeps the config schema (workerd.capnp, compiled-bindings.capnp), the config compiler, the WorkerdApi and the C++ libraries the factory is built from (alarm scheduler, channel tokens, container client, facet tree index, fallback service, actor IDs, JSON logger, V8 platform), and their C++ unit tests. The Rust/C++ boundary. The factory keeps everything that touches the isolate: compiling a worker (WorkerdApi, compatibility…

CloudflareAGENTS.md

workerd / util

cloudflare/workerd/src/workerd/util/AGENTS.md

Shared utility library: data structures, SQLite wrapper, feature gating, logging, thread-local scopes. No workerd-specific API dependencies — consumed across api/, io/, server/.

CloudflareAGENTS.md

workerd / fetch

cloudflare/workerd/src/wpt/fetch/AGENTS.md

WPT fetch/api runs in two cells, one per streams implementation: Both cells pin the same compatibility flags otherwise (strip_bom_in_read_all_text). Most entries in either config are fetch API divergences that apply to both implementations (missing CORS, cache modes, redirect handling, header validation, unimplemented methods, ...). They are duplicated in both configs and kept identical. Subtests whose result depends on the streams implementation. A row here means the two configs differ for that subtest: it is an expectedFailures or disabledTests entry in…

CloudflareAGENTS.md

workerd / types

cloudflare/workerd/types/AGENTS.md

Generates @cloudflare/workers-types .d.ts files from C++ and Rust JSG RTTI (via jsg/rtti.capnp) + hand-written defines/*.d.ts. Rust descriptions come from TypeInfo and typed module registration in src/rust/jsg/; internal module registration does not make a type an ambient root. A workerd-hosted Worker extracts RTTI at runtime per compat-date; TypeScript transforms post-process into ambient and importable outputs. CI validates generated-snapshot/ matches. - Structure.tsName / StructureType.tsName supply the emitted declaration and reference name. When empty, the generator derives the name from fullyQualifiedName, which remains…

AppleAGENTS.md

containerization

apple/containerization/AGENTS.md

The project is built via make, not directly with swift build. Two Swift packages live in this repo: the root package (Containerization libraries + cctl + macOS-only integration binary) and vminitd/ (the Linux guest init system, compiled as a static musl binary inside the Linux dev container via the apple/container CLI — see make vminitd).

No other project uses it yet

PydanticAGENTS.md

monty / limitations

pydantic/monty/docs/limitations/AGENTS.md

This file is for contributors and agents editing this directory. It is excluded from the docs build (exclude_docs in mkdocs.yml, exclude in the unified-docs sync), so nothing here is published. Every pull request that changes a CPython divergence MUST update its topic page here. Docstrings and inline comments do not count: the divergence has to be written down here. Host-API contracts belong in the relevant docs/ topic and binding reference; implementation rationale belongs in crate READMEs or code comments, not…

No other project uses it yet

SentryAGENTS.md

sentry-javascript / browser

getsentry/sentry-javascript/packages/browser/AGENTS.md

Bundle size is critical. Be mindful of imports and tree-shaking. Use /add-cdn-bundle skill to create new CDN bundles.

MicrosoftAGENTS.md

microsoft-ui-xaml / xcp

microsoft/microsoft-ui-xaml/dxaml/xcp/AGENTS.md

Most code in this repo uses the IFC_RETURN macro to record some information about an HRESULT and return if it's a failure.

MicrosoftAGENTS.md

microsoft-ui-xaml / TableViewSampleApp

microsoft/microsoft-ui-xaml/Samples/TableViewSampleApp/AGENTS.md

The end-user quick start is in README.md. This file records how the sample is wired and why, for anyone maintaining it. The sample used to hand-wire around the product, because TableView's type information was withheld from the public winmd and its theme resources did not resolve in a consuming app. It linked raw build output, regenerated its own CsWinRT projection, injected a XAML metadata provider, seeded an internal template part into XamlTypeInfo, compiled the control's theme resources out of the…

MongoDBAGENTS.md

mongo-go-driver

mongodb/mongo-go-driver/AGENTS.md

Official MongoDB Go Driver (go.mongodb.org/mongo-driver/v2). Correctness, backward compatibility, and conformance to MongoDB Driver Specifications are top priorities. Uses Task, not make. Tests require a running mongod on localhost:27017 (or MONGODB_URI). The full test suite is serial (-p 1) — integration tests share server state. Do not parallelize. Evergreen's project configuration lives in .evergreen/config.yml, where every task, variant, and expansion is declared; supporting CI scripts live alongside it. Validate any change with evergreen validate -p mongo-go-driver -f .evergreen/config.yml (authenticate with evergreen…

No other project uses it yet

VercelAGENTS.md

deepsec

vercel-labs/deepsec/.deepsec/AGENTS.md

This is a deepsec scanning workspace. Each registered project has its own setup prompt at data/<id>/SETUP.md — open the relevant one when asked to set a project up. - Set up a project for scanning: read data/<id>/SETUP.md and follow it (read node_modules/deepsec/SKILL.md, then fill data/<id>/INFO.md from the target codebase). - Add a new project: run deepsec init-project <root> — it scaffolds data/<id>/ and prints/writes the setup prompt for the new project. - Write a custom matcher (only after a real…

MicrosoftAGENTS.md

Mastering-GitHub-Copilot-for-Paired-Programming

microsoft/Mastering-GitHub-Copilot-for-Paired-Programming/AGENTS.md

This is Mastering GitHub Copilot for Paired Programming, an open-source educational repository maintained by Microsoft. It is a multi-module, 10-hour course that teaches developers how to use GitHub Copilot as an AI coding partner — from beginner to advanced topics including Agent Mode. The repository is documentation-centric: most content is Markdown-based lesson guides. A small number of code samples exist within specific lessons. Each lesson module follows a consistent structure: Most exercises reference external Codespaces template repos (e.g., github/dotnet-codespaces) rather…

JetBrainsAGENTS.md

thinkrail

JetBrains/thinkrail/AGENTS.md

The agentic IDE that gets better every time you use it, built around the pi coding agent. The app is a thin host that runs pi and bridges it to a rich UI; pi owns models, skills, compaction, cost, and session state. - Use goal-and-requirements.md for the product's goal, principles, capabilities, and non-goals. - Use architecture.md for system topology, cross-module decisions, and repo-wide invariants. - For a pi upgrade or a host workaround around pi, read pi-compatibility.md: verify every applicable…

No other project uses it yet