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

skills/ # Built-in skills (by category) optional-skills/: shipped, not active ├── ui-tui/ # Ink (React) terminal UI — `hermes --tui` ├── tui_gateway/ # Python JSON-RPC backend for TUI + Desktop — server.py + methods

250k6mo agoReads credentialsDiscuss

NousResearchAGENTS.md

hermes-agent / web

NousResearch/hermes-agent/web/AGENTS.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

DeepSeekAGENTS.md

deepseek-harness / client

deepseek-ai/deepseek-harness/packages/client/AGENTS.md

what UI domains may share: 1. **Everything a render reads that can change outside React arrives through a framework hook** (rule 4 above). Event-handler code may read live snapshots

238k54d agoReads credentialsDiscuss

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 / autogpt_platform

Significant-Gravitas/AutoGPT/autogpt_platform/AGENTS.md

monorepo containing: - **Backend** (`backend`): Python FastAPI server with async support - **Frontend** (`frontend`): Next.js React application - **Shared Libraries** (`autogpt_libs`): Common Python utilities ## Component Documentation - **Backend**: See @backend/AGENTS.md for backend-specific

188k22d agoReads credentialsDiscuss

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

fAGENTS.md

prompts.chat

f/prompts.chat/AGENTS.md

with customizable branding, themes, and authentication. ### Tech Stack - **Framework:** Next.js 16.0.7 (App Router) with React 19.2 - **Language:** TypeScript 5 - **Database:** PostgreSQL with Prisma ORM 6.19 - **Authentication:** NextAuth.js 5 (beta) with

170k8mo agoReads credentialsDiscuss

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

VercelAGENTS.md

next.js

vercel/next.js/AGENTS.md

flag wiring across config/schema/define-env/runtime env - `$dce-edge` - DCE-safe `require()` patterns and edge/runtime constraints - `$react-vendoring` - `entry-base.ts` boundaries and vendored React type/runtime rules - `$react-sync` - build a local React checkout

143k5mo agoReads credentialsDiscuss

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

nexu-io/open-design/AGENTS.md

tests and self-validation; see `mocks/README.md`). - `apps/web` is the Next.js 16 App Router + React 18 web runtime; do not restore `apps/nextjs`. - `apps/daemon` is the local privileged daemon

96k4mo agoReads credentialsDiscuss

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 / e2e

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

flat `*.test.ts` Playwright tests. Do not add subdirectories, TSX, Vitest, jsdom, Testing Library, or React harness tests under `ui/`. - `ui/` tests must import runtime-bound `test`/`expect` from `@/playwright/suite

96k4mo agoReads credentialsDiscuss

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

infiniflowAGENTS.md

ragflow / web

infiniflow/ragflow/web/AGENTS.md

built with UmiJS: - **Components**: shadcn/ui - **Styling**: Tailwind CSS - **State**: Zustand - **Data Fetching**: TanStack Query (React Query) - **i18n**: react-i18next ## Common Commands ```bash npm install npm run dev # Development server

91k7mo agoReads credentialsDiscuss

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.