DeepSeekAGENTS.mddeepseek-harness / workspace
deepseek-ai/deepseek-harness/snapshots/session/ptc-workspace-context/workspace/AGENTS.md
Workspace snapshot root instruction.
AGENTS.md examples from real projects
How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.
Most stars first · from page 2Worked for most · soon
DeepSeekAGENTS.mdDeepSeekAGENTS.mddeepseek-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 CODEMODECONTEXT_OK and nothing else.
DeepSeekAGENTS.mddeepseek-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/,…
n8n-ioAGENTS.mdn8n / skills
n8n-io/n8n/.agents/skills/AGENTS.md
Shared n8n skills live in .agents/skills. These are the canonical source for skills that should work across Claude Code, OpenCode, and future agent harnesses. Claude plugin skills should usually be…
MicrosoftAGENTS.mdvscode
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.mdvscode / 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…
MicrosoftAGENTS.mdvscode / 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:
MicrosoftAGENTS.mdvscode / 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…
MicrosoftAGENTS.mdvscode / 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…
MicrosoftAGENTS.mdvscode / 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: Optional protocol fields are usually backwards-compatible. Add the field in the source protocol repo, sync protocol/**, and add wrapper exports only when VS Code code needs them. Adding a new server-produced action type is backwards-compatible when old clients can ignore it safely. Old clients at the same protocol version ignore unknown action…
MicrosoftAGENTS.mdvscode / 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…
MicrosoftAGENTS.mdvscode / 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.
MicrosoftAGENTS.mdvscode / 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…
Significant-GravitasAGENTS.mdAutoGPT
Significant-Gravitas/AutoGPT/AGENTS.md
This guide provides context for coding agents when updating the **autogpt_platform** folder. See docs/platform/getting-started.md for setup instructions. See /frontend/CONTRIBUTING.md for complete patterns. Quick reference:
Significant-GravitasAGENTS.mdAutoGPT / vercel-react-best-practices
Significant-Gravitas/AutoGPT/.claude/skills/vercel-react-best-practices/AGENTS.md
Version 1.0.0 Vercel Engineering January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring React and Next.js codebases at Vercel. Humans may…
Significant-GravitasAGENTS.mdAutoGPT
Significant-Gravitas/AutoGPT/docs/AGENTS.md
When updating manual sections (<!-- MANUAL: ... -->) in block documentation files (e.g., docs/integrations/basic.md), follow these formats: Provide a technical explanation of how the block functions: - Describe the processing…
Hugging FaceAGENTS.mdtransformers
huggingface/transformers/AGENTS.md
.ai/AGENTS.md
Hugging FaceAGENTS.mdtransformers
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/). If your approach is materially different, say why a second PR is needed in the issue. - No one-off PRs for tiny edits (a single typo, an isolated lint fix). Mechanical cleanups are fine, but not as a first…
langgeniusAGENTS.mddify / api
langgenius/dify/api/AGENTS.md
Read surrounding module, class, and function docstrings plus non-obvious comments before changing backend behavior. They are local contracts; update them only when their owned behavior changes, and keep them aligned…
langgeniusAGENTS.mddify / cli
langgenius/dify/cli/AGENTS.md
This package is the Node 24+, ESM TypeScript implementation of difyctl. Development also requires the Bun version pinned in .bun-version; command-tree generation and the dev, test, and build pre-scripts invoke…
About AGENTS.md
What is AGENTS.md?
An open format for instructions to coding agents, read by Codex, Cursor and others. Think of it as a README written for agents.
Where does it go?
At the repository root, with more specific files in subdirectories. Agents read the one closest to the file they're editing.
What should it contain?
Setup and test commands, code style, and the rules a new contributor would need to know.
Does Claude Code read it?
Claude Code reads CLAUDE.md. A one-line CLAUDE.md that points at AGENTS.md covers both.