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

nyldnAGENTS.md

claude-octopus

nyldn/claude-octopus/docs/AGENTS.md

deployment-engineer (haiku - fast) Troubleshooting → devops-troubleshooter (sonnet - specialized) Incidents → incident-responder (sonnet - SRE) ``` ### Documentation & Diagrams 📚 ``` Technical Docs → docs-architect (sonnet - writing) Flowcharts → mermaid-expert (haiku - simple) ``` --- ## Knowledge Work > *When

4.1k49d agoDiscuss

Google DeepMindAGENTS.md

acme / user

google-deepmind/acme/docs/user/agents.md

setup on GCP (`--lp_launch_type=vertex_ai`). For details please refer to [Launchpad documentation](https://github.com/deepmind/launchpad/search?q=%22class+LaunchType%22). We've listed the agents below in separate sections based on their

4.1k4y agoDiscuss

bethingtonAGENTS.md

ghidra-mcp

bethington/ghidra-mcp/AGENTS.md

tools for binary analysis, knowledge database, BSim integration, headless server support, AI documentation workflows ## Directory Structure - `src/` — Java source for Ghidra extension and headless server - `python/bridge_mcp_ghidra/` — Python MCP bridge package

4k7d agoDiscuss

CloudflareAGENTS.md

capnweb / packages

cloudflare/capnweb/packages/docs/AGENTS.md

size, and its fill is a literal hex -- a favicon is its own document and inherits no custom properties. - Reach for `--cw-mark-fill` / `--cw-mark-stroke` to recolour

4k7d agoDiscuss

Gaurav-GosainAGENTS.md

tuios

Gaurav-Gosain/tuios/AGENTS.md

follow when changing it. An agent **running inside a TUIOS pane** wants the other document. Run `tuios --skill` for the core that drives a running session: addressing panes, reading

4k9d agoDiscuss

get-bbAGENTS.md

bb

get-bb/bb/AGENTS.md

Delete accepted-but-ignored route or command fields, or implement them end to end. Document route and command behavior when it is non-obvious. ## Server And Daemon - The server owns

4k8d agoDiscuss

Hugging FaceAGENTS.md

huggingface_hub

huggingface/huggingface_hub/AGENTS.md

Test plan" section. Call out breaking changes explicitly if any. It is important to document any decision taken in the PR or instructions provided in the prompt while working

3.9k6mo agoDiscuss

evalstateAGENTS.md

fast-agent

evalstate/fast-agent/AGENTS.md

generated reference material live under `docs/`; runnable examples live under `examples/`. Keep durable behavior documented closest to its audience and avoid copying generated/default configuration by hand

3.9k8d agoDiscuss

CloudflareAGENTS.md

kumo / kumo-docs-astro

cloudflare/kumo/packages/kumo-docs-astro/AGENTS.md

KUMO DOCS KNOWLEDGE BASE **Generated:** 2026-09-03 | **Commit:** 9b4eb70 | **Branch:** rozenmd/test-preview ## OVERVIEW Astro documentation site for `@cloudflare/kumo`. Static output uses React islands, MDX reference pages, Tailwind v4, and Cloudflare

3.9k2mo agoDiscuss

CloudflareAGENTS.md

kumo / demos

cloudflare/kumo/packages/kumo-docs-astro/src/components/demos/AGENTS.md

DEMOS KNOWLEDGE BASE Executable Kumo examples used by documentation pages, the homepage showcase, visual regression, and component registry generation. ## STRUCTURE ```text demos/ ├── *Demo.tsx # Component-oriented exported examples ├── Chart/ # ECharts

3.9k2mo agoDiscuss

MicrosoftAGENTS.md

apm / hello-world

microsoft/apm/templates/hello-world/AGENTS.md

clean, maintainable code and best practices. You prioritize: - Clear, readable code with good documentation - Test-driven development approaches - Security-first design patterns - Performance optimization where appropriate When working

3.9k14d agoDiscuss

MongoDBAGENTS.md

mongoid

mongodb/mongoid/AGENTS.md

Project Description Mongoid is a Ruby Object-Document Mapper (ODM) framework for MongoDB. Mongoid allows developers to define their data models using Ruby classes, and it handles the mapping between

3.9k14d agoDiscuss

NVIDIAAGENTS.md

k8s-device-plugin

NVIDIA/k8s-device-plugin/AGENTS.md

plugin image. - `deployments/devel/` holds the pinned development toolchain used by `make`. - `docs/` holds additional documentation, including `docs/cdi.md` and `docs/gpu-feature-discovery/`. - `tests/` holds the end-to-end and Helm test suites

3.9k15d agoDiscuss

MicrosoftAGENTS.md

PhiCookBook

microsoft/PhiCookBook/AGENTS.md

Project Overview PhiCookBook is a comprehensive cookbook repository containing hands-on examples, tutorials, and documentation for working with Microsoft's Phi family of Small Language Models (SLMs). The repository demonstrates

3.9k7mo agoDiscuss

MicrosoftAGENTS.md

PhiCookBook / en

microsoft/PhiCookBook/translations/en/AGENTS.md

3.9k7mo agoDiscuss

MicrosoftAGENTS.md

PhiCookBook / fr

microsoft/PhiCookBook/translations/fr/AGENTS.md

dépôt complet de livres de cuisine contenant des exemples pratiques, des tutoriels et une documentation pour travailler avec la famille Phi des Small Language Models (SLM) de Microsoft. Le dépôt

3.9k7mo agoDiscuss

MicrosoftAGENTS.md

PhiCookBook / hi

microsoft/PhiCookBook/translations/hi/AGENTS.md

कार्यान्वयन - **08.RAG/** - रिट्रीवल-ऑगमेंटेड जनरेशन नमूने - **09.UpdateSamples/** - नवीनतम अपडेट किए गए नमूने ### Documentation (`/md/`) - **01.Introduction/** - परिचय गाइड, पर्यावरण सेटअप, प्लेटफार्म मार्गदर्शक - **02.Application/** - प्रकार (टेक्स्ट, कोड, विज़न

3.9k7mo agoDiscuss

MicrosoftAGENTS.md

PhiCookBook / km

microsoft/PhiCookBook/translations/km/AGENTS.md

គំរូកម្មវិធីចាប់ពីដំណាក់កាលដើមទៅចុងក្រោយ - **07.Lab/** - អនុវត្តន៍មន្ទីរសាកល្បង - **08.RAG/** - ឧទាហរណ៍បង្កើតនៃ Retrieval-Augmented Generation - **09.UpdateSamples/** - គំរូដែលបានធ្វើបច្ចុប្បន្នភាពថ្មីៗ ### Documentation (`/md/`) - **01.Introduction/** - មគ្គុទេសក៍ណែនាំ ការកំណត់បរិយាកាស និងមគ្គុទេសក៍វេទិកា - **02.Application/** - គំរូកម្មវិធីតាមប្រភេទ (អត្ថបទ, កូដ, រូបភាព, សម្លេង, ល) - **02.QuickStart

3.9k7mo agoDiscuss

MicrosoftAGENTS.md

PhiCookBook / ko

microsoft/PhiCookBook/translations/ko/AGENTS.md

실험실/시험적 구현 - **08.RAG/** - Retrieval-Augmented Generation 샘플 - **09.UpdateSamples/** - 최신 업데이트 샘플 ### Documentation (`/md/`) - **01.Introduction/** - 소개 가이드, 환경 설정, 플랫폼 안내 - **02.Application/** - 유형별 애플리케이션 샘플 (텍스트

3.9k7mo agoDiscuss

MicrosoftAGENTS.md

PhiCookBook / ml

microsoft/PhiCookBook/translations/ml/AGENTS.md

നടപ്പാക്കലുകൾ - **08.RAG/** - Retrieval-Augmented Generation സാമ്പിളുകൾ - **09.UpdateSamples/** - ഏറ്റവും പുതിയ അപ്ഡേറ്റ് ചെയ്ത സാമ്പിളുകൾ ### Documentation (`/md/`) - **01.Introduction/** - പരിചയപതിപ്പുകൾ, പരിസ്ഥിതി സജ്ജീകരണം, പ്ലാറ്റ്ഫോം മാർഗ്ഗനിർദ്ദേശങ്ങൾ - **02.Application/** - ആപ്ലിക്കേഷൻ സാമ്പിളുകൾ ടൈപ്പുകൾ അനുസരിച്ച് ക്രമീകരിച്ചു

3.9k7mo 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.