AGENTS.md examples from real projects

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

Best matches · from page 6Worked for most · soon

ObservalAGENTS.md

Observal

Observal/Observal/AGENTS.md

TypeScript (web) Vite 6 SPA with TanStack Router, not Next.js. `web/AGENTS.md` is the authoritative frontend reference; the rules below are the short form. - **Auth storage is split.** `observal_access_token

3.7k2mo agoDiscuss

ObservalAGENTS.md

Observal / web

Observal/Observal/web/AGENTS.md

Frontend Vite 6 / React 19 / TypeScript 6 / TanStack Router / Tailwind CSS 4 / Playwright 1.59 ## How users interact with it The web UI is one of three ways to interact with

3.7k2mo agoDiscuss

ElasticAGENTS.md

elasticsearch-net

elastic/elasticsearch-net/AGENTS.md

src/RequestConverter/** - converts Elasticsearch API request examples into .NET client code, with **src/RequestConverter.Console/** as CLI frontend and **src/RequestConverter.Wasm/** as WASM/npm packaging - **tests/** - test projects (see Testing) ### Generated code `src/Elastic.Clients.Elasticsearch/_Generated/` and `src/RequestConverter/_Generated

3.6k57d agoDiscuss

NVIDIAAGENTS.md

TransformerEngine

NVIDIA/TransformerEngine/AGENTS.md

those tests; they do not replace them. For external library dependencies such as cuDNN Frontend, consult the documentation matching the version supported by Transformer Engine rather than assuming behavior from

3.6k7d agoDeletes or force-pushesDiscuss

Ontos-AIAGENTS.md

knowhere

Ontos-AI/knowhere/AGENTS.md

processing │ │ ├── app/ │ │ │ ├── services/document_parser/ # All parser modules │ │ │ └── services/workload/ # Celery task handlers │ │ └── worker.py # Celery entrypoint │ ├── web/ # Frontend (separate repo: knowhere-dashboard) │ └── docs/ # Internal documentation ├── packages/ │ └── shared-python/shared/ # Shared library (pip: knowhere

3.5k5mo agoReads credentialsDiscuss

agentscope-aiAGENTS.md

ReMe

agentscope-ai/ReMe/AGENTS.md

tests/integration/`: service/model tests that may need credentials or external processes. - `reme_studio/`: ReMe Studio frontend source plus the independently published `reme_studio` Python package and `@agentscope-ai/reme_studio` npm static

3.5k42d agoReads credentialsDiscuss

NVIDIAAGENTS.md

cuda-python

NVIDIA/cuda-python/AGENTS.md

findings are discovered, state that explicitly and mention any residual risks or testing gaps. # Frontend tasks When doing frontend design tasks, avoid collapsing into "AI slop" or safe, average-looking

3.4k48d agoDeletes or force-pushesDiscuss

edison7009AGENTS.md

EchoBird

edison7009/EchoBird/AGENTS.md

repo. Read this before modifying code. ## Project shape Tauri desktop app: React + TypeScript + Vite frontend in `src/`, Rust backend in `src-tauri/`. Two-tier tool/feature registries often ship in **both

3.3k18d agoDiscuss

neomjsAGENTS.md

neo

neomjs/neo/AGENTS.md

invariant: wake messages in old transcripts are noise. - **Visual Verification (§visual_verification_protocol):** Debugging frontend UI/layout. - **Authoring / app-work gate (`apps/**`):** Read 1–2 siblings and load `src/Neo.mjs`, `src/core/Base.mjs`, `src/state/Provider.mjs

3.3k5mo agoDiscuss

nexu-ioAGENTS.md

nexu

nexu-io/nexu/AGENTS.md

Biome lint pnpm format # Biome format pnpm test # Vitest pnpm generate-types # OpenAPI spec → frontend SDK ``` After API route/schema changes: `pnpm generate-types` then `pnpm typecheck`. This repo is desktop

3.3k6mo agoReads credentialsDiscuss

xpf0000AGENTS.md

FlyEnv

xpf0000/FlyEnv/AGENTS.md

License**: MIT - **Author**: Pengfei Xu - **Repository**: <https://github.com/xpf0000/FlyEnv> ## Technology Stack ### Core Technologies - **Frontend Framework**: Vue 3 (Composition API) - **Desktop Framework**: Electron 39.8.7 - **Build Tool**: Vite 6.x + esbuild

3.2k5d agoDiscuss

mikeyobrienAGENTS.md

ralph-orchestrator

mikeyobrien/ralph-orchestrator/AGENTS.md

test after code changes. ### Web Dashboard ```bash ralph web # Launch both servers (backend:3000, frontend:5173) npm install # Install all dependencies npm run dev # Dev mode (both

3.1k7mo agoDiscuss

stravuAGENTS.md

crystal

stravu/crystal/AGENTS.md

Project Structure & Module Organization - Root `pnpm` workspace with packages: `main/` (Electron main process, TypeScript), `frontend/` (React + Vite), `shared/` (shared types), and `tests/` (Playwright E2E). - Key paths: `main/src/{services,ipc,utils

3.1k12mo agoReads credentialsDiscuss

Chachamaru127AGENTS.md

claude-code-harness / opencode

Chachamaru127/claude-code-harness/opencode/AGENTS.md

specific skill variants / `hooks/` Hooks / `scripts/` Shell scripts / `src/` TypeScript implementation / `app/` App layer / `frontend/` Frontend implementation / `docs/` Documentation / `templates/` Templates / `tests/` Validation / `go/` Harness v4 Go native engine ([SPEC.md

3.1k48d agoDeletes or force-pushesDiscuss

elie222AGENTS.md

rakazo

elie222/rakazo/AGENTS.md

only when it becomes relevant; do not add explainer text that repeats the interface. Frontends express intent and render state; the backend owns orchestration, authorization, validation, retries, recovery, and provider

3k16d agoReads credentialsDiscuss

silexlabsAGENTS.md

Silex

silexlabs/Silex/AGENTS.md

model provider you prefer — local models included. Silex endorses none in particular. ## Tech Stack - **Frontend**: TypeScript, GrapesJS (visual editor framework), 11ty (static site generation) - **Desktop**: Rust, Tauri v2 - **Build

3k3mo agoDiscuss

GoogleAGENTS.md

osv.dev

google/osv.dev/AGENTS.md

migrate logic to Go.* - `gcp/`: GCP deployment configurations, Cloud Functions, and workers. - `website/`: Frontend assets for the osv.dev website (`frontend3` using `pnpm`) and blog posts (`blog` using Hugo). - `vulnfeeds/`: Vulnerability

2.9k5mo agoDiscuss

Hugging FaceAGENTS.md

tau

huggingface/tau/AGENTS.md

concerns: ```text AgentHarness = reusable agent brain AgentSession = coding-agent environment TUI = one possible frontend ``` Tau should be organized around these layers: ```text tau_ai provider/model streaming layer tau_agent portable

2.9k3mo agoDiscuss

compozyAGENTS.md

compozy / zod

compozy/compozy/.agents/skills/zod/AGENTS.md

MEDIUM (Full Zod is ~17kb gzipped; Zod Mini is ~1.9kb - 85% smaller for frontend-critical bundles) --- ## References 1. [https://zod.dev/](https://zod.dev/) 2. [https://zod.dev/v4](https://zod.dev/v4) 3. [https://github.com/colinhacks/zod](https://github.com/colinhacks/zod)

2.8k6d agoDiscuss

runkidsAGENTS.md

skillshare

runkids/skillshare/AGENTS.md

were not run. ## Hard Limits - Never run `ss`, `skillshare`, `go test`, `make test`, or frontend package scripts on the host. - Never expose, hardcode, or commit secrets, tokens, credentials, or private

2.7k12d 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.