AGENTS.md examples from real projects

How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.

Best matchesWorked for most · soon

obraAGENTS.md

superpowers

obra/superpowers/AGENTS.md

harness and send exactly this user message: > Let's make a react todo list A working integration auto-triggers the `brainstorming` skill before any code is written. Paste the complete

292k3mo agoDiscuss

NousResearchAGENTS.md

server and applied with `TIOCSWINSZ`. **Do not re-implement the primary chat experience in React.** Transcript, composer/input flow (including slash-command behaviour), and the PTY-backed terminal belong

250k6mo agoDiscuss

MicrosoftAGENTS.md

vscode / common

microsoft/vscode/extensions/copilot/src/platform/authentication/common/AGENTS.md

session or `undefined` - `authService.copilotToken` — cached Copilot token (without the raw token string) or `undefined` React to `onDidAuthenticationChange` for identity changes (sign in/out, account switch). React to `onDidCopilotTokenChange` for token-level

193k24d agoDiscuss

MicrosoftAGENTS.md

vscode / agentHost

microsoft/vscode/src/vs/platform/agentHost/AGENTS.md

# Multi-Chat Architecture > Node runtime service construction is documented separately in [`node/serviceBootstrapping.md`](node/serviceBootstrapping.md). > Host

193k24d agoDiscuss

Significant-GravitasAGENTS.md

AutoGPT / vercel-react-best-practices

Significant-Gravitas/AutoGPT/.claude/skills/vercel-react-best-practices/AGENTS.md

React Best Practices **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

188k22d agoDiscuss

langgeniusAGENTS.md

dify / web

langgenius/dify/web/AGENTS.md

audit requests, including test reviews. Use `frontend-testing` when writing or changing Vitest or React Testing Library tests. ## Package Contracts Web owns application-specific requirements and consumes shared architecture guidance

157k7d agoDiscuss

SupabaseAGENTS.md

supabase

supabase/supabase/AGENTS.md

111k10d agoDiscuss

SupabaseAGENTS.md

supabase / kb

supabase/supabase/apps/kb/AGENTS.md

routes, or middleware](https://docs.astro.build/en/guides/routing/) - [Working with Astro components](https://docs.astro.build/en/basics/astro-components/) - [Using React, Vue, Svelte, or other framework components](https://docs.astro.build/en/guides/framework-components/) - [Adding or managing content](https://docs.astro.build

111k10d agoDiscuss

SupabaseAGENTS.md

supabase / studio

supabase/supabase/apps/studio/AGENTS.md

Supabase Studio Next.js pages router + TanStack Start (mid-migration, see below), React 19. Dev server: `pnpm dev:studio` → http://localhost:8082. ## Skills — load before working Load the skills matching

111k10d agoDiscuss

nexu-ioAGENTS.md

open-design / apps

nexu-io/open-design/apps/AGENTS.md

shell, Store, channel, or generation policy here. - `apps/web`: Next.js 16 App Router + React 18 web runtime. Entrypoints live in `apps/web/app/`; the main client shell is `apps/web/src/App.tsx`. During local `tools

96k4mo agoDiscuss

nexu-ioAGENTS.md

open-design / packages

nexu-io/open-design/packages/AGENTS.md

APIs, browser APIs, SQLite, daemon internals, or the sidecar control-plane protocol. - `packages/components`: shared React UI primitives and primitive CSS. It may depend on React types/runtime only; keep product workflows

96k4mo agoDiscuss

infiniflowAGENTS.md

ragflow

infiniflow/ragflow/AGENTS.md

Current stack - Backend: Python 3.13+, Quart-based API server, Peewee ORM, async workers. - Frontend: React + TypeScript + Vite in `web/`. When working under `web/`, read and follow `web/AGENTS.md` — it holds

91k7mo agoDiscuss

colbymchenryAGENTS.md

codegraph

colbymchenry/codegraph/docs/AGENTS.md

updating an element re-render the canvas on screen?"* (the full flow crosses three React boundaries: observer callback, `setState`→`render`, and JSX child). | Stage | duration | Read | Grep | codegraph | |---|---|---|---|---| | Without codegraph

72k2mo agoDiscuss

tw93AGENTS.md

Pake

tw93/Pake/AGENTS.md

button_state == MouseButtonState::Up`, because Windows emits `TrayIconEvent::Click` twice per physical click and reacting to both runs the toggle twice; and `any_app_window_visible` must exclude minimized windows

62k14d agoDiscuss

calesthioAGENTS.md

OpenMontage / vercel-react-best-practices

calesthio/OpenMontage/.agents/skills/vercel-react-best-practices/AGENTS.md

59k46d agoDiscuss

CherryHQAGENTS.md

cherry-studio / vercel-react-best-practices

CherryHQ/cherry-studio/.agents/skills/vercel-react-best-practices/AGENTS.md

52k45d agoDiscuss

QuantumNousAGENTS.md

new-api

QuantumNous/new-api/AGENTS.md

each module’s `go.mod`), Gin web framework, GORM v2 ORM - **Frontend**: React 19, TypeScript, Rsbuild 2, TanStack Router/Query/Table, Zustand, Base UI, Tailwind CSS 4 - **Databases**: SQLite, MySQL, PostgreSQL

49k16d agoDiscuss

HKUDSAGENTS.md

nanobot

HKUDS/nanobot/AGENTS.md

configuration loaded from `~/.nanobot/config.json`. Supports camelCase aliases for JSON compatibility. - **WebUI** (`webui/`): Vite-based React SPA that talks to the gateway over a WebSocket multiplex protocol. The dev server proxies

49k5mo agoDiscuss

SentryAGENTS.md

sentry / static

getsentry/sentry/static/AGENTS.md

Guide" section in `/AGENTS.md` in the repository root. ## Frontend Tech Stack - **Language**: TypeScript - **Framework**: React 19 - **Build Tool**: Rspack (Webpack alternative) - **Package management**: pnpm - **State Management**: Reflux, React Query (TanStack

45k3mo agoDiscuss

VercelAGENTS.md

agent-skills / composition-patterns

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

React Composition Patterns **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

31k5mo agoDiscuss

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.