Claude Code now reads AGENTS.md if there is no Claude.md

datadrivenangel 604 points 213 comments September 18, 2026
code.claude.com · View on Hacker News

Discussion Highlights (20 comments)

hbarka

Great, now I have to redo my scaffold harness. I guess this agent.md awareness is part of the system prompt?

vindex10

First feature to borrow after peaking into openai repos? ))

askonomm

Finally doing something standards-compliant instead of forcing users into a proprietary workflow.

neverrroot

Thanks guys, you did the right thing.

clutter55561

Don’t get too excited, Claude code still won’t detect skills on .agents/skills.

datadrivenangel

This allows us to remove our one line Claude.md files that just say "AGENTS.MD"

cmrdporcupine

Only took them a year and a half of everyone complaining to finally do the right thing. Congrats.

anukin

Thank you Tobi Lutke.

TomGarden

Caught myself about to praise this, but it's the absolute bare minimum. Time to delete the symlinks

blueaquilae

Forced to do something for the users...

seaal

The madlads finally did it, now if only I could use my Claude sub in other harnesses without risking getting banned.

throwaw12

Remember they didn't do this because they wanted to help community, they did it because community was angry and they were losing users to other harnesses. Doesn't look like Anthropic care about dev community

rvz

A reminder that needs to be said: Don't use a closed-source harness. Why? This is why. [0] [0] https://news.ycombinator.com/item?id=49750694

aroman

Finally, I can delete `sync-agent-docs.sh`, which recursively symlinked AGENTS.md to GEMINI.md and CLAUDE.md...

dinga

My claude.md: # CLAUDE.md This project uses `AGENTS.md` as its agent instruction file (kept provider-agnostic). Treat any `AGENTS.md` file exactly as you would a `CLAUDE.md` file — at the root level and in any subdirectory you are working in. @AGENTS.md

stillpointlab

I recently had Claude Fable set up a new project for me and I pointed it at some existing projects to use as a guide on how I like to structure things. It created, unprompted, an AGENTS.md file and a CLAUDE.md symlink to AGENTS.md I didn't even have that symlink in any other project - it just did it. I think it saw that one of the projects I already had was set up by Codex and that project had an AGENTS.md so perhaps it inferred that I was using both Claude and Codex, so it was politely covering both? Or maybe a recent change made this behavior default? I was surprised and I hope they continue to seek standards.

nunodonato

yay! /s Why are people still putting up with this kind of attitude, especially when there are so many good alternatives available?

sscaryterry

Still can't read what their models vomit at me.

Madmallard

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?

armcat

About time!

Semantic search powered by Rivestack pgvector
7,105 stories · 65,136 chunks indexed