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
openclawAGENTS.md

openclaw

openclaw/openclaw/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…

394k2d agoReviewMountCreate a free account to mount
openclawAGENTS.md

openclaw

openclaw/openclaw/docs/AGENTS.md

Own docs authoring, published links, docs i18n policy.

1 project uses a version of this

394k2d agoReviewMountCreate a free account to mount
openclawAGENTS.md

openclaw / extensions

openclaw/openclaw/extensions/AGENTS.md

Bundled plugins. Same boundary as third-party plugins.

394k2d agoReviewMountCreate a free account to mount
openclawAGENTS.md

openclaw / scripts

openclaw/openclaw/scripts/AGENTS.md

Own local tooling, script wrappers, generated-artifact helper rules.

394k2d agoReviewMountCreate a free account to mount
openclawAGENTS.md

openclaw / test

openclaw/openclaw/test/AGENTS.md

No summary in the file. Open it to read it.

1 project uses a version of this

394k2d agoReviewMountCreate a free account to mount
openclawAGENTS.md

openclaw / ui

openclaw/openclaw/ui/AGENTS.md

The Control UI and its plugin views use Solid 2 and native primitives; never add Lit or Web Awesome. Solid route modules expose renderSolid(props) from the existing lazy page import. The outlet mounts that renderer once and supplies live data, loaderPending, and presented props; loader updates must preserve page-local state. Keep page imports inside their route's component loader.

394k2d agoReviewMountCreate a free account to mount
openclawAGENTS.md

gogcli

openclaw/gogcli/AGENTS.md

No summary in the file. Open it to read it.

1 project uses a version of this

8.5k10d agoReviewMountCreate a free account to mount
openclawAGENTS.md

Peekaboo

openclaw/Peekaboo/AGENTS.md

No summary in the file. Open it to read it.

5.4k20d agoReviewMountCreate a free account to mount
openclawAGENTS.md

mcporter

openclaw/mcporter/AGENTS.md

No summary in the file. Open it to read it.

Surging9 mentions in 2 weeks

1 project uses a version of this

5.1k10d agoReviewMountCreate a free account to mount
openclawAGENTS.md

acpx

openclaw/acpx/AGENTS.md

This file is for contributors and coding agents working in this repository. Keep it focused on how to develop, validate, and ship acpx. Use these files for the other concerns: When you need implementation detail, prefer the in-repo references below instead of expanding this file into a full technical spec. - GitHub: https://github.com/openclaw/acpx - npm: https://www.npmjs.com/package/acpx - Default branch: main - Runtime: Node.js >=22.13.0 - Source builds: Node.js ^22.22.1 || ^24.11.0 || >=26.0.0 (lint-staged sets the Node 22 minimum; tsdown…

Steady3 mentions in 2 weeks

No other project uses it yet

3.4k27d agoReviewMountCreate a free account to mount
openclawAGENTS.md

acpx

openclaw/acpx/docs/agents.md

Built-in agent registry — every friendly name acpx ships with, the ACP adapter it spawns, the upstream coding agent it wraps, and per-agent notes.

3.4k27d agoReviewMountCreate a free account to mount
openclawAGENTS.md

wacli

openclaw/wacli/AGENTS.md

No summary in the file. Open it to read it.

2.9k5mo agoReviewMountCreate a free account to mount
openclawAGENTS.md

openclaw-windows-node

openclaw/openclaw-windows-node/AGENTS.md

Read-only requests stay read-only. Permission to implement does not grant permission to commit, push, publish, change GitHub metadata, or alter shared runtimes. Preserve unrelated work and use the current task-owned worktree. Start with the reported behavior, its production owner, and the existing tests. Use the task routes below rather than reading every background document. Delegate independent work only when it benefits from separate context; keep one writer per worktree and give each task a bounded objective and evidence requirement. A…

2.2k11d agoReviewMountCreate a free account to mount
openclawAGENTS.md

openclaw-windows-node

openclaw/openclaw-windows-node/docs/AGENTS.md

These rules apply to repository documentation. The root AGENTS.md still owns authorization, validation, runtime safety, and architecture policy. For a documentation task, use the technical-documentation skill. Choose the page's purpose before editing: overview, workflow guide, reference, troubleshooting, historical record, or agent instruction. State its scope, then give one recommended path with prerequisites, steps, observable success, and failure recovery. Keep alternatives after the common path. Use enough explanation to support a correct decision. Do not optimize for line counts or replace…

Surging1 mention in 2 weeks

1 project uses a version of this

2.2k11d agoReviewMountCreate a free account to mount
openclawAGENTS.md

clawsweeper

openclaw/clawsweeper/AGENTS.md

ClawSweeper is the conservative maintenance bot for OpenClaw repositories. Keep changes narrow, evidence-backed, and automation-safe. AGENTS.md is the canonical repository-wide coding-agent policy. Task-specific workflows under .agents/skills/ are opt-in procedures and do not override this file. This repository does not currently maintain AGENT.md, CLAUDE.md, or Cursor aliases; agents that do not discover AGENTS.md automatically must be directed here rather than given a duplicated policy copy. - Main code: src/clawsweeper.ts. - Repair lane code: src/repair/; canonical records live in the Cloudflare Worker,…

2k19d agoReviewMountCreate a free account to mount
openclawAGENTS.md

lobster

openclaw/lobster/AGENTS.md

Guidance for coding assistants operating in this repository.

1.3k5mo agoReviewMountCreate a free account to mount
openclawAGENTS.md

agent-skills

openclaw/agent-skills/AGENTS.md

Public shared skills for agent workflows.

1.1k7d agoReviewMountCreate a free account to mount
openclawAGENTS.md

agent-skills / autoreview

openclaw/agent-skills/skills/autoreview/AGENTS.md

No summary in the file. Open it to read it.

1.1k7d agoReviewMountCreate a free account to mount
openclawAGENTS.md

clawpatch

openclaw/clawpatch/AGENTS.md

clawpatch is a TypeScript CLI. Source lives in src/, with the CLI entry in src/cli.ts, workflow orchestration in src/app.ts and src/workflow.test.ts, and feature mappers under src/mappers/. Tests sit beside implementation files as *.test.ts. Build output is generated into dist/ and should not be edited. User documentation is in docs/; the static website assets are in website/. Use pnpm with Node 22.x (22.13+), 24.x, or 26+ for pnpm 11 and Vitest 5 development. The published CLI continues to support Node 22…

8155mo agoReviewMountCreate a free account to mount
openclawAGENTS.md

nix-openclaw

openclaw/nix-openclaw/AGENTS.md

We are not accepting PRs from non-maintainers. If your handle is not in the Maintainers list below or on https://github.com/orgs/openclaw/people, do not open a PR. Describe your problem and talk…

7194d 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.