📖 Add API conventions and deprecation guidance to AGENTS.md

[pedjak]

Description

Add API conventions section to AGENTS.md documenting:

• Links to OpenShift and Kubernetes API conventions that must be followed
• API linting workflow (make lint-api-diff)
• CRD field deprecation pattern following Go and OpenShift conventions
• Regeneration commands after API type changes

This helps AI coding assistants (and developers) follow the correct conventions
when making API changes, particularly around field deprecation.

Reviewer Checklist

• API Go Documentation
• Tests: Unit Tests (and E2E Tests, if appropriate) — docs-only change
• Comprehensive Commit Messages
• Links to related GitHub Issue(s)

[netlify]

✅ Deploy Preview for olmv1 ready!

Name	Link
🔨 Latest commit	f7d885e
🔍 Latest deploy log	https://app.netlify.com/projects/olmv1/deploys/6a2fb7fad349c500099cee07
😎 Deploy Preview	https://deploy-preview-2763--olmv1.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[Copilot]

Pull request overview

This PR updates AGENTS.md to document API conventions and field deprecation guidance so that developers and AI coding assistants follow OpenShift + Kubernetes norms when changing CRD-backed Go APIs.

Changes:

• Add links to OpenShift and Kubernetes API conventions for api/v1/*_types.go changes.
• Document regeneration and API-lint workflows (make manifests/make crd-ref-docs, make lint-api-diff).
• Add a recommended deprecation comment pattern and related guidelines (optional fields, JSON tags, staticcheck suppression).

---

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

[Copilot]

Pull request overview

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

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 66.80%. Comparing base (9c49467) to head (f7d885e).
⚠️ Report is 7 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2763      +/-   ##
==========================================
- Coverage   66.97%   66.80%   -0.17%     
==========================================
  Files         149      149              
  Lines       11382    11382              
==========================================
- Hits         7623     7604      -19     
- Misses       3206     3220      +14     
- Partials      553      558       +5     

Flag	Coverage Δ
e2e	35.11% <ø> (+0.04%)	⬆️
experimental-e2e	52.56% <ø> (-0.13%)	⬇️
unit	52.12% <ø> (-0.06%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[perdasilva]

/approve

[openshift-ci]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: perdasilva

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

The pull request process is described here

Details

Needs approval from an approver in each of these files:

• OWNERS [perdasilva]

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

[perdasilva]

/lgtm