AGENTS.md examples from real projects

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

Best matches · from page 9Worked for most · soon

first-flukeAGENTS.md

oh-my-agent

first-fluke/oh-my-agent/AGENTS.md

prisma} | | debug | `.agents/rules/debug.md` | on request | | design | `.agents/rules/design.md` | on request | | dev-workflow | `.agents/rules/dev-workflow.md` | on request | | frontend | `.agents/rules/frontend.md` | **/*.{tsx,jsx,css,scss} | | i18n-arb | `.agents/rules/i18n-arb.md` | **/*.arb | | i18n-guide | `.agents/rules/i18n-guide.md` | always | | infrastructure | `.agents/rules/infrastructure.md

1.3k7d agoDiscuss

study8677AGENTS.md

repobrain / openspec

study8677/repobrain/openspec/AGENTS.md

tasks.md:** ```markdown ## 1. Implementation - [ ] 1.1 Create database schema - [ ] 1.2 Implement API endpoint - [ ] 1.3 Add frontend component - [ ] 1.4 Write tests ``` 5. **Create design.md when needed:** Create `design.md

1.3k3mo agoDiscuss

yjl9903AGENTS.md

AnimeGarden

yjl9903/AnimeGarden/AGENTS.md

Module Organization AnimeGarden is a pnpm/Turborepo monorepo. Apps live in `apps/`: `apps/web` is the frontend Remix app, `apps/server` is the backend with `server` and `cron` service types, and `apps/worker` redirects

1.3k38d agoDiscuss

puppyone-aiAGENTS.md

puppyone-cloud

puppyone-ai/puppyone-cloud/AGENTS.md

external source relationships live in `connections`. ## Active Development Directories - **`backend/`** — Python (FastAPI) backend service - **`frontend/`** — Next.js frontend application - **`cli/`** — Node.js command-line tool (Commander.js) - **`sandbox/`** — Docker sandbox environment (JSON editing

1.3k13d agoDiscuss

coollabsioAGENTS.md

jean

coollabsio/jean/AGENTS.md

camelCase with `#[serde(rename_all = "camelCase")]` (for API/command data)** - Used for: Data passed between frontend and Tauri commands (e.g., `IssueContext`, `PullRequestContext`) - Add `#[serde(rename_all = "camelCase")]` to Rust struct - TypeScript

1.3k8mo agoReads credentialsDiscuss

sipyourdrink-ltdAGENTS.md

bernstein

sipyourdrink-ltd/bernstein/AGENTS.md

write to them manually. - `adversary` - `analyst` - `architect` - `backend` - `ci-fixer` - `devops` - `docs` - `frontend` - `manager` - `ml-engineer` - `prompt-engineer` - `qa` - `resolver` - `retrieval` - `reviewer` - `security` - `visionary` - `vp` ## Documentation duty Every PR that

1.3k9d agoDiscuss

dohoooAGENTS.md

helmor

dohooo/helmor/AGENTS.md

with perf HUD (VITE_HELMOR_PERF_HUD=1) bun run build # tsc + vite build (frontend bundle to dist/) bun run typecheck # tsc --noEmit for frontend AND sidecar bun run lint

1.3k3mo agoDiscuss

heymrunAGENTS.md

heym

heymrun/heym/AGENTS.md

default agent behavior. ## Essential Commands ### Quick Start ```bash ./run.sh # Start all services (postgres, backend, frontend) ./run.sh --no-debug # Start with INFO logging instead of DEBUG ./check.sh # Run frontend lint/typecheck, backend

1.3k5mo agoReads credentialsDiscuss

pnokerAGENTS.md

iot-dc3

pnoker/iot-dc3/AGENTS.md

1.3k3mo agoReads credentialsDiscuss

AgentshireAGENTS.md

Agentshire

Agentshire/Agentshire/AGENTS.md

developers. User docs: [README.md](README.md). ## Tech Stack - **Runtime**: OpenClaw Plugin SDK (Node.js / ESM) - **Frontend**: Three.js + vanilla TypeScript (no framework), Vite build, multi-page entries (game / editor / preview / citizen-editor) - **Protocol

1.3k6mo agoDiscuss

AgentshireAGENTS.md

Agentshire / town-frontend

Agentshire/Agentshire/town-frontend/AGENTS.md

Town Frontend Development Rules > Rules for AI assistants working on `town-frontend/`. Read before any UI/style/text change. ## Brand Color Palette All UI components MUST use these colors. Never invent

1.3k6mo agoDiscuss

d-kimusonAGENTS.md

claude-code-viewer

d-kimuson/claude-code-viewer/AGENTS.md

based client built as a CLI tool serving a Vite application. **Core Architecture**: - Frontend: Vite + TanStack Router + React 19 + TanStack Query - Backend: Hono (standalone server) + Effect-TS (all business logic

1.3k5mo agoDiscuss

MicrosoftAGENTS.md

generative-ai-with-javascript

microsoft/generative-ai-with-javascript/AGENTS.md

Files:** - `app.js` - Express server and OpenAI integration - `public/characters.json` - Character definitions and system prompts - `public/index.html` - Frontend interface - `views/` - EJS templates **Character Configuration:** Edit `public/characters.json` to: - Add new characters - Modify character descriptions

1.3k12mo agoReads credentialsDiscuss

huytieuAGENTS.md

COG-second-brain

huytieu/COG-second-brain/AGENTS.md

work. They encode taste as mechanical rules rather than vibes. --- ### /taste-skill **Description:** Anti-slop frontend skill for **landing pages, portfolios, and redesigns**. Reads the brief, infers the right design direction

1.2k2mo agoDiscuss

heyhuynhgiabuuAGENTS.md

proxypal

heyhuynhgiabuu/proxypal/AGENTS.md

ProxyPal Tauri v2 desktop app — proxy API management with SolidJS frontend and Rust backend. ## Stack - **Frontend:** SolidJS 1.9 + TypeScript 5.6 + Tailwind CSS 3 + Kobalte UI - **Backend:** Rust (Tauri

1.2k18d agoReads credentialsDiscuss

heyhuynhgiabuuAGENTS.md

proxypal / src

heyhuynhgiabuu/proxypal/src/AGENTS.md

Frontend Guidelines (SolidJS + TypeScript) ## Reactivity - Use `createSignal` for local state, `createMemo` for derived values. - Use `createEffect` sparingly; prefer reactive derivations. - Use `splitProps` to separate component-specific props from pass-through

1.2k18d agoDiscuss

heyhuynhgiabuuAGENTS.md

proxypal / src-tauri

heyhuynhgiabuu/proxypal/src-tauri/AGENTS.md

tauri::command]` for all IPC functions. - Return `Result<T, String>` for error propagation to frontend. - Access shared state via `State `. ```rust #[tauri::command] pub fn get_status(state: State ) -> Result

1.2k18d agoDiscuss

polterguyAGENTS.md

magic

polterguy/magic/AGENTS.md

AGENTS.md Magic Cloud is a .NET 10 backend + React/Vite/TypeScript frontend with a Hyperlambda DSL runtime built on the Active Events (slots/signals) pattern. ~30 C# plugin projects live in `plugins/`, each

1.2k2mo agoDiscuss

Ido-LeviAGENTS.md

Hephaestus

Ido-Levi/Hephaestus/AGENTS.md

FastAPI MCP server), `monitoring/` (Guardian & Conductor loops), and shared utilities in `core/`. - `frontend/` is the Vite + React dashboard; run UI tooling from that directory. - `tests/` contains integration suites and `run_all_tests.py

1.2k11mo agoReads credentialsDiscuss

xuzhougengAGENTS.md

wisp-science

xuzhougeng/wisp-science/AGENTS.md

skips the fetch); run `scripts/refresh_model_catalog.sh` to refresh the snapshot before releases. - `ui/`: Leptos frontend. - `ui-tests/`: Playwright tests with mocked Tauri bridge. - `skills/`: bundled scientific workflows. - `docs/superpowers/specs/` and `docs/superpowers/plans/`: architecture

1.2k2mo 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.