Repo Agent Kit
Snapshot · 2026-09-01 · 100 pinned commits

39 of GitHub’s top 100 repositories use a root AGENTS.md.

A reproducible adoption snapshot of the 100 most-starred public repositories. Every repository has a commit-pinned status record, every positive result links to its exact file, and the complete sample is downloadable as JSON or CSV.

JSON CSV
39/100
Root AGENTS.md
39%
Adoption rate
112
Median lines
29
Mention testing
Analyze the 39 root files for configuration smells

Pinned evidence

The 39 repositories with a root file

The downloads include all 100 repositories, including the 61 without an exact root AGENTS.md at the pinned commit.

Root AGENTS.md evidence in GitHub’s 100 most-starred public repositories
Rank and repositoryStarsFile shapeSignalsEvidence
6
388.5K
362 lines
19 headings · 28 command lines
TestingScopeCompletion
Pinned file
10
317.7K
15 lines
2 headings · 0 command lines
Scope
Pinned file
13
280.4K
115 lines
18 headings · 1 command lines
TestingScope
Pinned file
17
245.7K
174 lines
14 headings · 2 command lines
TestingScope
Pinned file
18
243.8K
25 lines
0 headings · 0 command lines
Pinned file
20
239.5K
1784 lines
89 headings · 32 command lines
TestingScopeCompletion
Pinned file
21
224.2K
62 lines
5 headings · 5 command lines
Scope
Pinned file
25
208K
154 lines
12 headings · 23 command lines
TestingScope
Pinned file
26
203K
347 lines
26 headings · 28 command lines
TestingScopeCompletion
Pinned file
27
203K
161 lines
13 headings · 6 command lines
TestingScope
Pinned file
31
195.2K
92 lines
10 headings · 5 command lines
TestingScope
Pinned file
32
190.4K
5 lines
1 headings · 0 command lines
Testing
Pinned file
36
187.1K
69 lines
6 headings · 5 command lines
TestingScopeCompletion
Pinned file
40
182.9K
52 lines
7 headings · 4 command lines
TestingScope
Pinned file
41
179.9K
21 lines
2 headings · 0 command lines
Pinned file
45
175.2K
19 lines
0 headings · 2 command lines
TestingScope
Pinned file
49
168.4K
268 lines
32 headings · 11 command lines
TestingScopeCompletion
Pinned file
51
164.7K
49 lines
7 headings · 10 command lines
Scope
Pinned file
54
154.1K
15 lines
3 headings · 0 command lines
Scope
Pinned file
55
154K
243 lines
26 headings · 31 command lines
TestingScope
Pinned file
60
145.4K
372 lines
35 headings · 11 command lines
TestingScopeCompletion
Pinned file
63
142.4K
76 lines
10 headings · 2 command lines
TestingScope
Pinned file
64
142.1K
560 lines
60 headings · 55 command lines
TestingScopeCompletion
Pinned file
67
138.3K
172 lines
25 headings · 1 command lines
TestingScopeCompletion
Pinned file
70
136.2K
9 lines
1 headings · 0 command lines
Pinned file
73
132.9K
601 lines
55 headings · 5 command lines
TestingScope
Pinned file
74
131.1K
386 lines
11 headings · 5 command lines
TestingScope
Pinned file
75
130.9K
3 lines
1 headings · 0 command lines
Pinned file
76
130.9K
137 lines
12 headings · 9 command lines
Testing
Pinned file
80
126.7K
249 lines
11 headings · 3 command lines
TestingScope
Pinned file
81
126.5K
68 lines
8 headings · 14 command lines
TestingScope
Pinned file
82
125.9K
38 lines
6 headings · 6 command lines
TestingScope
Pinned file
86
122.3K
112 lines
15 headings · 1 command lines
Scope
Pinned file
87
120.7K
322 lines
28 headings · 17 command lines
TestingScope
Pinned file
88
120.2K
64 lines
5 headings · 1 command lines
TestingScopeCompletion
Pinned file
89
119.8K
32 lines
1 headings · 1 command lines
TestingScope
Pinned file
92
119K
322 lines
57 headings · 8 command lines
TestingScopeCompletion
Pinned file
94
117K
243 lines
13 headings · 7 command lines
TestingScope
Pinned file
99
113.3K
8 lines
1 headings · 0 command lines
Pinned file

Root-file status

The 61 repositories without a root file

Each record states the exact root-only boundary, links to the pinned commit, and offers a current public-branch audit.

Repositories without an exact root AGENTS.md at the pinned commit
Rank and repositoryStarsLanguagePinned commitStatus
1
codecrafters-io/build-your-own-x
Exact root path not found in the snapshot
544.6KMarkdownaa17439b62f3View record
2
sindresorhus/awesome
Exact root path not found in the snapshot
502KNot reportedd35bcd9c5c83View record
3
public-apis/public-apis
Exact root path not found in the snapshot
474.2KPython1d093a984adbView record
4
freeCodeCamp/freeCodeCamp
Exact root path not found in the snapshot
454.8KTypeScriptc8e64e20096eView record
5
EbookFoundation/free-programming-books
Exact root path not found in the snapshot
395.8KPython32aac0ab39f3View record
7
donnemartin/system-design-primer
Exact root path not found in the snapshot
367.4KPythonae9bbd7b02d9View record
8
nilbuild/developer-roadmap
Exact root path not found in the snapshot
366.1KTypeScript64d2a7275c4fView record
9
jwasham/coding-interview-university
Exact root path not found in the snapshot
360.2KNot reported717298bf219aView record
11
awesome-selfhosted/awesome-selfhosted
Exact root path not found in the snapshot
316.5KNot reportedc656b14a1ba7View record
12
practical-tutorials/project-based-learning
Exact root path not found in the snapshot
281.7KPython39aff3332574View record
14
996icu/996.ICU
Exact root path not found in the snapshot
276.8KNot reportedf5e35f48d769View record
15
react/react
Exact root path not found in the snapshot
248.6KJavaScript0209ef8a77bcView record
16
torvalds/linux
Exact root path not found in the snapshot
245.8KC786262be6048View record
19
trimstray/the-book-of-secret-knowledge
Exact root path not found in the snapshot
241.6KNot reported7d37069a361dView record
22
vuejs/vue
Exact root path not found in the snapshot
211.3KTypeScript9e8870794008View record
23
multica-ai/andrej-karpathy-skills
Exact root path not found in the snapshot
209.4KNot reported2c606141936fView record
24
ossu/computer-science
Exact root path not found in the snapshot
208.6KHTML33d44a44e352View record
28
tensorflow/tensorflow
Exact root path not found in the snapshot
198.3KC++2b01994c7feaView record
29
DigitalPlatDev/FreeDomain
Exact root path not found in the snapshot
197.1KMarkdown9c7c54110705View record
30
trekhleb/javascript-algorithms
Exact root path not found in the snapshot
196.6KJavaScript85293e3e2b88View record
33
ohmyzsh/ohmyzsh
Exact root path not found in the snapshot
189.5KShell9112b53fa8b5View record
34
massgravel/Microsoft-Activation-Scripts
Exact root path not found in the snapshot
189KBatchfile6401d2f36975View record
35
yt-dlp/yt-dlp
Exact root path not found in the snapshot
188.4KPythonbbc809a1161dView record
37
jackfrued/Python-100-Days
Exact root path not found in the snapshot
185.8KJupyter Notebook44b2575bf42aView record
38
CyC2018/CS-Notes
Exact root path not found in the snapshot
185.8KNot reportedb70121d377cbView record
39
getify/You-Dont-Know-JS
Exact root path not found in the snapshot
184.8KNot reported044120ef5556View record
42
flutter/flutter
Exact root path not found in the snapshot
178.7KDart51322b199b6eView record
43
microsoft/markitdown
Exact root path not found in the snapshot
177.6KPythonf618f478a724View record
44
github/gitignore
Exact root path not found in the snapshot
175.5KNot reported32652622a46dView record
46
twbs/bootstrap
Exact root path not found in the snapshot
174.7KMDX12cb8b902d17View record
47
521xueweihan/HelloGitHub
Exact root path not found in the snapshot
174.2KPython75c87e759278View record
48
anthropics/skills
Exact root path not found in the snapshot
173KPython53048666b05bView record
50
AUTOMATIC1111/stable-diffusion-webui
Exact root path not found in the snapshot
164.8KPython82a973c04367View record
52
jlevy/the-art-of-command-line
Exact root path not found in the snapshot
162.2KNot reported6b50745d2e78View record
53
Snailclimb/JavaGuide
Exact root path not found in the snapshot
158.2KJavaScript82bb2b64bbd5View record
56
open-webui/open-webui
Exact root path not found in the snapshot
150.6KPython2a960a59fe1dView record
57
msitarzewski/agency-agents
Exact root path not found in the snapshot
149.5KShell3c9588880b7cView record
58
Genymobile/scrcpy
Exact root path not found in the snapshot
148.7KC2926c06c5dc3View record
59
airbnb/javascript
Exact root path not found in the snapshot
148.1KJavaScript8ed19247bef1View record
61
anthropics/claude-code
Exact root path not found in the snapshot
143.7KPythona1e64dc407ddView record
62
x1xhlol/system-prompts-and-models-of-ai-tools
Exact root path not found in the snapshot
143.3KNot reported1e4203a7d888View record
65
clash-verge-rev/clash-verge-rev
Exact root path not found in the snapshot
141.6KTypeScriptf5cc24ec9fc7View record
66
ytdl-org/youtube-dl
Exact root path not found in the snapshot
141.1KPython956b8c585591View record
68
iptv-org/iptv
Exact root path not found in the snapshot
137.3KTypeScriptd006a4b6c9f7View record
69
golang/go
Exact root path not found in the snapshot
137.1KGo23761e7bb278View record
71
Shubhamsaboo/awesome-llm-apps
Exact root path not found in the snapshot
135.6KPythona13701eae315View record
72
labuladong/fucking-algorithm
Exact root path not found in the snapshot
135.5KMarkdownb1f23cb9605fView record
77
farion1231/cc-switch
Exact root path not found in the snapshot
130.6KRust68d71cc63920View record
78
krahets/hello-algo
Exact root path not found in the snapshot
129.7KJava28c1e74c1d35View record
79
Chalarangelo/30-seconds-of-code
Exact root path not found in the snapshot
128.9KJavaScriptf1b2d5a65c32View record
83
nextlevelbuilder/ui-ux-pro-max-skill
Exact root path not found in the snapshot
123.8KPythonf23267105ad1View record
84
electron/electron
Exact root path not found in the snapshot
122.8KC++e5f5e3df2542View record
85
shadcn-ui/ui
Exact root path not found in the snapshot
122.7KTypeScript8a1b5386010eView record
90
Hack-with-Github/Awesome-Hacking
Exact root path not found in the snapshot
119.5KNot reportedb2bb13aa69b4View record
91
harry0703/MoneyPrinterTurbo
Exact root path not found in the snapshot
119.3KPython3ade9fbc40e1View record
93
justjavac/free-programming-books-zh_CN
Exact root path not found in the snapshot
118.6KNot reportedcc1108ac90f5View record
95
godotengine/godot
Exact root path not found in the snapshot
116.5KC++74e99170ee72View record
96
2dust/v2rayN
Exact root path not found in the snapshot
115.2KC#7870ae89cf1fView record
97
mrdoob/three.js
Exact root path not found in the snapshot
115KJavaScript20bd26f2d1f2View record
98
d3/d3
Exact root path not found in the snapshot
113.6KShellca958d45217bView record
100
immich-app/immich
Exact root path not found in the snapshot
113.2KTypeScript1c7f9a4f24b1View record

What appears inside

Testing and scope are common. Completion rules are not.

29 of 39 files mention testing, validation, or quality checks.

32 mention scope, boundaries, or explicit restrictions.

Only 10 match the bounded completion-guidance signal.

AGENTS.md

11 repos

Commands

5 repos

Testing

5 repos

Project Overview

4 repos

Build commands

3 repos

Conventions

3 repos

Type checking

3 repos

Architecture

2 repos

Reproducible methodology

Exact root files, exact commits, no model judgment.

The first 100 public repositories returned by GitHub repository search sorted by stars descending for stars:>1.

Every repository is pinned to the default-branch commit resolved during the snapshot.

Adoption means an exact, case-sensitive AGENTS.md file exists at the repository root at the pinned commit.

Line counts, Markdown headings, command-shaped lines, and three bounded guidance regexes are computed without model judgment.

Limits: Nested AGENTS.md files are not counted when the root file is absent. GitHub stars and the top-100 boundary change over time; this is a dated snapshot, not a live ranking. Keyword signals show that guidance text is present, not that it is correct, complete, or followed. Repository popularity is not a representative sample of all software projects.
Reproduce or cite the dataset on GitHubCollector source, integrity checks, citation metadata, and a versioned JSON and CSV release.

Adoption is not readiness

Audit what a repository actually tells an agent.

Run the deeper deterministic rubric on any public GitHub repository.

Run live audit