AGENTS.md examples from real projects

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

Best matches · from page 7Worked for most · soon

runkidsAGENTS.md

skillshare / website

runkids/skillshare/website/AGENTS.md

parent `../AGENTS.md` for CLI/Go codebase details and the project-wide rules (run frontend tooling inside the devcontainer, never on the host). ## Commands ```bash pnpm start # Dev server with hot reload

2.7k12d agoDiscuss

felinicsAGENTS.md

Memoh

felinics/Memoh/AGENTS.md

2.6k4d agoDiscuss

samanhappyAGENTS.md

mcphub

samanhappy/mcphub/AGENTS.md

Scoped guides - [Architecture and data/auth invariants](docs/agents/architecture.md) - [Development workflow and troubleshooting](docs/agents/development.md) - [TypeScript and frontend conventions](docs/agents/typescript-and-frontend.md) - [Testing](docs/agents/testing.md) - [API and CLI changes](docs/agents/api-and-cli.md) - [Git and contribution workflow](docs/agents/git-and-contribution.md) - [Agent

2.5k29d agoDiscuss

dstackaiAGENTS.md

dstack

dstackai/dstack/AGENTS.md

src/tests` and mirror package paths; add new suites alongside the code they cover. - Frontend lives in `frontend` (React/webpack) and is built into `src/dstack/_internal/server/statics`. - Docs sources are in `mkdocs/docs/` with extra

2.3k20mo agoDiscuss

AmoyLabAGENTS.md

Unla

AmoyLab/Unla/agents.md

handles configuration management. 3. `web`: A lightweight React-based admin frontend, used for managing services conveniently. 4. `mock-server`: A mock downstream service, used for simulating target systems

2.2k16mo agoDiscuss

DicklesworthstoneAGENTS.md

mcp_agent_mail

Dicklesworthstone/mcp_agent_mail/AGENTS.md

agent-mail mail status .`. 2) Across different repos in one project (e.g., Next.js frontend + FastAPI backend) - Option A (single project bus): register both sides under the same `project_key` (shared

2.2k4mo agoPipes a download into a shellDiscuss

Kritt-aiAGENTS.md

open-kritt

Kritt-ai/open-kritt/AGENTS.md

security vulnerability scanner. It's a **polyglot monorepo** of cooperating services: | Path | What | Stack | | ---------------- | --------------------------------------------- | ----------------------------- | | `frontend/` | Web UI | React 18 + Vite (npm) | | `backend/` | HTTP API | Node + Express + Prisma (npm) | | `engine/` | Scan

2.2k2mo agoReads credentialsDiscuss

cjo4m06AGENTS.md

mcp-shrimp-task-manager

cjo4m06/mcp-shrimp-task-manager/docs/agents.md

agent creation - Template sharing and export ### Agent Specializations | Agent Type | Best For | Example Tasks | |------------|----------|---------------| | **Frontend Developer** | UI/UX implementation | React components, CSS styling | | **Backend Engineer** | Server-side logic | API endpoints, database

2.2k18mo agoDiscuss

CloudflareAGENTS.md

templates / x402-proxy-template

cloudflare/templates/x402-proxy-template/AGENTS.md

persisting - Must be HTTPS (cookies have `Secure` flag) - Check `SameSite=Strict` compatibility with your frontend - Cookies are valid for 1 hour after payment ### "JWT_SECRET not set" (500) on protected

2.1k9mo agoDiscuss

alpic-aiAGENTS.md

skybridge

alpic-ai/skybridge/AGENTS.md

apps` spec (JSON-RPC postMessage) Developers write one server (backend) and view(s) (frontend). Skybridge detects the runtime at load time. For deep understanding, read `docs/get-started/` and `docs/api-reference/`. ## Monorepo layout

2.1k28d agoDiscuss

4thfeverAGENTS.md

cultivation-world-simulator

4thfever/cultivation-world-simulator/AGENTS.md

tests/test_data_paths_runtime_contract.py`, `tests/test_docker_runtime_smoke.py`, `tests/test_nginx_proxy_contract.py`, `tests/test_server_binding.py`, `README.md`, `docs/readme/*.md` | Docker 场景统一走 `CWS_DATA_DIR` 持久化；容器不得因无人连接自动退出；frontend 健康检查要反映 backend 代理链路可用；生产镜像只装 runtime 依赖；相关改动必须补 contract/smoke 测试与文档。 | | `.cursor/rules/external-control-api.mdc` | `src/server/**/*.py`, `web/src/api/**/*.ts`, `web/src/stores

2.1k2mo agoReads credentialsDiscuss

MicrosoftAGENTS.md

vscode-eslint

microsoft/vscode-eslint/agents.md

Structure (Relevant Directories) | Path | Purpose | |------|---------| | `package.json` | Extension manifest, contributes settings/commands/tasks, build scripts. | | `client/` | Extension (frontend) code – activation, LSP client, task provider, status integration. | | `server/` | LSP server implementation – lint orchestration, diagnostics

2k12mo agoDiscuss

xu-xiangAGENTS.md

everything-claude-code-zh

xu-xiang/everything-claude-code-zh/.codex/AGENTS.md

可用技能： - tdd-workflow — 测试驱动开发（TDD），包含 80% 以上的覆盖率 - security-review — 全面的安全自查清单 - coding-standards — 通用编码规范 - frontend-patterns — React/Next.js 模式 - frontend-slides — 视口安全（Viewport-safe）的 HTML 演示文稿及 PPTX 转 Web 转换工具

1.9k7mo agoDiscuss

vstorm-coAGENTS.md

full-stack-ai-agent-template

vstorm-co/full-stack-ai-agent-template/AGENTS.md

cookiecutter.json # ~120 variables ├── hooks/post_gen_project.py # Cleanup & formatting └── {{cookiecutter.project_slug}}/ ├── backend/app/ # FastAPI (agents, rag, services, repos) └── frontend/ # Next.js 15 (optional) ``` Jinja2 conditionals: `{%- if cookiecutter.enable_rag %}...{%- endif %}` ## Key Features - **5 AI Frameworks**: PydanticAI

1.9k6mo agoDiscuss

ginlix-aiAGENTS.md

LangAlpha

ginlix-ai/LangAlpha/AGENTS.md

Edit here, not there. ## Common Commands ```bash make up # full stack (postgres, redis, backend, frontend); auto-detects sandbox make config # interactive setup wizard (LLM, data, sandbox, search) make help

1.8k5d agoReads credentialsDiscuss

ginlix-aiAGENTS.md

LangAlpha / desktop

ginlix-ai/LangAlpha/desktop/AGENTS.md

running stack, and launches the shell against it. `--web-env ` builds the frontend the way another environment builds it and `--platform ` runs the saas edition, which together make a hosted

1.8k5d agoReads credentialsDiscuss

ginlix-aiAGENTS.md

LangAlpha / web

ginlix-ai/LangAlpha/web/AGENTS.md

langalpha web Frontend for langalpha — React 19 + Vite + TypeScript SPA. Talks to the FastAPI backend over REST (axios) + SSE (raw fetch). Path alias `@` → `src/` (wired in both `vite.config.js` and `vitest.config.ts

1.8k5d agoDiscuss

Google CloudAGENTS.md

scion

GoogleCloudPlatform/scion/AGENTS.md

agent instructions for their respective areas of the codebase. | Path | Domain | |------|--------| | [`web/AGENTS.md`](web/AGENTS.md) | Web frontend (Lit components, Shoelace, Vite build) | | [`docs-site/AGENTS.md`](docs-site/AGENTS.md) | Documentation site | ### Before

1.7k3mo agoDiscuss

Google CloudAGENTS.md

scion / default

GoogleCloudPlatform/scion/pkg/config/embeds/templates/default/agents.md

blocked: `sciontool status blocked " "` For example: `sciontool status blocked "Waiting for agent deploy-frontend to complete"` This prevents the system from falsely marking you as stalled. You do not need

1.7k3mo agoDiscuss

Google CloudAGENTS.md

scion / web-dev

GoogleCloudPlatform/scion/.scion/templates/web-dev/agents.md

user another question like "what would you like to do now?" just stop. ## Frontend Developer You are focused on front end development, begin by reviewing the instructions in @web/AGENTS.md

1.7k3mo 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.