agentleFS

AGENTS.md examples from real projects

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

Worked for most · soon
morlutoAGENTS.md

rea

morluto/rea/AGENTS.md

REA is a local-only reverse-engineering tool with shared CLI/MCP workflows. Distinguish observations, derivations, inferences, and unknowns; preserve Evidence provenance and session semantics through both adapters. Provider support and setup live in README.md and its linked guides. Follow the contribution scope and fail-closed integration rule. Do not integrate capabilities while material scope, authority, side-effect, or required verification questions remain unresolved. For new providers or capabilities involving target execution, injection, mutation, or protection recovery, seek the required maintainer scope decision before substantial…

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

Keep this file under 20,000 characters, the size OpenClaw loads whole. Put long rules in the owning guide and leave a one-line pointer here. Design trades correctness against complexity and performance. Choose deliberately; never maximize one axis at others' expense. Task defines scope and authorization; chosen workflow owns execution, review, publication, recovery, and cleanup. Explicit user instructions override skill guidelines and workflow defaults; host limits and required authorization boundaries still apply. Read nearest scoped AGENTS.md and matching guides below in…

6 projects use a version of this

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

clawdbot

molt-bot/clawdbot/AGENTS.md

The task defines scope and authorization; its chosen workflow owns execution, review, publication, recovery, and cleanup. Explicit user instructions take precedence over skill guidelines and workflow defaults; host limits and required authorization boundaries still apply. Read the nearest scoped AGENTS.md and the matching references below, including when changing callers outside an owner's directory. Update instructions at their owner instead of adding competing rules here.

No other project uses it yet

391k37d agoReviewMountCreate a free account to mount
vintaAGENTS.md

awesome-python

vinta/awesome-python/AGENTS.md

An opinionated guide to the best Python frameworks, libraries, and tools. README.md is the source of truth for entries, and website/data/category_intros/ holds the category page intros; website/ renders both into…

No other project uses it yet

333k6d agoReviewMountCreate a free account to mount
obraAGENTS.md

superpowers

obra/superpowers/AGENTS.md

Stop. Read this section before doing anything. This repo has a 94% PR rejection rate. Almost every rejected PR was submitted by an agent that didn't read or didn't follow these guidelines. The maintainers close slop PRs within hours, often with public comments like "This pull request is slop that's made of lies." Your job is to protect your human partner from that outcome. Submitting a low-quality PR doesn't help them — it wastes the maintainers' time, burns your human…

Steady7 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

DeepSeek Harness is an all-plugin Cordis agent harness. Read docs/architecture.md before changing packages/; follow docs/AGENTS.md for documentation. Public APIs are pre-stable; update every consumer. Follow version/status and type acknowledgements. Adjacent migration may add a version-named successor but never move, overwrite, or delete committed generations; predecessors imply neither fallback nor downgrade support. SQLite uses monotonic SCHEMA_VERSION. Acknowledge declared persistence-type changes. Record each externally perceptible breaking change immediately in an upgrade guide. Application launch. Only dsh profiles launch supported Node apps; package…

Steady3 mentions in 2 weeks

No other project uses it yet

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

hermes-agent

NousResearch/hermes-agent/AGENTS.md

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's AGENTS.md loads automatically when you work in that directory; read it before editing there. python scripts/check caps this file at 12k chars and every root-to-area chain at 30k, so it loads whole on 128k+ models: long form goes in the guide. Never give up on the right solution. Hermes is a personal AI agent that runs…

No other project uses it yet

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

ECC

affaan-m/ECC/AGENTS.md

This is a production-ready AI coding plugin providing 68 specialized agents, 286 skills, 94 commands, and automated hook workflows for software development. Version: 2.2.1 Use agents proactively without user prompt: - Complex feature requests → planner - Code just written/modified → code-reviewer - Bug fix or new feature → tdd-guide - Architectural decision → architect - Security-sensitive code → security-reviewer - Brownfield project onboarding → spec-miner - Autonomous loops / loop monitoring → loop-operator - Harness config reliability and cost…

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

Guidance for AI coding agents (and their humans) contributing to TheAlgorithms/Python. This complements — and never overrides — CONTRIBUTING.md. Read that first. This repository is educational: implementations should be clear and correct rather than maximally optimized. Every change goes through CI and the algorithms-keeper bot, both of which reject non-conforming PRs automatically. - Check at least one box in the PR description. The algorithms-keeper bot closes any PR whose "Describe your change" section has no checked box (* [x]). Fill…

Steady25 mentions in 2 weeks

No other project uses it yet

226k3y agoReviewMountCreate a free account to mount
sstAGENTS.md

opencode

sst/opencode/AGENTS.md

Use a short branch name of at most three words, separated by hyphens. Do not use slashes or type prefixes such as feat/ or fix/. Examples: session-recovery, fix-scroll-state, regenerate-sdk. Use conventional commit-style messages and PR titles: type(scope): summary. Valid types are feat, fix, docs, chore, refactor, and test. Scopes are optional; use the affected package or area when helpful, e.g. core, opencode,

2 projects use a version of this

225k27d agoReviewMountCreate a free account to mount
n8n-ioReads credentialsAGENTS.md

n8n

n8n-io/n8n/AGENTS.md

This file provides guidance on how to work with the n8n repository. n8n is a workflow automation platform written in TypeScript, using a monorepo structure managed by pnpm workspaces. It…

No other project uses it yet

210k12d agoReviewMountCreate a free account to mount
firecrawlReads credentialsAGENTS.md

firecrawl

firecrawl/firecrawl/AGENTS.md

Firecrawl is a web scraper API. The directory you have access to is a monorepo: - apps/api has the actual API and worker code - apps/*-sdk are various SDKs When…

Steady13 mentions in 2 weeks

No other project uses it yet

200k17mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

vscode

microsoft/vscode/AGENTS.md

This file provides instructions for AI coding agents working with the VS Code codebase. For detailed project overview, architecture, coding guidelines, and validation steps, see the Copilot Instructions.

7 projects use a version of this

195k12d agoReviewMountCreate a free account to mount
instructkrReads credentialsAGENTS.md

claw-code

instructkr/claw-code/AGENTS.md

Generated: 2026-08-16 Commit: b71afdd Branch: main (Refs = rg count across rust/crates; rust-analyzer references timed out during mapping.)

3 projects use a version of this

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