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

vercel / cli

vercel/vercel/packages/cli/AGENTS.md

Always-loaded guidance for work inside packages/cli. Keep this file small. The CLI UX design system lives in packages/cli/.agents/skills/cli-ux/ and should be loaded only when the task or code review touches user-facing CLI behavior. Common shared areas:

17k19d agoReviewMountCreate a free account to mount
VercelAGENTS.md

vercel / python

vercel/vercel/python/AGENTS.md

- Dependencies: PEP 440 compatible release clauses (rich ~= 14.0), avoid pinning patch releases (rich ~= 14.0.0). - Only add code that is actually used. No speculative APIs or exports. - _internal/ is private — no backwards compatibility needed when refactoring. - uv: uv sync, uv run <cmd>, uv add <pkg> - ruff: uv run ruff check . (lint), uv run ruff format . (format) - pytest: uv run pytest, uv run pytest tests/test_foo.py, uv run pytest -k test_name. Tests…

17k19d agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

cloudflared

cloudflare/cloudflared/AGENTS.md

Cloudflare's command-line tool and networking daemon written in Go. Production-grade tunneling and network connectivity services used by millions of developers and organizations worldwide. Notes on linting: - .golangci.yaml is configured with new-from-rev and whole-files: true. Touching a file triggers linting of the ENTIRE file, not just the changed hunks. Expect to fix pre-existing issues in files you modify, or add targeted // nolint: <linter> comments with a short justification. - Prefer defer func() { _ = resource.Close() }() over defer…

Steady2 mentions in 2 weeks

No other project uses it yet

17k17d agoReviewMountCreate a free account to mount
Hugging FaceAGENTS.md

transformers.js

huggingface/transformers.js/.ai/AGENTS.md

This file governs AI-assisted contributions to the huggingface/transformers.js repository. Agentic users must read and follow it before proposing changes. - transformers-js — how to use the library itself. Load this skill when working on code that calls @huggingface/transformers. Before opening a pull request: - Check for existing work. Search open PRs and issues (gh pr list, gh issue list) for the area you're touching. Don't duplicate someone else's in-progress work. - Coordinate on the issue first. If an issue exists,…

Steady29 mentions in 2 weeks

No other project uses it yet

16k2mo agoReviewMountCreate a free account to mount
HashiCorpAGENTS.md

packer

hashicorp/packer/AGENTS.md

Packer is HashiCorp's open-source (BUSL-1.1) CLI for building automated machine images. It is a Go program that orchestrates pluggable builders, provisioners, post-processors, and data sources through the hashicorp/packer-plugin-sdk, driven by…

16k4mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

pyright

microsoft/pyright/AGENTS.md

Pyright is a Python static type checker written in TypeScript. Before changing code, read the repository Copilot instructions and the applicable contributor and test-policy guidance. For a reported issue, use…

16k5d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

playwright-cli

microsoft/playwright-cli/AGENTS.md

This repo ships the npm package @playwright/cli. The CLI itself is in microsoft/playwright, in packages/playwright-core/src/tools/: cli-client/ has the commands and their options, cli-daemon/ has the daemon that keeps the browser open between commands, and backend/ has the tools that the commands run. - What this repo owns: playwright-cli.js, which runs the CLI of the pinned playwright-core and adds the update check, skillCheck.js, the README, and the tests of the packaged CLI. - What is a copy: skills/playwright-cli/ is a copy…

15k7mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

playwright-python

microsoft/playwright-python/AGENTS.md

Python bindings for Playwright. The client in playwright/_impl/ talks to the Node.js driver in playwright/driver/ over a pipe. Everything comes from microsoft/playwright at the commit in DRIVER_VERSION: the driver, the generated API and the code that we port. .upstream/ is a full clone of it (gitignored). Read upstream code there. Do not edit, commit or switch branches in it. The client talks to the Node.js driver that is built from .upstream/. When the same calls fail in a Node.js test…

15k2d agoReviewMountCreate a free account to mount
MicrosoftReads credentialsAGENTS.md

playwright-python / _impl

microsoft/playwright-python/playwright/_impl/AGENTS.md

These rules say how to write playwright/_impl from packages/playwright-core/src/client in microsoft/playwright. Use them at each roll, for every new or changed line of the client. The upstream code is in .upstream/, the checkout at the commit in DRIVER_VERSION. The steps of a roll are in the playwright-roll skill. The port is line by line. The structure of the Python follows the JavaScript. The timing of the Python follows asyncio. A reviewer reads the .ts file and the .py file side…

No other project uses it yet

15k2d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

playwright-python / tests

microsoft/playwright-python/tests/AGENTS.md

These rules say how to write tests/async/{page,library} and tests/sync/{page,library} from tests/page and tests/library in microsoft/playwright, at the commit in DRIVER_VERSION. Use them at each roll, for every new or changed upstream test. The upstream tests are in .upstream/, the checkout at that commit. The steps of a roll are in the playwright-roll skill. The port is line by line, with zero deviations. A reviewer reads the .spec.ts file and the two .py files side by side. Each upstream statement maps…

No other project uses it yet

15k2d agoReviewMountCreate a free account to mount
NVIDIAAGENTS.md

TensorRT-LLM

NVIDIA/TensorRT-LLM/AGENTS.md

TensorRT-LLM: open-source library for optimized LLM inference on NVIDIA GPUs. Python and C++ codebase with a PyTorch execution path. If a CLAUDE.local.md file exists alongside this file, read and respect…

15k3mo agoReviewMountCreate a free account to mount
NVIDIAAGENTS.md

TensorRT-LLM

NVIDIA/TensorRT-LLM/.codex/AGENTS.md

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

15k3mo agoReviewMountCreate a free account to mount
NVIDIAAGENTS.md

TensorRT-LLM / kv_cache_manager_v2

NVIDIA/TensorRT-LLM/cpp/tensorrt_llm/batch_manager/kv_cache_manager_v2/AGENTS.md

This directory contains the C++ implementation of KVCacheManagerV2: allocation, prefix reuse, eviction, GPU/host/disk movement, page locking, and KV-cache event generation. Python accesses it through the nanobind bindings in cpp/tensorrt_llm/nanobind/batch_manager/kvCacheManagerV2.cpp. This…

15k3mo agoReviewMountCreate a free account to mount
NVIDIAAGENTS.md

TensorRT-LLM / jenkins

NVIDIA/TensorRT-LLM/jenkins/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

15k3mo agoReviewMountCreate a free account to mount
NVIDIAAGENTS.md

TensorRT-LLM / commands

NVIDIA/TensorRT-LLM/tensorrt_llm/commands/AGENTS.md

Rules for the trtllm-serve CLI (commands/serve.py) are in tensorrt_llm/serve/AGENTS.md.

15k3mo agoReviewMountCreate a free account to mount
NVIDIAAGENTS.md

TensorRT-LLM / kv_cache_manager_v2

NVIDIA/TensorRT-LLM/tensorrt_llm/runtime/kv_cache_manager_v2/AGENTS.md

This file provides guidance to coding agents when working with code in this directory. The Python surface of KVCacheManagerV2, the KV cache management subsystem for TensorRT-LLM. It manages GPU/host/disk memory…

15k3mo agoReviewMountCreate a free account to mount
NVIDIAAGENTS.md

TensorRT-LLM / serve

NVIDIA/TensorRT-LLM/tensorrt_llm/serve/AGENTS.md

Scope: tensorrt_llm/serve/ and everything under it. Supplements the repo-root AGENTS.md and tests/AGENTS.md; tensorrt_llm/commands/AGENTS.md points here for the serve CLI. Where a check enforces a rule, the rule names it; a…

15k3mo agoReviewMountCreate a free account to mount
NVIDIAAGENTS.md

TensorRT-LLM / tests

NVIDIA/TensorRT-LLM/tests/AGENTS.md

Scope: this directory and everything under it. Supplements the repo-root AGENTS.md. This is a reminder for whoever adds a test, not a hard gate. Not every test runs in CI…

15k3mo agoReviewMountCreate a free account to mount
NVIDIAAGENTS.md

TensorRT-LLM / visual_gen

NVIDIA/TensorRT-LLM/tests/integration/defs/visual_gen/AGENTS.md

Scope: this directory (tests/integration/defs/visual_gen/). Supplements the repo-root AGENTS.md. A VisualGen test that cannot run because a resource CI is expected to provide is missing must fail loudly, not pytest.skip —…

15k3mo 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.