agentleFS
Sign inSign up

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 3Worked for most · soon
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: 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…

193k21d agoDiscuss
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…

193k21d agoDiscuss
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.

193k21d agoDiscuss
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…

193k21d agoDiscuss
Significant-GravitasAGENTS.md

AutoGPT

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:

188k19d agoDiscuss
Significant-GravitasAGENTS.md

AutoGPT / autogpt_platform

Significant-Gravitas/AutoGPT/autogpt_platform/AGENTS.md

AutoGPT Platform is a monorepo containing: .env.default files are public. Any real key, token, password, or signing secret committed to one is a published secret: scanners pick it up, it…

188k19d agoReads credentialsDiscuss
Significant-GravitasAGENTS.md

AutoGPT / 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…

188k19d agoDiscuss
Significant-GravitasAGENTS.md

AutoGPT

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…

188k19d agoDiscuss
firecrawlAGENTS.md

firecrawl

firecrawl/firecrawl/AGENTS.md

Firecrawl is a web scraper API. The directory you have access to is a monorepo: - apps/api has the actual API and worker code - apps/*-sdk are various SDKs When…

186k16mo agoReads credentialsDiscuss
fAGENTS.md

prompts.chat

f/prompts.chat/AGENTS.md

Guidelines for AI coding agents working on this project. prompts.chat is a social platform for AI prompts built with Next.js 16. It allows users to share, discover, and collect prompts…

170k8mo agoReads credentialsDiscuss
Hugging FaceAGENTS.md

transformers

huggingface/transformers/AGENTS.md

.ai/AGENTS.md

167k23d agoDiscuss
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/). 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…

167k23d agoDiscuss
langgeniusAGENTS.md

dify

langgenius/dify/AGENTS.md

Dify is an open-source platform for building LLM applications, agentic workflows, and RAG pipelines. This monorepo contains the backend API (api/), frontend application (web/), deployment assets (docker/), standalone agent backend…

157k4d agoReads credentialsDiscuss
langgeniusAGENTS.md

dify / 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…

157k4d agoDiscuss
langgeniusAGENTS.md

dify / 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…

157k4d agoDiscuss
langgeniusAGENTS.md

dify / dify-agent

langgenius/dify/dify-agent/AGENTS.md

Read surrounding docstrings and non-obvious comments before changing behavior. They are local contracts; update them only when their owned behavior changes, and keep them aligned with the current code. Read…

157k4d agoDiscuss
langgeniusAGENTS.md

dify / e2e

langgenius/dify/e2e/AGENTS.md

This package contains Dify's repository-level Cucumber scenarios with Playwright as the browser layer. This file owns current package architecture, runtime, session and tag semantics, seed, protocol, and cleanup contracts. The…

157k4d agoDiscuss
langgeniusAGENTS.md

dify / web

langgenius/dify/web/AGENTS.md

Web owns application-specific requirements and consumes shared architecture guidance from skills and primitive contracts from Dify UI. Link to those owners instead of redefining their rules here. This version has…

157k4d agoDiscuss
LangChainAGENTS.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…

147k7d agoReads credentialsDiscuss
DietrichGebertAGENTS.md

ponytail

DietrichGebert/ponytail/AGENTS.md

You are a lazy senior developer. Lazy means efficient, not careless. The best code is the code never written. Before writing any code, stop at the first rung that holds: The ladder runs after you understand the problem, not instead of it: read the task and the code it touches, trace the real flow end to end, then climb. Bug fix = root cause, not symptom: a report names a symptom. Grep every caller of the function you touch and…

143k4mo agoDiscuss

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.