logoalt Hacker News

Feature Request: Support AGENTS.md

124 pointsby fg137yesterday at 9:19 PM71 commentsview on HN

Comments

areoformyesterday at 11:13 PM

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.

All successful startups begin to drift away from the ground truth of their product. 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...

My theory is that 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.

show 1 reply
OleksandrCyesterday at 10:58 PM

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.

show 1 reply
nullbiotoday at 12:10 AM

Stop supporting Anthropic with your money. They are a hostile company.

show 1 reply
wxwyesterday at 11:11 PM

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.

Wowfunhappyyesterday at 11:10 PM

You can inject your own 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.

jpalomakitoday at 12:30 AM

It’s easy to end up with bunch of old stuff in AGENTS.md that latest models no longer need and what might just confuse them. See for example the story about Anthropic cutting 80% of their system prompt [1].

Maybe they feel just using the AGENTS.md written for another model and possibly different era gives bad user experience.

[1] https://claude.com/blog/the-new-rules-of-context-engineering...

asveikautoday at 12:35 AM

> I propose that Claude Code adopt a dual-file approach that prioritizes its native format while gracefully falling back to the open standard.

I'm having flashbacks to the fact that GNU make reads GNUmakefile before Makefile, so it's possible to write one makefile using GNU extensions and another that works on BSD or (back in the day) commercial unix.

skeledrewyesterday at 11:01 PM

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.

show 1 reply
Jcampuzano2yesterday at 11:06 PM

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!

Planktonneyesterday at 11:01 PM

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.

dude250711yesterday at 11:05 PM

They want to be the Apple of AI: producing non-standard interfaces and making grandiose claims.

acedTrextoday at 12:51 AM

agentsmd is a ridiculous concept, it feels like a huge psyop that theres so much hullabaloo about this ridiculous markdown file.

show 1 reply
jjcmyesterday at 11:25 PM

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

drivingmenutstoday at 12:20 AM

Why not symlink AGENTS.md to CLAUD.md?

show 2 replies
HDBaseTyesterday at 11:43 PM

How exactly does Claude not support AGENTS.md?

I can ask Claude to review AGENTS.md and it will read it. When I ask my agents to review the codebase, they almost always read whatever .md files exist.

show 2 replies
shay_keryesterday at 10:54 PM

how does agents.md work for subagents and swarms? is it actually that useful?

show 2 replies
wilgyesterday at 10:56 PM

Also the skills are different. it's quite annoying!

luciana1uyesterday at 11:16 PM

every tool ships its own instruction file and somehow the actual standard is still the README everyone half-reads and forgets to update

douglas77yesterday at 11:42 PM

Anthropic implemented it https://github.com/Piebald-AI/tweakcc/pull/459

show 2 replies
verdvermyesterday at 10:43 PM

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

chompyesterday at 10:44 PM

My Claude.md has one line that says to read agents.md, this is a bit of a nothingburger

show 4 replies
frdev1786855380yesterday at 11:01 PM

[flagged]

JohnMakinyesterday at 11:25 PM

cp AGENTS.md CLAUDE.md

what am I missing?

show 1 reply