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

tmolavi

tmolaviReads credentialsAGENTS.md

agent-project-discovery-skill / templates

tmolavi/agent-project-discovery-skill/templates/AGENTS.md

Welcome, AI Agent. Treat this repository as a production environment maintained by senior engineers. Before proposing changes, executing commands, or asking questions, you MUST follow the Discovery Protocol defined below. "Understand before you change. Inspect before you ask. Decide autonomously in EVERY project." Act like a senior engineer newly onboarded to this codebase. Do not make assumptions, do not rewrite functional patterns, and do not make changes without establishing your mental model first. Universal Scope: All rules in this policy…

232d agoReviewMount

tmolaviAGENTS.md

n8n-agent-skills

tmolavi/n8n-agent-skills/AGENTS.md

This repository teaches AI coding agents how to build production-grade n8n workflows. Author: Taghi Molavi · Repo: https://github.com/tmolavi/n8n-agent-skills All skills: ./skills/*/SKILL.md Example configs: ./configs/ Tool routing: ./skills/n8n-mcp-tooling/SKILL.md

13mo agoReviewMount

tmolaviAGENTS.md

news-traffic-engine

tmolavi/news-traffic-engine/AGENTS.md

This document guides autonomous AI coding agents (Hermes Agent, Claude Code, Google Antigravity, Cursor, OpenAI Codex, Kimi Code, Windsurf, and GitHub Copilot) on how to discover, invoke, and automate news-traffic-engine. Agents can run commands non-interactively using the CLI:

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