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

replica / minimal

github/replica/starters/minimal/AGENTS.md

Read the shared Replica instructions before prototype work. They own task scope, component preflight, canvas setup, publishing and browser validation. This file owns Minimal's app conventions. Minimal uses React, TypeScript, Vite and TanStack Router with hash-based routes. It has no component library. Keep routing and scaffolding local to this app. Use an installed Node.js version matching engines.node in package.json: For checks, run npm run typecheck, npm test, npm run build and npm run format:check. Format authored code with npm run…

23023d agoReviewMountCreate a free account to mount
GitHubAGENTS.md

gh-aw-actions

github/gh-aw-actions/AGENTS.md

GitHub Agentic Workflows is a Go-based GitHub CLI extension for writing agentic workflows in natural language using markdown files, running them as GitHub Actions. gh-aw is a GitHub CLI extension (gh aw) that compiles markdown workflows into GitHub Actions. It is not the GitHub Copilot CLI (copilot command). While workflows can use the Copilot CLI as an AI engine, gh-aw itself is a separate tool for workflow management and compilation. BE LAZY: Skills in skills/ provide detailed, specialized knowledge about…

5130d agoReviewMountCreate a free account to mount
GitHubAGENTS.md

copilot-billing-preview

github/copilot-billing-preview/AGENTS.md

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

326mo agoReviewMountCreate a free account to mount
GitHubAGENTS.md

plugin-marketplace-starter

github/plugin-marketplace-starter/AGENTS.md

Follow README.md, CONTRIBUTING.md, and the guides in docs/ for team setup, package layout, installation, versioning, validation, evals, CI, and host checks. Update those instructions in place; don't duplicate them here. - Scaffold a plugin with npm run new-plugin -- <name> (with --with agent, mcp, hook, or extension, and --no-skill when it has no skill), remove one with npm run remove-plugin -- <name> (remove-example for the shipped examples), and rename the marketplace with npm run rename-marketplace, rather than editing the catalog,…

124d agoReviewMountCreate a free account to mount
GitHubAGENTS.md

evals-action

github/evals-action/AGENTS.md

- Keep this a thin GitHub adapter over the acquired Vally CLI. Translate supported commands and consume native JSONL; never duplicate selection, configuration parsing, grading or execution. - Use Node 24, the pinned pnpm version, and one lockfile. Install with scripts disabled. Run focused tests during development and pnpm check before review. - Rebuild and commit dist after source changes. Never manually edit bundles. - Do not run models, add credentials, publish, merge or change repository visibility without separate authorization.…

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