[Chore] Add Agents.md to help coding agents

[fzaninotto]

Problem

The core team uses Copilot Chat and Copilot Code Reviews. Yet some of the common practices from the core team aren't known to coding agents.

Solution

Provide an Agents.md, which is automatically added to the context by coding agents.

How To Test

Ask your assistant to add a new feature (e.g. a createMany data provider method).

[slax57]

Other than that, that's a pretty solid start! Looking forward to see how well AI agents perform with these guidelines now!

[slax57]

One more question: why place this file under .claude?
My understanding is that, for VSCode at least, the AGENTS.md file should be place a the root of the repository.
https://code.visualstudio.com/docs/copilot/customization/custom-instructions#_use-an-agentsmd-file

[fzaninotto]

One more question: why place this file under .claude? My understanding is that, for VSCode at least, the AGENTS.md file should be place a the root of the repository. https://code.visualstudio.com/docs/copilot/customization/custom-instructions#_use-an-agentsmd-file

That's a mistake, I fixed it locally but I forgot to push it.

[fzaninotto]

Review applied, RFR again