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
VercelReads credentialsAGENTS.md

next.js

vercel/next.js/AGENTS.md

This is a pnpm monorepo containing the Next.js framework and related packages. The main Next.js framework lives in packages/next/. This is what gets published as the next npm package. Source code is in packages/next/src/. Key entry points: Compiled output goes to packages/next/dist/ (mirrors src/ structure). Before editing or creating files in any subdirectory (e.g., packages/*, crates/*), read all README.md files in the directory path from the repo root up to and including the target file's directory. This helps identify any…

Steady2 mentions in 2 weeks

No other project uses it yet

143k6mo agoReviewMountCreate a free account to mount
VercelAGENTS.md

next.js / bundle-analyzer

vercel/next.js/apps/bundle-analyzer/AGENTS.md

This app enables the Rust React Compiler (reactCompiler and turbopackRustReactCompiler in next.config.mjs). When adding or reviewing UI code:

No other project uses it yet

143k6mo agoReviewMountCreate a free account to mount
VercelAGENTS.md

next.js / crates

vercel/next.js/crates/AGENTS.md

Read and follow the shared turbo_tasks caching and invalidation guidance. Those turbo_tasks rules also apply throughout crates/ and all its subdirectories when developing with turbo_tasks.

No other project uses it yet

143k6mo agoReviewMountCreate a free account to mount
VercelAGENTS.md

next.js / evals

vercel/next.js/evals/AGENTS.md

Do not export evals with "publish": false to next-evals-oss or publish their results on nextjs.org/evals.

Steady2 mentions in 2 weeks

No other project uses it yet

143k6mo agoReviewMountCreate a free account to mount
VercelAGENTS.md

next.js / agent-062-pokedex-dev-loop

vercel/next.js/evals/evals/agent-062-pokedex-dev-loop/AGENTS.md

Before any Next.js work, find and read the relevant doc in app/node_modules/next/dist/docs/. Your training data is outdated — the docs are the source of truth.

Steady2 mentions in 2 weeks

No other project uses it yet

143k6mo agoReviewMountCreate a free account to mount
VercelAGENTS.md

next.js / next-13

vercel/next.js/evals/next-upgrade/apps/member-dashboard/next-13/AGENTS.md

You may edit this application and create local commits. Do not push or create pull requests. Use npm. Preserve the behavior described in README.md.

Steady2 mentions in 2 weeks

No other project uses it yet

143k6mo agoReviewMountCreate a free account to mount
VercelAGENTS.md

next.js

vercel/next.js/.github/AGENTS.md

Set permissions: {} at the workflow level and grant the minimum needed per-job. Prefer GitHub-provided (actions/*) and Vercel-owned actions. For third-party actions: ${{ ... }} is interpolated into the script before bash runs, so untrusted values (PR title, branch name, issue body) can break out and execute. Route them through an env var and quote on use:

No other project uses it yet

143k6mo agoReviewMountCreate a free account to mount
VercelAGENTS.md

next.js / next

vercel/next.js/packages/next/AGENTS.md

This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in dist/docs/ before writing any code. Heed deprecation notices.

No other project uses it yet

143k6mo agoReviewMountCreate a free account to mount
VercelAGENTS.md

next.js / test

vercel/next.js/test/AGENTS.md

All newly created e2e tests must work with Cache Components both enabled and disabled. The test infrastructure runs both variants. In the enabled variant, __NEXT_CACHE_COMPONENTS=true enables Cache Components even when the fixture's next.config does not declare cacheComponents. - Write fixtures that conform to Cache Components rules by default: put uncached or request-time work behind appropriate <Suspense> boundaries, and use "use cache" for work that should be cached. Preserve what the test is intended to cover when adapting the fixture. -…

Steady2 mentions in 2 weeks

No other project uses it yet

143k6mo agoReviewMountCreate a free account to mount
VercelAGENTS.md

next.js / turbopack

vercel/next.js/turbopack/AGENTS.md

Turbopack is a general-purpose bundler that is built and designed for Next.js, but is not necessarily Next.js-specific. Keep Next.js concepts out of it. These rules apply throughout this directory tree when developing with turbo_tasks:

Steady2 mentions in 2 weeks

No other project uses it yet

143k6mo 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.