chore: add instructions for coding ai in agents.md

[mburri]

We are using Windsurf - I started to create some guidelines to improve the generated code for new stuff.

what do you think?
Should we share the rules?

[yvespp]

IMHO if we have one, we should have a very small one that only has the most important stuff. A paper by ETH showed that it can make AI responses worse, probably because of the larger context:

• https://www.youtube.com/watch?v=6VC-TuWVlCc
• https://arxiv.org/abs/2602.11988

[mburri]

@yvespp this is a good input - in many ways. I learned about the agents.md file - this probably works for various coding ai tools - at least it works with our windsurf ide and intellij plugin. I did not try with claude or copilot. Meanwhile, the .windsurf folder seems to be specific to windsurf ide and plugins.

The agents.md files can be placed in the root and in subdirectories. If the file is in the root, it is always on, while files in subdirectories only apply for "work" in the subdirectories. This would be nice for us to split and focus instructions for each module (angular, amw_rest, e2e...)

A coworker also suggested to look up the following project: https://github.com/drona23/claude-token-efficient
The idea is to tell the agent to be concise and short in order to save tokens.

I'd propose to add a agents.md file with some general info about the product and the instructions in https://raw.githubusercontent.com/drona23/claude-token-efficient/refs/heads/main/CLAUDE.md

And then go on from there, gradually update and improve the files as needed.