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

Microsoft Hiding risky files

MicrosoftAGENTS.md

bobpgdemos / caldova-logistics-agent

microsoft/bobpgdemos/caldovalogistics/demo4-foundry-agent/caldova-logistics-agent/AGENTS.md

This project is a Microsoft Foundry hosted agent — a containerized AI agent that runs in Foundry Agent Service. The platform handles containerization, hosting, security, scaling, and observability so you can focus on agent logic. The Azure Developer CLI (azd) manages the full lifecycle: If you are in VS Code, read the vscode-microsoft-foundry skill first. Install the Microsoft Foundry Skill for guided deployment, evaluation, and troubleshooting workflows. Direct install (preferred, works with any coding agent): Or install the Azure Skills…

028d agoReviewMount

MicrosoftAGENTS.md

FixLab

microsoft/FixLab/AGENTS.md

FixLab is a reusable Agency Copilot workflow for turning defects and small enhancements into evidence-backed pull requests. Keep the core product-neutral: repository-specific paths, commands, ports, environments, and browser journeys belong in repository profiles and examples. 1. Read README.md, docs/architecture.md, the nearest AGENTS.md, and any matching .github/instructions/*.instructions.md learned rules. 2. Inspect git status and preserve unrelated worktree changes. 3. Reproduce behavioral defects or define a measurable acceptance check for small enhancements. 4. Make the smallest complete change. 5. Add focused regression…

02mo agoReviewMount

MicrosoftAGENTS.md

FixLab / dashboard

microsoft/FixLab/dashboard/AGENTS.md

Changes in this directory affect local HTTP handling, job execution, process ownership, evidence retention, screenshots, and authenticated work-item intake. - Preserve loopback-only binding and strict request-size limits. - Validate untrusted input before filesystem, process, or network use. - Keep credentials and authorization headers out of responses, logs, prompts, caches, and persisted job state. - Resolve artifact paths beneath verified FixLab-owned roots and reject path traversal and symbolic-link escapes. - Stop only child processes created and tracked by the current job.…

02mo agoReviewMount

MicrosoftAGENTS.md

se-assist

microsoft/se-assist/AGENTS.md

SE Assist is a local-first Windows Electron application for Solution Engineers. Read README.md first, then docs/customer-workspace.md for process boundaries and data flows. There is no active application cloud backend. infra/…

024d agoReviewMount

MicrosoftAGENTS.md

verbose-disco

microsoft/verbose-disco/AGENTS.md

Primary instructions for AI agents operating in this repository.

09mo 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.