agentleFS
Sign inSign up

AGENTS.md examples from real projects

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

Most stars first · from page 19Worked for most · soon
MicrosoftAGENTS.md

sre-agent / onboardinglab

microsoft/sre-agent/labs/onboardinglab/AGENTS.md

Help the learner complete this existing ticketing lab. Keep the application and UI unchanged. Read README.md and .github/skills/onboarding-lab/SKILL.md first. You are the local coding assistant. You can inspect this checkout, prepare configuration and run approved setup operations. The deployed Azure SRE Agent investigates the workload and guides the exercises. Do not claim it persisted knowledge merely because you edited a local file or it agreed in conversation. - Identify whether the learner has an assigned agent, an existing azd environment,…

1685mo agoDiscuss
MicrosoftAGENTS.md

sre-agent / zava-aks-postgres

microsoft/sre-agent/labs/zava-aks-postgres/AGENTS.md

Guidance for any AI agent (GitHub Copilot CLI/IDE, Claude Code, Cursor, Codex, etc.) working in this repo. Azure SRE Agent demo — AKS + PostgreSQL e-commerce app with break/fix scenarios and autonomous incident response. When a user clones this repo, guide them through setup: 1. Check prerequisites: az, azd, pwsh, plus Owner/User Access Administrator (or equivalent role-assignment write permission) at subscription scope — install anything missing. (kubectl is not required on the operator workstation: the AKS cluster is private, operator…

1685mo agoDiscuss
MicrosoftAGENTS.md

sre-agent / zava-learning

microsoft/sre-agent/labs/zava-learning/AGENTS.md

Guidance for humans and agents extending this lab. The overriding principle: Alerts describe what a student or operator observes, never the cause. The whole point of the lab is that the SRE Agent diagnoses root cause from telemetry and live configuration. The same symptom (Zava-quiz-launch-failing) is reachable from multiple causes (NSG priority inversion, App Gateway probe, an API at zero replicas). Routing is by symptom, not cause. Likewise, the NSG fault rule is named plausibly (legacy-cross-subnet-deny), not the-bug — the…

1685mo agoDiscuss
MicrosoftAGENTS.md

winget-dsc

microsoft/winget-dsc/AGENTS.md

Follow .github/copilot-instructions.md for repository-specific development guidance. Before filing a GitHub issue in this repository: Before opening a pull request:

15651d agoDiscuss
MicrosoftAGENTS.md

Huabu / vercel-composition-patterns

microsoft/Huabu/.agents/skills/vercel-composition-patterns/AGENTS.md

Version 1.0.0 Engineering January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring React codebases using composition. Humans may also find it useful, but guidance here is optimized for automation and consistency by AI-assisted workflows. Composition patterns for building flexible, maintainable React components. Avoid boolean prop proliferation by using compound components, lifting state, and composing internals. These patterns make codebases easier for both humans and AI agents to work with as they…

1557mo agoDiscuss
MicrosoftAGENTS.md

Huabu / vercel-react-best-practices

microsoft/Huabu/.agents/skills/vercel-react-best-practices/AGENTS.md

Version 1.0.0 Vercel Engineering January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring React and Next.js codebases. Humans may also find it useful, but guidance here is optimized for automation and consistency by AI-assisted workflows. Comprehensive performance optimization guide for React and Next.js applications, designed for AI agents and LLMs. Contains 40+ rules across 8 categories, prioritized by impact from critical (eliminating waterfalls, reducing bundle size) to incremental (advanced patterns). Each…

1557mo agoDiscuss
MicrosoftAGENTS.md

Huabu / external-agent

microsoft/Huabu/apps/server/src/prompt/external-agent/agents.md

Load this guide when work should be handled by a visible Agent conversation instead of direct Space operations. An Agent may use Huabu's default Profile or another available Profile. The huabu Profile is the default. Use another returned Profile ID only when its specialization is useful. The huabu Profile uses Huabu's configured model provider. Other Profiles use their own configured runtimes and do not depend on that provider. For a Huabu Agent, send the first prompt directly. This creates a…

1557mo agoDiscuss
MicrosoftAGENTS.md

simplechat / _features

microsoft/simplechat/docs/_features/agents.md

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

1533mo agoDiscuss
MicrosoftAGENTS.md

moaw

microsoft/moaw/AGENTS.md

MOAW is a repository of workshop content plus the tooling to create, preview, and publish workshops on the MOAW website. Run from the repository root: From CONTRIBUTING.md:

1518mo agoDiscuss
MicrosoftAGENTS.md

moaw / cli

microsoft/moaw/packages/cli/AGENTS.md

Command line tool to create, preview and export workshops using the MOAW platform. Run from repo root (preferred): From packages/cli/README.md:

1518mo agoDiscuss
MicrosoftAGENTS.md

moaw / database

microsoft/moaw/packages/database/AGENTS.md

Generates a JSON database aggregating workshop metadata/content for the website. From repo root: From this package directory:

1518mo agoDiscuss
MicrosoftAGENTS.md

moaw / website

microsoft/moaw/packages/website/AGENTS.md

Angular website for browsing and rendering workshops. From repo root: From this package directory:

1518mo agoDiscuss
MicrosoftAGENTS.md

eval-guide

microsoft/eval-guide/AGENTS.md

This repository contains an AI agent evaluation toolkit for Copilot Studio, grounded in Microsoft's *Practical Guidance on Agent Evaluation* — a 10-step playbook**. The canonical methodology spine is skills/eval-guide/playbook.md. Helps users go from "I don't know where to start with eval" to "I have a plan, test cases, and know how to interpret results" — in one session. No running agent required for planning and test generation. This toolkit provides 6 prompt files in .github/prompts/. When the user's request matches…

1303mo agoDiscuss
MicrosoftAGENTS.md

vscode-copilotstudio

microsoft/vscode-copilotstudio/AGENTS.md

This is the Copilot Studio Extension for Visual Studio Code - a hybrid TypeScript/C# project that provides a full-featured VS Code extension for editing Microsoft Copilot Studio agents. The extension enables developers to clone agents locally, edit components (topics, triggers, actions, knowledge sources) in YAML format, and sync changes bidirectionally with cloud environments. IntelliSense is powered by a Language Server Protocol (LSP) backend written in C#. Current State: Generally Available (GA) Documentation: https://learn.microsoft.com/en-us/microsoft-copilot-studio/visual-studio-code-extension-overview Build constraint: Full .NET restore/build currently depends…

1124mo agoDiscuss
MicrosoftAGENTS.md

teams.ts

microsoft/teams.ts/AGENTS.md

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

10733d agoDiscuss
MicrosoftAGENTS.md

agentic-agile-template

microsoft/agentic-agile-template/AGENTS.md

Universal agent entry point. Any agent reading this repository cold starts here. This file is both orientation reference and onboarding orchestrator. This repository is built on the Agentic-Agile Template — a starter framework for teams adopting structured human-agent collaboration. It provides the process layer that makes agent partnerships repeatable: structured backlogs, spec-first stories, platform adapter context files, built-in governance, and continuous measurement. This file (AGENTS.md) is the single canonical entry point for all AI coding agents. Read it completely before…

964mo agoDiscuss
MicrosoftAGENTS.md

awesome-rayfin

microsoft/awesome-rayfin/AGENTS.md

This repository is the Awesome Rayfin template gallery, not a single Rayfin app. Work primarily in templates/ and keep gallery metadata, manifests, and docs in sync. Templates must work on both Windows and Unix-like systems (macOS/Linux). When adding or modifying scripts: Use Conventional Commits: <type>(<scope>): <description>. See CONTRIBUTING.md for the full reference.

954mo agoDiscuss
MicrosoftAGENTS.md

awesome-rayfin / angular-blankapp

microsoft/awesome-rayfin/templates/angular-blankapp/AGENTS.md

This project ships Rayfin agent context. Load .agents/skills/rayfin/SKILL.md and the rayfin MCP server in .mcp.json before writing Rayfin code. Rayfin docs are version-locked to the packages installed in this project. Prefer the MCP tools searchdocs, getdoc, listdocs, and discoverpackages for examples, API details, and troubleshooting. If MCP is unavailable, run rayfin docs ... from the project root so the CLI reads this project's node_modules. If rayfin is not on PATH, use npx -y @microsoft/rayfin-cli docs ... from the project root.

954mo agoDiscuss
MicrosoftAGENTS.md

awesome-rayfin / campus-scheduler

microsoft/awesome-rayfin/templates/campus-scheduler/AGENTS.md

Notes for whoever — or whatever — edits this template next. They are the things that are not visible from the code, and most of them were learned by getting them wrong first. Do not attach fiction to fact. This app draws real buildings, at true scale, with their real room numbers on them. Every figure it shows is therefore read as the university's own. So each dataset carries a provenance stamp (measured / derived / synthetic), the UI badges…

954mo agoDiscuss
MicrosoftAGENTS.md

awesome-rayfin / fabric-atlas

microsoft/awesome-rayfin/templates/fabric-atlas/AGENTS.md

Fabric Atlas is a React and Rayfin Data App that indexes Microsoft Fabric workspace metadata. It visualizes catalog items, lineage, access, sensitivity, jobs, configuration and team notes. It never stores workspace business data. - Use real Fabric or Rayfin metadata; never add mock production data. - Keep dark and light themes working through semantic tokens in src/global.css. - Use the existing spacing, typography, color and radius tokens. - Keep source comments in English. - Preserve the first-sync gate and staged…

954mo agoDiscuss
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.