AGENTS.md examples from real projects

How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.

Best matchesWorked for most · soon

“documentation” 1k+ stars Hiding risky files

obraAGENTS.md

superpowers

obra/superpowers/AGENTS.md

what produced a change in order to weigh it: agent-generated content reasoned from documentation is held to a different bar than work grounded in a real session. Contributions that

292k3mo agoDiscuss

NousResearchAGENTS.md

hermes-agent / plugins

NousResearch/hermes-agent/plugins/AGENTS.md

VERSION`, a manifest-wide native `api:` match, or version literals on unrelated payloads. Documented surfaces stay additive: - Hook payload data is added as **keyword fields**; callbacks are signature-inspected

250k6mo agoDiscuss

affaan-mAGENTS.md

ECC

affaan-m/ECC/AGENTS.md

246k30d agoDiscuss

DeepSeekAGENTS.md

deepseek-harness / notes

deepseek-ai/deepseek-harness/.agents/notes/AGENTS.md

proposals and decision records that preserve rationale, alternatives, consequences, and required verification. Follow the [documentation standard](../../docs/AGENTS.md) and the [Agent Note rules](README.md). **Every new Agent Note triggers a supersession

238k51d agoDiscuss

DeepSeekAGENTS.md

deepseek-harness / archived

deepseek-ai/deepseek-harness/.agents/notes/archived/AGENTS.md

repair, delete, or move a sealed artifact; use an active Agent Note or current documentation for new decisions and facts. The archival change may only relocate a complete English/Chinese/sidecar triplet

238k51d agoDiscuss

DeepSeekAGENTS.md

deepseek-harness / implemented

deepseek-ai/deepseek-harness/.agents/notes/implemented/AGENTS.md

Implemented Agent Notes These Agent Notes describe shipped decisions. Follow the [root instructions](../../../AGENTS.md), [documentation standard](../../../docs/AGENTS.md), and [Agent Note format](../README.md#the-file-format); `verify-agent-note-format` gates

238k51d agoDiscuss

DeepSeekAGENTS.md

deepseek-harness

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

AGENTS.md — The documentation standard This file defines document structure, Markdown tiers, writing rules, and `verify-doc-budgets` ceilings. Use [dsh-doc](../.agents/skills/dsh-doc/SKILL.md) for placement and validation, and [dsh-prose-standard

238k51d agoDiscuss

DeepSeekAGENTS.md

deepseek-harness / packages

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

subsystem ownership through a canonical English page link or justified [exemption](../scripts/verify-subsystem-pages.ts). - Package READMEs document model, token, and KV-cache effects using the [canonical Model Experience format](../docs/cookbook/adding-a-package.md#4-write

238k51d agoDiscuss

DeepSeekAGENTS.md

deepseek-harness / experimental

deepseek-ai/deepseek-harness/packages/experimental/AGENTS.md

through `devDependencies`; examples may load them explicitly. - Experimental status does not relax engineering, security, documentation, lifecycle, testing, invariant, or snapshot requirements. - Publishing an experimental package does not promote

238k51d agoDiscuss

DeepSeekAGENTS.md

deepseek-harness / website

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

AGENTS.md — Documentation website adapter Follow the [root instructions](../AGENTS.md), the [documentation standard](../docs/AGENTS.md), and the [documentation workflow](../.agents/skills/dsh-doc/SKILL.md). ## Keep documentation content out of this tree `website/` owns only VitePress configuration

238k51d agoDiscuss

MicrosoftAGENTS.md

vscode / agentHost

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

Multi-Chat Architecture > Node runtime service construction is documented separately in [`node/serviceBootstrapping.md`](node/serviceBootstrapping.md). > Host startup timings, process-lifetime correlation, and session workload counts are documented in [`PERFORMANCE.md`](PERFORMANCE.md). > **Status: COMPLETE

193k21d agoDiscuss

MicrosoftAGENTS.md

vscode / prompts

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

tools registered by Agent Host. This internal debugging setting assumes those values use the documented string shape. > **Launch-time freeze.** The SDK accepts a system message only at session create/resume

193k21d agoDiscuss

Significant-GravitasAGENTS.md

AutoGPT

Significant-Gravitas/AutoGPT/AGENTS.md

calling `onKeyDown` as a safety net; every handler on a raw ` `/` `, a container, or `document` must use `isKey` itself. That atom-level guard is deliberately unconditional, so a modifier chord

188k19d agoDiscuss

Significant-GravitasAGENTS.md

AutoGPT / vercel-react-best-practices

Significant-Gravitas/AutoGPT/.claude/skills/vercel-react-best-practices/AGENTS.md

React Best Practices **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

188k19d agoDiscuss

Significant-GravitasAGENTS.md

AutoGPT

Significant-Gravitas/AutoGPT/docs/AGENTS.md

Documentation Guidelines ## Block Documentation Manual Sections When updating manual sections (` `) in block documentation files (e.g., `docs/integrations/basic.md`), follow these formats: ### How It Works Section Provide a technical explanation

188k19d agoDiscuss

langgeniusAGENTS.md

dify / api

langgenius/dify/api/AGENTS.md

explicit and bounded. Do not perform external I/O inside an open transaction unless a documented consistency contract requires it. - Read configuration through `configs.dify_config`, access storage through `extensions.ext_storage.storage`, and route

157k4d agoDiscuss

langgeniusAGENTS.md

dify / dify-agent

langgenius/dify/dify-agent/AGENTS.md

package's `uv` environment and Pydantic v2 APIs. Inspect current dependency source or official documentation before integrating, implementing, or mocking an API whose runtime contract is not established locally. ## Tests

157k4d agoDiscuss

VercelAGENTS.md

next.js / test

vercel/next.js/test/AGENTS.md

specific to self-hosted behavior; even then, prefer an explicit deploy-mode assertion that documents the different deployed semantics

143k5mo agoDiscuss

MicrosoftAGENTS.md

PowerToys

microsoft/PowerToys/AGENTS.md

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

139k8mo agoDiscuss

OpenAIAGENTS.md

codex

openai/codex/AGENTS.md

methods, newtypes, or other idiomatic Rust API shapes when they keep the callsite self-documenting. - When you cannot make that API change and still need a small positional-literal callsite

127k4mo 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.