How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.
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.
MicrosoftAGENTS.mdmicrosoft/rayfin/packages/typescript-sdk/storage/AGENTS.md
This package provides the standalone storage SDK for blob operations (upload, download, list, delete) with typed folder access. Run these from packages/typescript-sdk/storage/:
MicrosoftAGENTS.mdmicrosoft/rayfin/samples/data-app/AGENTS.md
You will help the user build out this React-based web app that visualizes data from Power BI semantic models. The app fetches live data via DAX queries, renders charts and grids using Vega-Lite and a built-in DataGrid component, and supports light/dark theming. Your job is to discover the user's data, write correct DAX queries, build React components that fetch and display that data, and validate the result in the browser. Break tasks into independent pieces and delegate them to sub-agents…
MicrosoftAGENTS.mdmicrosoft/rayfin/samples/universal-app/template/AGENTS.md
Build the requested React and Vite Fabric App from the small authenticated workspace. Turn on only the capabilities the app needs, preserve the protected default and dynamic authentication flow, and validate the result users will actually run. Read the capability-router before writing application code. It owns source selection and the capability decision. Capabilities compose. Apply every selected pack with a separate command, serially, because pack operations mutate workspace manifests and root orchestration. The scaffolder accepts one pack per invocation; do…
MicrosoftAGENTS.mdmicrosoft/ApplicationInsights-dotnet/AGENTS.md
This is the .NET SDK for Azure Monitor / Application Insights, built on OpenTelemetry. It provides the Microsoft.ApplicationInsights family of NuGet packages for instrumenting .NET applications with distributed tracing, metrics, and logging. Platform-specific filters: Everything.Windows.slnf, Everything.Linux.slnf. Key conventions: - Central package management via Directory.Packages.props - Public API tracking in .publicApi/ (update PublicAPI.Unshipped.txt when adding public APIs) - Strong-name signing required The skills/applicationinsights-setup/ folder contains a portable skill that helps developers set up, migrate, or enhance Application Insights 3.x SDK in…
MicrosoftAGENTS.mdmicrosoft/semantic-link-labs/AGENTS.md
This guide provides comprehensive instructions for AI agents working on the Semantic Link Labs (sempy_labs) codebase — an open-source Python library that extends the capabilities of Semantic Link for Microsoft Fabric notebooks. Semantic Link Labs is a community-driven extension library designed for use in Microsoft Fabric notebooks. It provides additional functionalities to work with: Semantic Link Labs depends on the semantic-link-sempy package as specified in pyproject.toml: The library uses the public APIs from sempy.fabric for: - FabricRestClient — HTTP client…
MicrosoftAGENTS.mdmicrosoft/CopilotAdventures/AGENTS.md
CopilotAdventures is an educational repository featuring fantasy-themed coding challenges designed to teach GitHub Copilot's different interaction modes. The repository is organized as follows:
MicrosoftAGENTS.mdmicrosoft/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…
MicrosoftAGENTS.mdmicrosoft/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…
MicrosoftAGENTS.mdmicrosoft/conductor/AGENTS.md
Conductor is a Python 3.12+ CLI that runs multi-agent workflows defined in YAML (parallel and for-each groups, conditional routing, loop-backs, human gates) on several LLM providers. This file is the always-loaded entry point for agents working on Conductor. It holds the rules that apply to every change and routes you to the guide that owns your task. To author or run a workflow, use the bundled Conductor skill (plugins/conductor/skills/conductor/SKILL.md) and the user docs in docs/. - Read every guide the…
MicrosoftAGENTS.mdmicrosoft/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.
MicrosoftAGENTS.mdmicrosoft/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…
MicrosoftAGENTS.mdmicrosoft/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, and the protocol's vocabulary and naming conventions (identifiers, units, booleans, message names, legacy names not to copy) are in .github/instructions/protocol-naming.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…
MicrosoftAGENTS.mdmicrosoft/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…
MicrosoftAGENTS.mdmicrosoft/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, discriminated_unions.go, and unknown_members.go) are auto-generated from the…
MicrosoftAGENTS.mdmicrosoft/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…
MicrosoftAGENTS.mdmicrosoft/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…
MicrosoftAGENTS.mdmicrosoft/agent-host-protocol/docs/guide/agents.md
This page has moved. See State Model for information about agents in the Agent Host Protocol.
MicrosoftPipes a download into a shellAGENTS.mdmicrosoft/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,…
MicrosoftAGENTS.mdmicrosoft/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…
MicrosoftAGENTS.mdmicrosoft/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.…
An open format for instructions to coding agents, read by Codex, Cursor and others. Think of it as a README written for agents.
At the repository root, with more specific files in subdirectories. Agents read the one closest to the file they're editing.
Setup and test commands, code style, and the rules a new contributor would need to know.
Claude Code reads CLAUDE.md. A one-line CLAUDE.md that points at AGENTS.md covers both.
