Agent Friendly Code

AGENTS.md examples from 214 open source repos

Of the 401 repos on the leaderboard, 214 have an AGENTS.md or CLAUDE.md at the root, and 198 of those files are long enough (800 characters or more) to pass the AGENTS.md check in full. Each file name below links to the file on its host, so you can read how a popular project explains itself to an agent.

Most-starred repos with an AGENTS.md or CLAUDE.md

Most-starred repos with an AGENTS.md or CLAUDE.md
RepoFileLength
openclaw/openclawAGENTS.md 19,912 chars
react/reactCLAUDE.md 358 chars
anomalyco/opencodeAGENTS.md 12,955 chars
n8n-io/n8nAGENTS.md 22,714 chars
microsoft/vscodeAGENTS.md 270 chars
firecrawl/firecrawlAGENTS.md 1,480 chars
Significant-Gravitas/AutoGPTAGENTS.md 6,889 chars
ollama/ollamaAGENTS.md 357 chars
huggingface/transformersAGENTS.md 3,262 chars
langflow-ai/langflowAGENTS.md 11,708 chars
anthropics/claude-codeCLAUDE.md 2,217 chars
langchain-ai/langchainAGENTS.md 20,351 chars
vercel/next.jsAGENTS.md 30,632 chars
github/spec-kitAGENTS.md 3,746 chars
Comfy-Org/ComfyUIAGENTS.md 24,869 chars
excalidraw/excalidrawAGENTS.md 372 chars
ggml-org/llama.cppAGENTS.md 11,566 chars
kubernetes/kubernetesAGENTS.md 1,583 chars
rustdesk/rustdeskAGENTS.md 17,440 chars
nodejs/nodeAGENTS.md 3,082 chars

Longest and shortest files that pass

Longest

Longest AGENTS.md or CLAUDE.md files that pass
RepoFileLength
PostHog/posthogAGENTS.md 44,226 chars
modelcontextprotocol/serversAGENTS.md 43,762 chars
cloudflare/vinextAGENTS.md 38,816 chars
webpack/webpackAGENTS.md 35,897 chars
coollabsio/coolifyAGENTS.md 32,837 chars

Shortest

Shortest AGENTS.md or CLAUDE.md files that pass
RepoFileLength
scylladb/scylladbAGENTS.md 820 chars
lit/litAGENTS.md 924 chars
nuxt/nuxtAGENTS.md 947 chars
kicad/code/kicadAGENTS.md 952 chars
antiwork/gumroadAGENTS.md 978 chars

AGENTS.md or CLAUDE.md: which file repos use

  • AGENTS.md: 195 repos (181 pass in full)
  • CLAUDE.md: 19 repos (17 pass in full)

The check accepts AGENTS.md, CLAUDE.md or AGENT.md at the repo root and reads the first one it finds, in that order, so a repo with both files is counted under AGENTS.md. Either name passes for every agent.

It is the one file most agents load without being asked. Claude Code loads CLAUDE.md at the start of every conversation. GPT-5 Codex reads AGENTS.md before it does any work. Cursor, Kimi CLI, OpenHands and Pi read AGENTS.md too. Without it, an agent has to work out your build steps and conventions by reading code, and it guesses.

The weight each agent gives this check:

The methodology links the docs each agent's weights come from.

Popular repos without one

By language

Every file (214)

Every repo on the leaderboard with an AGENTS.md or CLAUDE.md
RepoFileLength
openclaw/openclawAGENTS.md 19,912 chars
react/reactCLAUDE.md 358 chars
anomalyco/opencodeAGENTS.md 12,955 chars
n8n-io/n8nAGENTS.md 22,714 chars
microsoft/vscodeAGENTS.md 270 chars
firecrawl/firecrawlAGENTS.md 1,480 chars
Significant-Gravitas/AutoGPTAGENTS.md 6,889 chars
ollama/ollamaAGENTS.md 357 chars
huggingface/transformersAGENTS.md 3,262 chars
langflow-ai/langflowAGENTS.md 11,708 chars
anthropics/claude-codeCLAUDE.md 2,217 chars
langchain-ai/langchainAGENTS.md 20,351 chars
vercel/next.jsAGENTS.md 30,632 chars
github/spec-kitAGENTS.md 3,746 chars
Comfy-Org/ComfyUIAGENTS.md 24,869 chars
excalidraw/excalidrawAGENTS.md 372 chars
ggml-org/llama.cppAGENTS.md 11,566 chars
kubernetes/kubernetesAGENTS.md 1,583 chars
rustdesk/rustdeskAGENTS.md 17,440 chars
nodejs/nodeAGENTS.md 3,082 chars
rust-lang/rustAGENTS.md 13,426 chars
earendil-works/piAGENTS.md 8,516 chars
supabase/supabaseAGENTS.md 6,857 chars
axios/axiosAGENTS.md 14,688 chars
denoland/denoCLAUDE.md 11,861 chars
pytorch/pytorchAGENTS.md 16,028 chars
neovim/neovimAGENTS.md 241 chars
mui/material-uiAGENTS.md 10,300 chars
microsoft/playwrightAGENTS.md 8,737 chars
oven-sh/bunAGENTS.md 17,599 chars
localsend/localsendAGENTS.md 12,267 chars
vllm-project/vllmAGENTS.md 5,820 chars
zed-industries/zedAGENTS.md 12,454 chars
storybookjs/storybookAGENTS.md 3,503 chars
modelcontextprotocol/serversAGENTS.md 43,762 chars
OpenHands/OpenHandsAGENTS.md 7,727 chars
astral-sh/uvAGENTS.md 3,504 chars
gohugoio/hugoAGENTS.md 1,712 chars
laravel/laravelAGENTS.md 1,445 chars
elastic/elasticsearchAGENTS.md 16,604 chars
caddyserver/caddyAGENTS.md 9,429 chars
python/cpythonAGENTS.md 602 chars
grafana/grafanaAGENTS.md 10,542 chars
openai/openai-cookbookAGENTS.md 5,961 chars
hiyouga/LlamaFactoryCLAUDE.md 3,901 chars
apache/supersetAGENTS.md 16,542 chars
strapi/strapiAGENTS.md 12,203 chars
moby/mobyAGENTS.md 553 chars
cline/clineAGENTS.md 5,432 chars
scikit-learn/scikit-learnAGENTS.md 1,316 chars
prometheus/prometheusAGENTS.md 6,410 chars
webpack/webpackAGENTS.md 35,897 chars
warpdotdev/warpAGENTS.md 19,737 chars
traefik/traefikAGENTS.md 12,369 chars
scrapy/scrapyAGENTS.md 4,908 chars
withastro/astroAGENTS.md 8,904 chars
coollabsio/coolifyAGENTS.md 32,837 chars
ghostty-org/ghosttyAGENTS.md 1,387 chars
BerriAI/litellmAGENTS.md 18,281 chars
penpot/penpotAGENTS.md 7,980 chars
nuxt/nuxtAGENTS.md 947 chars
makeplane/planeAGENTS.md 2,941 chars
spring-projects/spring-frameworkAGENTS.md 4,261 chars
crewAIInc/crewAIAGENTS.md 1,866 chars
meilisearch/meilisearchAGENTS.md 989 chars
rails/railsAGENTS.md 6,904 chars
go-gitea/giteaAGENTS.md 2,612 chars
appwrite/appwriteAGENTS.md 28,553 chars
remix-run/react-routerAGENTS.md 7,400 chars
aaif-goose/gooseAGENTS.md 6,209 chars
ggml-org/whisper.cppAGENTS.md 6,191 chars
JetBrains/kotlinAGENTS.md 234 chars
expo/expoAGENTS.md 9,454 chars
tldraw/tldrawAGENTS.md 13,885 chars
chenglou/pretextAGENTS.md 10,211 chars
TanStack/queryAGENTS.md 455 chars
ClickHouse/ClickHouseAGENTS.md 17,013 chars
astral-sh/ruffAGENTS.md 20,390 chars
pandas-dev/pandasAGENTS.md 2,713 chars
metabase/metabaseCLAUDE.md 8,135 chars
JuliaLang/juliaAGENTS.md 6,706 chars
calcom/cal.diyAGENTS.md 9,222 chars
discourse/discourseAGENTS.md 5,866 chars
prisma/ormAGENTS.md 11,042 chars
apache/airflowAGENTS.md 22,630 chars
cli/cliAGENTS.md 5,769 chars
milvus-io/milvusAGENTS.md 9,484 chars
streamlit/streamlitAGENTS.md 9,151 chars
files-community/FilesAGENTS.md 7,102 chars
getsentry/sentryAGENTS.md 8,125 chars
jestjs/jestCLAUDE.md 45 chars
payloadcms/payloadAGENTS.md 21,502 chars
logseq/logseqAGENTS.md 5,125 chars
apache/sparkAGENTS.md 19,774 chars
colinhacks/zodAGENTS.md 21,940 chars
ray-project/rayAGENTS.md 3,693 chars
gradio-app/gradioAGENTS.md 3,776 chars
fastlane/fastlaneAGENTS.md 1,575 chars
duckdb/duckdbAGENTS.md 18,015 chars
chakra-ui/chakra-uiCLAUDE.md 9,339 chars
nushell/nushellAGENTS.md 2,235 chars
pingcap/tidbAGENTS.md 14,515 chars
PostHog/posthogAGENTS.md 44,226 chars
novuhq/novuAGENTS.md 2,426 chars
mattermost/mattermostAGENTS.md 738 chars
directus/directusAGENTS.md 8,016 chars
nextcloud/serverAGENTS.md 8,748 chars
pnpm/pnpmAGENTS.md 32,390 chars
medusajs/medusaCLAUDE.md 13,702 chars
date-fns/date-fnsAGENTS.md 1,209 chars
lightpanda-io/browserAGENTS.md 2,097 chars
huggingface/diffusersAGENTS.md 4,082 chars
apache/kafkaAGENTS.md 9,997 chars
surrealdb/surrealdbCLAUDE.md 4,188 chars
labstack/echoCLAUDE.md 3,132 chars
cockroachdb/cockroachCLAUDE.md 5,664 chars
filamentphp/filamentAGENTS.md 16,538 chars
supermemoryai/supermemoryCLAUDE.md 3,962 chars
vercel/turborepoAGENTS.md 2,364 chars
statelyai/xstateAGENTS.md 740 chars
nautechsystems/nautilus_traderAGENTS.md 5,349 chars
square/leakcanaryAGENTS.md 9,766 chars
simstudioai/simAGENTS.md 21,569 chars
chroma-core/chromaAGENTS.md 128 chars
nrwl/nxAGENTS.md 9,129 chars
h4ckf0r0day/obscuraAGENTS.md 10,389 chars
mastra-ai/mastraAGENTS.md 1,674 chars
ml-explore/mlxAGENTS.md 1,594 chars
charmbracelet/crushAGENTS.md 10,590 chars
QwenLM/qwen-codeAGENTS.md 18,319 chars
eslint/eslintAGENTS.md 8,223 chars
vercel/aiAGENTS.md 13,567 chars
elixir-lang/elixirAGENTS.md 9,853 chars
apache/flinkAGENTS.md 22,898 chars
rollup/rollupAGENTS.md 8,327 chars
vapor/vaporAGENTS.md 3,122 chars
biomejs/biomeAGENTS.md 5,171 chars
different-ai/openworkAGENTS.md 4,679 chars
guzzle/guzzleAGENTS.md 4,577 chars
oxc-project/oxcAGENTS.md 14,547 chars
forem/foremAGENTS.md 6,062 chars
microsoft/onnxruntimeAGENTS.md 7,686 chars
lit/litAGENTS.md 924 chars
vitessio/vitessAGENTS.md 1,237 chars
sveltejs/kitAGENTS.md 4,188 chars
wagtail/wagtailAGENTS.md 2,161 chars
questdb/questdbCLAUDE.md 16,381 chars
vitest-dev/vitestAGENTS.md 18,397 chars
sindresorhus/kyAGENTS.md 621 chars
weaviate/weaviateCLAUDE.md 5,906 chars
aio-libs/aiohttpAGENTS.md 3,652 chars
apache/dorisAGENTS.md 15,038 chars
quarkusio/quarkusAGENTS.md 6,710 chars
scylladb/scylladbAGENTS.md 820 chars
facebook/inferAGENTS.md 7,131 chars
apache/pulsarAGENTS.md 7,099 chars
TanStack/routerAGENTS.md 5,020 chars
millionco/react-doctorAGENTS.md 27,856 chars
ktorio/ktorAGENTS.md 6,126 chars
phpstan/phpstanCLAUDE.md 6,228 chars
apache/druidAGENTS.md 5,423 chars
Kotlin/kotlinx.coroutinesAGENTS.md 330 chars
trinodb/trinoAGENTS.md 1,592 chars
debezium/debeziumAGENTS.md 18,496 chars
Kludex/starletteAGENTS.md 117 chars
redpanda-data/redpandaCLAUDE.md 13,184 chars
StarRocks/starrocksAGENTS.md 4,467 chars
coil-kt/coilAGENTS.md 3,164 chars
data-privacy-stack/presidioAGENTS.md 6,369 chars
google/osv-scannerAGENTS.md 4,648 chars
AutoMQ/automqAGENTS.md 1,339 chars
yugabyte/yugabyte-dbAGENTS.md 5,151 chars
electric-sql/electricAGENTS.md 14,447 chars
apache/cassandraAGENTS.md 4,413 chars
sqlfluff/sqlfluffAGENTS.md 11,495 chars
antiwork/gumroadAGENTS.md 978 chars
apache/seatunnelAGENTS.md 8,693 chars
risingwavelabs/risingwaveAGENTS.md 5,179 chars
apache/icebergAGENTS.md 17,435 chars
JetBrains/ExposedCLAUDE.md 11,202 chars
cloudflare/vinextAGENTS.md 38,816 chars
delta-io/deltaAGENTS.md 3,402 chars
vercel-labs/deepsecCLAUDE.md 1,855 chars
MoonshotAI/kimi-codeAGENTS.md 14,885 chars
farzaa/clickyAGENTS.md 13,014 chars
detekt/detektAGENTS.md 7,439 chars
GreptimeTeam/greptimedbAGENTS.md 8,382 chars
MaterializeInc/materializeAGENTS.md 13,388 chars
scala/scala3AGENTS.md 3,469 chars
gitlab-org/gitlabAGENTS.md 5,439 chars
apache/pinotAGENTS.md 8,110 chars
roc-lang/rocAGENTS.md 2,893 chars
inngest/inngestAGENTS.md 2,782 chars
Uniswap/interfaceAGENTS.md 9,359 chars
apache/paimonAGENTS.md 1,875 chars
TanStack/aiAGENTS.md 9,355 chars
api-platform/coreAGENTS.md 3,254 chars
gitlab-org/gitlab-runnerAGENTS.md 12,742 chars
TheOrcDev/8bitcn-uiAGENTS.md 9,197 chars
getnao/naoAGENTS.md 3,028 chars
ocaml/duneAGENTS.md 8,766 chars
gnachman/iterm2AGENTS.md 3,199 chars
symfony/aiAGENTS.md 11,122 chars
libeigen/eigenAGENTS.md 18,434 chars
gitlab-org/cliAGENTS.md 7,445 chars
kicad/code/kicadAGENTS.md 952 chars
krakenfx/kraken-cliAGENTS.md 25,315 chars
Shopify/cliAGENTS.md 6,402 chars
gitlab-org/gitalyAGENTS.md 2,496 chars
championswimmer/TwoFacAGENTS.md 3,271 chars
wormhole-foundation/wormhole-connectCLAUDE.md 1,240 chars
privy-io/go-sdkAGENTS.md 3,533 chars
hsnice16/agent-friendly-code(this site's own repo)AGENTS.md 12,677 chars
hsnice16/tula(by this site's author)AGENTS.md 73,892 chars