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 5Worked for most · soon
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

95k49d agoReviewMountCreate a free account to mount
louislamAGENTS.md

uptime-kuma

louislam/uptime-kuma/AGENTS.md

programming language), even though it is working. - You use AI to reply to our code review comments. You may use AI tools to understand the codebase and as an assistant

No other project uses it yet

94k5d 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

Steady4 mentions in 2 weeks

No other project uses it yet

94k9mo agoReviewMountCreate a free account to mount
All-Hands-AIAGENTS.md

OpenHands

All-Hands-AI/OpenHands/AGENTS.md

Create TDD tests for behavioral changes. Keep tests focused on user behavior and real code paths: - Use Arrange, Act, Assert structure and clear test data. - Avoid duplicate cases and duplicate

1 project uses a version of this

94ktodayReviewMountCreate a free account to mount
home-assistantPipes a download into a shellAGENTS.md

core

home-assistant/core/AGENTS.md

unchecked checkboxes in place so reviewers can see which options were not selected. ## Code review - Start review comments with a short, one-sentence summary of the suggested

No other project uses it yet

92k7d agoReviewMountCreate a free account to mount
Model Context ProtocolReads credentialsAGENTS.md

servers

modelcontextprotocol/servers/AGENTS.md

used, not general-purpose products. **This file holds the _rules_: the conventions a reviewer cites against a diff.** It is loaded in full at the start of every session

No other project uses it yet

92k19d agoReviewMountCreate a free account to mount
storybookjsAGENTS.md

storybook

storybookjs/storybook/AGENTS.md

each skill has a symlink in `.claude/skills/`; add one when you add a skill. ## Code Review Before reviewing a pull request or a diff, read the [`code-review` skill](.agents/skills/code-review/SKILL.md

No other project uses it yet

92k4d agoReviewMountCreate a free account to mount
koala73AGENTS.md

worldmonitor

koala73/worldmonitor/AGENTS.md

that PR after relevant review or CI failures. - Keep explicit diagnosis-only requests, standalone code reviews, and pure explanations read-only. Interpret the whole request and the accepted task scope

Steady6 mentions in 2 weeks

No other project uses it yet

91k1d agoReviewMountCreate a free account to mount
cheaper-inferenceReads credentialsAGENTS.md

OmniRoute

cheaper-inference/OmniRoute/AGENTS.md

broken. Decision tree: `docs/ops/HARD_RULES_DETAIL.md` → Rule 18. **Copilot coverage policy**: When a PR changes production code and coverage is below 60% (statements/lines/functions/branches), do not just report — add or update tests, rerun

Steady33 mentions in 2 weeks

1 project uses a version of this

88k26d agoReviewMountCreate a free account to mount
lobehubReads credentialsAGENTS.md

lobe-chat

lobehub/lobe-chat/AGENTS.md

skill for placement, naming, test location, and how a large file becomes a directory. ### Code Review Before reviewing a PR / diff / branch change, read the **deep-review** skill. Ordinary review

1 project uses a version of this

86k2d agoReviewMountCreate a free account to mount
bytedanceAGENTS.md

deer-flow

bytedance/deer-flow/AGENTS.md

edit a directory, read every `AGENTS.md` from that directory up to this file. Some coding agents do not load the nested files on their own. | Area | Guide | | --- | --- | | Backend: harness, Gateway

Steady13 mentions in 2 weeks

No other project uses it yet

85k5mo agoReviewMountCreate a free account to mount
heygen-comAGENTS.md

hyperframes

heygen-com/hyperframes/docs/AGENTS.md

Never infer product behavior from page titles or old docs. Verify it in current code. - Do not preserve a page merely because it already exists. Merge, rewrite, redirect, or remove

Steady29 mentions in 2 weeks

No other project uses it yet

85k7d agoReviewMountCreate a free account to mount
jesseduffieldAGENTS.md

lazygit

jesseduffield/lazygit/AGENTS.md

follow-up commit. This gives reviewers (and `git bisect`) a clear before/after and proves the test actually exercises the broken code path. This applies only to defects that existed before

Steady4 mentions in 2 weeks

No other project uses it yet

84k6mo agoReviewMountCreate a free account to mount
santiferReads credentialsAGENTS.md

career-ops

santifer/career-ops/AGENTS.md

career-ops project (parent/sibling repos, other codebases on the machine), knowledge from other Claude Code projects on the same machine, and cross-session inferences not written into an in-scope

Surging1 mention in 2 weeks

1 project uses a version of this

83k6d agoReviewMountCreate a free account to mount
santiferAGENTS.md

career-ops / web

santifer/career-ops/web/AGENTS.md

finds the user's files, and it keeps your real pipeline out of it. ## Reviews and scope `web/` is maintained as first-party: functional and correctness fixes are very welcome

Surging1 mention in 2 weeks

1 project uses a version of this

83k6d agoReviewMountCreate a free account to mount
netdataReads credentialsAGENTS.md

netdata

netdata/netdata/AGENTS.md

Review findings are leads until verified against the relevant design or shipped code and its contracts. - A review request alone is read-only, as defined under "When

Steady4 mentions in 2 weeks

No other project uses it yet

81k12d agoReviewMountCreate a free account to mount
ruvnetReads credentialsAGENTS.md

claude-flow

ruvnet/claude-flow/AGENTS.md

type`) | Type | Purpose | |------|---------| | `coordinator` | Orchestrates other agents | | `coder` | Writes code | | `tester` | Writes tests | | `reviewer` | Reviews code | | `architect` | Designs systems | | `researcher` | Analyzes requirements | | `security-architect` | Security design | | `performance-engineer` | Optimization | ### Task

3 projects use a version of this

80k19d agoReviewMountCreate a free account to mount
storytoldAGENTS.md

photocraft

storytold/photocraft/AGENTS.md

agent answers for what it opens and for its review comments. 2. **Check, then claim.** Before writing code, read the issue comments, search pull requests for `#N` and the keywords

No other project uses it yet

80k3d agoReviewMountCreate a free account to mount
MicrosoftReads credentialsAGENTS.md

ai-agents-for-beginners

microsoft/ai-agents-for-beginners/AGENTS.md

Notebooks should execute without errors - README files should be clear and accurate - Follow existing code patterns in the repository - Maintain consistency with other lessons ## Additional Notes ### Common Gotchas 1. **Python

Steady33 mentions in 2 weeks

No other project uses it yet

79k4mo agoReviewMountCreate a free account to mount
MicrosoftReads credentialsAGENTS.md

ai-agents-for-beginners / en

microsoft/ai-agents-for-beginners/translations/en/AGENTS.md

Notebooks should execute without errors - README files should be clear and accurate - Follow existing code patterns in the repository - Maintain consistency with other lessons ## Additional Notes ### Common Gotchas 1. **Python

Steady33 mentions in 2 weeks

No other project uses it yet

79k4mo 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.