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
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…

44453d agoReviewMountCreate a free account to mount
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…

44453d agoReviewMountCreate a free account to mount
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…

44453d agoReviewMountCreate a free account to mount
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…

44453d agoReviewMountCreate a free account to mount
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.

44453d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

zerotrustassessment

microsoft/zerotrustassessment/AGENTS.md

The Zero Trust Assessment PowerShell module runs tenant assessments and generates reports. This file is the entry point for humans and coding agents. Copilot-specific guidance already lives in .github/copilot-instructions.md, and there are repo skills under .github/skills/. For the full suite, build the module and run Pester: A change is done when verify.ps1 and the relevant tests under code-tests/ pass.

44227d agoReviewMountCreate a free account to mount
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 as_microsoft extension pattern, and the EXCLUDED_TESTS mechanism are documented…

39958d agoReviewMountCreate a free account to mount
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 call_unsafe_wdf_function_binding! macro from wdk-sys. These are always unsafe blocks: WDF structs require their Size field to be set.…

3628mo agoReviewMountCreate a free account to mount
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…

3616mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

slow-cheetah

microsoft/slow-cheetah/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…

3534mo agoReviewMountCreate a free account to mount
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.

3275mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

vscode-azurefunctions

microsoft/vscode-azurefunctions/AGENTS.md

TypeScript VS Code extension creates, configures, debugs, deploys, manages local and Azure Function Apps. Use this map to find narrowest owner before editing; matching .github/instructions/*.instructions.md files hold deeper subsystem rules. Trace behavior end-to-end before editing: package.json contribution or API call -> registration -> command/wizard -> shared service/tree model -> refresh/output -> tests. Interactive Azure authentication follows this chain: Functions -> Azure Resources extension -> @microsoft/vscode-azext-azureauth -> vscode.authentication -> built-in Microsoft Authentication provider.

3219d agoReviewMountCreate a free account to mount
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…

30643d agoReviewMountCreate a free account to mount
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-events\SKILL.md — the…

29316d agoReviewMountCreate a free account to mount
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…

2895mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

SqlScriptDOM

microsoft/SqlScriptDOM/AGENTS.md

This repository keeps its canonical Copilot instruction files in the .github folder and its reusable agent skills in .agents/skills. Before starting work, read .github/copilot-instructions.md for repository-wide guidance. Then use the relevant topic-specific instruction files in .github/instructions/: - adding_new_parser.guidelines.instructions.md - bug_fixing.guidelines.instructions.md - database_option.guidelines.instructions.md - debugging_workflow.guidelines.instructions.md - function.guidelines.instructions.md - grammar_validation.guidelines.instructions.md - grammar.guidelines.instructions.md - new_data_types.guidelines.instructions.md - new_index_types.guidelines.instructions.md - parser.guidelines.instructions.md - testing.guidelines.instructions.md When a reusable skill applies, load it from .agents/skills/: - add-feature/SKILL.md - verify-and-test-tsql-syntax/SKILL.md Version note: - Treat TSql180 as the current vNext/latest…

2847mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

finnts

microsoft/finnts/AGENTS.md

Make changes that are testable, documented, backward-compatible where practical, and R CMD check-clean. If a required check cannot run, state why and name the command that remains to be run.

28241d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

clarity-agent

microsoft/clarity-agent/AGENTS.md

processes/ contains markdown files that act as the control flow — an LLM reads and executes them. src/clarity_agent/ contains Python infrastructure those processes call. clarity.py is the entry point. processes/clarity-agent.md is "main". It checks whether .clarity-protocol/ exists, runs packet_status.py to assess state, and routes to the correct process guide. After any process completes, control returns here. src/clarity_agent/protocol/packet_status.py is the build system / flow controller. It maintains a SHA-256 dependency graph among protocol documents (stored in config.json) and detects when a…

2792mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

clarity-agent / music_library

microsoft/clarity-agent/examples/music_library/AGENTS.md

This file integrates the Clarity Protocol into your AI-assisted development workflow. The Clarity Protocol helps you build systems that actually work by maintaining shared understanding of what you're building, why, and what could go wrong. When building software with AI assistance, three things commonly go wrong: The Clarity Protocol solves this by creating a .clarity-protocol/ directory alongside your code that captures: Think of it as the "missing manual" for your code—the stuff you can't figure out just by reading the…

2792mo agoReviewMountCreate a free account to mount
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 -

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