agentleFS

AGENTS.md examples from real projects

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

Best matchesWorked for most · soon
morlutoAGENTS.md

rea

morluto/rea/AGENTS.md

silently expand scope for theoretical robustness. Assess brittleness in touched code during implementation, debugging, review, and maintenance. Fix the producing representation or ownership rule before adding downstream repairs. Normalize once

Steady21 mentions in 2 weeks

No other project uses it yet

461k4d agoReviewMountCreate a free account to mount
morlutoAGENTS.md

rea / website

morluto/rea/website/AGENTS.md

translations extract` after changing source text, and review translated setup prompts, terminology and case-study reasoning for readability. Keep code, commands, URLs, paths and Evidence unchanged. Use inline `code

No other project uses it yet

461k4d agoReviewMountCreate a free account to mount
steipeteAGENTS.md

warelay

steipete/warelay/AGENTS.md

before merge or completion ([gate](.agents/skills/openclaw-pr-maintainer/references/media.md#screenshot-completion-gate)). - Before nontrivial code commit/landing: follow [fresh review](.agents/skills/openclaw-pr-maintainer/SKILL.md#review-and-publish). - **Choose one review route.** Follow [local review](docs/reference/pull-request-review-flow.md#local-review

Steady5 mentions in 2 weeks

No other project uses it yet

395ktodayReviewMountCreate a free account to mount
steipeteAGENTS.md

warelay / scripts

steipete/warelay/scripts/AGENTS.md

/CONTRIBUTING.md#before-you-pr). - PR preparation: `pr` / `pr-lib` own source acquisition, correction reviews, gate bindings. Changing them: read [PR preparation](../docs/reference/scripts/pr-preparation.md). - PR wrapper lifecycle: `pr` / `pr-lib` own supervision

Steady5 mentions in 2 weeks

5 projects use a version of this

395ktodayReviewMountCreate a free account to mount
steipeteAGENTS.md

warelay / ui

steipete/warelay/ui/AGENTS.md

Control UI Guide ## Solid - Before writing, reviewing, or refactoring any Solid code here, read the [Solid skill](../.agents/skills/solid/SKILL.md) in full, the installed `node_modules/solid-js/CHEATSHEET.md` it points to, and the references

Steady5 mentions in 2 weeks

No other project uses it yet

395ktodayReviewMountCreate a free account to mount
steipeteAGENTS.md

clawdis

steipete/clawdis/AGENTS.md

before merge or completion ([gate](.agents/skills/openclaw-pr-maintainer/references/media.md#screenshot-completion-gate)). - Before nontrivial code commit/landing: follow [fresh review](.agents/skills/openclaw-pr-maintainer/SKILL.md#review-and-publish). - **Choose one review route.** Follow [local review](docs/reference/pull-request-review-flow.md#local-review

5 projects use a version of this

394k8d agoReviewMountCreate a free account to mount
steipeteAGENTS.md

clawdis / ui

steipete/clawdis/ui/AGENTS.md

Control UI Guide ## Solid - Before writing, reviewing, or refactoring any Solid code here, read the [Solid skill](../.agents/skills/solid/SKILL.md) in full, the installed `node_modules/solid-js/CHEATSHEET.md` it points to, and the references

4 projects use a version of this

394k8d agoReviewMountCreate a free account to mount
clawdbotAGENTS.md

clawdbot / scripts

clawdbot/clawdbot/scripts/AGENTS.md

/CONTRIBUTING.md#before-you-pr). - PR preparation: `pr` / `pr-lib` own source acquisition, correction reviews, gate bindings. Changing them: read [PR preparation](../docs/reference/scripts/pr-preparation.md). - PR wrapper lifecycle: `pr` / `pr-lib` own supervision

No other project uses it yet

394k16d agoReviewMountCreate a free account to mount
clawdbotAGENTS.md

clawdbot / ui

clawdbot/clawdbot/ui/AGENTS.md

Control UI Guide ## Solid - Before writing, reviewing, or refactoring any Solid code here, read the [Solid skill](../.agents/skills/solid/SKILL.md) in full, the installed `node_modules/solid-js/CHEATSHEET.md` it points to, and the references

No other project uses it yet

394k16d agoReviewMountCreate a free account to mount
molt-botAGENTS.md

clawdbot

molt-bot/clawdbot/AGENTS.md

merge or completion ([gate](.agents/skills/openclaw-pr-maintainer/references/media.md#screenshot-completion-gate)). - Before committing or landing nontrivial code, get fresh review through the permitted workflow and resolve actionable findings unless the user opts

No other project uses it yet

391k40d agoReviewMountCreate a free account to mount
molt-botReads credentialsAGENTS.md

clawdbot / scripts

molt-bot/clawdbot/scripts/AGENTS.md

Actions run URL land in `.local/gates.env` (`REMOTE_GATES_*`) and `.local/prep.md`. Use it for reviewed trusted code when a loaded host makes the local 88-shard run stall-kill; contributor/fork code

3 projects use a version of this

391k40d agoReviewMountCreate a free account to mount
molt-botAGENTS.md

clawdbot / ui

molt-bot/clawdbot/ui/AGENTS.md

separate `control-ui-boot-*` groups in `ui/config/control-ui-chunking.ts`, reducing requests without pulling chat-only code into New Session. Its `entries` record contains the dynamic entry points actually requested by each route

3 projects use a version of this

391k40d agoReviewMountCreate a free account to mount
obraAGENTS.md

superpowers

obra/superpowers/AGENTS.md

theoretical fixes Every PR must solve a real problem that someone actually experienced. "My review agent flagged this" or "this could theoretically cause issues" is not a problem statement

Steady3 mentions in 2 weeks

No other project uses it yet

314k5mo agoReviewMountCreate a free account to mount
DeepSeekReads credentialsAGENTS.md

deepseek-harness

deepseek-ai/deepseek-harness/AGENTS.md

component or state, conversation or Session behavior, or lifecycle, concurrency, subprocess, and teardown code. Its [review principles](docs/defensive-patterns/README.md#why-these-rules) apply per artifact. ## Type safety and documentation Everything compiles

Steady2 mentions in 2 weeks

No other project uses it yet

282k3mo agoReviewMountCreate a free account to mount
DeepSeekAGENTS.md

deepseek-harness

deepseek-ai/deepseek-harness/docs/AGENTS.md

timing, ownership, modality, exceptions, consequences, and non-obvious orientation; delete narration, test walkthroughs, review analysis, and code restatement. Keep the local contract and link its rationale. Use [dsh-prose-standard

Steady2 mentions in 2 weeks

No other project uses it yet

282k3mo agoReviewMountCreate a free account to mount
DeepSeekAGENTS.md

deepseek-harness / system

deepseek-ai/deepseek-harness/native/system/AGENTS.md

packages have one independent version and release workflow. ## Runtime rules - Landlock's argv, exit codes, diagnostics, and fail-closed confinement are defined in [docs/cli-contract.md](docs/cli-contract.md). Do not change them when

Steady2 mentions in 2 weeks

No other project uses it yet

282k3mo agoReviewMountCreate a free account to mount
DeepSeekReads credentialsAGENTS.md

deepseek-harness / client

deepseek-ai/deepseek-harness/packages/client/AGENTS.md

current design; these are the rules you must not violate when writing or reviewing client code: 1. **Two declaration forms**: use `ctx.slots.register({ name, children?, store?, inject? }, Component)` for a parent

Steady2 mentions in 2 weeks

No other project uses it yet

282k3mo agoReviewMountCreate a free account to mount
NousResearchAGENTS.md

hermes-agent / agent

NousResearch/hermes-agent/agent/AGENTS.md

name == ...` chain); `tools/todo_tool.py` is the pattern. ## Message-flow invariants (every change is reviewed against these) - **Prompt caching must not break.** Never alter past context, change toolsets, reload memories, or rebuild

1 project uses a version of this

264k3d agoReviewMountCreate a free account to mount
NousResearchReads credentialsAGENTS.md

hermes-agent

NousResearch/hermes-agent/AGENTS.md

core. Two invariants shape almost every design decision and are the lens for reviewing any change: - **Per-conversation prompt caching is sacred.** Mutating past context, swapping toolsets, reloading memories

No other project uses it yet

264k3d agoReviewMountCreate a free account to mount
NousResearchReads credentialsAGENTS.md

hermes-agent / cron

NousResearch/hermes-agent/cron/AGENTS.md

pool is keyed by home (`cron.max_parallel_jobs` is per profile); and the stale-code yield gate asks `scheduler_ownership.owns_cron_tick_for(home)` / `live_gateway_ticking(home)` instead

1 project uses a version of this

264k3d 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.