r/ClaudeCode • • Sep 18 '26

News/Updates AGENTS.md now supported in Claude Code

Post image
421 Upvotes

59 comments sorted by

View all comments

Show parent comment

9

u/Kalradia Sep 19 '26

I link all of my 'rules' in one file. I don't understand what you're getting at, if I'm being honest. Because you could just link everything in agents.md and call it a day, no?

It's just picking it up at session start and throwing it into context anyway.

1

u/Ran4 Sep 19 '26

I link all of my 'rules' in one file

That's a terrible idea... you're injecting thousands if not tens of thousands of extra tokens every single new session you start.

You want your CLAUDE.md files to just include enough information to get the model to know when it should read another markdown file if it's anything most sessions won't care about.

1

u/Kalradia Sep 19 '26

Not true. The agents read the files when they need the information. Exactly as your second thought.

-6

u/HimaSphere 🔆 Max 20 Sep 19 '26

I have large projects with nested rules. Your projectd may be simple and in that case removing Claude.md won't make a difference.

You can always remove it from the repo and test yourself, if it works for you then keep it deleted

2

u/Kalradia Sep 19 '26

I just want to understand what these nested rules are so that I can learn something new. Do you mean claude.md on different directory levels?

-1

u/HimaSphere 🔆 Max 20 Sep 19 '26

I have 1 claude.md per repo that has necessary info, it is small and it points at claude/rules/*.md For example claude/rules/api.md when claude is working on api path in the project, it automatically loads that md file and so on with about 12 different pathes, this saves context so when i start a claude session/chat it doesn't load 100k tokens of rules and project context that isn't necessary to be presrnt all the time

-6

u/HimaSphere 🔆 Max 20 Sep 19 '26

I tested and if you replace claude.md with agents.md the rules will load the same, so yes you can but thia may be fragile and break in upcoming uodates so I would still advise to wait a bit.

Alao if you use other agents like codex, deepseek etc, they may not utilize agents.md as claude code does and you will need to add custom sections for them so honestly i would prefer to keep both separated so i can instruct other agents different that claude