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

Steady25 mentions in 2 weeks

No other project uses it yet

442k18d 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

Steady25 mentions in 2 weeks

No other project uses it yet

442k18d agoReviewMountCreate a free account to mount
moltbotAGENTS.md

clawdbot

moltbot/clawdbot/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

6 projects use a version of this

394k7d agoReviewMountCreate a free account to mount
moltbotAGENTS.md

clawdbot / scripts

moltbot/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

4 projects use a version of this

394k7d agoReviewMountCreate a free account to mount
moltbotAGENTS.md

clawdbot / ui

moltbot/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

4 projects use a version of this

394k7d 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

1 project uses a version of this

394k14d 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

1 project uses a version of this

394k14d 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

391k38d 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

391k38d 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

Steady7 mentions in 2 weeks

No other project uses it yet

314k5mo 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

Steady3 mentions in 2 weeks

No other project uses it yet

276k3mo 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

Steady3 mentions in 2 weeks

No other project uses it yet

276k3mo 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

No other project uses it yet

262k43d agoReviewMountCreate a free account to mount
NousResearchAGENTS.md

hermes-agent / tests

NousResearch/hermes-agent/tests/AGENTS.md

keep it. Reviewers reject new change-detectors; authors convert them before re-review. ## Never read source code in tests A test that reads a `.py`/`.ts`/`.tsx` file's text

262k43d agoReviewMountCreate a free account to mount
affaan-mAGENTS.md

ECC

affaan-m/ECC/AGENTS.md

design and scalability | Architectural decisions | | tdd-guide | Test-driven development | New features, bug fixes | | code-reviewer | Code quality and maintainability | After writing/modifying code | | security-reviewer | Vulnerability detection | Before commits, sensitive

Steady13 mentions in 2 weeks

No other project uses it yet

246k3mo agoReviewMountCreate a free account to mount
TheAlgorithmsAGENTS.md

Python

TheAlgorithms/Python/AGENTS.md

algorithm file per PR.** Split unrelated changes into separate PRs to keep review focused. - **Don't change code and its doctests in the same PR.** If you're only updating

Steady25 mentions in 2 weeks

No other project uses it yet

226k3y agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

vscode / references

microsoft/vscode/extensions/copilot/assets/prompts/skills/agent-customization/references/agents.md

Supported Events `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `PreCompact`, `SubagentStart`, `SubagentStop`, `Stop` ### Example ```yaml --- description: "Secure code reviewer that blocks dangerous commands" tools: [read, search, execute] hooks: PreToolUse: - type: command command: "./scripts/block-dangerous-cmds.sh

Steady+17 stars this week

No other project uses it yet

195k13d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

vscode / copilotcli

microsoft/vscode/extensions/copilot/src/extension/chatSessions/copilotcli/AGENTS.md

Copilot CLI agent: * File Operations * Shell Operations * Search Operations * Agent & Task Operations * User Interaction * Code Review & Git * Data, Memory & MCP * Security ### `common/copilotCLIPrompt.ts` Parses raw user prompts and extracts structured chat

Steady+17 stars this week

No other project uses it yet

195k13d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

vscode / agentHost

microsoft/vscode/src/vs/platform/agentHost/AGENTS.md

exports the public provider types from `agent.ts` for call-site compatibility; new provider code should import directly from `agent.ts`. ### Customization installation (Skills, MCP servers, catalog plugins) Installation is local-only

No other project uses it yet

195k13d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

vscode / prompts

microsoft/vscode/src/vs/platform/agentHost/node/copilot/prompts/AGENTS.md

other prompt or filesystem inputs to this setting without an explicit security review. Code-managed prompt experiments should still use a contributor (Lever 2) gated

Steady+17 stars this week

No other project uses it yet

195k13d 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.