I agree that we should standardize on AGENTS.md but Gemini CLI does at least let you configure the filename: https://github.com/google-gemini/gemini-cli/blob/3a369ddec3b...

Claude Code seems to require the CLAUDE.md filename.

https://technicalwriting.dev/ai/agents/

Hmm kinda makes sense to keep them separate because the agents perform differently, right?

You might want to tell Claude not to write so many comments but you might want to tell Gemini not to reach for Kotlin so much, or something.

A unified approach might be nice, but using the same prompt for all of the LLM "coding tools" is probably not going to be as nice as having prompts tailored for each specific tool.

Put in the file:

Instructions for Claude:

- ...

- ...

Instructions for Gemini:

- ...

- ...

But then the irrelevant instructions are just cluttering the context.

Most of the instructions will be suitable for all the models. Only a few will be model-specific.

that just overloads the agents context and decreases performance.

Agreed. If there are provider-specific differences then we should be able to add CLAUDE/GEMINI.md to take precedence, but most things in there are basic or general information and should apply to all providers (same for .cursor/, .windsurfrules/, ..)

I think this whole thing sucks.. we should have a single way of setting these instructions that all agents will read. not sure why they feel they need to own that part. seems so petty. do you think something like this would be useful? https://github.com/luisrudge/dot-ai/ basically a cli that generates files for multiple AI tools based on a single source