AGENTS.md examples from real projects

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

Best matches · from page 25Worked for most · soon

kubeshopAGENTS.md

testkube

kubeshop/testkube/AGENTS.md

variables** → mention them in `AGENTS.md` under "Configuration references" if they affect agent behavior. - **New code-generation or build steps** → add them under "Regenerating artifacts" in `AGENTS.md`. When in doubt

1.7k5y agoDiscuss

phronesis-ioAGENTS.md

eigenflux

phronesis-io/eigenflux/AGENTS.md

area: | Module doc | Covers | |------------|--------| | `conventions.md` | API response format, ID conventions, data models (RawItem, ProcessedItem), coding standards | | `idl_and_db.md` | IDL modification workflow (kitex/hz), hz tool constraints, database migration scripts | | `pipeline.md` | Async messaging

1.7k6mo agoReads credentialsDiscuss

Priivacy-aiAGENTS.md

spec-kitty

Priivacy-ai/spec-kitty/AGENTS.md

record the rationale in the PR if Sonar raises a hotspot. Code change and hotspot review are separate actions. - **PR description must call out remaining Sonar UI work

1.6k4mo agoReads credentialsDiscuss

LynpointAGENTS.md

CyberVerse

Lynpoint/CyberVerse/AGENTS.md

agreement before correction. Bad: “Yes, you’re right, but…” Good: “No. The issue is…” Code Review Rules When reviewing or modifying code: - Do not assume the user’s diagnosis

1.6k4mo agoDiscuss

e2b-devAGENTS.md

infra

e2b-dev/infra/AGENTS.md

applies to all agents. ## Understanding the repository Read [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) before working on or reviewing code here. It describes what each service does, how services interact (sandbox creation, traffic routing

1.6k18d agoDiscuss

DeadWaveWaveAGENTS.md

opencove

DeadWaveWave/opencove/AGENTS.md

relevant module `DEVELOPMENT.md` (linked from root `DEVELOPMENT.md`). 4. **Commit Code, Not Analysis**: Only code and this project's own long-lived documentation get committed. Research reports and per-PR review/acceptance

1.6k7mo agoDiscuss

agentlas-aiAGENTS.md

Agentlas-OS

agentlas-ai/Agentlas-OS/AGENTS.md

commit, push, tag, release, or upload to a public GitHub repository, construct and review an explicit allowlist. Public source and release artifacts may contain only files required

1.6k36d agoReads credentialsDiscuss

KaelioAGENTS.md

ktx

Kaelio/ktx/AGENTS.md

approved metrics, then turns them into reviewable files agents can search and execute. ``` ### Terminology For canonical vocabulary used across docs, code, comments, CLI strings, and error messages — including the disambiguation

1.6k4mo agoDeletes or force-pushesDiscuss

kenryu42AGENTS.md

cc-safety-net

kenryu42/cc-safety-net/AGENTS.md

build a framework; if the fix seems to require one, stop and ask. ## Code Review Rules - Before reviewing, read `REVIEW.md` and apply its review criteria. Its review scope, classification rules

1.6k15d agoDiscuss

krusemediallcAGENTS.md

arcads-claude-code

krusemediallc/arcads-claude-code/AGENTS.md

Code Ad Agent and the GenAI system in Airtable - **Meta Masterclass** — the systems behind scaling Meta ads to 8 figures ($1.2k value) - **Custom GPTs** — ad copywriting, compliance review

1.5k6mo agoReads credentialsDiscuss

OpenAIAGENTS.md

openai-java

openai/openai-java/AGENTS.md

custom-code guidance](scripts/castiron/CUSTOM_CODE.md). Budget changes belong in a separate PR containing only `.castiron-ratchet.json`, with an explicit justification in the PR description. Increases require a **human approving review** before merging

1.5k38d agoReads credentialsDiscuss

fim-aiAGENTS.md

fim-one

fim-ai/fim-one/AGENTS.md

alembic upgrade head` (shared SQLite dev DB desyncs). Write migration files + ORM + code only; apply after merge-back. - **Worktree merge-back**: orchestrator (main conversation) MUST `git merge ` when agent finishes

1.5k15d agoReads credentialsDiscuss

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.