Top
Best
New

Posted by datadrivenangel 4 days ago

Claude Code now reads AGENTS.md if there is no Claude.md(code.claude.com)
739 points | 286 commentspage 4
victor9000 4 days ago|
The fact that something like this is so widely celebrated shows just how user hostile anthropic has become.
orlp 4 days ago||
I wonder when they'll finally fix the VS Code plugin to not constantly dump your current file into the context.
aroman 4 days ago||
Finally, I can delete `sync-agent-docs.sh`, which recursively symlinked AGENTS.md to GEMINI.md and CLAUDE.md...
marcelo-earth 4 days ago||
Oh, finally! Time to delete symlinks

That said, AGENTS.md doesn't seem like a good name, right?, technically, it's an instructions file read by a single agent, not necessarily for agents, so it always struck me as a bit odd

But until the next standardization, keeping just AGENTS.md is the best approach.

marssaxman 4 days ago||
Consistency with `robots.txt` seems like a reasonable choice.
marcelo-earth 4 days ago|||
Ohhhh... now I get it!!!
mitxela 4 days ago|||
so "agents.txt"?
apetresc 4 days ago||
I’m honestly not sure what distinction you’re drawing here. Is it the pluralization you’re objecting to?
osr00 4 days ago||
Better late than never... Now it's time for Claude Code to load skills from .agents/skills!
neverrroot 4 days ago||
Thanks guys, you did the right thing.
Madmallard 4 days ago||
Still don't understand the point of the markdown files.

Isn't it literally all just more text you're adding to the prompt. How can you even be sure it isn't just clouding context with nonsense for whatever you're asking for?

mahboi 4 days ago||
For skills, it only reads the summary telling it when to read the rest. So yes if you have too many skills, it can get confused and start reading all them and cloud the context. But if you have a few and they're used tactically, it's better than having to manually paste in prompts that you reuse a lot.

Similar reasoning with claude.md except it always reads the entire thing(?)

mcherm 4 days ago||
You know it because you write the content of AGENTS.md. And if you are smart, you keep it brief and cover only the important things that anyone (human OR LLM) would want to know if working in this directory.
Madmallard 4 days ago||
As far as I understand even adding relevant information still eventually clouds context
verdverm 4 days ago|||
this is probably outdated, attention typically stays fine up to ~200k tokens these days

you end up clouding that more with an agent having to re-understand concepts or conventions

AGENTS.md is good when it is a nested sparknotes for the project, you save context and turns overall, but keep them minimal and largely gotchyas or unusual workflows in your repo

pixl97 4 days ago||||
You still need to define assumptions somehow. What you want and what the model wants will not match up by default.
Madmallard 4 days ago||
In my experience telling it what I want is not a reliable process at all whatsoever if what I'm asking for is sufficiently complex, no matter what context I provide. So instead I break tasks down into very small parts, ask for solutions to those that I can reasonably quickly assess and then put them together myself. Asking it to do the architectural or deep algorithmic legwork IME wastes so much time and is often just wrong.
TeMPOraL 4 days ago|||
There's a balance to be found here, that's unfortunately very hard to find at times.

In my experience, there are two classes of tasks: some are very "in-distribution", and for those LLMs can near-flawlessly perform the "architectural or deep algorithmic legwork", with maybe a single second round to fix the mistakes. For others, I have to break the tasks down myself, and often it's a "death through thousand papercuts", because the size of a task that I can quickly verify and the LLM will not screw up with > 50% probability is small enough that it's sometimes net negative time spent relative to doing it myself (and using LLMs only as glorified search engine and article summarizer).

I like to tell myself that I'm getting better at recognizing these two classes up front, but I'm still frequently surprised when "type 1" turns out to be "type 2".

But circling back to the main topic: with "type 2", agent instructions are paramount, if only to enforce the "small steps, pre-commit to scope and methodology, verification at the end, user doesn't even want to know about anything in between" rules, as agents naturally want to run ahead faster than I can keep up with.

verdverm 4 days ago|||
A good practice to use (ime) is having it do research for the larger task, propose alternatives, and write that in a file. You can then review and comment that up, go through another iteration.

Then when it comes to implementation time, things typically go much smoother for larger changesets. Be wary to not overplan, as we all know how often we realized we missed something once we get into the details. Here, I stop the session and go back to iterating on the design/plan doc. Not a step-by-step guide, if you don't instruct them to the difference, they will just pseudo-implement in the plan like they do in their thinking traces, need to be be explicit about the level of detail.

electroglyph 4 days ago|||
do you just manually type out your important instructions every time instead of being smart and putting a few lines in a text file?
cmrdporcupine 4 days ago||
Only took them a year and a half of everyone complaining to finally do the right thing.

Congrats.

getnormality 4 days ago|
I gotta hand it to programmers (or whatever we call ourselves now) for sticking to principle on something this trivial.

It was either this or Claude had to become a generic term like sheetrock.

fragmede 4 days ago|
slopologist
More comments...