ROSA-447: Add AGENTS.md and CLAUDE.md for AI agent development guidance

[tiwillia]

Summary

• Adds AGENTS.md with build commands, architecture overview, testing patterns, and development workflow documentation
• Adds CLAUDE.md that references AGENTS.md (@AGENTS.md), keeping agent guidance tool-agnostic while supporting Claude Code's convention
• Enables AI agent confidence when working with this repository as part of the Agentic SDLC initiative

Context

ROSA-447 — Establishing consistent acceptance mechanisms across ROSA operator repos so AI agents can implement changes with high confidence.

AGENTS.md is the tool-agnostic source of truth for how to build, test, lint, and understand repo architecture. CLAUDE.md simply references it.

Test plan

• Verify AGENTS.md content accurately reflects the repo's build commands and architecture
• No functional code changes — documentation only

[openshift-ci-robot]

@tiwillia: This pull request references ROSA-447 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the initiative to target the "4.22.0" version, but no target version was set.

Details

In response to this:

Summary

• Adds CLAUDE.md with build commands, architecture overview, testing patterns, and development workflow documentation
• Enables AI agent confidence when working with this repository as part of the Agentic SDLC initiative

Context

ROSA-447 — Establishing consistent acceptance mechanisms across ROSA operator repos so AI agents can implement changes with high confidence.

CLAUDE.md is the agent's primary source of truth for how to build, test, lint, and understand repo architecture.

Test plan

• Verify CLAUDE.md content accurately reflects the repo's build commands and architecture
• No functional code changes — documentation only

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 openshift-eng/jira-lifecycle-plugin repository.

[openshift-ci]

[APPROVALNOTIFIER] This PR is NOT APPROVED

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

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

Details

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

[openshift-ci]

@tiwillia: all tests passed!

Full PR test history. Your PR dashboard.

Details

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.