AGENTS.md vs CLAUDE.md, tested on 13 repos


AGENTS.md vs CLAUDE.md, tested on 13 repos
12 of mine load it. One never did, and I didn't notice for a month.  ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌
WotAI

AGENTS.md vs CLAUDE.md, tested on 13 repos

Hey there,

I have 13 repos that carry both an AGENTS.md and a CLAUDE.md. This week I checked how each one wires them together, expecting 13 identical answers.

Twelve import AGENTS.md on line one of CLAUDE.md. One asks the agent, in a sentence, to please go read it. That one holds 6,479 bytes of branch rules and load-bearing invariants that load only if the agent decides to.

AGENTS.md vs CLAUDE.md: which file your agent actually reads

AGENTS.md vs CLAUDE.md – a document the height of a building, and the one glowing line at the top that decides whether any of it loads

Every guide explains the difference between the two files. None of them runs the test, so I did: same author, same month, two wiring mechanisms, and only one of them is deterministic. The fix is one line. The more useful part is why nothing caught it for a month, and why my own first audit got the count wrong – it checked line one, reported two broken repos, and only one was. If you keep rules in a file and your agent still ignores them, this is probably where they went.

Read the measured comparison →


Reply and tell me what your line one says. I read every reply.

– Alex

P.S. – The conversations behind reads like these happen in the WotAI Skool community. 760+ builders, three live calls a week, free to jump in.

Come build with us

Follow WotAI: LinkedIn  ·  YouTube  ·  TikTok
You are receiving this because you subscribed to the WotAI newsletter. Unsubscribe

WotAI · AI Automation that Actually Ships

wotai.co

WotAI · 440 N. Barranca Ave., Unit 3777, Covina, CA 91723

WotAI

If you're building with Claude Code, n8n, or AI agents in production, this is the email I'd want. Weekly recap of what shipped, what broke, and how I'm running it. Specific over vague. Replies welcome.

Read more from WotAI

Claude, GPT-5 and Kimi, tested on the same 150 judgments Only four of the sixteen will admit when they are not sure. Claude, GPT-5 and Kimi, tested on the same 150 judgments Jev is the only sub-second model that will tell you it doesn't know TypeSafe shipped a model this week that returns calibrated probabilities instead of text, so I ran it against fifteen others on the same 150 judgments. It finished tenth on accuracy. I threw away two headlines before the data stopped contradicting me: the...

This Claude Code plugin loads before you type

This Claude Code plugin loads before you type It installs itself into every session, then quietly wins six skills. Plus 2 more reads. This Claude Code plugin loads before you type Hey there, I have both of the big Claude Code process plugins installed in the same repo. It took me a while to notice that six of their skills do the exact same job. Nobody warns you about that, and the thing that decides which one wins is smaller than you would expect. Six Claude Code skills collide, and one hook...

Claude Code edited my video

Claude Code edited my video I never opened the timeline once, and the spec became the whole job. Plus 2 more reads. Claude Code edited my video Hey Reader, Three reads this week, and two of them are about the same quiet shift: the tool got good enough that the bottleneck moved somewhere less glamorous. An agent that can drive a video timeline still cannot decide what belongs on it. A workflow that looks automatable can still be the wrong one to touch first. I let Claude Code edit a video, and...