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

cover finalization. Before adding complexity for a speculative or vanishingly unlikely race or security edge case, explain the concrete failure mode, likelihood, and complexity cost to the user

Steady21 mentions in 2 weeks

No other project uses it yet

461k5d agoReviewMountCreate a free account to mount
molt-botAGENTS.md

clawdbot

molt-bot/clawdbot/AGENTS.md

writers, reported incidents. - Before adding complexity for a speculative or vanishingly unlikely race or security edge case, explain the concrete failure mode, likelihood, and complexity cost to the user

Steady5 mentions in 2 weeks

No other project uses it yet

395ktodayReviewMountCreate a free account to mount
steipeteAGENTS.md

clawdis

steipete/clawdis/AGENTS.md

incidents. No engineering for millisecond races, theoretical interleavings, or adversarial timing unless user data, security, or money at risk, or a real incident shows them. - Prefer cheap mechanisms: idempotency keys

5 projects use a version of this

394k8d agoReviewMountCreate a free account to mount
DeepSeekReads credentialsAGENTS.md

deepseek-harness

deepseek-ai/deepseek-harness/AGENTS.md

DEFAULT_*` constant or test hook is not configurability. Protocol constants, external specs, and security invariants stay fixed. - **Misconfiguration fails loud** at load when self-contained, otherwise at the earliest resolvable

Steady2 mentions in 2 weeks

No other project uses it yet

282k3mo agoReviewMountCreate a free account to mount
DeepSeekAGENTS.md

deepseek-harness / experimental

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

packages through `devDependencies`; examples may load them explicitly. - Experimental status does not relax engineering, security, documentation, lifecycle, testing, or snapshot requirements. - Publishing an experimental package does not promote

No other project uses it yet

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

hermes-agent

NousResearch/hermes-agent/AGENTS.md

contract tests; E2E with real imports against a temp `HERMES_HOME` for resolution, config, security and I/O changes; salvage by cherry-pick so authorship survives. **Rejected even when well-built

No other project uses it yet

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

hermes-agent / hermes_cli

NousResearch/hermes-agent/hermes_cli/AGENTS.md

automatically. Top-level sections (non-exhaustive): `model, agent, terminal, compression, display, stt, tts, memory, security, delegation, smart_model_routing, checkpoints, auxiliary, curator, skills, gateway, logging, cron, profiles, plugins`. `auxiliary

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

hermes-agent / skills

NousResearch/hermes-agent/skills/AGENTS.md

autonomous-ai-agents, blockchain, communication, creative, devops, email, health, mcp, migration, mlops, productivity, research, security, web-development`. Reviewing a skill PR: check the target directory — heavy-dep or niche skills

No other project uses it yet

264k3d agoReviewMountCreate a free account to mount
affaan-mAGENTS.md

ECC

affaan-m/ECC/AGENTS.md

domain tasks 2. **Test-Driven** — Write tests before implementation, 80%+ coverage required 3. **Security-First** — Never compromise on security; validate all inputs 4. **Immutability** — Always create new objects, never mutate

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

coding, tests, formatting | GPT 5.5 | | Complex features, architecture | GPT 5.5 | | Debugging, refactoring | GPT 5.5 | | Security review | GPT 5.5 | ## Skills Discovery Skills are auto-loaded from `.agents/skills/`. Each skill contains: - `SKILL.md

Steady8 mentions in 2 weeks

1 project uses a version of this

246k3mo agoReviewMountCreate a free account to mount
anomalycoAGENTS.md

opencode

anomalyco/opencode/AGENTS.md

improves the caller. - Before adding complexity for a speculative or vanishingly unlikely race or security edge case, explain the concrete failure mode, likelihood, and complexity cost to the user

1 project uses a version of this

227k29d agoReviewMountCreate a free account to mount
n8n-ioReads credentialsAGENTS.md

n8n

n8n-io/n8n/AGENTS.md

ticket in Linear - use the branch name suggested by Linear, **unless it is a security fix** (see Security Fix Hygiene below) - Use mermaid diagrams in MD files when you need

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

/hooks.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

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

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 prompt references (files, locations, diagnostics) ### `node/copilotcliPromptResolver.ts

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

FAMILY`, which is process-scoped and would leak across every session in the window. > **Security note.** The setting is application-scoped (not workspace-configurable) and forwarded to the agent host

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

Store**: Marketplace for sharing agent templates 5. **Virus Scanning**: ClamAV integration for file upload security ### Environment Configuration #### Configuration Files - **Backend**: `backend/.env.default` (defaults) → `backend/.env` (user overrides) - **Frontend**: `frontend/.env.default` (defaults) → `frontend/.env` (user

Steady5 mentions in 2 weeks

No other project uses it yet

188k3d agoReviewMountCreate a free account to mount
DietrichGebertAGENTS.md

ponytail

DietrichGebert/ponytail/AGENTS.md

unfinished: new non-trivial logic (a branch, a loop, a parser, money or security, or a whole new script or app) leaves one small test or an assert-based self

Surging16 mentions in 2 weeks

1 project uses a version of this

182k5mo agoReviewMountCreate a free account to mount
Hugging FaceAGENTS.md

transformers

huggingface/transformers/.ai/AGENTS.md

only affects fresh pretrains with a nonstandard config, so it doesn't count. Security bugs are the exception. A bug report needs a short reproducer that you have

No other project uses it yet

169k6d agoReviewMountCreate a free account to mount
clash-verge-revAGENTS.md

clash-verge-rev

clash-verge-rev/clash-verge-rev/AGENTS.md

required issue is missing, ask maintainers to open or approve one before implementing. For security-sensitive fixes that cannot be tracked publicly, follow maintainer-approved private tracking. 2. **Scope discipline

No other project uses it yet

159k27d agoReviewMountCreate a free account to mount
LangChainReads credentialsAGENTS.md

langchain

langchain-ai/langchain/AGENTS.md

document provides context to understand the LangChain Python project and assist with development. ## Corridor security analysis When Corridor's `analyzePlan` tool is available, create a plan and use the tool

No other project uses it yet

150k54d 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.