Feature Request: Support AGENTS.md

8/20/2026 at 11:17:33 AM

So many developer-hostile things lately.

Just a few days ago they turned on an experiment the forces claude code to use bash over standard tools in auto mode.

From the system prompt directly, new as of August 18th:

  Do your work through the Bash tool wherever it can accomplish the job: read files with cat, head, or sed -n, search with grep and find, and make file changes with sed, heredocs, or short scripts, rather than using the dedicated Read, Edit, or Write tools. Fall back to a dedicated tool only when Bash genuinely cannot do the job.

I was wondering why Claude Code started ignoring my LSP tools and such a couple days ago, and this is why. Prompting around it (even with CLAUDE.md) results in low adherence. This can be turned off by setting a special environment variable (setting CLAUDE_CODE_THRIFTY_SONIC to 0), but this is just a bad idea all around.

I'm sure they'll argue they are trying to make it use less context tokens to do things, but if this is the best they could think of, ....

This is of course, also not documented anywhere, as is typical for anthropic, you just have to guess whether you are going crazy or if they changed stuff seriously on you under the covers.

This was the last straw for me. Their harness (models are fine) was already falling well behind the other one i use (OMP) in the past 6 months in usability/etc, and they are the only ones who don't allow me to use other harnesses with my subscription.

So I've now stopped using claude code entirely. Unless something changes, i'll drop my max plan when it expires next month.

by DannyBee

8/20/2026 at 11:45:02 AM

> So many developer-hostile things lately.

It is extraordinary how they managed to fuck up all of their goodwill with all these unnecessary stuff. They truly are a hostile company if I have ever seen one. And they had the entire developer community cheering for them a couple months ago.

I hope they fail in their mission, whatever that is. Because I'm sure it's no benefit to anyone ever.

by eknkc

8/20/2026 at 1:22:29 PM

While they’ve certainly fucked up goodwill with their actions, it’s also true that the tech enthusiast community has always been like teenagers who reject their favorite band when it gets popular.

Oh, I used Claude before they got popular… their new stuff is trash compared to the early albums

by brookst

8/20/2026 at 2:42:10 PM

ha, a bit aggro, but I gave you an upvote because I think you aren't wrong.

by sanderjd

8/20/2026 at 3:48:13 PM

It's astonishing how often Anthropic choose to self-own. They're giving AMD a real run for their money in "never miss an opportunity to miss an opportunity"

by unrented7977

8/20/2026 at 2:45:37 PM

> It is extraordinary how they managed to fuck up all of their goodwill with all these unnecessary stuff.

The product is almost completely vibed with no humans in the loop (neither writing nor reading).

IOW, there is little to no human judgement or care exercised in the production and maintenance of it, with predictable results.

by lelanthran

8/20/2026 at 4:00:43 PM

I mean their track record when humans are in the loop is not better either. Decisions on hidden downgrades, subscription usage restrictions, account bans, neverending dance around model availability on subscription plans. Keeping CC closed source. Not releasing a single open model. BURNING BOOKS..

OpenAI feels like a bastion of competent management and development compared to this shit show and they have a psychopath on the helm. This is an achievement by itself.

by eknkc

8/20/2026 at 1:23:30 PM

What I find amazing is how many people are still clutching onto Claude Code like it's the only feasible tool and somehow genre-defining?

I personally got sick as f with their unreliability and hostility and bugs back in about January and switched to Codex but this is still very clearly a minority position.

I'm sure OpenAI will do the same nonsense eventually, but people need to act like they have options.

by cmrdporcupine

8/20/2026 at 2:44:54 PM

It's just an immature ecosystem still, which means that everything has its drawbacks (IMO). I like Code way more than Codex. I like Pi a lot, and I expect it or something like it will eventually be the winner here for me, but I really miss the no-brainer "it just works" integration of Claude into Code, and the non-usage-based billing. Pi feels a lot more "raw" to me at the moment.

by sanderjd

8/20/2026 at 1:44:10 PM

Interesting. They really have a fraught history dealing with shell in a sane way:

https://github.com/anthropics/claude-code/issues/7490

by e12e

8/20/2026 at 12:53:51 PM

Oh is that why? Thank you! This saw me downgrade to Opus 4.8 for the past several days. I had no idea where it was coming from.

by pie_flavor

8/20/2026 at 4:42:04 PM

Oh ffs is that why it suddenly started running into a ton of permissions errors trying to read and write files outside it's sandbox (I think the auto mode classifier blocks bash commands that would be allowed as read commands) and runs into all this nonsense where it uses bash to read a file then later tries to use the write tool and gets blocked on "must read file before writing it" and stuff? I thought I was going crazy yesterday- like had something changed ov5or had I just somebody not noticed it was failing tool calls that badly for months until yesterday but it makes sense if it was just because of that system prompt update. That's so god damn annoying idk how many tokens are getting wasted in the past couple days on these failed tool calls but it's not a trivial number

by vikramkr

8/20/2026 at 1:01:23 PM

> and they are the only ones who don't allow me to use other harnesses with my subscription.

Google too.

by XYen0n

8/20/2026 at 1:29:06 PM

For what reason are they encouraging it to use bash over the purpose-specific tools?

by cedws

8/20/2026 at 2:46:27 PM

If i'm trying to steel-man why, I presume because the read/write/edit tools use more context tokens because they don't support reading part of a file/etc.

So the agent is going to put less into context when it uses sed to see 15 lines of a file than using read and putting the entire file into context.

That is my best charitable guess at what they are hoping to achieve.

Of course, there is an obvious set of solutions for this problem that don't involve pushing the agent to use bash.

by DannyBee

8/21/2026 at 12:00:22 AM

Surely the read and update tools support ranges

by olejorgenb

8/20/2026 at 8:17:45 PM

Probably because it makes distilling and external analysis/tracking harder.

by MintPaw

8/20/2026 at 12:08:46 PM

[flagged]

by tomveber

8/19/2026 at 11:10:01 PM

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.

by Wowfunhappy

8/19/2026 at 11:13:32 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 time, 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.

by areoform

8/20/2026 at 7:06:51 AM

The Twitter situation was a bit different: I built the very first Android Twitter client which grew to millions of users. We later got acquired by TweetUp and I'm partly responsible for their strategy to acquire other popular clients, too. We basically owned 60%+ of the third-party market within months with the potential of 'migrating' a large portion to a new tbd Twitter competitor. Needless to say Twitter wasn't happy, and the rest is history. Never build on somebody else's turf.

by thm

8/20/2026 at 1:22:46 AM

> 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.

Pournelle's Iron Law of Bureaucracy.

by chipsa

8/20/2026 at 2:44:41 AM

My shorthand is builders vs extractors.

by richardw

8/20/2026 at 5:03:14 AM

Companies start in Growth mode and as they get older investors demand they mature into Margin mode.

by edoceo

8/20/2026 at 7:26:09 AM

There’s a point where you have to start paying people back the money they gave you.

I’ve been in companies that have grown fast and then realised that their margins are very slim. It’s a very grim position to be in.

Great turnover - where’s the profit?

by iamflimflam1

8/19/2026 at 11:27:28 PM

It sounds to me like you're describing enshittification. As coined by Cory Doctorow:

> 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.)

by Wowfunhappy

8/20/2026 at 2:12:45 AM

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

This pisses off businesses though. I guarantee you that multiple businesses will set up workflows with different AIs for orchestration as sold to them by OpenAI and Anthropic. Cue agents.md not working, "What do you mean the thing I'm paying this much per seat for doesn't play well with the other AIs?"

The consumers here are developers -- who are--> potential founders OR future purchase decision makers.

It's a TERRIBLE idea to piss them off just because they're small.

They're "small" right now. But quite a few of them will have long careers and they will remember.

It's why so many trad corp companies give stuff away to students for free / treat the people on the come up as first tier customers. Because those are future decision makers. And the turn table turntables.

A cautionary case study is Google. How many times does a founder who is considering which cloud service to use gets cautioned to never use Google Cloud?

Google Cloud was a has been before it ever got out of the gate because of just how much goodwill Google blew up over the years. There's nothing, literally nothing, they can spend money on to make that go away in the short-term. And they're not willing to commit to the long-term.

by areoform

8/20/2026 at 1:45:47 AM

Precisely. Anthropic was never good to its consumer users.

by OutOfHere

8/20/2026 at 12:48:44 AM

it's always been this way with Claude/Ant though, not something that changed

This is more SV modus operandi

by verdverm

8/20/2026 at 3:16:10 AM

Reddit is undergoing an even worse tragetory right now:

They're a lot heavier on the censorship and sidewide ban. Subs are being astroturfed as much or worse than usual.

On top of that they're trying to stop anonymous browsing by paywalling on a timer.

by monksy

8/20/2026 at 3:25:25 AM

They finally killed the `old.reddit.com` subdomain for logged-out users this week, which was the final push I needed to stop even idly browsing. I've been using the site since at least the digg exodus in 2010.

by ghostpepper

8/20/2026 at 6:22:39 AM

They are also slowly killing /r/all ahead of the elections

by nextaccountic

8/20/2026 at 6:47:47 AM

you can still access old reddit by choosing on Settings → User Preferences → Prefer classic UI or something like that

by ybbond

8/20/2026 at 6:54:04 AM

As the gp says, only if you're logged in.

by n1c

8/20/2026 at 11:11:22 AM

They've also been making it so the preference seemingly doesn't stick now. Used to be it would just randomly undo that setting, now it just doesn't respect it at all in my experience.

by xienze

8/20/2026 at 3:28:13 AM

They are trying to stop scraping, I guess.

by operatingthetan

8/20/2026 at 4:08:02 AM

Scrapers won't be stopped by needing an account; in the recent discussion [0] about this, someone mentioned that there's even a JSON API you can use - by appending .json to any post! It's to drive engagement... for the advertisers. They gotta keep the valuation up after the IPO.

[0] https://news.ycombinator.com/item?id=49015533

by spaqin

8/20/2026 at 9:24:48 AM

I exposed this JSON API in the same style as their original API at api.reddiw.com and they banned my account without warning. I explicitly included my reddit username in the user-agent so that they could reach out if they had a problem with it. Nope, straight to banning my decade old account.

The company has turned evil sadly.

by dom96

8/21/2026 at 3:54:01 AM

spez likes your comment.

by monksy

8/20/2026 at 6:45:06 AM

Well ya, but they have written posts to mods explaining that their long term goal is to limit scraping.

by operatingthetan

8/20/2026 at 4:25:20 AM

> They finally killed the `old.reddit.com` subdomain for logged-out users this week...

Is it a gradual shutdown? [0] works just fine for me, and I don't and have never had a Reddit account so I'm always logged out. I've visited a few of the comment threads on that page and they all display just fine.

[0] <https://old.reddit.com/r/mikrotik/>

by simoncion

8/20/2026 at 4:37:25 AM

It’s been broken for me for at least a week. When I click that link I get:

Log in to use old Reddit To keep Reddit safe, accounts are required to access old Reddit. Log in, or continue without an account on reddit.com.

By continuing, you agree to our User Agreement and acknowledge that you understand the Privacy Policy

—

Somehow Reddit thinks I care enough about their content to set up an account and log in just to read it. They are mistaken.

by OkGoDoIt

8/20/2026 at 5:10:34 AM

I get the login wall too. Chrome (incognito)/Android/Pixel

by edoceo

8/20/2026 at 10:54:24 AM

"To keep Reddit safe", god why do they have to lie in such an obnoxious and patronising way?

by suddenlybananas

8/20/2026 at 3:58:58 PM

because its spez. That is his nature.

by monksy

8/20/2026 at 4:39:34 AM

Hmm.

I'm using Firefox on a full-sized computer (that is, not a phone or tablet). Do you get different results with Firefox on a full-sized computer, or is that your primary web browser?

> Somehow Reddit thinks I care enough about their content to set up an account and log in just to read it. They are mistaken.

Same here.

by simoncion

8/20/2026 at 4:47:08 AM

I wouldn’t be surprised if it has more to do with the fact that I’m currently in Vietnam. I certainly get a lot of websites that give me extra hassle about accessing from here, or some simply refuse to load at all. Just try booking a domestic USA flight on Frontier Airlines or Southwest Airlines while currently being in Southeast Asia…

For what it’s worth, I’ve received this on my iPhone running safari. I almost never use Reddit, and when I do it’s usually because I’m casually browsing and someone linked to it, and for that type of usage I’m almost always on my phone. I can’t remember the last time I attempted to access Reddit on an actual computer. But I’m clearly not their target user, I simply don’t care about them enough to be willing to jump through any hoops.

by OkGoDoIt

8/20/2026 at 6:57:54 AM

Doesn't work in Europe either -> full login wall, Desktop Firefox.

by onli

8/20/2026 at 4:54:27 AM

> I certainly get a lot of websites that give me extra hassle about accessing from here, or some simply refuse to load at all.

That's fuckin lame.

Thanks for the detailed reply.

by simoncion

8/20/2026 at 6:32:12 AM

I haven't been able to access old reddit for ages, but it is different now. Previously, they just gave me that obnoxious fedora-reddit-guy "whoa there pardner!" and some anti-bot message I think, but now it explicitly says "Log in to use old Reddit. To keep Reddit safe, accounts are required to access old Reddit."

by duskdozer

8/20/2026 at 9:36:28 AM

logged-out users have been blocked if using a VPN for a while.

by flir

8/20/2026 at 4:47:12 AM

That link is giving me a login screen completely on desktop.

New reddit: Doesn't require a login Redlib: Doesn't require a login

by monksy

8/20/2026 at 8:11:19 AM

It worked for me (from two French IP addresses in different ASs) for two or three weeks since people started talking about. Now it's gone too.

by progval

8/20/2026 at 6:10:36 AM

My Reddit account is 14 years old, I've decided to stop using the website and overwrite all historical comments with a protest message.

I honestly did not enjoy it anymore, almost all subs feel political these days (and the worst kind of politics, American politics ;)), the hive mind downvotes everything that it disagrees with (irrespective of the merit or quality of the message) and you get bans for seemingly everything if the mods disagree with you (/r/UnitedKingdom for criticizing the government motability scheme, /r/Europe for "rape belittlement" for a message in which I mentioned _war crimes_ such as rape. I guess calling it a war crime isn't serious enough...).

Glad to have ditched it! It's a shame there isn't a similar community like old Reddit but I guess we'll get one at some point!

by LaurensBER

8/20/2026 at 7:05:37 AM

Actually, Reddit is a lot more dead than that right now. I would argue >90% of the content now is fake.

by kaliqt

8/20/2026 at 7:19:43 AM

That is a big claim. I know some of it is because I have interviewed people who have described ~exploits building LLM redditors.

But >90%? Can you provide something that supports something in this ballpark?

by bredren

8/20/2026 at 8:04:39 AM

I don’t think it’s 90%, but also - fake content doesn’t apply just to LLM generated content.

When you go the places which are clearly at the target of bots such as commercial products, geopolitical issues, and politics - the ratio becomes bad.

This is also true in hacker news, but the moderation team here is good enough in burying these topics away from the front page for the most part.

by gpt5

8/20/2026 at 5:53:17 AM

This is the Iron Law of Bureaucracy

by inigyou

8/20/2026 at 4:42:34 AM

I agree with you on this general pattern, but I don’t really see how it applies to Claude Code’s usage of claude.md specifically.

I believe Claude code has been using that file since before the agents.md standard, so it’s not really a business decision to be different. There are some potential rough edges with changing over now, and the best proposed solution in the GitHub issue could be a bit complicated and error-prone from a technical or security point of view.

I’m not saying I agree with the decision, I would certainly prefer if they standardized on agents.md, but I don’t really believe their lack of doing so is deliberate enshittification.

by OkGoDoIt

8/20/2026 at 12:10:45 AM

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

by nullbio

8/20/2026 at 7:45:09 AM

How quickly this has changed since the time when people were boycotting OpenAI for making a deal with US Department of Defence and switching to Anthropic.

by fallingbananna

8/20/2026 at 8:05:52 AM

Did nullbio say something like that? There are a lot of people on hn, and they have a lot of differing opinions.

by marand23

8/20/2026 at 10:37:05 AM

They’re all hostile.

by voisin

8/20/2026 at 12:52:24 AM

Fireworks and OpenCode both have excellent open model offerings

prefer open companies to closed ones

by verdverm

8/20/2026 at 1:26:38 PM

[flagged]

by brookst

8/19/2026 at 11:11:19 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.

by wxw

8/20/2026 at 10:36:26 AM

So because of the hardship of renaming a file, creating a symlink, or importing another file, you rename a file.

If somebody switches because of this, then they lie.

by ruszki

8/20/2026 at 12:35:01 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.

by asveikau

8/20/2026 at 4:30:25 AM

Workaround: local symlink from CLAUDE.md to AGENTS.md, inside each repo.

It's not pretty, but it works, and it has become my standard practice, so that I get consistent behavior between claude cursor codex etc.

by blevinstein

8/20/2026 at 4:35:50 AM

I put “@AGENTS.md” in a sibling CLAUDE.md which makes it a bit more explicit and don’t want to run into compatibility issues with the different types of OS’es / filesystems people are using.

But yeah, I think the ultimate goal of Anthropic is just to have a CLAUDE.md in every repository for marketing.

by stingraycharles

8/20/2026 at 6:23:41 AM

You can also use .claude/CLAUDE.md which will be found. I symlink that to my AGENTS.md which keeps my top level dir clean

by djc404

8/20/2026 at 6:35:46 AM

Is there a way to make this with for both window and Linux users through git?

by phito

8/20/2026 at 7:40:18 AM

"read AGENTS.md and follow it" in the first line of CLAUDE.md should work

by shunia_huang

8/20/2026 at 2:53:27 AM

@boris and anthropic in general are incredibly hostile to the rest of the development world. They think their shit doesn’t stink.

by johnmlussier

8/20/2026 at 2:11:50 PM

I think it mostly amounts to getting extremely high on their own supply.

Many of us have experienced the sinking feeling of having used an agent to build an entire beautiful castle and then turned around and found themselves lost in its dungeons unaware of how the thing is actually laid out.

I actually think they're fully down there in their own code base, product requirements, and the like and ... don't know what's around the bend anymore.

And when you have leadership at the top insisting that software engineers will be obsolete any day now, what do you expect? Good solid software engineering requires competent stable and principled leadership hopefully with an obsession on quality and customer excellence.

Telling people that their profession is obsolete because robots are taking it over is only going to poison the well.

Core engineering at Anthropic seems to have just rotted away.

by cmrdporcupine

8/19/2026 at 11:25:02 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

by jjcm

8/19/2026 at 10:58:31 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.

by OleksandrC

8/19/2026 at 11:16:11 PM

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.

by postalcoder

8/19/2026 at 11:30:29 PM

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.

by epistasis

8/19/2026 at 11:51:26 PM

What tools do you find are better?

I have been happy with Claude Code lately, but I haven't explored other options much in over a year. Curious to try something else out if it's less rambling and tangential.

by annzabelle

8/20/2026 at 12:28:13 AM

> less rambling and tangential

This is not necessarily a problem with the harness (IE, swapping from Claude Code wouldn't necessarily fix this).

If what you're looking to avoid is specifically 'rambling and tangential', you can get quite far with anything that adds directives to avoid those things, early in every context window. Ie, through use of Agents.md/claude.md, skills, hooks, and so on.

Changing model would also affect this. Fable 5, Opus 5, and Sonnet 5 are all going to average out to different levels of ramble. Openai, Xai, Google, etc; different providers models will also have different levels of ramble.

What Claude Code does take away from you is some level of control over what makes it into the context window. The system prompt which claude code append to the beginning of every session of course has measurable ramble-affect.

I quite like the Pi harness, most in part because important goal with the approach behind it is "give the user as much control over what makes it into the cotext window as possible."

Codex TUI is also good. Haven't touched it since moving to Pi however. Again- harness isnt the big "stop rambling" thing to change, tho.

by agentdev001

8/20/2026 at 4:52:08 PM

Yeah, exactly, the thinking process of the latest Claude models have really mucked up the responses they show to users, presumably to game benchmarks or something. My agents are constantly referring to things that happened behind the scenes, either in thinking or with subagents, as if I had full visibility into every aspect of everything they saw. But with Claude Code, everything is hidden.

I've taken to looking through the jsonl of sessions rather than trying to get Claude Code to explain what it means, and have better success about 50% of the time.

Older models work better, IMHO, and one can configure Claude Code to use any model that supports Anthropic Messages format, or a translator to other models, but the TUI itself is something I'm also straining against, and prefer Pi usually.

Anthropic's moat is actually workplace environments that are serving the opposing goals of 1) executive demands to use AI, and 2) legal demands to keep all company data on lockdown. In that environment, employees can get locked into whatever the approved AI methods are, and Anthropic excels in navigating that.

by epistasis

8/20/2026 at 12:20:30 AM

The sub only works in Claude Code itself (unless they changed that rule again?), and all the Chinese models are trained on Claude Code (a bunch of them don't even work in Codex).

I use a custom harness, but I constantly hear good things about Pi.

EDIT: Checked out Pi and Oh-My-Pi. 250k LoC and 1.5M LoC respectively. Sheesh. How's that for minimalism...

Mine's 50. (Lines.)

https://gist.github.com/a-n-d-a-i/bd50aaa4bdb15f9a4cc8176ee3...

Vendored in my own LLM micro library (100 LoC) so it's 150.[0]

There's no parallelism or anything, but I use it for surgical edits and it's much faster and cheaper than the official harnesses for some reason. (Absence of sysprompt bigger than my repo probably helps there...)

[0] This one uses OpenRouter so you can use it with any model, but jerry rigged Codex sub version available on demand :)

---

I also have a ultra turbo bloated version (500 lines... need to strip it down a bit!) which has autorun files (for grep-based context injection), notification (frog croak when agent done, etc.) Watch this space!

by andai

8/20/2026 at 12:29:07 AM

They did walk that back, you are able to use an Anthropic login in a non-anthropic harness. (For now.)

(Edit: I failed too mention, using a different harness with a CC/Anthropic subscription bumps you up to the pay-per-token rate.)

by agentdev001

8/20/2026 at 12:36:46 AM

Yeah and it bills extra usage? Or did they walk that back too.. gotta keep the customers on their toes!

by andai

8/20/2026 at 12:47:29 AM

Shoot, yes. The user experience of logging in is the same, but yes- using a different (non-cc) harness bumps you up to the pay-per-token rates.

However! I have seen projects which use CC under the hood, in order to get the subsidized rates.

Writing comments which get me to go look through anthropic documentation, and find friction I wasnt aware of (CC does not have an app-server), refreshes my frustration towards anthropic.

by agentdev001

8/20/2026 at 1:02:44 AM

Doing the whole “pay per token rate” when logging into a harness not made by them is not only being enforced by anthropic/claude though. It also is what Google does with agy (their TUI).

Is there any provider that doesn’t do this? That’s the one I want to support.

  > TLDR: they are all probably doing it because they are banking on you not using all your tokens.

I would be surprised though, it makes business sense to make the default vendor native TUI cheaper because it’s understood that most nascent users will just use the harness offered by the LLM provider and those that would stray off that would probably be more power users who would spend their token share more consistently till it drains.

by alanwreath

8/20/2026 at 1:15:25 AM

OpenAI allows you to use the subsidized limits outside of their products. I don't think they clearly "tell" the world that this is the case, but they do put out a product surface that- I dont think they would, if they didnt allow this usage.

This is... close. They offer ways to leverage openai subscription directly for 3rd party app use. https://learn.chatgpt.com/docs/app-server

by agentdev001

8/20/2026 at 1:13:24 AM

    > Is there any provider that doesn’t do this? That’s the one I want to support.

Yes, IIRC, OpenAI. In sama we trust??

by areoform

8/20/2026 at 1:49:13 AM

Pi with Claude is better than Claude code in my experience. But I even use old GLM5.2 with pi and generally have a better experience than current Claude Code. It reminds me of peak productivity with Claude Code of 5+ months ago.

by epistasis

8/20/2026 at 12:16:03 AM

New guidelines that I have seen in a certain place is to configure and update existing CC setups to be CC/Codex agnostic. Plus setting up both allows Claude Code to delegate tasks [1] to Codex to reduce usage.

Most are easy to share with symlinks and @agents.

https://github.com/openai/codex-plugin-cc

by 8cvor6j844qw_d6

8/20/2026 at 12:21:32 AM

Oh my god, that's an official plugin. That's hilarious. I had the same idea last year, when I noticed how much cheaper GPT was for the same tasks, but Claude was still better as a high level "operator".

Also cause OpenAI was cool with you calling their sub in an automated way, but Anthropic very much was not (they were banning people at the time).

by andai

8/20/2026 at 12:34:22 PM

I resist the Node.js rage by using the Rust agent https://maki.sh/ . It is very capable and has a sane plugin system via Lua.

by speq

8/20/2026 at 12:39:28 AM

T3 Code if you want to use your subscriptions in an interface that respects its users.

by cleaning

8/19/2026 at 11:56:30 PM

Not OP but I like OpenCode a lot. But OhMyPi: https://omp.sh/ is also taking off. Personally I didn't like it as much as OpenCode.

by dalenw

8/20/2026 at 6:12:44 AM

yeh i tried pi, as a neovim user i naturally like customizability, but with how little i use agents, i want something that just works, which opencode does for me.

by pixlmint

8/20/2026 at 7:47:30 AM

I use it in a very basic way on the $20 plan and the code it produces seems alright (for the parts I care about) but I increasingly can't stand the way it "talks". I may actually change to something else entirely for this reason.

by conradfr

8/20/2026 at 1:13:09 AM

Ironically, I think Claude Code is shit, especially after I started to get used to Pi.

It has a sort of first mover advantage, but I wouldn't be surprised if basically any harness is superior to that crap.

by surgical_fire

8/20/2026 at 12:25:37 AM

Except I actively despise that commit message anytime I see it.

by johnsmith1840

8/19/2026 at 11:07:06 PM

[flagged]

by Diti

8/19/2026 at 11:08:24 PM

If only we had some sort of technology that enabled large scale refactoring

by pjm331

8/19/2026 at 11:12:02 PM

It would take like 30s of vibe-coding (including writing the prompt) to add support for AGENTS.md to claude code.

by fastball

8/19/2026 at 11:17:01 PM

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.

by threecheese

8/19/2026 at 11:19:13 PM

>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.

by kelvinjps10

8/19/2026 at 11:36:10 PM

rg CLAUDE.md > refactor_hits.txt

claude -p "@refactor_hits.txt support either CLAUDE.md or AGENTS.md in each location. if they both exist, prefer CLAUDE.md and do not concatenate"

by nostrebored

8/19/2026 at 11:11:06 PM

Nah I think it’s the advertising angle.

by gigatexal

8/19/2026 at 11:18:15 PM

No.

by dcre

8/20/2026 at 8:56:27 AM

I didn’t even realize Claude Code doesn’t honor AGENTS.md. Nothing a quick sed -i -e s/CLAUDE.md/AGENTS.md/g can’t fix

by fmajid

8/20/2026 at 10:54:40 AM

I was thinking ln -s AGENTS.md CLAUDE.md but to each their own.

by Frost1x

8/20/2026 at 11:23:45 PM

It works, but the problem is that you then have to do that in every repo you clone, it gets annoying.

by wlonkly

8/20/2026 at 11:57:18 AM

Really strange; anyway it is closed source and best not to have too much reliance and attachment to any one tool. I have switched to GPT 5.5 and 5.6 Sol and Codex ove Claude already. Fable is very expensive/token limiting. I am an experienced programmer heavily using AI for many POCs now. At one time Anthropic and its models Opus,Fable looked leading; now OpenAI has caught up. I find 5.5 models more than enough for most tasks and have shifted back to codex

by alexcpn

8/20/2026 at 12:46:12 PM

To be honest I am not even bothering learning to use these harnesses much less tweaking the bare minimum configs.

I fully expect I will be switching every couple of years to a new one. And even if I don't, they will be very different then than they are today.

by DanielHB

8/19/2026 at 11:01:25 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.

by skeledrew

8/19/2026 at 11:21:32 PM

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.

by Sha1rholder

8/19/2026 at 11:11:50 PM

Unfortunately, this doesn't work with CC's other features like the lazy loading of CLAUDE.md files in subdirectories.

by postalcoder

8/19/2026 at 11:23:37 PM

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?

by threecheese

8/20/2026 at 10:59:24 AM

I put a reference to AGENTS.md in the CLAUDE.md file, and then put Claude specific stuff (mainly info about hooks and scripts) after that.

https://github.com/kstenerud/yoloai/blob/main/CLAUDE.md

by kstenerud

8/20/2026 at 11:37:06 AM

I just have one as a symlink to the other. Seems to work, and doesn't need an extra tool call.

by usef-

8/20/2026 at 11:07:51 AM

Yes but, should you have to do that is the question. There's a standard, and CLAUDE.md isn't it.

by xienze

8/20/2026 at 11:18:46 AM

For me it's very handy to have agent-specific instructions. Each harness does it differently and with differing levels of annoyance:

- .cursor/rules

- CLAUDE.md

- .github/copilot-instructions.md

- .aider.conf.yml

- .gemini/settings.json

A simple @AGENTS.md at the top of CLAUDE.md makes it play nice.

by kstenerud

8/19/2026 at 11:06:54 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!

by Jcampuzano2

8/20/2026 at 10:38:54 AM

To be fair, that comment is by Boris Cherny, the guy who developed Claude Code. You have to give him a bit of slack for wanting to use his tool for literally everything.

by weavie

8/20/2026 at 7:15:16 AM

For agent skills and MCP servers, https://github.com/agentplugins/agent-plugins-spec is trying to standardize the packaging/distribution layer with a minimal common spec

by guidoiaquinti

8/20/2026 at 9:42:57 AM

I've actually abandoned these files. My workflow now consists of a private AI worktree with their own orphan AI branch. Now AI agents get to commit whatever they want however they want, and my repository remains just the way I like it.

by matheusmoreira

8/20/2026 at 8:27:31 AM

At the project level, there should be no need for an AGENTS.md. Whatever you might want to let agents know you would let a human know too, so you should be writing a README.md, CONTRIBUTING.md, ARCHITECTURE.md and whatever else.

by pronik

8/20/2026 at 8:52:58 AM

AGENTS.md is specifically for agents. Every time you launch an agent in a repo, it's the agent's first time existing in the universe. This file lets it orient with the project.

Humans don't need it. Nor do they need to be reminded to launch subagents for simple tasks for example - which is another command that belongs in AGENTS.md.

by theshrike79

8/20/2026 at 8:30:53 AM

I find agents need a lot of verbose instructions that are a waste of space for people. Things that are better said in a PR comment for people if needed are better front loaded for agents. People benefit from concise documentation that they are thus more likely to actually read.

For example, "don't write comments that reference things that you removed from the code" is commonly needed for coding agente and almost never needed for people.

by tdeck

8/20/2026 at 8:57:58 AM

In general, Claude family models write absolutely terrible comments, docs, and prose. It’s basically the number 1 thing that caused everyone on my team to migrate away from Anthropic models completely.

by aabhay

8/20/2026 at 2:31:45 PM

What about if everyone symlinked CLAUDE to AGENT and then added it to .gitignore to stop the free “advertising”?

by vadansky

8/20/2026 at 9:26:32 AM

I feel like we've missed a trick here. The purpose of AGENTS.md—to make metadata about a project available in a structured format—seems far more valuable than to limit it to just those projects that use AI or those projects that do, but don't require any other kind of automated processing.

Why not iterate on README.md with something like PARSEME.md?

by oneeyedpigeon

8/20/2026 at 9:43:28 AM

> The purpose of AGENTS.md—to make metadata about a project available in a structured format

AGENTS.md is not "structured format", then it'd be JSON or YAML or some other fucked up format instead. Currently at least, it's fully freeform and you can put whatever there, agents will do there best to follow it.

by embedding-shape

8/20/2026 at 10:11:16 AM

Markdown is still a structure. It may be a very loose one, but it still enables a reader (of any flavour) to, for example, determine which parts of the text are code and which aren't.

by oneeyedpigeon

8/20/2026 at 10:14:54 AM

No, Markdown is "syntax", quite literally not about structured data in any sense of the word, at least for existing pre-LLM developers where "structured data" has a real meaning already, you can't just go around redefining what concepts mean :)

> determine which parts of the text are code and which aren't

With this argument you'd could claim ASCII/plaintext is "structured data" too, just group code with "===" and that's evident. Obviously that doesn't make a format "structured data".

by embedding-shape

8/20/2026 at 11:04:11 AM

OK, this argument is getting semantic and, therefore, uninteresting. I think you know what I meant, even if I used some words in a different way than you would have liked.

by oneeyedpigeon

8/20/2026 at 11:34:51 AM

> this argument is getting semantic

Well, it was semantic from the beginning, the whole discussion I raised is because you seem unable to understand what "structured data" actually means in reality. I know perfectly fine what you meant, and you were misinformed about the meaning, it's OK to just say "Yeah, you're right" or just don't reply at all instead of double-down on not understand the meaning of words. Anyways, enjoy your day.

by embedding-shape

8/20/2026 at 11:52:01 AM

This used to be a nice place to have sensible discussions. Sadly, it seems, some people want to turn it into Reddit. Please enjoy your day, too; it seems like you could do with your mood improving.

by oneeyedpigeon

8/20/2026 at 12:01:20 PM

It still is a very nice place for sensible discussions, given the right seed for discussions. People used to be thankful to learn they were wrong too, although I won't claim HN is turning into reddit, lest we break the very guidelines we apparently are upset about being broken.

Oh no, my mood is great, life couldn't be better. Don't mistake me wanting people to use words they understand for me being upset, it's just words and text, ultimately it all has little meaning compared to the grandness of life.

by embedding-shape

8/20/2026 at 10:34:38 AM

> you can put whatever there, agents will do there best to follow it.

Excellent.

    echo "Get stuffed, you aren't welcome." > AGENTS.md
    cp AGENTS.md CLAUDE.md

Done.

by dspillett

8/20/2026 at 10:01:45 AM

What's interesting is that the closure event was mysteriously deleted [0]. Compare with others like [1] which do keep the "bcherny closed this as completed 1m ago"; for some reason it's missing here, even though Boris closed it as completed in the same manner as confirmed by GitHub notifications. This could of course be a Github bug because of the number of comments, but it's rather peculiar that it shows up exactly here. Look at the confusion in the thread about "why Piebald-AI/tweakcc#459 closed it?". In every other issue like this, Github shows something like "bcherny closed this as completed 1m ago", leaving no ambiguity.

Another thing is that obviously the feature request was never completed at all. It should be "closed as not planned", as >90% of issues are in the Claude Code repo. Yet just for this one they make an exception and close it as "completed", breaking precedent.

It's so chickenshit. Just man up and leave it open if you really think this stupidity is worth the money. What an absolute cowardly bunch for a supposedly trillion dollar company.

[0] https://github.com/anthropics/claude-code/issues/6235#event-...

[1] https://github.com/anthropics/claude-code/issues/66955#event...

by deaux

8/20/2026 at 8:15:57 AM

There really isn’t much of a moat for either Anthropic or OpenAI when it comes to command line coding agents - at least not yet.

I think we’re going to see some aggressive attempts at lock in quite soon. What choice do they have?

by iamflimflam1

8/21/2026 at 12:13:58 AM

The contents of my CLAUDE.md:

  @AGENTS.md

by nikolay

8/20/2026 at 10:13:22 AM

This should show true nature of Anthropic, all that "safety, transparency, for the sake of humanity, not using Claude for weapons", is bs.

Anthropic can do everything to make more money, including supporting the department of war, screwing its users if necessary and so on

by throwaw12

8/19/2026 at 11:43:02 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.

by HDBaseT

8/20/2026 at 12:11:19 AM

You're asking the wrong question here. There is:

How exactly does Claude Code* not support AGENTS.md?

How exactly does the Claude suite of Models not support AGENTS.md?

The problem being pointed at in parent linked is referring to the Claude Code Harness not supporting AGENTS.md. Harnesses which do support it (eg codex), append the content to the initial model turn upon the model discovering it at the project root.

* Or Claude Code Tui, Claude Code desktop, Claude Cowork, Claude Desktop, Claude Design, Etc.

(Edit: i wish I could tattoo the distinction on ny forehead. Im vocal about Anthropic engineer-oriented tools being lackluster, and i frequently find myself in conversations where I have to stop a coworker and ask if they're talking about a platform, tool, or model- and which, depending on the answer. I feel like those two things together make me come off somewhat abrasive, but man, we're all engineers here.)

by agentdev001

8/20/2026 at 10:12:16 AM

Every other coding harness (i.e. 9 out of the top 10) automatically read AGENTS.md. It is a universal standard. Claude Code does not.

by deaux

8/20/2026 at 12:08:05 AM

Claude code will only read the other .md files after you take a turn to prompt it, not when the session starts. So if I run `/clear` it will retain the CLAUDE.md context but not AGENTS.md.

by wfurney

8/20/2026 at 8:53:26 AM

This plus auto-discovery of nested non-root CLAUDE.mds in a more complex setup (monnorepo or even a big project with different parts)

by morbicer

8/20/2026 at 6:06:17 AM

Maybe I miss a bit of information here, but I'm wondering why a random PR in a repository (https://github.com/Piebald-AI/tweakcc/pull/459) can close an issue in an unrelated repository (https://github.com/anthropics/claude-code/issues/6235)?

Is that a misconfiguration, or is that on purpose for Github? I never noticed that before.

by MrGilbert

8/20/2026 at 6:38:24 AM

GitHub API says it was closed by bcherny himself:

$ gh api repos/anthropics/claude-code/issues/6235 --jq '{state, state_reason, closed_at, closed_by}'

{ "closed_at": "2026-08-17T03:37:37Z", "closed_by": { ... "id": 1761758, "login": "bcherny", "url": "https://api.github.com/users/bcherny", }, "state": "closed", "state_reason": "completed" }

by PieUser

8/20/2026 at 6:44:08 AM

Weird, at the top of the issue it says "fixed by <link to random pr in other repo>" in a pill.

by plorntus

8/20/2026 at 10:11:19 AM

What's even weirder is that the "bcherny closed this as completed 1d ago" is missing after his comment, even though all other issues have it, e.g. https://github.com/anthropics/claude-code/issues/66955#event...

A permalink actually exists for the event in the post's issue too, but it leads to nothing: https://github.com/anthropics/claude-code/issues/6235#event-...

by deaux

8/20/2026 at 6:13:40 AM

I don’t see that the issue was closed by that PR. Where do you see that?

by QuantumNomad_

8/20/2026 at 8:10:04 AM

Next to the closed indicator at the top is a drop-down, which reads "Fixed by: Piebald-AI/tweakcc #459".

It also reads "Remaining: #58639 #29385"

by MrGilbert

8/19/2026 at 10:56:25 PM

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

by wilg

8/19/2026 at 11:48:00 PM

Anthropic are the only ones who think they can ignore the open standards. Absolute dirt bags.

by Sammi

8/20/2026 at 6:49:18 AM

So, a supposedly trillion dollar worth, about to IPO company thinks their moat is a specifically named Markdown file.

by moezd

8/20/2026 at 9:42:35 AM

Making your tool less compatible with the rest of the ecosystem at large not only makes it harder to move to your tool, but also harder to move away from your tool. Given these AI labs basically have no moat, seems they're trying to hold on to every little piece they can do make it harder to move away, even if it's a really tiny and marginal feature, like specifically titled file on disk... Kind of embarrassing overall, but I guess they make so much money no people there have any shame left to feel.

by embedding-shape

8/20/2026 at 1:23:54 PM

It's not a moat, or much of a barrier because you can literally just rename it, but it is 'good' marketing/branding. People talking about CLAUDE.md is much better for Anthropic than people talking about AGENTS.md.

by OJFord

8/20/2026 at 11:06:39 AM

> Making your tool less compatible with the rest of the ecosystem at large not only makes it harder to move to your tool, but also harder to move away from your tool.

That's true but this is really not something that's a barrier to switching, just an annoyance for users. All it takes is a rename/symlink/reference whatever from the user's perspective. If it required a lot of rearchitecting on Anthropic's side or it was a _lot_ harder for users to adapt to I'd understand them standing their ground on this issue. But neither of those are true, it's just pettiness.

by xienze

8/20/2026 at 11:36:32 AM

Depends on how you use these harnesses, I don't interact with any of them directly for example, but have my own harness around them, mostly so I can collect all the different ones under one "roof". With that, comes certain expectations of where things live. Anything that has "CC uses file path X" for example would require refactoring/changes, compared to other agents. Contrived example, but sometimes it's more than just "mv AGENTS.md CLAUDE.md".

by embedding-shape

8/20/2026 at 11:25:11 AM

I think it’s more branding than moat. Free advertising if every vibe coded repo on GitHub has a CLAUDE.md at the root.

And its probably also to make people think there’s something special about Claude.

by smoe

8/20/2026 at 9:22:28 AM

just the filename. The contents of the file are unstructured, besides being markdown

by vrighter

8/20/2026 at 1:25:09 PM

But the semantic meaning can be agent-specific. For instance, my Claude.md files have things like “never present multiple questions in walls of text, use `AskUserQuestion` with clear tradeoffs described”

by brookst

8/21/2026 at 6:05:27 AM

it is still just an unstructured file

by vrighter

8/20/2026 at 10:00:18 AM

Why do people continue to use the word “moat” only in context of AI companies?

by austin-cheney

8/20/2026 at 10:07:00 AM

I don’t think that’s true? I’ve been here quite a while now and it goes back a long long time in the startup world

by girvo

8/20/2026 at 6:58:57 AM

I have a co-worker who symlinks CLAUDE.md to AGENTS.md in all the repositories he owns.

by woadwarrior01

8/19/2026 at 11:01:38 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.

by Planktonne

8/19/2026 at 10:54:55 PM

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

by shay_ker

8/19/2026 at 11:10:55 PM

A good one does, yeah.

A bad one is noticeably harmful.

by baby_souffle

8/19/2026 at 11:05:26 PM

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

by verdverm

8/19/2026 at 11:05:53 PM

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

by dude250711

8/20/2026 at 5:06:51 AM

Apple at least builds things with a modicum of quality control, which is not the case for Anthropic.

by nozzlegear

8/20/2026 at 9:31:52 AM

They wont do it. Just symlink your CLAUDE.md

by rurban

8/20/2026 at 10:04:00 AM

> They wont do it.

That's the point of this post, Boris Cherny closed it as "completed", of course without implementing it.

by deaux

8/19/2026 at 11:16:49 PM

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

by luciana1u

8/20/2026 at 8:07:52 AM

kinda feels like agents.md is just a README with stricter consequences for being wrong

by mvpboyy

8/19/2026 at 10:43:08 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

by verdverm

8/19/2026 at 11:14:16 PM

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).

by Jcampuzano2

8/20/2026 at 5:00:47 PM

Anthropic started out as the "safe", "ethical" and "computer science elite" type personality facade but after that stopped working (i.e., they were booted out of the US gov), they went full enshittification. Not like they were to be trusted in the first place (Reminder: no AI company is good).

by VCFundedGenYer

8/20/2026 at 5:01:51 PM

> Anthropic started out as the "safe", "ethical" and "computer science elite" type personality facade but after that stopped working (i.e., they were booted out of the US gov), they went full enshittification.

Wow you mean the things that keeps happening happened again? Eventually we’ll have to learn to recognize and stomp out the snakes.

by ydat

8/20/2026 at 3:10:50 AM

Did something happen? Why is this on HN even though the issue's a year old?

by ihuman

8/20/2026 at 10:07:48 AM

It was closed yesterday as "completed" by Anthropic's bcherny, despite not being implemented/completed, and being by far the most requested feature that would take all of 10 seconds to implement. So yes, something happened yesterday.

by deaux

8/20/2026 at 4:33:01 AM

This issue was linked in the recently-front-page issue on Opus 5 using astronomically hard to understand manners of speaking. Someone must have just noticed it and decided to post it here.

by Tadpole9181

8/20/2026 at 1:24:09 PM

Thats why I don't like Boris and misanthropic. They have superiority complex.

by cute_boi

8/20/2026 at 7:07:14 AM

ln -s AGENTS.md CLAUDE.md

by a2x

8/20/2026 at 10:23:07 AM

Symlink and done?

by jhoechtl

8/20/2026 at 12:51:03 AM

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

by acedTrex

8/20/2026 at 12:53:41 AM

people use it because it does in fact make a sizable difference in experience and outcomes

by verdverm

8/20/2026 at 4:13:46 AM

Theres a study from earlier this year which suggests the opposite: https://arxiv.org/abs/2602.11988

Most of the agents.md and what people use it for / write into is does, in fact, not make a difference.

Now, sure, this study is a bit old for LLM standards - as everything beyond the current month is - but

a) I haven't seen any tangible evidence to the contrary and

b) Since the basic inner workings of LLMs haven't changed I'd be sceptical of this not still applying.

I think one major side effect of LLMs moving so fast is that best practices and how to use this tool is very much not catching up as fast.

No one knows what is best and what actually makes a difference, doubly so because LLMs are / very / hard to quantify - even benchmarks themselves are very rough estimations.

People do, in fact, use stuff which makes no difference all the times.

by Systemerror7A69

8/20/2026 at 4:54:46 AM

That's not what the study says. from the abstract:

> We conclude that while context files are useful for specifying non-standard coding practices, any attempts to improve performance should be rigorously evaluated before deployment.

The purpose of AGENTS.md is not to improve "coding performance" as the study looked at, it's to give an agent practical instructions that are useful to your specific workflow. For example you want it to use a certain format or specific tools for your project. This is stuff that can't be learned during training and must be loaded into the agent's context at the project level.

by bryan0

8/20/2026 at 6:51:40 AM

Yes, but since we are specifically talking about claude.md, Anthropic themselves claim on their website these files "serve[s] multiple purposes: providing architectural context, ..." (https://claude.com/blog/using-claude-md-files)

They also recommend starting with an /init command, which is also something the study very specifically called out as "having a marginal negative effect"

And from personal experience, I can only confirm that many people seem to see this as the main purpose of agents/claude md files - a persistent architectural overview of your project.

Quick Edit: My point simply being that I think it's understandable if some people don't understand the big deal about these files because they've had a drastically different experience than other people - anthropic themselves recommend apparently totally ineffective practices on their website, and the starter tool present in many harnesses seems to even have a (marginal) negative effect.

by Systemerror7A69

8/20/2026 at 5:53:50 AM

this right here, call out your project best practices and peculiarities in AGENTS.md

I suspect eventually this will move to fine-tuning, there are multi-tenant LoRAs on the horizon that will let us keep paying per-token on FTs

by verdverm

8/20/2026 at 2:51:15 PM

It hides information usually in a slop deluge that SHOULD be in normal human project documentation.

If it's useful to an LLM its useful to a human, information should be treated as human first, the LLM will come along with it.

by acedTrex

8/20/2026 at 12:20:32 AM

Why not symlink AGENTS.md to CLAUD.md?

by drivingmenuts

8/20/2026 at 12:25:03 AM

This is what I do. Works fine.

I’ll also include entries in the .github dir in project repos doing same thing in case anyone working on it happens to use GitHub copilot via vscode will also pick up on the AGENTS.md as well as any skills I might have cooked up for the repo.

(Though it’s mostly because I don’t trust team members to read the docs and the skills I made are meant to guide following standards for the project - and this approach almost incepts the standards for anyone not paying attention)

by sudonem

8/20/2026 at 3:07:24 AM

That works perfectly, as does adding '@AGENTS.md' to your CLAUDE.md.

Both techniques have worked (and been officially documented by Anthropic) for as long as I can remember.

https://code.claude.com/docs/en/memory#agents-md

by CharlesW

8/20/2026 at 12:34:17 AM

Works fine for me too. I use this for GEMINI.md as well.

by Demiurge

8/20/2026 at 3:37:17 AM

ln -s AGENTS.md CLAUDE.md

You're welcome!

by ltbarcly3

8/20/2026 at 12:12:56 PM

This is actually a complete and fully effective solution with no drawbacks, why did you dummies downvote it?

by ltbarcly3

8/20/2026 at 12:34:48 PM

[flagged]

by jwiegant

8/19/2026 at 11:01:32 PM

[flagged]

by frdev1786855380

8/20/2026 at 3:22:09 AM

[flagged]

by modgate

8/20/2026 at 10:55:55 AM

[dead]

by vasilyoshev

8/20/2026 at 12:27:20 PM

[flagged]

by syn_ayos

8/20/2026 at 10:35:58 AM

[dead]

by yishaicohen

8/20/2026 at 9:38:14 AM

[dead]

by felixlu2026

8/19/2026 at 10:44:12 PM

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

by chomp

8/19/2026 at 10:48:01 PM

You can save a tool call by just making it a symlink

by eigenspace

8/19/2026 at 11:24:36 PM

You can also use @AGENTS.md which automatically concatenates the files

by Mossly

8/19/2026 at 10:57:48 PM

This is the way.

by hparadiz

8/19/2026 at 11:00:02 PM

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.

by superfrank

8/19/2026 at 11:25:50 PM

Are you saying this wouldn’t happen if the file had a different name? Or just that codex is better at instruction following.

by threecheese

8/19/2026 at 11:53:40 PM

No. I'm saying that the pattern of having one instruction file that just says "read this other file" doesn't seem to work well. Having a CLAUDE.md that just says "Read AGENTS.md" resulted in Claude randomly not following the rules. We tried the other way and it didn't seem like it was any better, but also, given that AGENTS.md is the standard everywhere except for Claude Code, I don't really want CLAUDE.md to be the source of truth

by superfrank

8/21/2026 at 3:59:58 AM

[flagged]

by weplay0628

8/19/2026 at 11:07:27 PM

At the current price for SSDs even a pointless symlink becomes waste...

by sschueller

8/19/2026 at 11:16:35 PM

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.

by eigenspace

8/19/2026 at 11:26:33 PM

Are you serious? A symlink is probably one of the smallest files you can possibly generate.

by inventor7777

8/19/2026 at 10:48:16 PM

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

by verdverm

8/19/2026 at 11:25:28 PM

cp AGENTS.md CLAUDE.md

what am I missing?

by JohnMakin

8/20/2026 at 10:30:21 AM

Or better cp -a AGENTS.md CLAUDE.md (or ln -s AGENTS.md CLAUDE.md if some of your tooling doesn't play well with hardlinks but does with symlinks) then if one changes so does the other as they are the same file with two links.

Not sure how source control will deal with this though, even if it commits to git/other fine Windows users might have trouble (NTFS supports both hardlinks and symlinks, since Vista IIRC, but mklink requires elevated privileges).

by dspillett

8/20/2026 at 12:56:31 AM

maintenance, being a good player in the ai ecosystem

by verdverm

8/20/2026 at 3:11:51 AM

this is so easy to work around though. it’s a file name. it doesnt even care about symlinks. if you want this badly it is so easy to do yourself, It’s the weirdest thing to complain about as someone who uses a multi provider system locally.

by JohnMakin

8/20/2026 at 5:52:06 AM

The point is that the ease of workaround is besides the point, this is about Anthropic's approach. Lest we forget the silent nerfing, the silent prompt modifications, refusals of valid user prompts, watermarking, and lies about distillation.

After years of "darling" tech companies coming out of SV and their eventual turn against users, why do we yet again endure these dark patterns for the latest darling Anthropic?

Have we not learned from the priors? I invite others to try open weight models, you are not going to miss claude that much, the open models have come quite far the last 12 months

by verdverm

8/20/2026 at 9:02:08 AM

Ant is also buying politicians and attempting regulatory capture, not things I'm keen to have corporations doing

by verdverm

8/19/2026 at 11:42:45 PM

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

by douglas77

8/20/2026 at 12:01:01 AM

Where does your link say it’s Anthropic?

by croes

8/19/2026 at 11:52:57 PM

Not really Anthropic.

by LetMeLogin

8/20/2026 at 12:30:52 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...

by jpalomaki