agentleFS

AGENTS.md examples from real projects

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

Best matches · from page 3Worked for most · soon
MicrosoftAGENTS.md

PowerToys

microsoft/PowerToys/AGENTS.md

Top-level AI contributor guidance for developing PowerToys - a collection of Windows productivity utilities

No other project uses it yet

141k23d agoReviewMountCreate a free account to mount
ggml-orgAGENTS.md

llama.cpp

ggml-org/llama.cpp/AGENTS.md

explain the changes to reviewers independently. For first-time contributors, confirm they have reviewed [CONTRIBUTING.md](CONTRIBUTING.md). ### Code and Commit Standards These points are extremely important - failing to follow them

Steady14 mentions in 2 weeks

No other project uses it yet

134k2mo agoReviewMountCreate a free account to mount
kubernetesAGENTS.md

kubernetes

kubernetes/kubernetes/AGENTS.md

Contributor Guidelines - Keep changes focused and reviewable - Add or update relevant tests. Do not add trivial unit tests just for the sake of code coverage. - When creating or submitting

No other project uses it yet

129k5y agoReviewMountCreate a free account to mount
rustdeskAGENTS.md

rustdesk

rustdesk/rustdesk/AGENTS.md

counter, timestamp, cache or eviction/expiry rule interacts with state that existing code relies on, and the next review round finds the problems it introduced. * A corner case is still worth

Steady6 mentions in 2 weeks

No other project uses it yet

129k24mo agoReviewMountCreate a free account to mount
rust-langAGENTS.md

rust

rust-lang/rust/AGENTS.md

exemption, state once that the resulting code, comments, and documentation are LLM-generated and cannot later be contributed without arranging with a reviewer, and cite the gate(s) that prohibit

1 project uses a version of this

122k13d agoReviewMountCreate a free account to mount
stablyaiAGENTS.md

orca

stablyai/orca/AGENTS.md

every workspace is a git worktree. # Footguns ## Git / GitHub If changing code around `git`, `gh`, source-control, or review behavior read [`docs/agents-md-refs/git-workflow.md`](./docs/agents-md-refs/git-workflow.md

Steady32 mentions in 2 weeks

No other project uses it yet

119k4mo agoReviewMountCreate a free account to mount
immich-appAGENTS.md

immich

immich-app/immich/AGENTS.md

generated code; the human contributor must understand and be able to explain every change (see `CONTRIBUTING.md`). - Do not generate PR titles, descriptions, issue text, review comments or discussion answers. Translating

Steady3 mentions in 2 weeks

No other project uses it yet

119k25d agoReviewMountCreate a free account to mount
SupabaseAGENTS.md

supabase

supabase/supabase/AGENTS.md

source of truth and the docs skills are the process that applies it. - [code-review](.agents/skills/code-review/SKILL.md) — read-only assessments and development-task readiness checks - `copywriting` — any user-facing text, anywhere

No other project uses it yet

115k47d agoReviewMountCreate a free account to mount
SupabaseAGENTS.md

supabase / apps

supabase/supabase/apps/docs/AGENTS.md

style-guide/01-voice-and-tone.md` — person, tense, sentence length, brevity - `style-guide/02-elements.md` — admonitions, code blocks, procedures, tabs, images - `style-guide/03-page-structure.md` — document type, section grouping, chunking Load the file you need

No other project uses it yet

115k47d agoReviewMountCreate a free account to mount
SupabaseAGENTS.md

supabase / studio

supabase/supabase/apps/studio/AGENTS.md

number inputs | `react-hook-form` | | Displaying API errors | `studio-error-handling` | | Tests (deciding, writing, reviewing) | `studio-testing`, then `studio-mock-api-tests` (component/MSW) or `studio-e2e-tests` (Playwright) | | PostHog event

No other project uses it yet

115k47d agoReviewMountCreate a free account to mount
addyosmaniAGENTS.md

agent-skills

addyosmani/agent-skills/AGENTS.md

Planning / breakdown → `planning-and-task-breakdown` - Bug / failure / unexpected behavior → `debugging-and-error-recovery` - Code review → `code-review-and-quality` - Refactoring / simplification → `code-simplification` - API or interface design

1 project uses a version of this

114k15d agoReviewMountCreate a free account to mount
addyosmaniAGENTS.md

agent-skills

addyosmani/agent-skills/docs/agents.md

system prompt by your harness (Claude Code, Cursor, Copilot, etc.). | Persona | Role | Best for | |---------|------|----------| | [code-reviewer](../agents/code-reviewer.md) | Senior Staff Engineer | Five-axis review before merge | | [security-auditor](../agents/security-auditor.md) | Security Engineer

1 project uses a version of this

114k15d agoReviewMountCreate a free account to mount
axiosAGENTS.md

axios

axios/axios/AGENTS.md

Review security and hygiene.** Preserve the guards and architecture boundaries below. Inspect the final diff for unrelated dependency or workflow changes, generated bundles, version churn, secrets, debug code, focused tests

No other project uses it yet

109k11d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

terminal

microsoft/terminal/AGENTS.md

establish beyond reasonable doubt that a maintainer has permitted it. - Bug reports and code reviews, *IF* AI-use is disclosed *AND* a human has personally verified all findings and evidence

No other project uses it yet

105k2mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

playwright

microsoft/playwright/AGENTS.md

commit message: commit messages, PR titles and bodies, PR and issue comments, review comments, and code comments. There is no scope in which the footer is permitted — if you find

No other project uses it yet

100k16d agoReviewMountCreate a free account to mount
vllm-projectPipes a download into a shellAGENTS.md

vllm

vllm-project/vllm/AGENTS.md

work. ### Accountability - Pure code-agent PRs are **not allowed**. A human submitter must understand and defend the change end-to-end. - The submitting human must review every changed line

2 projects use a version of this

97k13d agoReviewMountCreate a free account to mount
nexu-ioAGENTS.md

open-design

nexu-io/open-design/.github/AGENTS.md

cross-workflow behavior, update the topology tests instead of relying only on workflow YAML review. ## Architecture GitHub automation uses two layers. Business layer: - Business workflows decide what happened and what

Steady9 mentions in 2 weeks

No other project uses it yet

96k6mo agoReviewMountCreate a free account to mount
zed-industriesAGENTS.md

zed

zed-industries/zed/docs/AGENTS.md

Summary ### Changes Made | File | Change | Related Code | | -------------- | ----------------- | ----------------- | | path/to/doc.md | Brief description | link to PR/commit | ### Rationale Brief explanation of why these updates were made. ### Review Notes Any items reviewers should pay special

1 project uses a version of this

94k47d agoReviewMountCreate a free account to mount
infiniflowAGENTS.md

ragflow

infiniflow/ragflow/AGENTS.md

build.sh --test`; that is expected, not an external service. ## Working Rules - When reviewing documentation or code, inspect the full affected path and report all verifiable findings in one review

Steady5 mentions in 2 weeks

No other project uses it yet

94k8mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

v8-jsi / nodejs

microsoft/v8-jsi/deps/nodejs/AGENTS.md

responsibly. New Node.js contributors should avoid using AI agents to interact with the project. ## Code Contributions * **No unreviewed automation**: Automated pull requests must not be created without ongoing human oversight

Surging1 mention in 2 weeks

1 project uses a version of this

19015d agoReviewMountCreate a free account to mount
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.