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 14Worked for most · soon
MicrosoftAGENTS.md

DebugMCP

microsoft/DebugMCP/AGENTS.md

DebugMCP is a VS Code extension that embeds an MCP (Model Context Protocol) server, enabling AI coding agents to control VS Code's debugger via DAP (Debug Adapter Protocol). AI agents can start/stop debugging, step through code, set breakpoints, inspect variables, and evaluate expressions. IMPORTANT: Keep docs/*.md files up to date when modifying components. These docs should remain high-level: - Purpose and motivation - Responsibility scope - Key concepts and patterns - Pointers to relevant code sections Do NOT duplicate detailed…

5287mo agoDiscuss
MicrosoftAGENTS.md

PowerAppsCodeApps / assets

microsoft/PowerAppsCodeApps/docs/assets/AGENTS.md

You are an assistant to develop code apps in Power Apps. Here is a documentation on how to create Power Apps code apps: https://learn.microsoft.com/en-us/power-apps/developer/code-apps/how-to/create-an-app-from-scratch. Read through it including the referenced documentation to fully understand what code apps are and how to build them. The user will ask you to create, update and deploy code apps. Follow the rules you gathered from the context, and assist the user with their asks. Make sure to use the PAC CLI tool to deploy…

5008mo agoDiscuss
MicrosoftAGENTS.md

vs-mef

microsoft/vs-mef/AGENTS.md

- Review the CONTRIBUTING.md file for instructions to build and test the software. - Run the .github\Prime-ForCopilot.ps1 script (once) before running any dotnet or msbuild commands. If you see any build errors about not finding git objects or a shallow clone, it may be time to run this script again. IMPORTANT: This repository uses Microsoft.Testing.Platform (MTP v2) with xunit v3. Traditional --filter syntax does NOT work. Use the options below instead. Run all tests: Run tests for a specific test…

4653mo agoDiscuss
MicrosoftAGENTS.md

azure-container-apps

microsoft/azure-container-apps/AGENTS.md

This file is read by AI coding agents (GitHub Copilot CLI, Claude Code, Cursor, etc.) working in this repository. Follow these conventions when authoring documentation, samples, skills, or code in this repo. uv is the canonical Python tooling for this repository. When writing docs, skills, samples, or scripts that involve Python, always lead with uv — never lead with bare python, python3, pip, or pip3. 1. Do not lead with pip install … / pip3 install … in any prose,…

4462mo agoPipes a download into a shellDiscuss
MicrosoftAGENTS.md

mssql-django

microsoft/mssql-django/AGENTS.md

Repository context for automated agents and code review. This file holds durable project facts and review judgment. SQL Server limitations, the asmicrosoft extension pattern, and the EXCLUDEDTESTS mechanism are documented…

39914d agoDiscuss
MicrosoftAGENTS.md

agent-host-protocol

microsoft/agent-host-protocol/AGENTS.md

Cross-cutting rules for AI coding agents working in this repository. Per-client codegen conventions are in clients/kotlin/AGENTS.md, clients/swift/AGENTS.md, clients/go/AGENTS.md, and clients/dotnet/AGENTS.md. Editorial rules for protocol types are in .github/instructions/general-instructions.instructions.md. Release mechanics are in RELEASING.md. This repo ships seven independently-versioned artifacts (the spec plus the Rust / Kotlin / Swift / TypeScript / Go / .NET clients), each with its own CHANGELOG.md in Keep-a-Changelog format. The publish workflows refuse to release a tag whose matching ## [X.Y.Z] heading is missing. To avoid…

3728d agoDiscuss
MicrosoftAGENTS.md

agent-host-protocol / dotnet

microsoft/agent-host-protocol/clients/dotnet/AGENTS.md

Conventions for AI coding agents working on the .NET client. Cross-cutting repo rules are in the root AGENTS.md; release mechanics are in RELEASING.md. Generated files are produced by scripts/generate-csharp.ts (run from the repo root via npm run generate:dotnet) from the TypeScript definitions in types/. The generator is modeled on scripts/generate-go.ts and shares its curated struct / enum / union lists — they are protocol-driven, not language-specific. After changing anything under types/, regenerate and commit; CI fails on any diff between…

3728d agoDiscuss
MicrosoftAGENTS.md

agent-host-protocol / go

microsoft/agent-host-protocol/clients/go/AGENTS.md

This directory contains the Go module for the Agent Host Protocol (AHP), published as github.com/microsoft/agent-host-protocol/clients/go. The module targets Go 1.22+ and is split into three packages that mirror the Rust client's three-crate split: - ahptypes/ — generated wire types only, no I/O. - ahp/ — async Client, reducers, and pluggable Transport. Sub- package ahp/hosts/ carries the multi-host runtime. - ahpws/ — WebSocket transport built on github.com/coder/websocket. The Go files under ahptypes/ (except common.go and discriminated_unions.go) are auto-generated from the TypeScript…

3728d agoDiscuss
MicrosoftAGENTS.md

agent-host-protocol / kotlin

microsoft/agent-host-protocol/clients/kotlin/AGENTS.md

This directory contains the Kotlin/JVM client library for the Agent Host Protocol (AHP), distributed via Maven Central as com.microsoft.agenthostprotocol:agent-host-protocol. The library targets pure Kotlin/JVM (Java 8 bytecode, JDK 17 toolchain) so it works for Android consumers, server-side JVM consumers, and KMP/JVM target consumers without any Android-specific dependencies. Only kotlinx-serialization-json is on the classpath at runtime. Types in src/main/kotlin/com/microsoft/agenthostprotocol/generated/ are auto-generated from the TypeScript definitions in types/. Do not edit these files directly. Generated files are committed to source control so…

3728d agoDiscuss
MicrosoftAGENTS.md

agent-host-protocol / swift

microsoft/agent-host-protocol/clients/swift/AGENTS.md

This directory contains two Swift packages for the Agent Host Protocol (AHP): The AgentHostProtocolClient library also ships a multi-host MultiHostClient actor on top of the per-host AHPClient. Single-host consumers can use MultiHostClient.single(_:) to get the same observability surface (event streams, generation-checked handles, persistent client ids) without thinking about a registry. See Sources/AgentHostProtocolClient/Hosts/. Types in AgentHostProtocol/Sources/AgentHostProtocol/Generated/ are auto-generated from the TypeScript definitions in types/. Do not edit these files directly. Generated files are committed to source control so the package is…

3728d agoDiscuss
MicrosoftAGENTS.md

agent-host-protocol / guide

microsoft/agent-host-protocol/docs/guide/agents.md

This page has moved. See State Model for information about agents in the Agent Host Protocol.

3728d agoDiscuss
MicrosoftAGENTS.md

SwiftStreamingMarkdown

microsoft/SwiftStreamingMarkdown/AGENTS.md

Trust these instructions first. Only search the repository if information here is incomplete or wrong. SwiftStreamingMarkdown is a Swift Package that renders Markdown in SwiftUI. It is consumed by Apple-platform apps that need to display Markdown content, either bespoke or incrementally produced by an LLM or other streaming source. The package is iOS-first, distributed via Swift Package Manager only, and ships with a sample app under Examples/. Key technologies: The major components of this library are parsing and rendering. They…

3614mo agoDiscuss
MicrosoftAGENTS.md

Windows-rust-driver-samples

microsoft/Windows-rust-driver-samples/AGENTS.md

Rust ports of Windows driver samples from the official Windows Driver Samples, using crates from windows-drivers-rs. All driver crates target #![no_std] and compile as cdylib for the Windows kernel. Requires EWDK build environment, Clang (LLVM), and cargo-make. CI enforces all of these — run before submitting PRs: Each driver crate follows this file structure: All WDF framework function calls go through the callunsafewdffunctionbinding! macro from wdk-sys. These are always unsafe blocks: WDF structs require their Size field to be set.…

3576mo agoDiscuss
MicrosoftAGENTS.md

ApplicationInsights-Java

microsoft/ApplicationInsights-Java/AGENTS.md

Read CONTRIBUTING.md and copilot-instructions.md first. It is the source of truth for repository layout, build and test commands, style expectations, and scope.

3274mo agoDiscuss
MicrosoftAGENTS.md

Build-CLI

microsoft/Build-CLI/AGENTS.md

This repo packages the Microsoft Events assistant plugin and the @microsoft/events-cli CLI. The plugin helps agents use live Microsoft Build and Ignite session catalogs; the CLI fetches, caches, normalizes, and searches those catalogs. The repo publishes plugin metadata for GitHub Copilot and Claude Code. Keep shared product identity fields aligned across the manifests when changing the plugin name, description, version, author, repository, keywords, license, skills path, or MCP wiring. Shared assets used by the plugin ecosystems: - skills\microsoft-build\SKILL.md — the…

2935mo agoDiscuss
MicrosoftAGENTS.md

model-mondays

microsoft/model-mondays/AGENTS.md

This repository publishes Model Mondays livestream episodes and Foundry Friday on-demand AMAs about AI models, Microsoft Foundry, and agent development. Checked-in JSON and published Markdown must agree. docs/assets/ is the canonical public asset tree. Foundry Fridays is an on-demand initiative, not a season-driven weekly series. AMA numbers are global, unique, and sequential. An AMA may optionally link to a related episode, but no relationship is required. Season 4 is titled Model Spotlights for Agent Builders. For a new episode: For…

2916d agoDiscuss
MicrosoftAGENTS.md

profile-explorer

microsoft/profile-explorer/AGENTS.md

NEVER commit or git add without explicit user permission. When asked for a commit message, provide the message text only - do not execute git commit or git add. IMPORTANT: Always use Release configuration (-c Release). The user runs Release builds, not Debug. If running, ask the user to close it before building. The Core project build is much faster (~2-3s) and doesn't require ProfileExplorer to be closed. The app version lives in 3 files that must stay in lockstep…

2864mo agoDiscuss
MicrosoftAGENTS.md

mggraph-intune-samples

microsoft/mggraph-intune-samples/AGENTS.md

Guidance for AI coding agents and human contributors working in this repository. mggraph-intune-samples is a collection of sample PowerShell scripts that show how to use the Microsoft Graph PowerShell SDK to manage Microsoft Intune (device configuration, compliance, app protection, enrollment, managed devices, reporting, and more). It is a non-production, learning/reference repository: the scripts are meant to be read, adapted, and run by IT pros against their own tenants. It produces no build artifact and is not a dependency of other…

2783mo agoDiscuss
MicrosoftAGENTS.md

powerplatform-vscode

microsoft/powerplatform-vscode/Agents.md

This is the Power Platform VS Code extension that provides tooling for creating, building, and deploying Power Platform solutions, packages, and portals. It integrates the Power Platform CLI (pac) directly into VS Code. - src/client/extension.ts: Main extension entry point - package.json: Extension manifest with commands and contributions - src/client/lib/PacActivityBarUI.ts: Activity bar panels and UI registration - src/client/PortalWebView.ts: Power Pages portal webview management - src/client/pac/PacWrapper.ts: Wrapper for Power Platform CLI commands - src/client/power-pages/actions-hub/ActionsHubTreeDataProvider.ts: Power Pages Actions Hub tree data provider -

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