Skip to content

Add AGENTS.md - #484

Open
felix-kaestner wants to merge 1 commit into
nxos/interface-pathfrom
chore/agents-md
Open

Add AGENTS.md#484
felix-kaestner wants to merge 1 commit into
nxos/interface-pathfrom
chore/agents-md

Conversation

@felix-kaestner

@felix-kaestner felix-kaestner commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

No description provided.

@rgildein rgildein left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall LGTM, only one small suggestion.

Comment thread AGENTS.md
Comment thread AGENTS.md Outdated
Comment on lines +59 to +60
Always run against a dedicated [Kind](https://kind.sigs.k8s.io/) cluster, not a real dev/prod cluster.
The Makefile passes `--context kind-$(KIND_CLUSTER_NAME)` to all kubectl calls automatically — no need to switch context globally.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

User can use any other k8s, e.g. I can spin VM with other k8s and ask Claude to run test on it. I would suggest to rephrase this to "Run agains Kind cluster only or any other user provided".

This is exactly one of reason why I'm using VM in #491, so Claude run commands in VM and do not touch view any of my context.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree that any k8s suffices (also e.g. minikube). However for the same reason I wouldn't make a suggestion to use a dedicated VM. While I do see a benefit for sandboxing coding agents in a VM, I'm not sure if we should make that recommendation within in this project. I'd rather then completely leave it up to a user/contributor on how to run k8s and how to sandbox their coding agent.

That being said, the default development environment uses Tilt, where we explicitly set some "allowed contexts" in https://github.com/ironcore-dev/network-operator/blob/main/Tiltfile.

Add AGENTS.md with coding guidelines for AI agents covering
project structure, constraints, workflows, API/controller/provider
design, logging conventions, testing style, and references.

Symlink CLAUDE.md to AGENTS.md as single source of truth.

Signed-off-by: Felix Kästner <felix.kaestner@sap.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants