[lobochrome]

Is there a way to let the agents share their agents.md? Claude code looks at Claude.md and I have yet to find a way to unify the agent handbook.

[simonw]

At this point effectively everyone else is on https://agents.md/ - Claude are the only holdout.

[data-ottawa]

Is there any reason this is better than just reading your regular readme or docs?

All of these things look helpful for humans too!

[simonw]

The main difference between AGENTS.md and a README.md is that coding agents will automatically ingest AGENTS.md when they start.

You may not want them to ingest README.md if it's long and contains irrelevant information as that might be a waste of valuable tokens.

[threecheese]

You could say that a Readme is declarative, while an agent file is imperative.

[mike_hearn]

I just use symlinks.