docs: add README for agents

[vprashar2929]

Add consolidated quick reference guide for AI agents contributing to
Kepler. Includes the development setup, testing instructions, PR
guidelines and project-specific context.

[SamYuan1990]

will agents.md work for ci check?

[vprashar2929]

yes

[SamYuan1990]

I am not sure if this agents.md too large.
can it reference to existing document?

[vprashar2929]

I am not sure if this agents.md too large. can it reference to existing document?

Updated the markdown

[vprashar2929]

@vimalk78 @KaiyiLiu1234 Should we also create symlink for CLAUDE.md as well?

[sunya-ch]

Looks good to me.
@vprashar2929 Can we add the instruction to ensure the content here and the one in docs/user such as https://github.com/sustainable-computing-io/kepler/blob/main/docs/user/installation.md#prerequisites (it seems not match now btw).

[vprashar2929]

Looks good to me. @vprashar2929 Can we add the instruction to ensure the content here and the one in docs/user such as https://github.com/sustainable-computing-io/kepler/blob/main/docs/user/installation.md#prerequisites (it seems not match now btw).

Good catch! You're absolutely right. I have updated AGENTS.md to maintain documentation consistency across all files to prevent this in the future.

[KaiyiLiu1234]

Can you also mention how to run it in more detail (reference to Other installation methods and Quick Start with helm ). Also, what about the documentation for running the dev setup with docker compose?