Claude Code 2.1.277 added AGENTS.md support, but the loader sits behind a remote feature flag. With telemetry or nonessential traffic turned off, a local AGENTS.md is skipped without a warning. This is what I measured…

485 points•pszypowicz•8 days ago•284 comments•

284 comments

mpoteat8 days ago
Sorry folks, this is a rollout artifact, we needed a way to turn this off remotely via feature flags if it broke something, and with telemetry off you don't get those. It's already been fixed as part of v2.1.281 releasing today.

The mod is source available here: https://github.com/anthropics/claude-code/tree/main/mods/age...

Apologies again folks, this was a fully human error on my part - I should've found a better way to launch with a kill-switch.

mpoteat8 days ago
The AGENTS.md support was implemented via our new extensibility system for CC, called Mods, which is launching soon-ish. A mod is a plugin with a new type of hook, which we call a function hook.

If folks play around with it, I would love feedback on the relevant issue: https://github.com/anthropics/claude-code/issues/91870

Mods allow quite a bit more customizability and control. I really believe in the idea.

amluto7 days ago
I skimmed a couple pages of the docs at:

https://github.com/user-attachments/files/31802150/EXTERNAL....

Might I gently suggest that you have a model at least as capable as Opus 5.5 translate that from Claudish to English? Or, even better, have an actual human work on the docs a bit? As it stands, they are fairly egregious, and they seem to devote at least as much space to little AI-generated quips that convey no meaning than to actually explaining what’s going on.

Also, maybe a human should decide whether these are “function” hooks or “module” hooks. All of this marketing calls them “function” hooks, but the json config seems entirely unaware of this.

(Has anyone else noticed that half the sentences in Claudish aren’t merely weird: they are noun phrases and not sentences at all? I’m pretty sure that any decent pre-LLM NLP-based grammar checker would correctly flag half the sentences in Claudish. Also, whatever variant of Claude wrote this thing can’t even capitalize around semicolons consistently with itself, let alone consistently with how English has been written for at least a century.)

edit: Fixed the link. Thanks, kaszanka.

rickette8 days ago
The only difference between CLAUDE.md and AGENTS.md is the filename. Do you really need a whole plugin system to support that use case? Feels like this could have been a one line change.
63stack7 days ago
>via our new extensibility system for CC, called Mods, which is launching soon-ish. A mod is a plugin with a new type of hook, which we call a function hook.

An extensibility system called mods, which is a plugin with a new type of hook that we call function hook?

I can't tell if this is real, or you are making fun of overengineered AI solutions.

Is this real?

glub7 days ago
I've developed several plugins for different harnesses, and I needed some upstream change for most of them.

The deciding factor for me whether or not I will work on the feature of the plugin is whether I (or rather, my agent) can look in upstream source and evaluate if it can be done with minimal upstream change, which I then contribute. And generally, even if no upstream change is needed, agents work so much better when they can read the code.

So why not just make Claude code open source? Considering also that source code was leaked once anyway.

d5lt58 days ago
Sounds like you've read the deepseek harness paper.
OtherShrezzing8 days ago
>Apologies again folks, this was a fully human error on my part

Blink twice if you need help

anon482937 days ago
Or add one additional telemetry metric and an extra prompt
piltdownman8 days ago
Much respect for the prompt response, humility, and frank disclosure.
dotancohen7 days ago
So what Anthropic calls "telemetry" is really "telechangeability"? That's sits with me even less comfortably than did the idea that some features are only available with telemetry enabled.
dannyw7 days ago
I’d just assume good intent here. Feature flags, telemetry, and fast rollouts / rollbacks are standard practice in software. Have a look at chrome://flags perhaps.

I fully believe GP that there was zero intent to gate this behind collecting telemetry. Sounds like a little tech debt and a little oversight, and the simplest explanation is that it is.

stravant7 days ago
That's just how big companies roll out software changes for software that auto-updates.

It's much preferable to be able to instantly fix it if the rollout of a new feature goes wrong than have everyone who installed the broken version bring stuck with problems until the company realizes the issue and rolls forwards with a fixed version.

https://martinfowler.com/articles/feature-toggles.html

post-it7 days ago
Not necessarily. They probably have an integrated service that handles some telemetry and also feature flags, like Braze. They toggled the whole thing off based on telemetry settings. It's a bug I've made before too.
tyre7 days ago
Seems like they overloaded whatever they use for telemetry to do feature flags.

It’s not a crazy conspiracy. They messed up, it’s fine.

aviperl8 days ago
Ouch.

I've had to send such messages, but internally at work, not on HN!

Have a great day, human.

sandrello8 days ago
Based on my experience with these tools so far, this seems exactly the kind of subtle but extremely severe bug that sneaks in when you start piling up layers of AI generated patches to a codebase without caring too much about the code.
HotHotLava8 days ago
"extremely severe" - aren't we laying it on a bit thick here? The whole impact seems to be that users who have telemetry turned off got this feature ~2 days later, when the bug was noticed.
code_runner8 days ago
a "feature" that every user has asked for - which is the equivalent of changing claude.md to agents.md - and the release isn't even smooth because the telemetry isn't wired up quite right.

for an organization that is being used as a model for new agentic software development practices.... and every software exec on earth is trying to reshape their organizations after - its a pretty stupid bug for a feature that should've been straightforward in the first place + took forever for them to get around to.

its just kind of emblamatic of the rough edges that exist EVEN FOR SIMPLE THINGS whenever human judgement is totally removed the equation.

csomar7 days ago
The issue is that this is the thing that got “noticed”. The problem is that your program behavior is now unpredictable. Anything can happen!
ares6237 days ago
and the enshittification lives on
hgoel8 days ago
Yep, especially with long contexts (and moreso if the last thing you were working on in the same context involved telemetry too). AI sneaks in weird conditions like this and then does the entire "You're absolutely right" thing if you're paying enough attention to catch it.
Agentlien8 days ago
I used to actively use Msty for local models because it just worked and had a lot of nice advanced features. A few months ago they released their beta version of a Claw-like UI and mentioned using a version of it to develop Msty itself. Well, that was around the time I stopped using Msty because every update started breaking things and two updates in a row included bugs which wiped all my configs, chats, and history.
crazygringo8 days ago
It seems to be exactly the opposite, a "fully human error":

https://news.ycombinator.com/item?id=49815363

Nothing to do with AI patches at all, nor was it a bug. It was intentional human behavior, a temporary rollout setting, that seems to have made sense.

But I guess that doesn't fit the "narrative".

fg1378 days ago
One thing I do know is that an Anthropic employee is definitely NOT going to blame this on the model they are using.
q3k8 days ago
> It seems to be exactly the opposite, a "fully human error"

"LLMize the succeses, humanize the failures." is the PR strategy at play here. Anything goes well it's because AI did it, anything goes bad it's because a human didn't catch it.

pasteleft7 days ago
I don't understand what you are talking about. Vibecoding IS a human error.
tpurves8 days ago
Except that, and this I find slightly amusing, is a situation where they definitely don't want to publicly blame the ai model when there are mistakes.
lucfranken8 days ago
Isn't that how they just release all features? So they can do progressive roll outs and telemetry on issues with it?

Not sure if they later move the code from inside the flag check to the main code or that they keep the flag check.

But if they would keep all features behind a flag that would not make most sense as you then would have not many features without telemetry.

fg1378 days ago
This is what's written in their release notes for 2.1.277:

> Added AGENTS.md support: in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead

My dumb brain tells me none of this is rolled out progressively (as of that version). You either have it or not.

nijave8 days ago
It's been like this at least months. I turned telemetry off a few months ago and it basically prevented all stages rollouts of new features from working.

Anthropic commonly gates behind feature flags that require telemetry until they're "promoted" and defaulted on.

A little bit annoying you can't manually control the flags without telemetry but I think the title is a bit click bait.

arrowsmith8 days ago
Claude Code also doesn't read AGENTS.md by default if there's a CLAUDE.md it can read instead. This isn't limited to your repo, e.g. if you have a ~/CLAUDE.md then no AGENTS.md will be read.

To always read both, you have to switch the 'Project instructions' setting to the non-default `claude-md-and-agents-md`.

Just in case anyone is wondering why their AGENTS.md still isn't being read.

fg1378 days ago
This in some way sounds like VSCode's bug of always adding Copilot as a co-author of git commit regardless of user settings.

If people only glance over the code agents generate for them and don't bother to spend even half a minute thinking through what's actually happening, this is inevitable.

Certainly this kind of things happened before LLMs existed. But I'm not optimistic about the direction of how things are going.

Read the full thread on Hacker News →

Related stories