Claude Code now reads AGENTS.md if there is no Claude.md
datadrivenangel
604 points
213 comments
September 18, 2026
Related Discussions
Found 5 related stories in 91.3ms across 7,105 title embeddings via pgvector HNSW
- Anthropic finally adds AGENTS.md support to Claude Code deaux · 45 pts · September 18, 2026 · 74% similar
- Feature Request: Support AGENTS.md fg137 · 191 pts · August 19, 2026 · 68% similar
- Claude for Commerce Agents ashazal · 60 pts · September 03, 2026 · 62% similar
- Agent-Manager: A Tmux TUI for Running Claude Code, Codex and OpenCode yoanwaidev · 95 pts · July 30, 2026 · 59% similar
- Claude Code from Source pykello · 16 pts · September 18, 2026 · 59% similar
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!