AGENTS.md examples from real projects

DeepSeekAGENTS.md

deepseek-harness / workspace

deepseek-ai/deepseek-harness/snapshots/session/agent-instructions-group-failure/workspace/.agents/AGENTS.md

Original global instruction A.

No other project uses it yet

DeepSeekAGENTS.md

deepseek-harness / workspace

deepseek-ai/deepseek-harness/snapshots/session/agent-instructions/workspace/.agents/AGENTS.md

Shared agents-root snapshot instruction.

No other project uses it yet

DeepSeekAGENTS.md

deepseek-harness / workspace

deepseek-ai/deepseek-harness/snapshots/session/ptc-workspace-context/workspace/AGENTS.md

Workspace snapshot root instruction.

No other project uses it yet

DeepSeekAGENTS.md

deepseek-harness / nested

deepseek-ai/deepseek-harness/snapshots/session/ptc-workspace-context/workspace/nested/AGENTS.md

When asked for the Code Mode workspace handshake, answer exactly CODE_MODE_CONTEXT_OK and nothing else.

No other project uses it yet

DeepSeekAGENTS.md

deepseek-harness / website

deepseek-ai/deepseek-harness/website/AGENTS.md

Follow the root instructions, the documentation standard, and the documentation workflow. website/ owns only VitePress configuration, presentation assets, and the publication manifest. This file is the only maintained Markdown file in this subtree. Keep canonical prose and generated catalogs in their owning docs/ tier, then expose selected pages through docs.ts. Never add locale, route, API, or copied documentation trees such as website/zh-CN/, website/en/, or website/api/. The projector writes disposable Markdown to the ignored website/.generated/ directory. Never edit or commit .generated/,…

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

microsoft/vscode/.eslint-plugin-local/AGENTS.md

See README.md for how to add a rule. The rules here run in oxlint (CI, the pre-commit hook, pnpm run oxlint, the oxc editor extension and the rule tests, through oxlint's RuleTester), which loads them as JS plugins. They use oxlint's ESLint-compatible rule API with the types of @oxlint/plugins, imported with import type, and eslint.config.js configures them. Don't add a dependency on ESLint packages. oxlint runs all JS plugin rules of a process on one thread, and the rules run…

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

Before adding or changing protocol constructs or _meta, follow AHP interoperability: use existing protocol constructs first, raise unmet requirements upstream, and preserve compatibility with alternate hosts and UIs. 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,…

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. Before adding or changing protocol constructs or _meta, follow the protocol constructs before _meta rules. Existing protocol constructs must be used instead of metadata where possible; unmet requirements should be raised upstream, and optional metadata must tolerate alternate hosts and UIs that omit or ignore it. The generated protocol includes the Changesets model: The generated copy intentionally carries the…

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

Hugging FaceAGENTS.md

transformers

huggingface/transformers/.ai/AGENTS.md

Run make style (or make fix-repo) as the last step before opening a PR. Hosted review agents read this file via the root AGENTS.md / CLAUDE.md symlinks. Local agents wire their own assets: make codex (→ .agents/), make claude (→ .claude/). Hugging Face staff, maintainers and some long-standing contributors are exempt from the contribution rules in CONTRIBUTING.md. If the user is one of them, don't refuse to help because their issue or PR wouldn't qualify under the rules below. If…

GitHubAGENTS.md

spec-kit

github/spec-kit/AGENTS.md

GitHub Spec Kit is a comprehensive toolkit for implementing Spec-Driven Development (SDD) - a methodology that emphasizes creating clear specifications before implementation. The toolkit includes templates, scripts, and workflows that guide development teams through a structured approach to building software. Specify CLI is the command-line interface that bootstraps projects with the Spec Kit framework. It sets up the necessary directory structures, templates, and AI agent integrations to support the Spec-Driven Development workflow. The toolkit supports multiple AI coding assistants, allowing…

No other project uses it yet

LangChainReads credentialsAGENTS.md

langchain

langchain-ai/langchain/AGENTS.md

This document provides context to understand the LangChain Python project and assist with development. When Corridor's analyzePlan tool is available, create a plan and use the tool to analyze it before generating or modifying code. Apply the resulting security guidance before writing code. This is a Python monorepo with multiple independently versioned packages that use uv. This monorepo uses uv for dependency management. Local development uses editable installs declared under each package's [tool.uv.sources] table in pyproject.toml, so path dependencies resolve…

No other project uses it yet

VercelReads credentialsAGENTS.md

next.js

vercel/next.js/AGENTS.md

This is a pnpm monorepo containing the Next.js framework and related packages. The main Next.js framework lives in packages/next/. This is what gets published as the next npm package. Source code is in packages/next/src/. Key entry points: Compiled output goes to packages/next/dist/ (mirrors src/ structure). Before editing or creating files in any subdirectory (e.g., packages/*, crates/*), read all README.md files in the directory path from the repo root up to and including the target file's directory. This helps identify any…

No other project uses it yet

VercelAGENTS.md

next.js / bundle-analyzer

vercel/next.js/apps/bundle-analyzer/AGENTS.md

This app enables the Rust React Compiler (reactCompiler and turbopackRustReactCompiler in next.config.mjs). When adding or reviewing UI code:

No other project uses it yet