AGENTS.md examples from real projects

MicrosoftAGENTS.md

mssql-jdbc

microsoft/mssql-jdbc/AGENTS.md

This document provides guidance for AI coding agents working with the mssql-jdbc repository. Before making changes, agents should be aware of: The .github/instructions/ directory contains comprehensive guides: This repository provides reusable prompts in .github/prompts/ for common maintainer workflows. Use these to guide agents through multi-step operations.

No other project uses it yet

MicrosoftAGENTS.md

agentrc

microsoft/agentrc/AGENTS.md

@microsoft/agentrc is a CLI tool (and VS Code extension) that sets up repositories for AI-assisted development. It analyzes repos, generates instruction files, evaluates AI responses, and runs readiness reports. @agentrc/core (in packages/core/) is bundled into the CLI output — it is not an external npm package. Use the @agentrc/core/* path alias for all cross-package imports. Output is ESM ("type": "module"). All node_modules are external except @agentrc/core, @github/copilot-sdk, and vscode-jsonrpc (bundled via noExternal in tsup.config.ts). SDK shim: tsup.config.ts patches getBundledCliPath() in…

MicrosoftAGENTS.md

agentrc / well-tooled-rust

microsoft/agentrc/src/services/__tests__/fixtures/rust-policy/well-tooled-rust/AGENTS.md

Keep the workspace lint, formatting, test, and supply-chain evidence intact.

MicrosoftAGENTS.md

shell-intune-samples

microsoft/shell-intune-samples/AGENTS.md

Canonical entry point for AI agents and human contributors. Read this first. This repository is a curated collection of sample shell scripts maintained by the Microsoft Intune Customer Experience Engineering (CXE) team. The samples show how to manage macOS and Linux devices with Microsoft Intune. They are provided for education and "the art of the possible" — download, test, and adapt them, and run them only in a non-production / test environment. Classification: non-production (samples / learning environment). The full…

MicrosoftAGENTS.md

testfx

microsoft/testfx/AGENTS.md

For repository contributions, read .github/copilot-instructions.md for build, test, encoding and delivery requirements. For applications consuming MTP from agents or CI tools, see MTP for agents and CI tools. Excluded-from-upstream skills and helpers are repository-owned and are NOT checked by gh copilot-curate verify; compare them explicitly on refresh. Details: .agents/skills/CURATION.md Use msbuild as the MSBuild entry point; nine legacy SKILL.md files are excluded from upstream curation. The grading rubric is not forked. Use curation-exceptions for gh copilot-curate update/verify and repository-owned skill…

MicrosoftAGENTS.md

testfx / common

microsoft/testfx/eng/common/AGENTS.md

Files under eng/common come from Arcade. Edits in eng/common will be overwritten by automation unless the changes are made directly in the Arcade repository. For more information, see the Arcade documentation.

MicrosoftAGENTS.md

work-iq

microsoft/work-iq/AGENTS.md

Work IQ is a Copilot CLI plugin marketplace for managing AI agent plugins for GitHub Copilot CLI. It provides MCP servers, skills, and tools that connect AI assistants to Microsoft…

MicrosoftAGENTS.md

work-iq-mcp

microsoft/work-iq-mcp/AGENTS.md

Work IQ is a Copilot CLI plugin marketplace for managing AI agent plugins for GitHub Copilot CLI. It provides MCP servers, skills, and tools that connect AI assistants to Microsoft…

MicrosoftAGENTS.md

vs-threading

microsoft/vs-threading/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…

No other project uses it yet

MicrosoftAGENTS.md

wassette

microsoft/wassette/AGENTS.md

Wassette is an MCP server that runs tools as WebAssembly components with Wasmtime. This file is the entry point for coding agents and contributors; the linked documentation and skills are the canonical sources for detailed guidance. - Contributing: contribution requirements and release-note policy. - Developer guide: prerequisites, repository layout, build, test, lint, documentation, and local CI workflows. - Architecture: system design and component boundaries. - Release process: release automation and versioning. Focused workflows live under .agents/skills/: Agents that support the…

MicrosoftAGENTS.md

MM-REACT / agents

microsoft/MM-REACT/docs/modules/agents/agents.md

Agents use an LLM to determine which actions to take and in what order. An action can either be using a tool and observing its output, or returning to the user. For a list of easily loadable tools, see here. Here are the agents available in LangChain. For a tutorial on how to load agents, see here. This agent uses the ReAct framework to determine which tool to use based solely on the tool's description. Any number of tools can…

MicrosoftAGENTS.md

MM-REACT / use_cases

microsoft/MM-REACT/docs/use_cases/agents.md

Agents are systems that use a language model to interact with other tools. These can be used to do more grounded question/answering, interact with APIs, or even take actions. These agents can be used to power the next generation of personal assistants - systems that intelligently understand what you mean, and then can take actions to help you accomplish your goal. Agents are a core use of LangChain - so much so that there is a whole module dedicated to…

MicrosoftAGENTS.md

vs-streamjsonrpc

microsoft/vs-streamjsonrpc/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…

MicrosoftAGENTS.md

microsoft-ui-reactor

microsoft/microsoft-ui-reactor/AGENTS.md

Reactor is a declarative, component-based C# framework for building WinUI 3 desktop apps. It renders real WinUI controls via a virtual element tree and reconciler — similar to React's programming model but targeting native Windows UI. Every suite runs on Microsoft.Testing.Platform (MTP): global.json pins test.runner, xunit.v3 v4 is MTP-only, and the MSTest projects opt in with EnableMSTestRunner. Practical consequences: the project is still passed positionally (dotnet test tests/Reactor.Tests), but prefer --filter-class / --filter-method / --filter-not-class / --filter-trait on the xUnit…

MicrosoftAGENTS.md

typeagent-py

microsoft/typeagent-py/AGENTS.md

DO NOT BE OBSEQUIOUS **NEVER use TEST_MODEL_NAME or "test" embedding model outside of test files** Never run git commands that make any changes. (git status and git diff are fine) Exceptions: git push, git worktree, git branch (for tracking setup), as instructed below. Exceptions: git push, git worktree, git branch (for tracking setup), as instructed below. NEVER COMMIT CODE. Do not run git commit or any other git commands that make changes to the repository. Exception: Worktrees/Branches below. git add…

MicrosoftAGENTS.md

SymCrypt

microsoft/SymCrypt/AGENTS.md

SymCrypt is Microsoft's core cryptographic function library, used across Windows and other Microsoft products. It is a FIPS 140-validated, security-critical C library with hand-written assembly for performance-critical paths. The Microsoft-internal repository is hosted in Azure DevOps. The public GitHub repository is updated periodically, but may not contain the latest code. For Microsoft internal development, you should always use the Azure DevOps repository. If you have access to Deep Wiki via MCP or web search, you can use it to ask…

MicrosoftAGENTS.md

AL / al-issue-triager

microsoft/AL/.github/agents/al-issue-triager/AGENTS.md

Investigate one public microsoft/AL issue and return exactly one standardized triage comment for the workflow to validate and post. Triage only: never change repository files, create a branch or pull request, post directly to GitHub, close or transfer the issue, assign it, or apply/remove labels. In particular, never apply accepted; a human owns acceptance and the separate internal follow-up process. A report that is independently not reproduced on the latest prerelease product path may instead be scoped as likely fixed;…

MicrosoftAGENTS.md

lage

microsoft/lage/AGENTS.md

This repo is public on GitHub. Do not use MCPs for Azure DevOps (unless the request relates to Azure DevOps pipelines). Lage ("make" in Norwegian) is a task runner for JavaScript/TypeScript monorepos. It pipelines npm scripts across packages so that, for example, test can start as soon as its own package's build finishes rather than waiting for all builds. This is a Yarn Berry (v4) workspace monorepo with ~28 packages under packages/. These commands work from the repo root. When…

MicrosoftAGENTS.md

beachball

microsoft/beachball/AGENTS.md

Trust these instructions. Only search the codebase if information here is incomplete or found to be in error (notify the user if an error is found). Following these steps will minimize failed commands and CI rejections. Beachball is a CLI tool for automating semantic version bumping, changelog generation, and npm publishing in monorepos and single-package repos. This repo is a Yarn 4 monorepo of ~2,000 files. The main deliverable is the beachball npm package. Always run yarn --immutable first if…

MicrosoftAGENTS.md

dotnet-framework-docker

microsoft/dotnet-framework-docker/AGENTS.md

This repository contains the official Docker images for .NET Framework, published to Microsoft Container Registry (mcr.microsoft.com). Images build on each other: runtime → aspnet → wcf, with sdk building on runtime. Each variant supports multiple .NET Framework versions (4.8, 4.8.1) across Windows Server Core versions (ltsc2016, ltsc2019, ltsc2022, ltsc2025). To modify Dockerfiles or READMEs, edit the templates and regenerate: Templates use Cottle syntax with variables from manifest.versions.json: Tests are categorized by image type: runtime, sdk, aspnet, wcf, pre-build. Tests validate…