📖 add AGENTS.md

[tuminoid]

Add AGENTS.md to allow AI assistants to be more effective, especially the Code Review Bot.

Note: do not create .github/copilot-instructions.md as it will prevent current version of Copilot CLI from reading AGENTS.md at all.

[metal3-io-bot]

Skipping CI for Draft Pull Request.
If you want CI signal for your change, please convert it to an actual PR.
You can still manually trigger a test run with /test all

[metal3-io-bot]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign tuminoid for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

• OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[tuminoid]

/hold
Iterating in multiple repos. Reviews welcome.

[Copilot]

Pull request overview

This PR adds comprehensive AI agent instructions through a new AGENTS.md file, designed to help AI coding assistants (especially Code Review Bots) work more effectively with the Ironic Standalone Operator codebase.

Key Changes:

• Adds detailed project architecture documentation including CRDs, controllers, and directory structure
• Provides complete development workflow guidance with Makefile targets, hack scripts, and CI/CD references
• Documents code conventions including Go import aliases, shell script patterns, and testing guidelines
• Includes behavioral guidelines specifically for AI agents working with the codebase

---

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

[metal3-io-bot]

@tuminoid: The following test failed, say /retest to rerun all failed tests or /retest-required to rerun all mandatory failed tests:

Test name	Commit	Details	Required	Rerun command
markdownlint	985a218	link	true	/test markdownlint

Full PR test history. Your PR dashboard.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

[tuminoid]

I'll sort out the markdownlint in a bit. AGENTS.md is now ~100 lines, very compact.

[lentzi90]

Looks ok to me. I added some minor suggestions, mainly to try to reduce it a bit.

[lentzi90]

Oh. I started reviewing yesterday. I see you updated since then 😄
Feel free to disregard

[lentzi90]

Nice! This I like!
Short, to the point but still providing very useful information.
/lgtm

[tuminoid]

Nice! This I like! Short, to the point but still providing very useful information. /lgtm

Yeah, let's start with 100 lines (90% reduction), and amend if we find shortcomings. Sorry for making you read the old version :)

[dtantsur]

I find it useful to highlight to the agent that these files are rarely modified directly, usually through some tag in the controller.

[dtantsur]

Also make lint please, in my experience Claude keeps forgetting it

[tuminoid]

Duh, it was supposed to be there. Will fix.