AGENTS.md examples from real projects

Hugging FaceAGENTS.md

OpenEnv

huggingface/OpenEnv/AGENTS.md

See CLAUDE.md for the full agentic workflow, skills, and standard build/test/lint commands. This file adds cloud-environment specifics on top of that.

SupabaseAGENTS.md

agent-skills

supabase/agent-skills/AGENTS.md

Guidance for AI coding agents working with this repository. Note: CLAUDE.md is a symlink to this file. This project uses pnpm for dependency management and task execution. Use the Node.js version declared in .node-version, then install dependencies with pnpm install. Run tasks with pnpm. Before completing any task, run pnpm test to ensure CI passes. This repository uses Release Please on main. If you change shipped skill contents under skills/, make sure the change is represented with an appropriate conventional…

No other project uses it yet

AWSAGENTS.md

aws-lambda-web-adapter

aws/aws-lambda-web-adapter/AGENTS.md

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

GoogleAGENTS.md

mantis

google/mantis/AGENTS.md

Always run pre-commit run --all-files before creating or amending a commit. This ensures all markdown files conform to the pinned mdformat 0.7.21 formatter (--number --wrap 80 with gfm + frontmatter plugins). The hook installs its own isolated venv — do not run local mdformat directly. If the hook modifies files, stage the changes and amend your commit. Security invariants (INV-1 through INV-6) are enforced deterministically by the Google ADK Python runtime, Pydantic schemas, and tool wrappers rather than prompt fences:

No other project uses it yet

NVIDIAAGENTS.md

NeMo-Agent-Toolkit

NVIDIA/NeMo-Agent-Toolkit/AGENTS.md

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --> AI…

No other project uses it yet

NVIDIAAGENTS.md

NeMo-Agent-Toolkit / references

NVIDIA/NeMo-Agent-Toolkit/skills/nat-agent-configuration/references/agents.md

The nine built-in NeMo Agent Toolkit agent types: when to pick which, key traits, and YAML examples. Companion: additional-agent-types.md lists the lesser-used types in detail. Classify the workflow shape before scaffolding: Alternates between reasoning and acting: think -> call tool -> observe result -> repeat until done (up to max_tool_calls, default 15). Use when: Tasks require interleaved reasoning over intermediate tool results; the LLM does not reliably support native tool calling (ReAct falls back to text-based Action:/Action Input: parsing); tools…

No other project uses it yet

MongoDBAGENTS.md

mongo-java-driver

mongodb/mongo-java-driver/AGENTS.md

All changes require human review. Breaking changes to public API require a major version bump — always warn if binary compatibility is affected. Also consult .AGENTS.md / ~/.AGENTS.md if present for local agent settings. Architecture: Multi-module Gradle project: bson → driver-core → driver-sync/driver-reactive-streams → language wrappers (driver-kotlin-sync, driver-kotlin-coroutine, driver-scala). See .agents/references/project-guide for module structure and dependency graph. Each module has its own AGENTS.md. The default branch is main (not master). Always use main when comparing, diffing, or creating branches. -…

No other project uses it yet

MongoDBAGENTS.md

mongo-java-driver / bom

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

Bill of Materials (BOM) for MongoDB Java Driver dependency management.

No other project uses it yet

MongoDBAGENTS.md

mongo-java-driver / bson

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

Core BSON (Binary JSON) library — the foundation module. All other modules depend on it. Depends on: None (foundation module)

No other project uses it yet

MongoDBAGENTS.md

mongo-java-driver / bson-kotlin

mongodb/mongo-java-driver/bson-kotlin/AGENTS.md

Kotlin extensions for the BSON library, providing idiomatic Kotlin codec support. Depends on: bson

No other project uses it yet

MongoDBAGENTS.md

mongo-java-driver / bson-kotlinx

mongodb/mongo-java-driver/bson-kotlinx/AGENTS.md

Kotlinx serialization integration for BSON, providing a pluggable serialization format. Depends on: bson

No other project uses it yet

MongoDBAGENTS.md

mongo-java-driver / bson-record-codec

mongodb/mongo-java-driver/bson-record-codec/AGENTS.md

Java record codec support for BSON serialization. Requires Java 17+. Depends on: bson - Work here if: modifying Java record serialization support - This module targets Java 17 (sourceCompatibility = 17) — Java 17 features (records, sealed classes, text blocks, etc.) are permitted here, unlike most other modules which target Java 8

No other project uses it yet

MongoDBAGENTS.md

mongo-java-driver / bson-scala

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

Scala extensions for the BSON library, providing Scala-idiomatic wrappers and macro-based codecs. Depends on: bson 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.

No other project uses it yet

MongoDBAGENTS.md

mongo-java-driver / buildSrc

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

Gradle build infrastructure providing convention plugins and shared configuration for all modules. - src/main/kotlin/conventions/ — Convention plugins applied by modules (formatting, testing, publishing, static analysis) - src/main/kotlin/project/ — Base project plugins for Java, Kotlin, and Scala modules - src/main/kotlin/ProjectExtensions.kt — Shared Gradle extension utilities After modifying buildSrc, run the sync-agents-docs skill to update AGENTS.md files and skills that may be affected.

No other project uses it yet

MongoDBAGENTS.md

mongo-java-driver / driver-benchmarks

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

Performance benchmarks for the MongoDB Java Driver using JMH and a custom benchmark framework. Depends on: driver-sync, mongodb-crypt - com.mongodb.benchmark.benchmarks — Benchmark suite and individual benchmarks (BSON, single/multi-doc, bulk operations) - com.mongodb.benchmark.benchmarks.bulk — Bulk write benchmarks - com.mongodb.benchmark.benchmarks.netty — Netty transport benchmarks - com.mongodb.benchmark.framework — Custom benchmark harness - com.mongodb.benchmark.jmh — JMH microbenchmarks

No other project uses it yet

MongoDBAGENTS.md

mongo-java-driver / driver-core

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

Core driver internals shared by all driver variants (sync, reactive, Kotlin, Scala). Largest and most complex module. Depends on: bson, bson-record-codec, optionally bson-kotlin, bson-kotlinx, mongodb-crypt - Work here if: modifying query builders (Filters, Updates, Aggregates), connection handling, wire protocol, server selection, or operation execution - Do not: block in async code paths, modify wire protocol or auth without human approval - Most extensive test suite — JUnit 5 + Spock + Mockito. Match surrounding patterns carefully. - MongoDriverVersion is auto-generated…

No other project uses it yet

MongoDBAGENTS.md

mongo-java-driver / driver-kotlin-coroutine

mongodb/mongo-java-driver/driver-kotlin-coroutine/AGENTS.md

Kotlin Coroutines driver providing suspend function-based async API. Depends on: bson, driver-reactive-streams, bson-kotlin

No other project uses it yet

MongoDBAGENTS.md

mongo-java-driver / driver-kotlin-extensions

mongodb/mongo-java-driver/driver-kotlin-extensions/AGENTS.md

Kotlin extensions providing type-safe DSLs for query and update construction. Depends on: driver-core, optionally driver-kotlin-sync, driver-kotlin-coroutine

No other project uses it yet

MongoDBAGENTS.md

mongo-java-driver / driver-kotlin-sync

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

Kotlin synchronous (blocking) driver — idiomatic Kotlin wrapper over driver-sync. Depends on: bson, driver-sync, bson-kotlin

No other project uses it yet

MongoDBAGENTS.md

mongo-java-driver / driver-legacy

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

Legacy MongoDB Java driver API — backwards compatibility facade for the 3.x API. Depends on: bson, driver-core, driver-sync - com.mongodb — Legacy API (MongoClient, DB, DBCollection, DBCursor) — distinct from driver-core classes in the same namespace - com.mongodb.gridfs — Legacy GridFS

No other project uses it yet