AGENTS.md examples from real projects

VercelAGENTS.md

agent-browser

vercel-labs/agent-browser/AGENTS.md

Instructions for AI coding agents working with this codebase. This project uses pnpm. Always use pnpm instead of npm or yarn for installing dependencies, running scripts, etc. (e.g., pnpm install, pnpm run build). Do not hard-wrap prose in documentation files such as Markdown, MDX, and READMEs; let the editor or renderer wrap text naturally. Use the technical-writer skill (.agents/skills/technical-writer/SKILL.md) when you write or edit prose for this repo, including docs pages, READMEs, changelog entries, commit messages, PR descriptions, and issues.

VercelAGENTS.md

agent-browser / eve

vercel-labs/agent-browser/examples/eve/AGENTS.md

This project uses the eve framework. Before writing code, always read the relevant guide in node_modules/eve/docs/.

VercelReads credentialsAGENTS.md

skills

vercel-labs/skills/AGENTS.md

This file provides guidance to AI coding agents working on the skills CLI codebase. skills is the CLI for the open agent skills ecosystem. Aliases: skills a works for add. skills i, skills install (no args) restore from skills-lock.json. skills ls works for list. skills experimentalinstall restores from skills-lock.json. skills experimentalsync reads skills from npm dependencies (sync remains a compatibility alias).

VercelAGENTS.md

skills

vercel-labs/skills/docs/agents.md

Back to the README Skills can be installed to any of these agents:

No other project uses it yet

VercelReads credentialsAGENTS.md

add-skill

vercel-labs/add-skill/AGENTS.md

This file provides guidance to AI coding agents working on the skills CLI codebase. skills is the CLI for the open agent skills ecosystem. Aliases: skills a works for add. skills i, skills install (no args) restore from skills-lock.json. skills ls works for list. skills experimentalinstall restores from skills-lock.json. skills experimentalsync crawls node_modules for skills.

VercelAGENTS.md

agent-skills

vercel-labs/agent-skills/AGENTS.md

A collection of skills for AI coding agents working with Vercel projects. Skills are packaged instructions and scripts that extend agent capabilities. bash bash /mnt/skills/user/{skill-name}/scripts/{script}.sh [args] Skills are loaded on-demand…

VercelAGENTS.md

agent-skills / composition-patterns

vercel-labs/agent-skills/skills/composition-patterns/AGENTS.md

Version 1.0.0 Engineering January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring React codebases using composition. Humans may also find it…

VercelAGENTS.md

agent-skills / react-best-practices

vercel-labs/agent-skills/skills/react-best-practices/AGENTS.md

Version 1.0.0 Vercel Engineering January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring React and Next.js codebases. Humans may also find…

VercelAGENTS.md

agent-skills / react-native-skills

vercel-labs/agent-skills/skills/react-native-skills/AGENTS.md

Version 1.0.0 Engineering January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring React Native codebases. Humans may also find it useful,…

VercelAGENTS.md

agent-skills / react-view-transitions

vercel-labs/agent-skills/skills/react-view-transitions/AGENTS.md

Version 1.0.0 Vercel Engineering Note: This standalone guide is compiled from SKILL.md and its reference files for agents that consume a single AGENTS.md document. Edit the source files, not this…

VercelAGENTS.md

agent-skills / vercel-optimize

vercel-labs/agent-skills/skills/vercel-optimize/AGENTS.md

Cross-agent entry point for the Vercel Optimize skill. The full procedure is in SKILL.md. Use this skill when the user asks to optimize a Vercel project, reduce a Vercel bill,…

VercelReads credentialsAGENTS.md

json-render

vercel-labs/json-render/AGENTS.md

Instructions for AI coding agents working with this codebase. Always check the latest version before installing a package. Before adding or updating any dependency, verify the current latest version on npm: Or check multiple packages at once: This ensures we don't install outdated versions that may have incompatible types or missing features. When using the Vercel AI SDK (ai package) with AI Gateway, pass the model as a plain string identifier -- do not import a provider constructor: This requires…

VercelAGENTS.md

portless

vercel-labs/portless/AGENTS.md

Use pnpm for all package management commands (not npm or yarn). Exception: End-user install instructions should use npm install -g (global) or npm install -D (project dev dependency) since npm is universal. Always check for the latest npm version when adding dependencies. Use pnpm add <package> (without version) to get the latest, or verify with npm view <package> version first. Do not use emojis anywhere in this repository (code, comments, output, docs). Never use -- or em dashes as dashes…

VercelAGENTS.md

deepsec

vercel-labs/deepsec/.deepsec/AGENTS.md

This is a deepsec scanning workspace. Each registered project has its own setup prompt at data/<id>/SETUP.md — open the relevant one when asked to set a project up. - Set up a project for scanning: read data/<id>/SETUP.md and follow it (read node_modules/deepsec/SKILL.md, then fill data/<id>/INFO.md from the target codebase). - Add a new project: run deepsec init-project <root> — it scaffolds data/<id>/ and prints/writes the setup prompt for the new project. - Write a custom matcher (only after a real…

VercelAGENTS.md

native

vercel-labs/native/AGENTS.md

Guidance for agents (and humans) working on this repository. Native SDK itself is implemented in Zig, but Native SDK apps are authored in TypeScript + Native markup by default. Do not infer the app-authoring language from this repository's implementation language or from older Zig-core examples. Run scripts/gate.sh fast before finishing any change; it maps your diff to the suites that cover it. The docs site checks with pnpm --dir docs check (the gate runs it only when docs/ changed). This…

VercelAGENTS.md

native

vercel-labs/native/docs/AGENTS.md

Always use HTML <table> syntax in MDX pages, never markdown pipe tables. This ensures consistent styling and avoids MDX parsing edge cases. The site uses the public @vercel/geistdocs package with Labs branding. Write pages in content/docs with a frontmatter title and no duplicate H1. Order pages and groups with content/docs/meta.json and folder metadata. Keep /docs/<slug> URLs and the permanent legacy redirects in next.config.mjs stable. Shared navigation, search, page actions, Markdown routes, MDX rendering, and theme behavior belong to Geistdocs. Local…

VercelDeletes or force-pushesAGENTS.md

native / guest-mac

vercel-labs/native/tools/guest-mac/agents.md

You are an agent whose live-GUI phase must not fight over the desktop of the host Mac. Run those phases inside a guest VM this tool manages: each guest has its own display, its own window server, and the repo mounted over virtio-fs. Everything below is headless; the windowed app exists for the human provisioning pass. Guests are named. Every verb takes --name VM (default default); bundles live at ~/.native/guest-mac/vms/<name>/. A provisioned guest clones in milliseconds (clone), and at most…

VercelReads credentialsAGENTS.md

scriptc

vercel-labs/scriptc/AGENTS.md

This is the only agent guide for the repository. Its rules apply everywhere, including docs/ and internal/compatibility/. Write prose paragraphs and list items as single source lines and let editors and renderers wrap them naturally. Do not hard-wrap Markdown at a fixed column; preserve separate lines only where Markdown syntax or intentional formatting requires them, such as headings, lists, tables, blockquotes, and code blocks. The Limitations page partials under docs/content/limitations/ are the exception: they keep one sentence per line (see…

VercelReads credentialsAGENTS.md

open-agents

vercel-labs/open-agents/AGENTS.md

This file provides guidance for AI coding agents working in this repository. This is a living document. When you make a mistake or learn something new about this codebase, add it to Lessons Learned. Authentication uses Better Auth with Vercel OAuth (sign-in) and GitHub OAuth (repo access). Config lives in apps/web/lib/auth/config.ts. Sessions are managed by better-auth's built-in session system — there is no manual JWE/encryption layer. Key env vars: BETTERAUTHSECRET (session signing), NEXTPUBLICVERCELAPPCLIENTID + VERCELAPPCLIENTSECRET (Vercel OAuth), plus GitHub App…

VercelAGENTS.md

open-agents / vercel-react-best-practices

vercel-labs/open-agents/.agents/skills/vercel-react-best-practices/AGENTS.md

Version 1.0.0 Vercel Engineering January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring React and Next.js codebases. Humans may also find it useful, but guidance here is optimized for automation and consistency by AI-assisted workflows. Comprehensive performance optimization guide for React and Next.js applications, designed for AI agents and LLMs. Contains 40+ rules across 8 categories, prioritized by impact from critical (eliminating waterfalls, reducing bundle size) to incremental (advanced patterns). Each…