AGENTS.md examples from real projects

MicrosoftAGENTS.md

vscode

microsoft/vscode/AGENTS.md

This file provides instructions for AI coding agents working with the VS Code codebase. For detailed project overview, architecture, coding guidelines, and validation steps, see the Copilot Instructions.

MicrosoftAGENTS.md

vscode / references

microsoft/vscode/extensions/copilot/assets/prompts/skills/agent-customization/references/agents.md

Custom personas with specific tools, instructions, and behaviors. Use for orchestrated workflows with role-based tool restrictions. Use reasoning-effort to set the reasoning level for the custom agent's model: The selected model must support the configured level. If omitted, the runtime resolves the effort from the model configuration and, when applicable, the parent agent. Sources: built-in aliases, specific tools, MCP servers (<server>/*), extension tools. Special: [] = no tools, omit = defaults. Body reference: #tool:<name> To discover available tools, check your…

No other project uses it yet

MicrosoftAGENTS.md

vscode / copilotcli

microsoft/vscode/extensions/copilot/src/extension/chatSessions/copilotcli/AGENTS.md

This folder contains the Copilot CLI integration for VS Code Chat. It enables users to open a new Chat window and interact with a Copilot CLI agent instance directly within VS Code. VS Code provides the UI, Copilot CLI SDK provides the smarts. Important: The Copilot CLI agent functionality is powered by the @github/copilot/sdk package. See the SDK package for full type definitions. The integration follows VS Code's platform layering pattern with three layers:

No other project uses it yet

MicrosoftAGENTS.md

vscode / common

microsoft/vscode/extensions/copilot/src/platform/authentication/common/AGENTS.md

IAuthenticationService manages GitHub and Copilot authentication. It provides GitHub sessions (OAuth tokens) and Copilot tokens (CAPI tokens). getGitHubSession requires a kind parameter. Choose thoughtfully: Returns AuthenticationSession (never undefined). Throws if the user cancels. Requires createIfNone with a StrictAuthenticationPresentationOptions containing a localized detail string explaining why auth is needed: Same as above but forces re-authentication even if a session exists. Use when the current token has lost authorization: Returns AuthenticationSession | undefined. Never shows UI. Use when auth is optional: For…

No other project uses it yet

MicrosoftAGENTS.md

vscode / agentHost

microsoft/vscode/src/vs/platform/agentHost/AGENTS.md

Node runtime service construction is documented separately in node/serviceBootstrapping.md. Host startup timings, process-lifetime correlation, and session workload counts are documented in PERFORMANCE.md. Status: COMPLETE (2026-07-01) All waves A–D and gates G-B1, G-C1, G-C2, G-D1 are done. Codex, Claude, and Copilot all use the unified orchestrator path. Codex advertises multipleChats: { fork: true, sideChat: true }. Model-backed peer, fork, and side-chat parity scenarios run in deterministic replay. The operational chat surface (send/abort/model/agent/history) is fully chat-addressed and uniform across harnesses. Session ownership…

No other project uses it yet

MicrosoftAGENTS.md

vscode / state

microsoft/vscode/src/vs/platform/agentHost/common/state/AGENTS.md

This directory contains the VS Code-facing wrappers around the Agent Host Protocol (AHP) state model. Read this before modifying protocol types. The generated protocol includes the Changesets model: The generated copy intentionally carries the optional CreateChatParams.title on top of the .ahp-version source commit 6eec1b91. Until the recorded pin advances to an AHP commit containing this field, preserve or reapply this generated delta when syncing. Neither titles nor initial messages require an additional capability; source-based creation still uses the existing fork…

No other project uses it yet

MicrosoftAGENTS.md

vscode / prompts

microsoft/vscode/src/vs/platform/agentHost/node/copilot/prompts/AGENTS.md

This directory customizes the system prompt for Copilot CLI agent host (ahp+cli) sessions. Read this before changing how the system message is built or adding per-model / per-tool guidance. It mirrors the Copilot extension's extensions/copilot/.../prompts/node/agent/ (agentPrompts), but the agent host runs in its own process and cannot use prompt-tsx, so contributors return plain data the SDK accepts directly. Unless the matching chat.agentHost.copilot.modelCapabilityOverrides entry provides a YAML promptOverrideString or promptOverrideFile containing systemPrompt, resolveSystemMessageConfig(model, context) layers, in order: The per-model prompt override…

No other project uses it yet

MicrosoftAGENTS.md

vscode / node

microsoft/vscode/src/vs/platform/agentHost/test/node/AGENTS.md

For tests in this area that touch the SessionDatabase, they MUST use an in-memory database, not a real database file on disk. Use SessionDatabase.open(':memory:') and see the examples from existing tests.

No other project uses it yet

MicrosoftAGENTS.md

vscode / imageCarousel

microsoft/vscode/src/vs/workbench/contrib/imageCarousel/AGENTS.md

A generic workbench editor for viewing collections of images in a carousel/slideshow UI. Opens as a modal editor pane with navigation arrows, a caption, and a thumbnail strip. The image carousel is a self-contained workbench contribution that follows the custom editor pattern: Clicking an image attachment pill in chat (when chat.imageCarousel.enabled is true) executes the workbench.action.chat.openImageInCarousel command, which collects request attachment images together with response-derived images for the current chat session and opens them in the carousel. MIME types are…

No other project uses it yet

MicrosoftAGENTS.md

PowerToys

microsoft/PowerToys/AGENTS.md

Top-level AI contributor guidance for developing PowerToys - a collection of Windows productivity utilities

No other project uses it yet

MicrosoftAGENTS.md

terminal

microsoft/terminal/AGENTS.md

These rules apply to all public contributions and interactions, no matter how they're done. The entity operating or authorizing the contributions and interactions is responsible for them. AI assistance does not relieve contributors of responsibility for their work. "The AI did it" is not an excuse. Violations may result in contributions being closed without further comment. Cases of deception, evasion, or repeat violations may result in account bans. Allowed: - All AI usage that remains non-public (e.g. questions, reviews, local…

No other project uses it yet

MicrosoftAGENTS.md

playwright

microsoft/playwright/AGENTS.md

playwright-chromium, playwright-firefox, playwright-webkit — per-browser distributions. playwright-browser-chromium, playwright-browser-firefox, playwright-browser-webkit — binary packages. Assume watch is running and code is up to date. Generated files (types, channels, validators) are produced by watch automatically. Runs all lint checks in parallel: eslint, tsc, doclint, check-deps, generate_channels, generate_types, lint-tests, test-types, lint-packages, code-snippet linting, check-dependency-age (every version in package-lock.json must be at least 7 days old). Run flint only before you upload a PR, and only after npm run build. Do not run it before…

No other project uses it yet

MicrosoftAGENTS.md

vcpkg

microsoft/vcpkg/AGENTS.md

No summary in the file. Open it to read it.

MicrosoftAGENTS.md

winget-cli

microsoft/winget-cli/AGENTS.md

Follow .github/copilot-instructions.md for repository-specific development guidance. Before filing a GitHub issue in this repository: Before opening a pull request:

MicrosoftAGENTS.md

onnxruntime

microsoft/onnxruntime/AGENTS.md

This file contains repository-wide guidance for coding agents. See Extending Agent Coding Guidance when adding or updating guidance. Before implementing or reviewing changes, inspect .github/instructions/**/*.instructions.md and parse each file's applyTo scope. Apply every instruction whose scope matches any target or changed path. Unless explicitly stated otherwise, matching instructions apply to both implementation and review. Repository skills are available in .github/skills. Load each skill whose description matches the requested task, subsystem, or behavior. For code reviews, follow the /code-review skill in…

MicrosoftAGENTS.md

fluentui

microsoft/fluentui/AGENTS.md

Instructions in this file are the source of truth, not existing code. This repo contains legacy patterns (especially in v8 packages) that predate current standards. Never copy patterns from existing…

MicrosoftAGENTS.md

mcp-for-beginners

microsoft/mcp-for-beginners/AGENTS.md

MCP for Beginners is an open-source educational curriculum for learning the Model Context Protocol (MCP) - a standardized framework for interactions between AI models and client applications. This repository provides comprehensive learning materials with hands-on code examples across multiple programming languages. This is a documentation-focused repository. Most setup occurs within individual sample projects and labs. Sample projects are located in: - 03-GettingStarted/samples/ - Language-specific examples - 03-GettingStarted/01-first-server/solution/ - First server implementations - 03-GettingStarted/02-client/solution/ - Client implementations - 11-MCPServerHandsOnLabs/ - Comprehensive…

No other project uses it yet

MicrosoftAGENTS.md

mcp-for-beginners / ar

microsoft/mcp-for-beginners/translations/ar/AGENTS.md

MCP للمبتدئين هو منهج تعليمي مفتوح المصدر لتعلم بروتوكول سياق النموذج (MCP) - إطار عمل معياري للتفاعلات بين نماذج الذكاء الاصطناعي وتطبيقات العملاء. يوفر هذا المستودع مواد تعليمية شاملة مع أمثلة تعليمية عملية عبر لغات برمجة متعددة. هذا المستودع موجه للوثائق. يتم معظم الإعداد داخل المشاريع النموذجية والمعامل الفردية. تقع المشاريع النموذجية في: - 03-GettingStarted/samples/ - أمثلة خاصة بكل لغة - 03-GettingStarted/01-first-server/solution/ - تنفيذات الخادم الأولى - 03-GettingStarted/02-client/solution/ - تنفيذات العميل - 11-MCPServerHandsOnLabs/ - معامل تكامل قواعد بيانات شاملة يحتوي…

No other project uses it yet

MicrosoftAGENTS.md

mcp-for-beginners / bg

microsoft/mcp-for-beginners/translations/bg/AGENTS.md

MCP за начинаещи е отворен образователен курс за изучаване на Model Context Protocol (MCP) - стандартизиран рамков протокол за взаимодействия между AI модели и клиентски приложения. Това хранилище предоставя пълни учебни материали с практическо кодиране на няколко програмни езика. Това е подредено хранилище, фокусирано върху документацията. Повечето настройки се извършват в отделни примерни проекти и лаборатории. Примерните проекти се намират в: - 03-GettingStarted/samples/ - Езиково специфични примери - 03-GettingStarted/01-first-server/solution/ - Първи имплементации на сървър - 03-GettingStarted/02-client/solution/ - Клиентски имплементации -…

No other project uses it yet

MicrosoftAGENTS.md

mcp-for-beginners / bn

microsoft/mcp-for-beginners/translations/bn/AGENTS.md

শুরুকারীদের জন্য MCP হল মডেল কন্টেক্সট প্রোটোকল (MCP) শেখার জন্য একটি ওপেন-সোর্স শিক্ষামূলক পাঠক্রম - যা AI মডেল এবং ক্লায়েন্ট অ্যাপ্লিকেশনের মধ্যে যোগাযোগের জন্য একটি মানসম্মত কাঠামো। এই রিপোজিটরিটি বিভিন্ন প্রোগ্রামিং ভাষায় হাতে-কলমে কোড উদাহরণের সাথে ব্যাপক শিক্ষামূলক উপকরণ সরবরাহ করে। এটি একটি ডকুমেন্টেশন-কেন্দ্রিক রিপোজিটরি। বেশিরভাগ সেটআপ আলাদা আলাদা নমুনা প্রকল্প এবং ল্যাবসের মধ্যে হয়। নমুনা প্রকল্পগুলি অবস্থিত: - 03-GettingStarted/samples/ - ভাষা-বিশেষ উদাহরণ - 03-GettingStarted/01-first-server/solution/ - প্রথম সার্ভার বাস্তবায়ন - 03-GettingStarted/02-client/solution/ - ক্লায়েন্ট বাস্তবায়ন - 11-MCPServerHandsOnLabs/ - পূর্ণাঙ্গ ডেটাবেস একীকরণ…

No other project uses it yet