logoalt Hacker News

Your AGENTS.md file doesn't do anything

17 pointsby latexrtoday at 9:00 AM21 commentsview on HN

Comments

xg15today at 10:41 AM

On my last project, it kept trying to use the system python instead of the project's virtual environment. It also kept using the wrong build tool. Both things wasted considerable tokens because the agent got sidetracked trying to understand why it could not run the tests - and that repeated on each new session.

A simple instruction in AGENTS.md fixed that.

show 3 replies
jen729wtoday at 10:56 AM

This guy – whose RSS feed I subscribe to – makes a living [0] by being anti-AI.

That's fine. Do what you do. But don't read this article as any sort of science. It's massively opinionated rage-bait.

[0]: https://www.patreon.com/davidgerard

show 2 replies
stuaxotoday at 10:24 AM

It mentions that a chatbot generated AGENTS.md does nothing, which makes sense.

I added one when it kept making the same mistake and using things from the wrong library version making compiler errors, adding in the common mistakes pre emptively.

show 2 replies
shim__today at 12:30 PM

It does, it makes it obvious that I'm looking at a vibe slopped project

LoganDarktoday at 10:21 AM

Just because it doesn't materially impact task success rates does not mean it's not useful. I use that file to give my agent information about the environment (operating system, architecture, command-line utilities I have installed), as well as how to do certain things (such as using `uv` for running Python when needed). I want my agent to work how I do, so I also tell it things like my preferred version control system (jj), my preferred implementation languages for things like shell scripts (zsh), and other things like that. I care more about how the work is done than the final result. It still slips up sometimes, but on the whole I think it works alright. It's not like it fixes tasks that wouldn't be completed at all, but it does help my satisfaction with how they were completed, as well as with the final result. Otherwise, I'd have to do a lot more manual cleanup.

show 2 replies
Sha1rholdertoday at 10:59 AM

“Don’t start off by git diff, git status, or git show” saved me quite a few tokens.

show 1 reply
jasonvorhetoday at 12:15 PM

Too deranged of an AI hater for me to even care to read this.

Knowing he did an AI hate interview with Tante just solidifies this: https://pivot-to-ai.com/2026/08/21/tante-on-ai-when-this-thi...

Just looking through his Mastodon reposts (neovim is "fascist software" if you didn't know already!) just leaves me shaking my head.

Incredible how much of an audience you can get by just being anti "the latest hype".

show 1 reply
lazidetoday at 10:54 AM

Like all LLM related issues, it doesn't until it does. Or does until it doesn't.

Either way, you get no visibility or predictability.

Good luck.