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

stripe-android

stripe/stripe-android/AGENTS.md

GitHub Issues — use gh CLI with GH_HOST=github.com prefix (export for reads, inline for writes). Always use --state all when searching. Check existing issues before investigating user reports. Pull requests — always open pull requests as drafts. When an agent opens a pull request, include Committed and created by <agent>. in the PR description, where agent is the type of agent (e.g., Claude or Codex). Internal Tools — Jira: MOBILESDK, RUN_MOBILESDK | Trailhead space: mobile-sdk Multi-module Android library for payment…

No other project uses it yet

1.6k9d agoReviewMountCreate a free account to mount
JetBrainsAGENTS.md

intellij-platform-gradle-plugin

JetBrains/intellij-platform-gradle-plugin/AGENTS.md

The IntelliJ Platform Gradle Plugin is a Kotlin Gradle plugin for building, testing, verifying, and publishing plugins for IntelliJ-based IDEs. Run commands from the repository root using ./gradlew (gradlew.bat on Windows). Use JDK 21 to match CI; compilation uses a Java 17 toolchain and Kotlin 2.2 language/API settings in build.gradle.kts. The Foojay resolver in settings.gradle.kts can provision the toolchain. The wrapper currently uses Gradle 9.8.2. Initial setup and tests need network access for Gradle, toolchains, dependencies, and IDE distributions. TestKit…

Steady3 mentions in 2 weeks

No other project uses it yet

1.5k11d agoReviewMountCreate a free account to mount
MongoDBAGENTS.md

mongo-rust-driver

mongodb/mongo-rust-driver/AGENTS.md

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

Steady8 mentions in 2 weeks

No other project uses it yet

1.5k24d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

waza

microsoft/waza/AGENTS.md

This repository contains waza, a CLI tool for evaluating Agent Skills. Go is the only implementation, and it lives in the repository root. (An early Python implementation was removed in February 2026.) When making changes, follow these guidelines to maintain consistency and quality. See Meet the Squad for current owners, the pinned Squad tooling, and upgrade/verification procedures. .squad/team.md and .squad/routing.md define the active team; .squad/governance.md defines bounded collaboration and independent review. Persisted GPT-first role assignments live in .squad/config.json, with code-review…

Steady3 mentions in 2 weeks

No other project uses it yet

1.5k5mo agoReviewMountCreate a free account to mount
Model Context ProtocolAGENTS.md

kotlin-sdk

modelcontextprotocol/kotlin-sdk/AGENTS.md

Kotlin Multiplatform SDK for the Model Context Protocol (MCP). Targets JVM, Native (macOS/Linux/Windows), JS, and Wasm. Implements both MCP clients and servers with pluggable transports. Run a single test class:

Steady13 mentions in 2 weeks

No other project uses it yet

1.5k7mo agoReviewMountCreate a free account to mount
NVIDIAAGENTS.md

deepops

NVIDIA/deepops/AGENTS.md

This file is the entry point for AI agents (and new humans) operating this repository. DeepOps deploys and manages GPU clusters — Slurm or Kubernetes on NVIDIA GPU servers — using Ansible. Everything here is driven by playbooks against an inventory you control; there is no server component. Load only what the task needs: this file for orientation and the golden paths, docs/ for depth, skills/ for step-by-step procedures with failure handling. The doctor must report "ok": true (or you…

1.5k12d agoReviewMountCreate a free account to mount
NVIDIAAGENTS.md

dgx-spark-playbooks / assets

NVIDIA/dgx-spark-playbooks/nvidia/playbook-dgx-station-ai-skills/assets/AGENTS.md

- Detect the actual platform with .dgx-station/bin/dgx-assist system inspect before advising. - Follow the detected compatibility profile and per-feature capabilities; do not infer behavior from a version prefix. - Use dgx-assist and the applicable dgx-station* skill. - Search the pinned NVIDIA playbooks before giving Station-specific commands. - Never assume an nvidia-smi index is a CUDA ordinal; select launch devices by UUID. - Never execute an unvalidated recipe or conceal a mutation, network exposure, or large download. <!-- END NVIDIA DGX…

Steady2 mentions in 2 weeks

No other project uses it yet

1.5k2mo agoReviewMountCreate a free account to mount
NVIDIAAGENTS.md

MatX

NVIDIA/MatX/AGENTS.md

When adding or changing accelerated backends such as CUDA, cuBLAS, cuSolver, cuFFT, or MathDx paths, preserve the existing non-accelerated behavior unless the task explicitly calls for a breaking change. Prefer focused tests that compare the new backend against an existing trusted MatX path, and include negative tests for unsupported shape, dtype, rank, or configuration combinations when applicable.

1.5k6mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native

microsoft/fluentui-react-native/AGENTS.md

Guidance for coding agents working in the FluentUI React Native monorepo, which implements Microsoft's Fluent Design System for iOS, Android, macOS, Windows, and Win32. This file is always loaded. It holds repository safeguards and routes each task to the workflow and references it needs; load only what the task requires. - AGENTS.md files hold safeguards and local invariants. Copilot CLI loads applicable files from the repository, working directory, ancestors, and directories in the path of files being worked on. Read…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / storybook

microsoft/fluentui-react-native/apps/storybook/AGENTS.md

These instructions apply to the apps/storybook consumer. Shared CLI, app configuration, driver, and runtime behavior belongs to package-owned guidance: - Read agent-map.yaml for stable paths, declared scripts, and runtime discovery commands. Keep it compact; the runtime story catalog is authoritative. Give a generated source a nested path and policy: generated-…: check-agent-instructions validates other sources against Git, so ignored local build output cannot satisfy it. - desktop.config.mts owns app name, package discovery, platform story exclusions, and native command exceptions. Do not…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / components

microsoft/fluentui-react-native/packages/agentic/components/AGENTS.md

This is the instruction root for @fluentui-react-native/components and every descendant. The package owns the agentic Fluent higher-order components, the public unstyled primitives, their React Native contracts, and the contract tooling. Read the user guide, then select the narrowest topic in the reference index: Implementation and planning use the agentic-component-authoring skill, contracts use the agentic-component-contract-authoring skill, cross-component extraction uses the agentic-component-optimization skill, and reviews use the review-component skill. Focus work starts with the repository's common focus reference (focus.common), then focus.windows-win32 or…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / design

microsoft/fluentui-react-native/packages/agentic/design/AGENTS.md

This is the instruction root for @fluentui-react-native/design and every descendant. The package owns Fluent UI React Native's theming contract: theme sources and providers, ready-made Fluent and Flex themes, structured appearance, Flex and legacy tokens, the token mappings, themed style factories, the runtime color library, and test-only design fixtures. Read the user guide, then select the narrowest topic in the reference index: Component authors applying tokens and styles also follow their component workflow; for agentic components that is the repository reference…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / desktop-driver

microsoft/fluentui-react-native/packages/agentic/desktop-driver/AGENTS.md

This is the instruction root for this package and every descendant. Read README.md and select the closest topic in the reference index. Native changes also require the matching provider README and native protocol. Inspect source and tests before editing. - Do not import Storybook, React, or React Native into this package. - Keep protocol, client, authoring, runner, artifacts, and fake-host code platform-neutral. Operating-system behavior belongs behind DesktopHost. - Keep the W3C server client-neutral. WebdriverIO belongs in /wdio, composed agent/CLI operations,…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / desktop-driver-mcp

microsoft/fluentui-react-native/packages/agentic/desktop-driver-mcp/AGENTS.md

This package is the Model Context Protocol adapter for the Desktop Driver agent operations. It is the instruction root for this package and every descendant. Read the README, then the narrowest entry in the reference index. The operations themselves, their schemas, and their failure reasons belong to @fluentui-react-native/desktop-driver (its agent operations reference); this package only maps them onto MCP. - Stay a thin client. Every tool calls the service's operation routes through the typed client; never add a second execution…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / desktop-test

microsoft/fluentui-react-native/packages/agentic/desktop-test/AGENTS.md

This package owns neutral app/suite configuration, desktop lifecycle, and aggregate reporting. Read the user guide, then select the narrowest topic in the reference index. For configuration work, begin with configuration; for reports and run status, use reporting, including the shared CLI reporter modes and bounded structured output contract. - Keep the harness application-neutral: no Storybook, React, or React Native dependencies. Storybook is introduced only by the optional integration. - Preserve exact application identity and ownership semantics. Reject unknown config fields…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / native-core

microsoft/fluentui-react-native/packages/agentic/native-core/AGENTS.md

This is the instruction root for @fluentui-react-native/native-core and every descendant. The package owns modern native-backed components and modules, the legacy Callout and FocusZone wrappers, and their macOS and Windows native implementations. Read the user guide, then select the narrowest topic in the reference index: Native changes use the implement-native-component skill. Apple changes follow the repository's Apple and Office rules (R-APPLE-001 through R-APPLE-007, in native.apple-office); Windows Fabric views follow native.windows-fabric. - Follow R-APPLE-001 through R-APPLE-007 for shared services and renderer adapters.…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / storybook-desktop

microsoft/fluentui-react-native/packages/agentic/storybook-desktop/AGENTS.md

This package owns the Storybook integration CLI and runtime orchestration. Read the package README, then select the closest topic in the reference index. Use references/contributing.md for source ownership and validation. - Keep app-specific identity, story discovery, and platform exclusions in the consumer app configuration. - Keep Storybook-specific behavior here; general target configuration and aggregate lifecycle reporting belong to @fluentui-react-native/desktop-test. - Only accept statically extractable story/test plans; invalid or dynamic plans fail generation. - Preserve authenticated runtime readiness, correlated request/run IDs,…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / storybook-desktop-runtime

microsoft/fluentui-react-native/packages/agentic/storybook-desktop-runtime/AGENTS.md

This package owns the on-device Storybook runtime, bridge, Metro integration, theme host, and chrome. Read the README and the narrowest section in the reference index. The runtime contract covers the authenticated bridge, Metro, theme, and platform chrome. - Keep this package as the on-device runtime. CLI orchestration and aggregate test reporting belong to the integration and harness packages. - Preserve the authenticated nonce, correlated request/run IDs, readiness, error signaling, and native story-root verification. - Keep one Flex ThemedRoot around app…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / foundation-compose

microsoft/fluentui-react-native/packages/deprecated/foundation-compose/AGENTS.md

These instructions apply to packages/deprecated/foundation-compose, which implements the repository's legacy v0 compose framework. The consumer recipe, recognition guide, and review checklist for v0 components live in the shared v0 reference; read it before changing this package or any v0 component. v0 is maintenance-only (R-V0-001). - compose combines foundation-composable, themed settings, foundation-settings, and foundation-tokens. Changes to settings override or merge semantics, or to token processing, also require those packages' tests. - The package publicly exports compose, initializeStyling, and the compose option,…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / framework-base

microsoft/fluentui-react-native/packages/framework-base/AGENTS.md

This is the instruction root for @fluentui-react-native/framework-base and every descendant. The package owns the shared component patterns, custom JSX runtime, slot types, interaction and focus-target hooks, universal accessibility helpers, and the merge and memoization utilities used by v1 and agentic components. Read the user guide, then select the narrowest topic in the reference index: Focus-target and interaction abstractions also follow the repository's common focus authoring reference (focus.common) and its platform breakouts. - Use directComponent only for hook-free prop and render…

1.4k5mo 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.