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

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.