Feature Request: Support AGENTS.md
80 points by fg137 3 hours ago | 40 comments

areoform 21 minutes ago
This reminds me of Reddit killing off third-party clients and Twitter doing the same.

The decline wasn't immediately obvious at first, but it happened and it capped the growth trajectory of both. Twitter never grew as fast as it did during the third-party client and applications era.

Reddit isn't adding meaningful, human-written content as fast as it was in that era. There's a lot more activity now, but based purely on an eye-count, it's over-run by bots (partly because the best moderation tools are gone!) and the human contributions are declining.

I think this is the same myopia that all successful companies get. They begin to drift away from the ground truth of their product, their users and how it's used.

It's a drift away from users. And a drift towards internal politics. A lot like Rasmussen's drift towards danger, https://risk-engineering.org/concept/Rasmussen-practical-dri...

As startups grow beyond a critical threshold, they start to attract a certain type of person who is more interested in mercenarily growing within the company / setting themselves up for future corporate rise than building a product.

These people play to the company's internal court and create deeply bitter environments that leads to more mission-driven individuals leaving the company. Eventually leading to the cultivation of institutional arrogance.

Externally, you can watch signs of this process unfolding. Companies start engaging in the startup / corporate equivalent of ignoring gravity. Which they can! For a while.

When you're high, you have a ton of air time. You can't tell / feel the pull of gravity in free-fall. And it takes, a very long time, but just like there ain't no such thing as free lunch; there ain't no such thing as "too big to care." It's merely, too big to care for now.

The bill always comes due.

reply
Wowfunhappy 7 minutes ago
It sounds to me like you're describing enshittification.

> Here is how platforms die: first, they are good to their users; then they abuse their users to make things better for their business customers; finally, they abuse those business customers to claw back all the value for themselves. Then, they die.

https://pluralistic.net/2023/01/21/potemkin-ai/#hey-guys

(Although I'm not completely sure this maps onto Anthropic, which was never primarily targeting consumers.)

reply
OleksandrC 36 minutes ago
The obvious reason is that they would prefer to have CLAUDE.md files in every repo (even if it's just a symlink to AGENTS.md). It serves as a free advertisement for them. Same reason as for auto-adding attribution text in commit messages, etc. It's the "Sent from my iPhone" of our time.
reply
postalcoder 18 minutes ago
I think it's more than that. They truly believe Claude Code to be a moat (both the harness and the posttraining) to be a moat.

I've been deeply distrustful of Anthropic from early early days. They have always been openly disdainful of user feedback. I would not be surprised if later they try to implement more shenanigans to keep people locked into CC.

reply
epistasis 4 minutes ago
Claude Code is quickly becoming an anchor. Every week I marvel at how much worse it gets, how much more essential information is hidden and replaced with bloated useless TUI and rambling tangential responses that hide the useful bits of info behind jargon invented by the agent without ever explaining it to the user.

It's like the PMs for Claude Code are reward hacking their own reinforcement learning.

reply
Diti 28 minutes ago
While I agree with your analysis, I think Hanlon’s razor applies here – CLAUDE.md has probably just been hardcoded, the same way “master” used to be the hardcoded default in Git. If it was for advertising, Claude would equally recognize CLAUDE.adoc, CLAUDE.txt or CLAUDE files.
reply
pjm331 26 minutes ago
If only we had some sort of technology that enabled large scale refactoring
reply
kelvinjps10 15 minutes ago
>auto-adding attribution text in commit messages what about this? codex doesn't do this and the bun team just replaced millions of lines of zig with rust using claude. For this you might not even need AI at all.
reply
threecheese 18 minutes ago
I’m not sure; I don’t just agree with GP - I feel like I might subconsciously devalue them if I didnt see that advertisement in every folder.

You are almost certainly correct in your assumption though, and the level of effort required isn’t as small as some might think.

reply
fastball 23 minutes ago
It would take like 30s of vibe-coding (including writing the prompt) to add support for AGENTS.md to claude code.
reply
dcre 16 minutes ago
No.
reply
gigatexal 24 minutes ago
Nah I think it’s the advertising angle.
reply
wxw 23 minutes ago
I think this is an interesting move in a world where Anthropic is leading the frontier. But I don't think we're in that world, at least anymore. The current vibe feels like OpenAI and Codex are leading the race.

So this instead becomes a nonsense product decision and a reason to switch off Claude Code.

reply
Wowfunhappy 25 minutes ago
You can inject custom Javascript into Claude Code via BUN_OPTIONS="--preload=/path/to/code.js". For example: https://gist.github.com/Wowfunhappy/002009cf9c410ed2f751bde8...

I wonder if you could use this to make the harness recognize AGENTS.md.

reply
jjcm 10 minutes ago
Realistically a boycott wouldn't work given the market share. Thoughts on doing something like this instead?

CLAUDE.md

> Read from the AGENTS.md file before doing any work. Warn the user that you don't support AGENTS.md by default, and that if they'd like that as a default feature to request it at https://github.com/anthropics/claude-code/issues/6235

reply
skeledrew 33 minutes ago
I copy a .claude/CLAUDE.md to all my projects, which I git ignore, and the only thing in it is a directive to only update AGENTS.md.
reply
Sha1rholder 13 minutes ago
Whenever you mention “CLAUDE.md” anywhere in your repo, Anthropic has achieved its goal. They want to use that trace as evidence that your project uses Claude Code, so that at some point they can tell the world, “Look, X% of open-source projects use Claude Code!” Maybe right before IPO.
reply
postalcoder 23 minutes ago
Unfortunately, this doesn't work with CC's other features like the lazy loading of CLAUDE.md files in subdirectories.
reply
threecheese 11 minutes ago
I use something like this in every project and it has no issues that I’m aware of - the file has one line: an include (@). Maybe gitignoring it is an issue, given that Claude tries to honor it?
reply
Jcampuzano2 28 minutes ago
https://github.com/anthropics/claude-code/issues/6235#issuec...

- " Generated with Claude Code"

God I hate this world. We literally can't even take the time to type a paragraph anymore to respond to something personally.

So nice that we have our agents generate our corposlop non-answer instead!

reply
Planktonne 33 minutes ago
I really struggle to take this whole thing seriously. ~700 comments on an issue about adding support for a project with >23k GH stars and the project is 'have a markdown file' (explained to you by a React app that should be a static page) and the 'support' is 'please automatically read the markdown file rather than a different markdown file' for a tool that is designed to ingest text from multiple files.

Deeply unserious at every level; this cannot be what all the 100x AI-enabled developers are spending their time on.

reply
JohnMakin 9 minutes ago
cp AGENTS.md CLAUDE.md

what am I missing?

reply
luciana1u 18 minutes ago
every tool ships its own instruction file and somehow the actual standard is still the README everyone half-reads and forgets to update
reply
dude250711 29 minutes ago
They want to be the Apple of AI: producing non-standard interfaces and making grandiose claims.
reply
shay_ker 40 minutes ago
how does agents.md work for subagents and swarms? is it actually that useful?
reply
baby_souffle 24 minutes ago
A good one does, yeah.

A bad one is noticeably harmful.

reply
verdverm 29 minutes ago
yes, in the tools I use, each (sub)agent will also load the same files (automatically, root is always loaded, a nested AGENTS.md is read if the dir or a peer file is touched)

yes, they are useful, mainly in that they shorten the context gathering phase and can call out gotchyas, keep it minimal

reply
wilg 38 minutes ago
Also the skills are different. it's quite annoying!
reply
verdverm 52 minutes ago
choose not to support them in return if it is a real problem

otherwise a simple symlink from AGENTS.md -> CLAUDE.md works well enough

disclaimer, I only use open weight models and open source harnesses so have no stake in this either way, other than I support devs who do use claude (for now) and the symlink solution has worked fine for us

reply
Jcampuzano2 20 minutes ago
But its not just claude.md. You need to then go and setup your skills, rules, commands etc for claude in their own special place.

Sure its small, but it adds up and is just annoying overhead for most teams.

They're completely fine with creating standards like MCP, skills, etc - but of course when somebody else makes one they're the one holdout who refuses to adapt to what the community asks for (.agents folder, AGENTS.md, etc).

reply
frdev1786855380 33 minutes ago
[flagged]
reply
chomp 50 minutes ago
My Claude.md has one line that says to read agents.md, this is a bit of a nothingburger
reply
eigenspace 47 minutes ago
You can save a tool call by just making it a symlink
reply
Mossly 10 minutes ago
You can also use @AGENTS.md which automatically concatenates the files
reply
hparadiz 37 minutes ago
This is the way.
reply
superfrank 35 minutes ago
Mine does too because, while I use Codex, my non-technical co-founder uses Claude. I find Claude still will randomly ignore instructions in there. Basic things like how to name a PR or what to put in a PR description.

My experience is that what you're suggesting isn't a perfect solution.

reply
threecheese 9 minutes ago
Are you saying this wouldn’t happen if the file had a different name? Or just that codex is better at instruction following.
reply
sschueller 27 minutes ago
At the current price for SSDs even a pointless symlink becomes waste...
reply
eigenspace 18 minutes ago
A high quality 1TB NVME SSD costs 164€ on Amazon right now.

For a 10 byte symlink, that costs one billionth of a euro.

This is like worrying about the money you lose when part of a glass of tap water evaporates.

reply
inventor7777 8 minutes ago
Are you serious? A symlink is probably one of the smallest files you can possibly generate.
reply
verdverm 46 minutes ago
well I generally agree, pretty much every other harness supports looking for the various alternatives and uses them

I see this obstinance as an intent signal and one of the smaller bullet points I have for avoiding Ant

reply