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

dcgm-exporter / pkg

NVIDIA/dcgm-exporter/internal/pkg/AGENTS.md

The root AGENTS.md still applies. This file adds rules for internal/pkg/. internal/pkg/ contains private implementation packages for metric collection, device discovery, rendering, server behavior, reload support, wrappers, and test helpers. The Go compiler enforces that these packages are not external API. - Keep public surfaces small and package-owned. Prefer package-local helpers over new cross-package abstractions unless multiple production packages need the same behavior. - Do not hide operational failures with .ok-style patterns or default values when the failure changes metric…

1.9k4mo agoReviewMountCreate a free account to mount
NVIDIAAGENTS.md

dcgm-exporter / cmd

NVIDIA/dcgm-exporter/pkg/cmd/AGENTS.md

The root AGENTS.md still applies. This file adds rules for pkg/cmd/. pkg/cmd/app.go owns the executable contract: CLI flags, environment variables, startup, logging configuration, web configuration, runtime reload wiring, and optional pprof endpoints. This package holds only code that needs the CLI framework or the flag definitions. The rest of the configuration code lives in other packages: - internal/pkg/appconfig owns the defaults (DefaultConfig), the flag-name strings (Flag... constants, which the exported CLI... constants here alias), ValidateValues and ValidateCombinations, the settings table,…

1.9k4mo agoReviewMountCreate a free account to mount
NVIDIAAGENTS.md

dcgm-exporter / tests

NVIDIA/dcgm-exporter/tests/AGENTS.md

The root AGENTS.md still applies. This file adds rules for tests/. The test tree contains multiple layers with different prerequisites. Pick the lowest layer that proves the behavior. - Package/unit tests: normal go test packages, no GPU expected. - tests/static: rendered chart, source, package, and Dockerfile checks with no live infrastructure. - tests/host: GPU/DCGM-backed exporter behavior on the host. - tests/container: container startup, metrics, health, and runtime checks; requires --tags=container plus local images or pullable images and Docker/GPU access. Without…

1.9k4mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

vscode-mssql

microsoft/vscode-mssql/AGENTS.md

- Use DEVELOPMENT.md for setup, build, test, localization, and debugging workflows. - Treat package scripts, workspace configuration, and test configuration as the source of truth when documentation disagrees. - Before…

1.9k40d agoReviewMountCreate a free account to mount
SentryAGENTS.md

sentry-php

getsentry/sentry-php/AGENTS.md

- sentry/sentry is the core PHP SDK, not an application or framework bundle. - Public entry points include the autoloaded global helpers in src/functions.php and the public classes and interfaces under src/. - Use this file for repo-specific constraints that are easy to miss, and explore the codebase for current implementation details. - The minimum supported PHP version for shipped code is 7.2. composer.json requires ^7.2|^8.0, so shipped code must remain valid on PHP 7.2 unless support policy is intentionally…

1.9k4mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

workers-oauth-provider

cloudflare/workers-oauth-provider/AGENTS.md

@cloudflare/workers-oauth-provider is a production-grade OAuth 2.1 provider library for Cloudflare Workers. It implements authorization code flow with PKCE, OAuth discovery, client registration, token exchange, audience validation, and encryption of sensitive data stored in KV. Primary use case: This library powers authorization for MCP (Model Context Protocol) servers. MCP servers are OAuth Resource Servers, and this library provides both protected-resource middleware and the authorization server functionality needed to secure them. This library was largely written with Claude AI assistance, with all…

Steady9 mentions in 2 weeks

No other project uses it yet

1.9k24d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

msphpsql

microsoft/msphpsql/AGENTS.md

This document provides guidance for AI coding agents working with the msphpsql GitHub repository — the open-source home of the sqlsrv and **pdo_sqlsrv** PHP extensions for Microsoft SQL Server. The drivers ship as two separate PHP extensions that share a common C++ core layer:

1.9k8mo agoReviewMountCreate a free account to mount
SentryAGENTS.md

sentry-react-native / core

getsentry/sentry-react-native/packages/core/AGENTS.md

Depth lives in the skills. The code-guidelines and test-guidelines skills (.agents/skills/) hold the authoritative, current guidance on code style, API/integration design, the bridge, and tests — load them before non-trivial work. This file covers the package's build/test commands, quick-reference conventions, and the TurboModule subsystem, which is documented nowhere else. Where a convention here overlaps a skill, the skill wins. Use describe/it blocks (preferred) or flat test() calls: Arrange-Act-Assert pattern — always structure tests with clear sections. Use specific Jest matchers:

1.8k2mo agoReviewMountCreate a free account to mount
SentryAGENTS.md

sentry-react-native / android

getsentry/sentry-react-native/packages/core/android/AGENTS.md

Depth lives in the skills. code-guidelines (.agents/skills/, esp. references/native-bridge.md) is authoritative for bridge and native conventions — load it before non-trivial work. This file is the quick reference for the Android surface; where a convention here overlaps a skill, the skill wins. Android native code supports both React Native architectures — a bridge-method change usually has to land in both: Catch Throwable at the boundary — not just Exception, so an Error can't crash the app either (the module code…

1.8k2mo agoReviewMountCreate a free account to mount
SentryAGENTS.md

sentry-react-native / ios

getsentry/sentry-react-native/packages/core/ios/AGENTS.md

Depth lives in the skills. code-guidelines (.agents/skills/, esp. references/native-bridge.md) is authoritative for bridge and native conventions — load it before non-trivial work. This file is the quick reference for the iOS surface; where a convention here overlaps a skill, the skill wins. Catch everything at the boundary and reject — never let an exception reach the app. The reject error code is the shared @"SentryReactNative", not a per-method code: ✅ Always - Resolve or reject every exported method — a…

1.8k2mo agoReviewMountCreate a free account to mount
SentryAGENTS.md

sentry-react-native / expo

getsentry/sentry-react-native/samples/expo/AGENTS.md

The test bed for the SDK under Expo (config plugin, Metro integration, EAS). Use it to verify a change behaves in an Expo-managed app, not just a bare RN one. yarn start then follows the Expo CLI prompts to open on an iOS simulator, Android emulator, or a physical device. Because the SDK ships native code, plain Expo Go isn't enough — the run:* scripts build a dev client that includes it. This app runs on the iOS UIScene lifecycle…

1.8k2mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

BotFramework-WebChat

microsoft/BotFramework-WebChat/AGENTS.md

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

1.8k29d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

BotFramework-WebChat / api

microsoft/BotFramework-WebChat/packages/api/AGENTS.md

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

1.8k29d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

BotFramework-WebChat / base

microsoft/BotFramework-WebChat/packages/base/AGENTS.md

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

1.8k29d agoReviewMountCreate a free account to mount
GoogleAGENTS.md

adk-java

google/adk-java/AGENTS.md

Placeholder - guidance for AI coding agents working in this repository is coming soon.

No other project uses it yet

1.8k46d agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

nimbus / www

cloudflare/nimbus/apps/www/AGENTS.md

Agent-facing context. If you're picking up work on this site, start here. Astro-based docs site. The nimbus-docs package provides the integration, content schemas, navigation/sidebar/TOC computation, MDX→markdown rendering, build hooks, and the nimbus CLI. Everything you see in src/ is user-owned and yours to edit. For Cloudflare deploys, also: wrangler.jsonc at project root. Frontmatter validates against the schema from docsCollection() (@cloudflare/nimbus-docs/content). Required: title. The schema includes optional fields for description, sidebar overrides, drafts, dates, edit-link suppression — read docsSchema in @cloudflare/nimbus-docs/schemas…

Steady11 mentions in 2 weeks

No other project uses it yet

1.8k31d agoReviewMountCreate a free account to mount
GitHubAGENTS.md

gh-stack

github/gh-stack/AGENTS.md

A GitHub CLI (gh) extension for managing stacked branches and pull requests. Written in Go, it automates creating branches, keeping them rebased, setting PR base branches, and navigating between stack layers. Repository operations require Git 2.36 or later. Always run go vet before tests. See CONTRIBUTING.md for the alternative canonical go test command, targeted tests, and timing artifacts. CI runs the full platform-applicable suite with race detection on Linux, macOS, and Windows, with a cross-shard completion gate. There is no…

Steady7 mentions in 2 weeks

No other project uses it yet

1.8k20d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

rnx-kit

microsoft/rnx-kit/AGENTS.md

This file provides guidance to agents when working with code in this repository. rnx-kit is a monorepo of React Native tooling created by Microsoft. It provides battle-tested tools for dependency management, Metro bundling enhancements, TypeScript integration, and cross-platform development (iOS, Android, macOS, Windows). - packages/ - Stable, published packages (e.g., @rnx-kit/cli, @rnx-kit/align-deps, @rnx-kit/metro-*) - incubator/ - Experimental packages (marked with "experimental": true in package.json) - scripts/ - Internal build tooling (rnx-kit-scripts CLI) - docsite/ - Documentation website (separate Yarn workspace…

No other project uses it yet

1.7k12d 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.