AGENTS.md examples from real projects

MongoDBAGENTS.md

mongo-java-driver / driver-reactive-streams

mongodb/mongo-java-driver/driver-reactive-streams/AGENTS.md

Reactive Streams driver implementing the Reactive Streams specification. Depends on: bson, driver-core

No other project uses it yet

MongoDBAGENTS.md

mongo-java-driver / driver-scala

mongodb/mongo-java-driver/driver-scala/AGENTS.md

Scala async driver providing Observable-based API wrapping driver-reactive-streams. Depends on: bson-scala, driver-reactive-streams Supported Scala versions: 2.11, 2.12, 2.13, 3 (default: 2.13, configured in root gradle.properties). See README.md for directory layout details. - Mirror new public Java types in Scala. Adding a public type or enum under a wrapped package (com.mongodb, com.mongodb.client.model and its subpackages, com.mongodb.connection, com.mongodb.client.result, …) requires a matching wrapper in the corresponding org.mongodb.scala.* package — this is enforced by ApiAliasAndCompanionSpec (the build fails if a mirror is missing):…

No other project uses it yet

MongoDBAGENTS.md

mongo-java-driver / driver-sync

mongodb/mongo-java-driver/driver-sync/AGENTS.md

Synchronous (blocking) Java driver — the most commonly used entry point for Java applications. Depends on: bson, driver-core - Work here if: modifying the blocking Java API surface (MongoClient, MongoDatabase, MongoCollection), GridFS, or CSFLE vault client - Do not: add new Spock tests (legacy only), add internal connection/protocol code (that belongs in driver-core) Primary entry point: MongoClients.create() or MongoClients.create(MongoClientSettings).

No other project uses it yet

MongoDBAGENTS.md

mongo-java-driver / gradle

mongodb/mongo-java-driver/gradle/AGENTS.md

Gradle configuration and infrastructure for the build system. - libs.versions.toml — Central version catalog defining all dependency versions, library coordinates, bundles, and plugin versions - wrapper/ — Gradle wrapper JAR and properties (do not modify manually — use ./gradlew wrapper --gradle-version=<version>) - scala/lib/ — Bundled Scala Ant JAR for Scala compilation support - All dependency versions are managed in libs.versions.toml — never declare versions inline in build.gradle.kts files - Never add dependencies without justification - The version catalog defines [versions],…

No other project uses it yet

MongoDBAGENTS.md

mongo-java-driver / mongodb-crypt

mongodb/mongo-java-driver/mongodb-crypt/AGENTS.md

Client-side field-level encryption (CSFLE) support via JNA bindings to libmongocrypt. Depends on: bson - Work here if: modifying CSFLE encryption/decryption logic or JNA bindings - Do not: move, re-expose, or refactor JNA/libmongocrypt bindings without human approval — this is security-critical code - Do not: modify the C API binding layer without understanding the libmongocrypt contract - com.mongodb.crypt.capi — mongocryptd C API bindings (JNA) — security-critical, do not modify without human review - com.mongodb.internal.crypt.capi — Internal encryption state management Tests are…

No other project uses it yet

MongoDBAGENTS.md

mongo-java-driver / testing

mongodb/mongo-java-driver/testing/AGENTS.md

Shared test resources and MongoDB specification test data. - resources/specifications/ — Git submodule containing MongoDB specification test data (CRUD, SDAM, auth, CSFLE, retryable ops, etc.) - resources/logback-test.xml — Shared logback configuration for tests - Do not modify spec test data — managed upstream. Update via git submodule update.

No other project uses it yet

GoogleAGENTS.md

zerocopy / anneal

google/zerocopy/anneal/AGENTS.md

Licensed under a BSD-style license <LICENSE-BSD>, Apache License, Version 2.0 <LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0>, or the MIT license <LICENSE-MIT or https://opensource.org/licenses/MIT>, at your option. This file may not be copied, modified, or distributed except according to those terms. --> Before working on the current Anneal redesign, read and preserve the project principles in PRINCIPLES.md and the shared design contract in DESIGN.md. The principles are authoritative if the two conflict. Determine current implementation behavior from the checked-in source. The v1/ subtree is…

GoogleAGENTS.md

zerocopy / zerocopy

google/zerocopy/zerocopy/AGENTS.md

Licensed under a BSD-style license <LICENSE-BSD>, Apache License, Version 2.0 <LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0>, or the MIT license <LICENSE-MIT or https://opensource.org/licenses/MIT>, at your option. This file may not be copied, modified, or distributed except according to those terms. --> These instructions apply to work in the zerocopy/ subtree. - Cargo: For zerocopy crate build, test, and lint commands, never run cargo directly. Use ./cargo.sh. Repository tools outside this crate may have their own invocation commands. See the toolchain reference for toolchain…

SupabaseAGENTS.md

supabase-py

supabase/supabase-py/AGENTS.md

Setup and commands: README.md § Local Development; make help and make <pkg>.help list every target. PR process: CONTRIBUTING.md. <pkg> is the directory under src/. Four import names differ from it: auth → supabase_auth, storage → storage3, functions → supabase_functions, utils → supabase_utils. Adding or renaming a public symbol means updating sdk-compliance.yaml with both the Async* and Sync* names. A method defined once on a generic base, like PostgrestClient.rpc or SupabaseClient.rpc, is listed under the base name, because the check does…

StripeAGENTS.md

stripe-ios

stripe/stripe-ios/AGENTS.md

This file provides guidance to LLM-based coding agents when working with code in this repository. The test runner (ci_scripts/run_tests.rb) handles simulator setup automatically. ci_scripts/setup_simulator.sh selects the runtime for the active Xcode version: iOS 16.4 through Xcode 26 and iOS 18.5 with Xcode 27 and later. Invoke ci_scripts/run_tests.rb directly as shown below. Do not prefix it with ruby or bundle exec; the runner has no bundled dependencies, and direct invocation lets agent environments grant it the simulator access it needs. If…

OpenAIAGENTS.md

openai-openapi

openai/openai-openapi/AGENTS.md

Read and follow CONTRIBUTING.md and SECURITY.md, including contribution eligibility, review, validation, and sensitive-data requirements. PRs are limited to OpenAI team members; external contributors use feedback.

NVIDIAAGENTS.md

cccl

NVIDIA/cccl/AGENTS.md

This document provides guidelines for building, testing, and contributing to the CCCL repository. It is primarily written for agentic AIs, but the information is also useful for CCCL developers. For…

NVIDIAAGENTS.md

cccl / compute

NVIDIA/cccl/python/cuda_cccl/benchmarks/compute/AGENTS.md

This directory contains the code for the Python cuda.compute benchmarks. They are migrated from the original C++ benchmarks and they should match the C++ implementations as closely as possible. The…

NVIDIAAGENTS.md

cccl / cuda_coop

NVIDIA/cccl/python/cuda_coop/AGENTS.md

Apply this guidance to package code, tests, documentation, API docstrings, and runnable examples. As a guiding principle, the design tenets behind cuda.coop are performant, consistent, delightful: - Performant: target negligible…

VercelAGENTS.md

vgpu

vercel-labs/vgpu/AGENTS.md

This file is the workflow index. Before planning, editing files, or acting on an issue/PR, read workflow context, then select the matching path below. If the directing person's role is unknown, follow its mandatory GitHub permission lookup and routing rules. Read required guides in full before the relevant stage. Read additional guides only when their conditions apply; the linked steps are mandatory, not optional reference material. Normal development targets canary. The linked production/release workflows define the exceptions. Repository specialists (researchers,…

No other project uses it yet

Microsoft AzureAGENTS.md

azure-sdk-for-java

Azure/azure-sdk-for-java/AGENTS.md

This file provides guidance for AI agents (e.g., GitHub Copilot, Model Context Protocol servers, or other LLM-based assistants) interacting with the Azure SDK for Java repository. The Azure SDK for Java provides developers with libraries for accessing Azure services. The SDK is organized into client libraries, with each library corresponding to an Azure service. The repository follows a specific structure: AI agents interacting with this repository can assist with: Agents should NOT: Most client libraries are generated from TypeSpec specifications…

VercelAGENTS.md

workflow / nextjs-turbopack

vercel/workflow/workbench/nextjs-turbopack/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…

GoogleAGENTS.md

XNNPACK

google/XNNPACK/AGENTS.md

Guidelines for automated agents and developers contributing to XNNPACK. XNNPACK is a highly optimized library of neural network inference operators for ARM, x86, RISC-V, and WebAssembly architectures. The codebase is…

No other project uses it yet

VercelAGENTS.md

chat

vercel/chat/AGENTS.md

Guidance for coding agents working in this repository. For PR workflow, signed commits, and changeset rules, see .github/CONTRIBUTING.md. Install dependencies with pnpm add, not by editing package.json by hand. pnpm + Turborepo monorepo. Packages are ESM ("type": "module"), TypeScript, bundled with tsup. When editing a specific package, read its AGENTS.md if present (most adapters, state packages, create-chat-sdk, and packages/catalog have one). {adapter}:{channel}:{thread} — e.g. slack:C123ABC:1234567890.123456. Some adapters base64-encode IDs that contain delimiters (Teams, Google Chat). mdast is the canonical message…

No other project uses it yet

VercelAGENTS.md

chat / apps

vercel/chat/apps/docs/public/AGENTS.md

Build multi-platform chat bots with Chat SDK (`chat` npm package). Use when developers want to scaffold a bot with create-chat-sdk, build a Slack, Teams, Google Chat, Discord, Telegram, GitHub, Linear, or WhatsApp bot, handle mentions, direct messages, subscribed threads, reactions, slash commands, cards, modals, files, or AI streaming, set up webhook routes or multi-adapter bots, send rich cards or streamed AI responses to chat platforms, or build a custom adapter or state adapter.