AGENTS.md examples from real projects

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

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Worked for most · soon

saffron-health Hiding risky files

saffron-healthAGENTS.md

libretto

saffron-health/libretto/AGENTS.md

Libretto is an open-source toolkit for building robust web integrations. It gives coding agents a live browser and a token-efficient CLI to inspect pages, capture network traffic, record user actions, and replay them as automation scripts. This is a pnpm monorepo. Root (runs across all packages): Writing rules, from Orwell, 1946. These govern prose: docs, PR text, messages. Never touch code or technical terms; swap in everyday words only where precision survives. Review every prose output against these rules before…

8833mo agoReviewMount

saffron-healthAGENTS.md

libretto

saffron-health/libretto/.deepsec/AGENTS.md

This is a deepsec scanning workspace. Each registered project has its own setup prompt at data/<id>/SETUP.md — open the relevant one when asked to set a project up. - Set up a project for scanning: read data/<id>/SETUP.md and follow it (read node_modules/deepsec/SKILL.md, then fill data/<id>/INFO.md from the target codebase). - Add a new project: run deepsec init-project <root> — it scaffolds data/<id>/ and prints/writes the setup prompt for the new project. - Write a custom matcher (only after a real…

8 projects use a version of this

8833mo agoReviewMount

saffron-healthAGENTS.md

libretto

saffron-health/libretto/docs/AGENTS.md

This top-level docs/ directory is the user-facing Holocron documentation site. Put internal implementation notes and maintainer references under the relevant package instead, such as packages/libretto/docs/. Config in docs.json. Preview with pnpm docs:dev (runs on localhost:5173). A page's file path determines its URL. When adding a page, put it in the folder for the intended URL and register it under the appropriate docs.json tab and group. For example, the "Guides" group contains /guides/* pages from docs/guides/.mdx, while the "Reference" tab contains…

8833mo agoReviewMount

saffron-healthAGENTS.md

libretto

saffron-health/libretto/.opencode/AGENTS.md

This directory contains agent configurations for OpenCode. OpenCode (sst/opencode) is a fast-moving repository. Before modifying agent configs in .opencode/agent/, use the librarian to research the current syntax and conventions: This prevents using deprecated patterns or incorrect tool/permission names.

8833mo agoReviewMount

saffron-healthAGENTS.md

opencode-gui

saffron-health/opencode-gui/AGENTS.md

VSCode extension with SolidJS webview. Two build targets: NEVER wrap a store property lookup in createMemo if downstream consumers need to react to in-place mutations (e.g. produce, push, splice). createMemo compares values with ===. A store proxy reference stays the same after in-place mutations, so the memo silently swallows the update. Use a plain function instead: createMemo is fine for derived computations that produce new values (e.g. .map(), new Map(...), arithmetic). Use the pnpm run publish script to publish the…

599mo agoReviewMount

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.