AGENTS.md examples from real projects

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

Best matches · from page 18Worked for most · soon

ChaunyzhangAGENTS.md

HiveWard

Chaunyzhang/HiveWard/AGENTS.md

before editing. - Implement from source of truth outward: shared contracts, persistence/schema/migration, service/worker owner, API/projection, frontend projection/UI, tests/gates. - Frontend may project backend truth; frontend must not own lifecycle, approval, session, permission

2464mo agoDiscuss

jontsaiAGENTS.md

openclaw-command-center

jontsai/openclaw-command-center/AGENTS.md

Jobs/scheduler API integration │ ├── linear-sync.js # Linear issue tracker integration │ └── topic-classifier.js # NLP-based topic classification ├── public/ # Frontend assets │ ├── index.html # Main dashboard UI │ ├── jobs.html # AI Jobs management UI │ ├── partials/ # ⭐ Shared HTML partials

2448mo agoDiscuss

tinyhumansaiAGENTS.md

opencompany

tinyhumansai/opencompany/AGENTS.md

under `docs/` is short for `crates/opencompany-core/src/...`; the data the crate embeds and reads (`companies/`, `frontend/`, `vendor/`) stays at the repository root, `../..` from `CARGO_MANIFEST_DIR`. - `crates/opencompany-app`: the Tauri desktop shell

24345d agoDiscuss

CodelyTVAGENTS.md

agent-harness

CodelyTV/agent-harness/AGENTS.md

test ``` # Architecture - Next.js 16, Onion Architecture, DDD. - Paths: - API routes `src/app/api/`. - Frontend `src/app/` - Backend `src/contexts/`. # Documentation - Detailed conventions with examples live in `docs/`. - When working on a task, use this

2422mo agoDiscuss

scitixAGENTS.md

siclaw

scitix/siclaw/AGENTS.md

text Runtime: Node.js >= 22.19.0, ESM-only Language: TypeScript 5.9 strict, .js imports Tests: vitest Frontend: React + Vite + Tailwind Agent: @mariozechner/pi-coding-agent Gateway DB: mysql2 / node:sqlite raw SQL Memory DB: node

2364mo agoDiscuss

ffrolivaAGENTS.md

gflow-cli

ffroliva/gflow-cli/AGENTS.md

private REST API at `aisandbox-pa.googleapis.com` — and, for accounts Google has moved to `flow.google.com`, that frontend's `batchexecute` wire (text-to-video, image-to-video from a local `--initial-frame`, reference

23416d agoReads credentialsDiscuss

VercelAGENTS.md

nostics / playground

vercel-labs/nostics/playground/AGENTS.md

project Learning project for TypeScript. A few buttons backed by a JS library. No frontend framework

23410d agoDiscuss

Google CloudAGENTS.md

race-condition

GoogleCloudPlatform/race-condition/AGENTS.md

2325mo agoReads credentialsDiscuss

aivrarAGENTS.md

portable-hermes-agent

aivrar/portable-hermes-agent/AGENTS.md

dashboard (`web/`) also consumes; **desktop has no build/runtime dependency on the dashboard frontend** — it spawns a headless `hermes serve` backend server (the same gateway `dashboard` serves, minus the browser

2293mo agoReads credentialsDiscuss

intent-hqAGENTS.md

intent

intent-hq/intent/AGENTS.md

/intent-hq/intentd) — Rust backend daemon - `packages/cloudlands-fe` → [intent-hq/cloudlands-fe](https://github.com/intent-hq/cloudlands-fe) — Electron + SvelteKit desktop frontend - `packages/ios` → [intent-hq/ios](https://github.com/intent-hq/ios) — SwiftUI iOS companion app (private) Code lives

22926d agoDiscuss

btsouthAGENTS.md

toolport

btsouth/toolport/AGENTS.md

Working on Toolport Toolport has a React/Vite frontend, a Tauri desktop shell, an optional GTK shell, and a Rust headless gateway. `src-tauri/src/bin/toolport-gateway.rs` owns the gateway protocol and catalog

22427d agoDiscuss

lobu-aiAGENTS.md

lobu

lobu-ai/lobu/AGENTS.md

connector-worker` connector jobs and agent turns (V8 isolates) · `connectors` built-in connectors · `owletto` frontend submodule. - Read the nearest package `AGENTS.md` before editing that package; grep `docs/GOTCHAS.md` when something looks

2233mo agoReads credentialsDiscuss

socai-ioAGENTS.md

socai

socai-io/socai/AGENTS.md

vanilla TypeScript (no UI framework). Bundle identifier `com.socai.app`. Product name lowercase `socai`. Layout: - `app/src/`: frontend — `main.ts`, `styles.css`, `assets/`. - `app/src-tauri/`: Rust shell — `lib.rs`, `tauri.conf.json`, `capabilities/`, `icons/`. - `app/branding/`: icon source-of-truth

2237d agoDiscuss

Maneek21AGENTS.md

Deft

Maneek21/Deft/AGENTS.md

constants ├── docker-compose.yml # Self-host: postgres + app ├── .env.example ├── LICENSE # GNU AGPL v3.0 only └── pnpm-workspace.yaml ``` **Stack:** - Frontend: Next.js 14, App Router, TypeScript, Tailwind CSS, TipTap (editor) - API: Hono on Node.js, TypeScript - Database

2214mo agoReads credentialsDiscuss

Yanyutin753AGENTS.md

LambChat

Yanyutin753/LambChat/AGENTS.md

为本文件在客户端领域的专项细化）。 - **文档**: VitePress，位于 `docs/`。主要目录： | 目录 | 用途 | |------|------| | `src/` | 后端代码 (agents, api, infra, kernel) | | `frontend/` | 前端代码 (Web + Mobile + Desktop) | | `tests/` | Python 测试 (镜像 src/ 结构) | | `deploy/` | docker-compose 单机部署（`deploy.sh

2207mo agoReads credentialsDiscuss

llm-ringAGENTS.md

lmring

llm-ring/lmring/AGENTS.md

track model performance through a leaderboard system. ## Tech Stack Built with modern technologies: - **Frontend**: Next.js 16, React 19, TypeScript 6.0+ - **UI**: shadcn/ui, Tailwind CSS 4 - **State**: Zustand - **Database**: PostgreSQL, DrizzleORM

2197mo agoDiscuss

vixuesAGENTS.md

LeAgent

vixues/LeAgent/AGENTS.md

image, media, skills, │ │ │ # workflow, integration, util) │ │ └── workflow/ # DAG engine, nodes, art pipeline, templates │ └── tests/ ├── frontend/ # React 19 + TypeScript SPA ├── desktop/ # Electron shell (bundled Python runtime) ├── deploy/ # Dockerfile + SQLite-only Compose

2175mo agoReads credentialsDiscuss

shirenchuangAGENTS.md

agentbro

shirenchuang/agentbro/AGENTS.md

this is **AgentBro** is a macOS-only Tauri app (Rust backend + React 19 / TypeScript frontend) that surfaces events from AI coding agents (Claude Code, Codex, Gemini CLI, Cursor, Copilot

2122mo agoReads credentialsDiscuss

lthoanggAGENTS.md

OpenAgentd

lthoangg/OpenAgentd/AGENTS.md

edit. The main local guides are: - Backend: `app/AGENTS.md`, plus `app/agent/AGENTS.md`, `app/api/AGENTS.md`, or `app/services/AGENTS.md`. - Frontend: `web/AGENTS.md` and `web/src/AGENTS.md`. - Native shells: `desktop/AGENTS.md`, `desktop/src-tauri/AGENTS.md`, `mobile/AGENTS.md`, `mobile/src-tauri/AGENTS.md`, and `native/shell-core/AGENTS.md`. - Tests and diagnostics: `tests/AGENTS.md`, `tests/manual/AGENTS.md

2112mo agoDiscuss

lthoanggAGENTS.md

OpenAgentd / desktop

lthoangg/OpenAgentd/desktop/AGENTS.md

sidecar explicitly make -C desktop build # release desktop bundle make -C desktop icons ``` For frontend HMR, run `cd web && bun dev` separately. Root `make dev` is also valid when both

2112mo 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.