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

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

Steady8 mentions in 2 weeks

No other project uses it yet

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

Steady8 mentions in 2 weeks

1 project uses a version of this

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

211k4d 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

195k4d 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

No other project uses it yet

195k4d 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

Steady+17 stars this week

No other project uses it yet

195k4d 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

195k4d agoReviewMountCreate a free account to mount
Significant-GravitasReads credentialsAGENTS.md

AutoGPT / autogpt_platform

Significant-Gravitas/AutoGPT/autogpt_platform/AGENTS.md

retry** — some turn out to be real races in the product code. ### Reviewing/Revising Pull Requests Use `/pr-review` to review a PR or `/pr-address` to address comments. When fetching comments manually

Steady5 mentions in 2 weeks

No other project uses it yet

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