AGENTS.md examples from real projects

MicrosoftAGENTS.md

agent-governance-toolkit / demos

microsoft/agent-governance-toolkit/examples/demos/AGENTS.md

The demo/ directory contains live demonstrations of AGT capabilities, including real-service walkthroughs and visual dashboards. Demos should help users see the system working end-to-end without changing the core product contract.

MicrosoftAGENTS.md

agent-governance-toolkit / pipelines

microsoft/agent-governance-toolkit/.github/pipelines/AGENTS.md

The pipelines/ directory contains Azure DevOps release automation, especially ESRP-backed publishing flows for Python, npm, NuGet, Rust, and Go artifacts. - Treat every pipeline edit as security-sensitive. - Keep secrets, client IDs, key vault names, and certificate identifiers in pipeline secrets or variables, not inline in YAML. - Pin package-install commands to explicit versions where applicable. - Preserve least privilege and existing release gates. - Prefer comments that explain non-obvious ESRP or platform constraints.

MicrosoftAGENTS.md

agent-governance-toolkit / policy-engine

microsoft/agent-governance-toolkit/policy-engine/AGENTS.md

The policy decision runtime now ships from the registry as agent-control-spec, rebased on the agent-hooks control contract. This tree is what AGT layers on top of it. core/ is a deprecation shim that keeps the historical agent_control_specification_core symbols importable for one release cycle, and sdk/rust/ is AGT's host SDK. Read docs/acs-retarget.md before changing anything here. Use ACS terms when writing issues, docs, tests, and code comments. Do not introduce predecessor project concepts that ACS removed, and do not reintroduce the…

MicrosoftAGENTS.md

rushstack / rushd-wire-e2e-test

microsoft/rushstack/build-tests/rushd-wire-e2e-test/AGENTS.md

This package is governed by an ultra-strict lint policy for generated code. All of the rules below are enabled to error in eslint.config.js via the shared local-node-rig/profiles/default/includes/eslint/flat/mixins/strict-codegen.js mixin. They apply…

MicrosoftAGENTS.md

rushstack / rush-daemon-protocol

microsoft/rushstack/libraries/rush-daemon-protocol/AGENTS.md

This package is governed by an ultra-strict lint policy for generated code. All of the rules below are enabled to error in eslint.config.js via the shared local-node-rig/profiles/default/includes/eslint/flat/mixins/strict-codegen.js mixin. They apply…

MicrosoftAGENTS.md

rushstack / rush-daemon-transport

microsoft/rushstack/libraries/rush-daemon-transport/AGENTS.md

This package is governed by an ultra-strict lint policy for generated code. All of the rules below are enabled to error in eslint.config.js via the shared local-node-rig/profiles/default/includes/eslint/flat/mixins/strict-codegen.js mixin. They apply…

MicrosoftAGENTS.md

rushstack / rush-terminal-renderer

microsoft/rushstack/libraries/rush-terminal-renderer/AGENTS.md

This package is governed by an ultra-strict lint policy for generated code. All of the rules below are enabled to error in eslint.config.js via the shared local-node-rig/profiles/default/includes/eslint/flat/mixins/strict-codegen.js mixin. They apply…

MicrosoftAGENTS.md

aspire

microsoft/aspire/AGENTS.md

Instructions for GitHub Copilot and other AI coding agents working with the Aspire repository. Aspire provides tools, templates, and packages for building observable, production-ready distributed applications. At its core is an app model that defines services, resources, and connections in a code-first approach. When authoring or reviewing a change, check test-selection impact if it: * Adds, removes, or renames a test project. * Adds or changes a CI job, reusable workflow, or run_* selection gate. * Adds or changes a…

MicrosoftAGENTS.md

VFSForGit

microsoft/VFSForGit/AGENTS.md

This file is for AI coding assistants (GitHub Copilot, Claude Code, Cursor, OpenAI Codex, Gemini CLI, Aider, etc.). It captures project-specific knowledge that isn't obvious from a fresh git clone and which routinely trips up agents. See CONTRIBUTING.md for coding standards (StyleCop rules, error handling, exception logging) — do not duplicate those here. The build scripts (scripts\Build.bat and friends) put build outputs one level up from the git working tree. The Readme documents the recommended clone-into-src\ convention, which matches the…

MicrosoftAGENTS.md

CUAWright

microsoft/CUAWright/AGENTS.md

Use Python 3.12 for desktop work. Install with: Keep the browser and desktop runtimes separate: Do not introduce a universal agent/model/environment abstraction or duplicate the browser runtime under another package. Preserve webwright compatibility aliases. Keep provider-specific private integrations outside this repository. Never save credentials or custom endpoint URLs in run artifacts, examples, or diagnostics. Before changing desktop prompts, read src/cuawright/desktop/config/prompts.py in full. Plain final text never completes a desktop task; the Actor must execute the standalone command python /opt/cuawright-tools/submit.py. Official…

MicrosoftAGENTS.md

typespec

microsoft/typespec/AGENTS.md

Alloy is a code generation framework using JSX components. Before working with Alloy code, read the relevant docs from installed packages. Your training data may be outdated — these docs match your installed version.

No other project uses it yet

MicrosoftDeletes or force-pushesAGENTS.md

azurelinux

microsoft/azurelinux/AGENTS.md

For project context and architecture, see .github/copilot-instructions.md. USE YOUR BEST JUDGEMENT, but when in doubt, test. If your change could affect the built RPMs, smoke-test before reporting success. See azldev-mock. Isolated latest-only local builds: Validate local component builds in a clean, task-specific mock root, exposing only the newest available RPM version per package name and architecture across all enabled repositories, including local repositories. Historical RPMs and previously installed dependencies must not mask missing or incompatible prerequisites. best=1 alone does not…

MicrosoftAGENTS.md

azurelinux / comps

microsoft/azurelinux/base/comps/AGENTS.md

Redirect azldev's project outputs into the container's writable artifacts mount. For example, save /artifacts/container.toml inside the container: Then run from the rendered tree:

MicrosoftAGENTS.md

azurelinux / distro

microsoft/azurelinux/distro/AGENTS.md

⚠️ Distro-wide config — changes here affect every component build. (See azldev.toml — distro/ is shared across all projects.) Default upstream: Fedora 43 (in azurelinux.distro.toml), unless overridden by a component's spec source.

No other project uses it yet

MicrosoftReads credentialsAGENTS.md

SynapseML

microsoft/SynapseML/AGENTS.md

Use this file for repository-wide rules. Human contributors should start with CONTRIBUTING.md. 1. Resolve the target branch (the PR base, not merely the checked-out feature branch), then use the branch context skill. 2. Read versions from build.sbt and environment.yml. Do not copy version numbers into this shared guide. 3. Use the narrowest relevant repository skill: Scala changes, local setup, and code review. 4. For requests to make one or more issues or PRs "5/5", "200% ready", or merge-ready, use the…

MicrosoftAGENTS.md

poml

microsoft/poml/AGENTS.md

This repository contains a TypeScript/JavaScript project together with a lite Python SDK. These instructions are for agents like Codex to contribute changes. After your changes you must verify that everything still builds and tests pass. Execute the following commands from the repository root: If you have updated the VS Code extension, please run the extension tests with: Update the component specifications if you have updated the type annotations and documentations of the components. Use clear titles and summaries. Include relevant…

MicrosoftAGENTS.md

fluentui-blazor

microsoft/fluentui-blazor/AGENTS.md

This file provides context and instructions for AI coding agents working on the Microsoft Fluent UI Blazor components library. This is a .NET Blazor component library that provides Fluent UI design system components for Blazor applications. The library wraps Microsoft's official Fluent UI Web Components and provides additional components leveraging the Fluent Design System. Unit tests are in tests/Core/Components/ mirroring the component structure in src/Core/Components/. Follow Conventional Commits:

No other project uses it yet

MicrosoftAGENTS.md

WindowsAppSDK

microsoft/WindowsAppSDK/AGENTS.md

Comprehensive guidance for AI contributions to the Windows App SDK. The SDK follows this organization: For C#/C++/IDL files: For XAML files:

MicrosoftReads credentialsAGENTS.md

AI-Engineering-Coach

microsoft/AI-Engineering-Coach/AGENTS.md

VS Code extension that analyzes local AI session logs and surfaces insights in a webview dashboard. Read-only, zero telemetry, all analysis runs on the user's machine.

MicrosoftAGENTS.md

apm / hello-world

microsoft/apm/templates/hello-world/AGENTS.md

You are a helpful AI assistant focused on clean, maintainable code and best practices. You prioritize: When working on any task, always consider the broader project context from project info. This is a demonstration project showcasing APM (Agent Primitives Manager) primitives compilation into AGENTS.md format. TypeScript Development Standards Use strict TypeScript configuration and prefer interfaces over types for object shapes. Implement proper generic constraints and avoid any type. Code Structure - Use barrel exports for clean imports - Implement proper…

No other project uses it yet