Jev read every CLAUDE.md

What 58 CLAUDE.md files actually say to the agent.

Claude Code started reading AGENTS.md last week. GitHub now has over half a million public CLAUDE.md files. TypeSafe's Jev, a decision model that returns probabilities instead of prose, read a size-stratified sample of them and answered eleven questions about each. Then it can read yours.

58
CLAUDE.md files read
sampled from 0 public ones
45%
start with the /init boilerplate
14% look never edited
47%
tell the agent to verify its work
71% give exact commands
31%
contain a hard “never”
0% shout in caps
7%
read as LLM-written
0% leak something private

What files contain

Share of files where Jev put the probability above 50%.

  • Exact build / test / lint commands71%
  • Tells the agent to verify its work47%
  • Maps where things live in the codebase78%
  • Explicit prohibitions (never, do not)31%
  • Git rules: commits, branches, pushing2%
  • Bans comments or explanatory prose2%
  • Reads as LLM-generated7%
  • Shouts in ALL CAPS0%
  • Leaks something that should be private0%

What kind of document it is

  • Architecture map
    45%
  • Ops manual
    41%
  • Style guide
    9%
  • Persona
    5%

Does length help?

sizefilescommandsverify/init
<1k20%0%0%
1-2.5k683%33%17%
2.5-5k1984%63%68%
5-10k1872%50%39%
>10k1354%31%38%

Grade yours against the 58

one Jev call, about a tenth of a cent, on your own key

Free at console.typesafe.ai/keys, $5 credit included. The key is forwarded per request and never stored or logged.