OCM-22932 | docs: add reviewer subagent

[amandahla]

PR Summary

This PR adds documentation for a reviewer subagent as expected by Cursor and a command review-pr.
Also some small updates in existing documentation.

Detailed Description of the Issue

Related Issues and PRs

• Jira: OCM-XXXXX
• Fixes: #
• Related PR(s):
• Related design/docs:

Type of Change

• feat - adds a new module capability or new user-facing behavior.
• fix - resolves incorrect module behavior or bug.
• docs - updates documentation only.
• style - formatting/naming changes with no logic impact.
• refactor - module code restructuring with no behavior change.
• test - adds or updates tests only.
• chore - maintenance work (tooling, housekeeping, non-product code).
• build - changes build system, packaging, or dependencies for build output.
• ci - changes CI pipelines, jobs, or automation workflows.
• perf - improves performance without changing intended behavior.

Previous Behavior

Behavior After This Change

How to Test (Step-by-Step)

Preconditions

Test Steps

Expected Results

Proof of the Fix

• Screenshots:
• Videos:
• Logs/CLI output:
• Other artifacts:

Breaking Changes

• No breaking changes
• Yes, this PR introduces a breaking change (describe impact and migration plan below)

Breaking Change Details / Migration Plan

Developer Verification Checklist

• I checked if this affects terraform-rhcs-rosa-classic and submitted (or already submitted) a companion PR when needed.
• Commit subject/title follows [JIRA-TICKET] | [TYPE]: <MESSAGE>.
• PR description clearly explains both what changed and why.
• Relevant Jira/GitHub issues and related PRs are linked.
• Tests were added/updated where appropriate.
• I manually tested the change.
• make verify passes.
• make verify-gen passes.
• Documentation was added/updated where appropriate (see make terraform-docs).
• Any risk, limitation, or follow-up work is documented.

[openshift-ci]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: amandahla

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 [amandahla]

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

[openshift-ci]

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

Test name	Commit	Details	Required	Rerun command
ci/prow/rosa-hcp-private	5960785	link	true	/test rosa-hcp-private
ci/prow/rosa-hcp-public	5960785	link	true	/test rosa-hcp-public

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.