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.
Read next: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.
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@website AGENTS.md file
AGENTS.md AGENTS.md file
AGENTS.md AGENTS.md file
AGENTS.md AGENTS.md file
AGENTS.md@docs/ja-JP AGENTS.md file
AGENTS.md@docs/es AGENTS.md file
AGENTS.md@.codex AGENTS.md file
AGENTS.md AGENTS.md file
AGENTS.md AGENTS.md file
AGENTS.md AGENTS.md file
AGENTS.md AGENTS.md file
AGENTS.md@captain/templates AGENTS.md file
AGENTS.md AGENTS.md file
AGENTS.md@packages/cli AGENTS.md file
AGENTS.md@mem AGENTS.md file
AGENTS.md@packages/shared/contracts AGENTS.md file
AGENTS.md@mcp AGENTS.md file
AGENTS.md@engine AGENTS.md file
AGENTS.md@packages/sdk/parity AGENTS.md file
AGENTS.md@shrink AGENTS.md file
AGENTS.md@packages/sdk/typescript AGENTS.md file
AGENTS.md@proxy AGENTS.md file
AGENTS.md@packages/sdk/python AGENTS.md file
AGENTS.md@shared/provider-catalog AGENTS.md file
AGENTS.md@extension AGENTS.md file
AGENTS.md AGENTS.md file
AGENTS.md@server/src/onboarding-assets/ceo AGENTS.md file
AGENTS.md AGENTS.md file
AGENTS.md@packages/plugins/plugin-llm-wiki/templates AGENTS.md file
AGENTS.md@packages/adapter-utils/src/acpx-engine AGENTS.md file
AGENTS.md@tests/runner-e2e/fixtures/git-streaming AGENTS.md file
AGENTS.md@server/src/onboarding-assets/default AGENTS.md file
AGENTS.md@tests/runner-e2e/fixtures/warm-continuity AGENTS.md file
AGENTS.md@server/src/built-ins/agents/reflection-coach AGENTS.md file
AGENTS.md@server/src/built-ins/agents/summarizer AGENTS.md file
AGENTS.md@packages/paperclip-runner/src/drivers/codex AGENTS.md file
AGENTS.md@apps AGENTS.md file
AGENTS.md AGENTS.md file
AGENTS.md@apps/web/src/components/Theater AGENTS.md file
AGENTS.md@apps/daemon AGENTS.md file
AGENTS.md@design-systems/_schema AGENTS.md file
AGENTS.md@design-templates AGENTS.md file
AGENTS.md@apps/closure AGENTS.md file
AGENTS.md@apps/web/src/components/chat AGENTS.md file
AGENTS.md@.github AGENTS.md file
AGENTS.md@apps/daemon/src/critique AGENTS.md file
AGENTS.md@apps/packaged AGENTS.md file
AGENTS.md AGENTS.md file
AGENTS.md AGENTS.md file
AGENTS.md AGENTS.md file
AGENTS.md@examples/deerflow-extension-knowledge-management AGENTS.md file
AGENTS.md@examples/deerflow-extension-workflows AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/runtime AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/agents AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/persistence AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/tui AGENTS.md file
AGENTS.md@examples/deerflow-extension-lightrag AGENTS.md file
AGENTS.md@frontend/src/core/auth AGENTS.md file
AGENTS.md@frontend/tests/e2e AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/uploads AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/typesafe AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/config AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/community/tavily AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/sandbox AGENTS.md file
AGENTS.md AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/tracing AGENTS.md file
AGENTS.md@frontend/src AGENTS.md file
AGENTS.md@frontend/src/core/memory AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/community/serper AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/mcp AGENTS.md file
AGENTS.md@backend/app/gateway AGENTS.md file
AGENTS.md@skills/public/data-analysis AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/community/brave AGENTS.md file
AGENTS.md@examples/deerflow-extension-weknora AGENTS.md file
AGENTS.md@examples/deerflow-extension-agent-teams AGENTS.md file
AGENTS.md@frontend/src/components/workspace/browser-view AGENTS.md file
AGENTS.md@backend/app/gateway/routers AGENTS.md file
AGENTS.md@backend/tests AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow AGENTS.md file
AGENTS.md@examples/deerflow-extension-knowledge-center AGENTS.md file
AGENTS.md@frontend/src/components/workspace AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/tools AGENTS.md file
AGENTS.md@frontend AGENTS.md file
AGENTS.md@frontend/src/core/background-tasks AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/agents/memory AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/persistence/user AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/extensions AGENTS.md file
AGENTS.md@scripts AGENTS.md file
AGENTS.md@skills/public/video-generation AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/subagents AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/skills AGENTS.md file
AGENTS.md@backend/app/channels AGENTS.md file
AGENTS.md@examples/deerflow-extension-knowledge-platform AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/models AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/reflection AGENTS.md file
AGENTS.md@backend/packages/harness/deerflow/utils AGENTS.md file