feat: add AGENTS.md and CLAUDE.md

[csviri]

Signed-off-by: Attila Mészáros a_meszaros@apple.com

[csviri]

TODO check: https://github.com/manusa/ai/blob/314598c3aba3176fde7f11fab3ee211c138888c5/dotfiles/.claude/skills/mn-agents-md/SKILL.md

[metacosm]

I'd rather we spend efforts on maintaining documentation for actual users than spending time having to maintain another document for "agents".

[csviri]

I'd rather we spend efforts on maintaining documentation for actual users than spending time having to maintain another document for "agents".

Hi @metacosm , this is WIP, will probably change fundamentally. Those two are not solving the same problem, this is guidline for AI when writing / helping to write code.

[metacosm]

I'd rather we spend efforts on maintaining documentation for actual users than spending time having to maintain another document for "agents".

Hi @metacosm , this is WIP, will probably change fundamentally. Those two are not solving the same problem, this is guidline for AI when writing / helping to write code.

I know what this is for but this looks like documentation and, for all purposes and intents, it is. So that's yet another thing that would need to be updated when we already struggle with the "regular" documentation.

[metacosm]

This won't stay true for much longer…

[csviri]

yeah, plan to do a facelift commit on next

[csviri]

@metacosm I did not have the time to get back on this properly yes, next week will do so.

[csviri]

@metacosm @xstefank this is ready for review now, feel free to suggest improvements, I assume we will iterate on this in the future few times.

[Copilot]

Pull request overview

Adds AI-agent-oriented repository guidance documentation to help automated coding tools work effectively within the Java Operator SDK repo.

Changes:

• Introduces AGENTS.md with project structure, build/test commands, and coding conventions for agents.
• Adds CLAUDE.md intended to point agents/tools at the primary guidance.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 8 comments.

File	Description
AGENTS.md	New AI agents guide covering tooling, workflow, conventions, and patterns.
CLAUDE.md	New file intended as an entrypoint/reference to the agent guidance.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.