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

391k24d agoReviewMountCreate a free account to mount
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

Steady36 mentions in 2 weeks

No other project uses it yet

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

Steady36 mentions in 2 weeks

No other project uses it yet

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

305k4mo 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

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

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

Steady8 mentions in 2 weeks

No other project uses it yet

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

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

257k30d agoReviewMountCreate a free account to mount
NousResearchReads credentialsAGENTS.md

hermes-agent

NousResearch/hermes-agent/AGENTS.md

Hermes Agent - Development Guide For AI coding assistants and developers working on hermes-agent. This root file is a hub: what applies everywhere, then a routing table. Each area

Steady3 mentions in 2 weeks

No other project uses it yet

257k30d 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

No other project uses it yet

257k30d 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

No other project uses it yet

257k30d 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

Steady32 mentions in 2 weeks

No other project uses it yet

246k2mo agoReviewMountCreate a free account to mount
affaan-mReads credentialsAGENTS.md

ECC

affaan-m/ECC/.codex/AGENTS.md

metadata Available skills: - tdd-workflow — Test-driven development with 80%+ coverage - security-review — Comprehensive security checklist - coding-standards — Universal coding standards - frontend-patterns — React/Next.js patterns - frontend-slides — Viewport-safe HTML

Steady32 mentions in 2 weeks

1 project uses a version of this

246k2mo 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

No other project uses it yet

226k3y agoReviewMountCreate a free account to mount
n8n-ioReads credentialsAGENTS.md

n8n

n8n-io/n8n/AGENTS.md

comprehensive lint, typechecks, and test suites. - For documentation-only changes, review the diff and run `git diff --check`. Skip code tests when no behavior changed. - Report which checks

No other project uses it yet

209k25d 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

194k3d 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

194k3d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

vscode / agentHost

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

# Multi-Chat Architecture > Node runtime service construction is documented separately in [`node/serviceBootstrapping.md`](node/serviceBootstrapping.md). Host

194k3d 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

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