AGENTS.md files

AGENTS.md is a plain markdown file in a repository that tells coding agents how to work there: how to build and test the project, and which conventions to follow. Coding agents read it before they change the code, and a repository can keep more than one, each next to the code it describes. Below are the most starred of the 3,901 the registry had collected by September 27, 2026, each version saved and graded.

Starting one of your own? A template for AGENTS.md, with what to change in it, on mdpantry.

AGENTS.md files by the numbers

From State of agent markdown, September 2026, counted September 27, 2026.

3,901 files indexed from public GitHub.
91.5% graded A on their latest version by the registry's automatic checks (A 3,570, B 316, C 6, F 9).
At least 27.8% (730 of the 2,623 watched for 14 days or more) got a new upstream commit within 14 days of being first indexed.
10.3% (403) are copies: at least 200 bytes, and byte-identical to a file in another repository.

The 120 most starred

From repos with the most stars first.

AGENTS.md AGENTS.md file

obra/superpowers · AGENTS.md

git:20260919.5bf4e78 · audit A · 297,596 stars

AGENTS.md AGENTS.md file

affaan-m/ecc · AGENTS.md

git:20261011.412347a · audit A · 277,095 stars

AGENTS.md@docs/ja-JP AGENTS.md file

affaan-m/ecc · docs/ja-JP/AGENTS.md

git:20261001.c05b2d6 · audit A · 277,095 stars

AGENTS.md@docs/es AGENTS.md file

affaan-m/ecc · docs/es/AGENTS.md

git:20261001.c05b2d6 · audit A · 277,095 stars

AGENTS.md@.codex AGENTS.md file

affaan-m/ecc · .codex/AGENTS.md

git:20260923.1aea780 · audit A · 277,095 stars

AGENTS.md AGENTS.md file

firecrawl/firecrawl · AGENTS.md

git:20261008.5a75dca · audit A · 191,238 stars

AGENTS.md AGENTS.md file

dietrichgebert/ponytail · AGENTS.md

git:20261008.2a1fe84 · audit A · 161,772 stars

AGENTS.md@website AGENTS.md file

morluto/rea · website/AGENTS.md

git:20261011.a2d3338 · audit A · 141,622 stars

AGENTS.md AGENTS.md file

morluto/rea · AGENTS.md

git:20261012.ac6ef95 · audit A · 141,622 stars

AGENTS.md AGENTS.md file

garrytan/gstack · AGENTS.md

git:20261011.5d64745 · audit A · 136,319 stars

AGENTS.md AGENTS.md file

graphify-labs/graphify · AGENTS.md

git:20260926.98d73fe · audit A · 125,506 stars

AGENTS.md AGENTS.md file

juliusbrussee/caveman · AGENTS.md

git:20260902.d9faebc · audit A · 111,034 stars

AGENTS.md@packages/cli AGENTS.md file

juliusbrussee/caveman · packages/cli/AGENTS.md

git:20260908.441c4cb · audit A · 111,034 stars

AGENTS.md@mem AGENTS.md file

juliusbrussee/caveman · mem/AGENTS.md

git:20260924.921eab8 · audit A · 111,034 stars

AGENTS.md@packages/shared/contracts AGENTS.md file

juliusbrussee/caveman · packages/shared/contracts/AGENTS.md

git:20260925.489940d · audit A · 111,034 stars

AGENTS.md@mcp AGENTS.md file

juliusbrussee/caveman · mcp/AGENTS.md

git:20260924.921eab8 · audit A · 111,034 stars

AGENTS.md@engine AGENTS.md file

juliusbrussee/caveman · engine/AGENTS.md

git:20260812.d4ef06b · audit A · 111,034 stars

AGENTS.md@packages/sdk/parity AGENTS.md file

juliusbrussee/caveman · packages/sdk/parity/AGENTS.md

git:20260812.d4ef06b · audit A · 111,034 stars

AGENTS.md@shrink AGENTS.md file

juliusbrussee/caveman · shrink/AGENTS.md

git:20260924.921eab8 · audit A · 111,034 stars

AGENTS.md@packages/sdk/typescript AGENTS.md file

juliusbrussee/caveman · packages/sdk/typescript/AGENTS.md

git:20260925.36ccf7d · audit A · 111,034 stars

AGENTS.md@proxy AGENTS.md file

juliusbrussee/caveman · proxy/AGENTS.md

git:20261006.9f5f9e7 · audit A · 111,034 stars

AGENTS.md@packages/sdk/python AGENTS.md file

juliusbrussee/caveman · packages/sdk/python/AGENTS.md

git:20260925.36ccf7d · audit A · 111,034 stars

AGENTS.md@shared/provider-catalog AGENTS.md file

juliusbrussee/caveman · shared/provider-catalog/AGENTS.md

git:20260812.d4ef06b · audit A · 111,034 stars

AGENTS.md@extension AGENTS.md file

juliusbrussee/caveman · extension/AGENTS.md

git:20261003.2ec7194 · audit A · 111,034 stars

AGENTS.md AGENTS.md file

addyosmani/agent-skills · AGENTS.md

git:20260709.b665c5c · audit A · 105,264 stars

AGENTS.md@apps AGENTS.md file

nexu-io/open-design · apps/AGENTS.md

git:20260903.1d21500 · audit A · 100,488 stars

AGENTS.md AGENTS.md file

nexu-io/open-design · AGENTS.md

git:20260909.d07102a · audit A · 100,488 stars

AGENTS.md@apps/web/src/components/Theater AGENTS.md file

nexu-io/open-design · apps/web/src/components/Theater/AGENTS.md

git:20260718.6b90486 · audit A · 100,488 stars

AGENTS.md@apps/daemon AGENTS.md file

nexu-io/open-design · apps/daemon/AGENTS.md

git:20260818.f1a0b60 · audit A · 100,488 stars

AGENTS.md@design-systems/_schema AGENTS.md file

nexu-io/open-design · design-systems/_schema/AGENTS.md

git:20260819.16fad1c · audit A · 100,488 stars

AGENTS.md@design-templates AGENTS.md file

nexu-io/open-design · design-templates/AGENTS.md

git:20260818.f1a0b60 · audit A · 100,488 stars

AGENTS.md@apps/closure AGENTS.md file

nexu-io/open-design · apps/closure/AGENTS.md

git:20260825.d03bf69 · audit A · 100,488 stars

AGENTS.md@apps/web/src/components/chat AGENTS.md file

nexu-io/open-design · apps/web/src/components/chat/AGENTS.md

git:20260907.ad09d38 · audit A · 100,488 stars

AGENTS.md@.github AGENTS.md file

nexu-io/open-design · .github/AGENTS.md

git:20261008.92fe7e8 · audit A · 100,488 stars

AGENTS.md@apps/daemon/src/critique AGENTS.md file

nexu-io/open-design · apps/daemon/src/critique/AGENTS.md

git:20260718.6b90486 · audit A · 100,488 stars

AGENTS.md@apps/packaged AGENTS.md file

nexu-io/open-design · apps/packaged/AGENTS.md

git:20260821.4b48f94 · audit A · 100,488 stars

AGENTS.md@backend/packages/harness/deerflow/runtime AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/runtime/AGENTS.md

git:20261008.85796f6 · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/agents AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/agents/AGENTS.md

git:20260930.af67738 · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/persistence AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/persistence/AGENTS.md

git:20261008.c58d04b · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/tui AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/tui/AGENTS.md

git:20261011.2ca0b79 · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/agents/middlewares AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/agents/middlewares/AGENTS.md

git:20261011.97ed0e9 · audit B · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/community/e2b_sandbox AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/community/e2b_sandbox/AGENTS.md

git:20261010.be69d99 · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/persistence/migrations AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/persistence/migrations/AGENTS.md

git:20261010.6c4c74a · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/uploads AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/uploads/AGENTS.md

git:20261009.2502b38 · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/typesafe AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/typesafe/AGENTS.md

git:20260927.d700ad9 · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/config AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/config/AGENTS.md

git:20261011.29a9581 · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/community/tavily AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/community/tavily/AGENTS.md

git:20261011.d5e0a0a · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/sandbox AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/sandbox/AGENTS.md

git:20261008.49a0e13 · audit A · 83,692 stars

AGENTS.md AGENTS.md file

bytedance/deer-flow · AGENTS.md

git:20261011.04a45db · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/community/aio_sandbox AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/community/aio_sandbox/AGENTS.md

git:20261009.b9a75b8 · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/tracing AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/tracing/AGENTS.md

git:20260927.e2c5027 · audit A · 83,692 stars

AGENTS.md@frontend/src AGENTS.md file

bytedance/deer-flow · frontend/src/AGENTS.md

git:20261008.69f4093 · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/community/serper AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/community/serper/AGENTS.md

git:20261010.be62fff · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/mcp AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/mcp/AGENTS.md

git:20261011.75ce6f4 · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/community/groundroute AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/community/groundroute/AGENTS.md

git:20261010.8834a75 · audit A · 83,692 stars

AGENTS.md@backend/app/gateway AGENTS.md file

bytedance/deer-flow · backend/app/gateway/AGENTS.md

git:20261011.78540ac · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/community/brave AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/community/brave/AGENTS.md

git:20261010.90aa5d4 · audit A · 83,692 stars

AGENTS.md@examples/deerflow-extension-agent-teams AGENTS.md file

bytedance/deer-flow · examples/deerflow-extension-agent-teams/AGENTS.md

git:20261005.d67a9e4 · audit A · 83,692 stars

AGENTS.md@backend/app/gateway/routers AGENTS.md file

bytedance/deer-flow · backend/app/gateway/routers/AGENTS.md

git:20261011.78540ac · audit A · 83,692 stars

AGENTS.md@backend/tests AGENTS.md file

bytedance/deer-flow · backend/tests/AGENTS.md

git:20261011.6103c7b · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/AGENTS.md

git:20261011.6103c7b · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/tools AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/tools/AGENTS.md

git:20261008.286bb5f · audit A · 83,692 stars

AGENTS.md@frontend AGENTS.md file

bytedance/deer-flow · frontend/AGENTS.md

git:20261011.3f71b2e · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/agents/memory AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/agents/memory/AGENTS.md

git:20261008.5ae953f · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/persistence/user AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/persistence/user/AGENTS.md

git:20260913.7513f16 · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/extensions AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/extensions/AGENTS.md

git:20261009.553f85e · audit A · 83,692 stars

AGENTS.md@scripts AGENTS.md file

bytedance/deer-flow · scripts/AGENTS.md

git:20261011.b9b74d2 · audit B · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/subagents AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/subagents/AGENTS.md

git:20261011.97ed0e9 · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/agents/task_continuity AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/agents/task_continuity/AGENTS.md

git:20261010.7e0e301 · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/skills AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/skills/AGENTS.md

git:20261008.4bab280 · audit B · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/community/jina_ai AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/community/jina_ai/AGENTS.md

git:20261011.3461c12 · audit A · 83,692 stars

AGENTS.md@backend/app/channels AGENTS.md file

bytedance/deer-flow · backend/app/channels/AGENTS.md

git:20261008.62c5423 · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/models AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/models/AGENTS.md

git:20261009.2157588 · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/reflection AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/reflection/AGENTS.md

git:20260813.ccff5f5 · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/utils AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/utils/AGENTS.md

git:20261011.3234563 · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/storage AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/storage/AGENTS.md

git:20261005.fcee85b · audit A · 83,692 stars

AGENTS.md@backend/packages/harness/deerflow/community/ragflow AGENTS.md file

bytedance/deer-flow · backend/packages/harness/deerflow/community/ragflow/AGENTS.md

git:20261007.3182ecb · audit A · 83,692 stars

AGENTS.md@backend AGENTS.md file

bytedance/deer-flow · backend/AGENTS.md

git:20261007.a83b244 · audit A · 83,692 stars

AGENTS.md AGENTS.md file

tt-a1i/archify · AGENTS.md

git:20260916.62bd6d2 · audit A · 81,858 stars

AGENTS.md AGENTS.md file

opendatalab/mineru · AGENTS.md

git:20260825.c92e6f8 · audit B · 81,612 stars

AGENTS.md AGENTS.md file

pbakaus/impeccable · AGENTS.md

git:20260906.6ebc24a · audit A · 79,831 stars

AGENTS.md AGENTS.md file

thedaviddias/front-end-checklist · AGENTS.md

git:20260930.d3ad6b7 · audit A · 74,452 stars

AGENTS.md AGENTS.md file

career-ops-hq/career-ops · AGENTS.md

git:20261011.7150794 · audit A · 74,108 stars

AGENTS.md@web AGENTS.md file

career-ops-hq/career-ops · web/AGENTS.md

git:20260902.dac7a0d · audit A · 74,108 stars

AGENTS.md@docs AGENTS.md file

code-yeongyu/oh-my-openagent · docs/AGENTS.md

git:20261011.f685ffc · audit A · 69,992 stars

AGENTS.md AGENTS.md file

code-yeongyu/oh-my-openagent · AGENTS.md

git:20261011.f685ffc · audit A · 69,992 stars

AGENTS.md@packages/omo-senpi/skills AGENTS.md file

code-yeongyu/oh-my-openagent · packages/omo-senpi/skills/AGENTS.md

git:20261012.f16cf8c · audit A · 69,992 stars

AGENTS.md@packages/omo-senpi AGENTS.md file

code-yeongyu/oh-my-openagent · packages/omo-senpi/AGENTS.md

git:20261011.5c95ea1 · audit A · 69,992 stars

AGENTS.md@packages/omo-senpi/src/components/memory AGENTS.md file

code-yeongyu/oh-my-openagent · packages/omo-senpi/src/components/memory/AGENTS.md

git:20261011.c945763 · audit A · 69,992 stars

AGENTS.md@packages/omo-opencode/src/hooks/keyword-detector AGENTS.md file

code-yeongyu/oh-my-openagent · packages/omo-opencode/src/hooks/keyword-detector/AGENTS.md

git:20261011.75e0642 · audit A · 69,992 stars

AGENTS.md@packages/omo-senpi/src AGENTS.md file

code-yeongyu/oh-my-openagent · packages/omo-senpi/src/AGENTS.md

git:20261011.834f68f · audit A · 69,992 stars

AGENTS.md@packages/omo-senpi/scripts/qa AGENTS.md file

code-yeongyu/oh-my-openagent · packages/omo-senpi/scripts/qa/AGENTS.md

git:20261010.daded47 · audit A · 69,992 stars

AGENTS.md@packages/hashline-core AGENTS.md file

code-yeongyu/oh-my-openagent · packages/hashline-core/AGENTS.md

git:20260617.6e3336b · audit A · 69,992 stars

AGENTS.md@packages/omo-senpi/plugin/scripts AGENTS.md file

code-yeongyu/oh-my-openagent · packages/omo-senpi/plugin/scripts/AGENTS.md

git:20261008.65255dc · audit A · 69,992 stars

AGENTS.md@packages/delegate-core AGENTS.md file

code-yeongyu/oh-my-openagent · packages/delegate-core/AGENTS.md

git:20260929.6ca6427 · audit A · 69,992 stars

AGENTS.md@packages/omo-codex/plugin/components/ulw-loop AGENTS.md file

code-yeongyu/oh-my-openagent · packages/omo-codex/plugin/components/ulw-loop/AGENTS.md

git:20260901.410d193 · audit A · 69,992 stars

AGENTS.md@packages/omo-opencode/src/agents/hephaestus AGENTS.md file

code-yeongyu/oh-my-openagent · packages/omo-opencode/src/agents/hephaestus/AGENTS.md · Developer reference for the Hephaestus autonomous deep worker agent — model variants, key behaviors, and delegation…

git:20260810.8357cb5 · audit A · 69,992 stars

AGENTS.md@packages/omo-codex/plugin/components/ulw-execute-continuation AGENTS.md file

code-yeongyu/oh-my-openagent · packages/omo-codex/plugin/components/ulw-execute-continuation/AGENTS.md

git:20260927.01b387d · audit A · 69,992 stars

AGENTS.md@packages/omo-senpi/src/components/thread AGENTS.md file

code-yeongyu/oh-my-openagent · packages/omo-senpi/src/components/thread/AGENTS.md

git:20261006.d9b50af · audit A · 69,992 stars

AGENTS.md@packages/skills-loader-core AGENTS.md file

code-yeongyu/oh-my-openagent · packages/skills-loader-core/AGENTS.md

git:20260824.f7cdde8 · audit A · 69,992 stars

AGENTS.md@packages/omo-opencode/src/hooks/ulw-execute AGENTS.md file

code-yeongyu/oh-my-openagent · packages/omo-opencode/src/hooks/ulw-execute/AGENTS.md

git:20260917.194d5b6 · audit A · 69,992 stars

AGENTS.md@packages/omo-opencode/src/tools/skill AGENTS.md file

code-yeongyu/oh-my-openagent · packages/omo-opencode/src/tools/skill/AGENTS.md

git:20261002.206da0f · audit A · 69,992 stars

AGENTS.md@packages/git-bash-mcp AGENTS.md file

code-yeongyu/oh-my-openagent · packages/git-bash-mcp/AGENTS.md

git:20260617.6e3336b · audit A · 69,992 stars

AGENTS.md@packages/omo-opencode/src/agents/atlas AGENTS.md file

code-yeongyu/oh-my-openagent · packages/omo-opencode/src/agents/atlas/AGENTS.md · Developer reference for the Atlas todo-list orchestrator agent -- model variants, prompt sections, and routing.

git:20260817.5a64754 · audit A · 69,992 stars

AGENTS.md@packages/claude-code-compat-core AGENTS.md file

code-yeongyu/oh-my-openagent · packages/claude-code-compat-core/AGENTS.md

git:20260616.2fff043 · audit A · 69,992 stars

AGENTS.md@packages/omo-opencode/src/plugin-handlers AGENTS.md file

code-yeongyu/oh-my-openagent · packages/omo-opencode/src/plugin-handlers/AGENTS.md

git:20260727.877d1ef · audit A · 69,992 stars

AGENTS.md@packages/senpi-task/src/dag AGENTS.md file

code-yeongyu/oh-my-openagent · packages/senpi-task/src/dag/AGENTS.md

git:20261007.d19e55e · audit A · 69,992 stars

AGENTS.md@packages/lsp-tools-mcp AGENTS.md file

code-yeongyu/oh-my-openagent · packages/lsp-tools-mcp/AGENTS.md