Skip to content

CLID-636: Update AGENTS.md#1421

Open
dorzel wants to merge 1 commit into
openshift:mainfrom
dorzel:CLID-636
Open

CLID-636: Update AGENTS.md#1421
dorzel wants to merge 1 commit into
openshift:mainfrom
dorzel:CLID-636

Conversation

@dorzel

@dorzel dorzel commented May 27, 2026

Copy link
Copy Markdown
Member

Description

Updates content in AGENTS.md.

Also fixes a typo.

Previous PR was accidentally closed after I renamed my branch: #1402.

Github / Jira issue: https://redhat.atlassian.net/browse/CLID-636

Type of change

Please delete options that are not relevant.

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Code Improvements (Refactoring, Performance, CI upgrades, etc)
  • Internal repo assets (diagrams / docs on github repo)
  • This change requires a documentation update on openshift docs

How Has This Been Tested?

Please describe the tests that you ran to verify your changes. Provide instructions so we can reproduce. Please also list any relevant details for your test configuration.

Expected Outcome

Please describe the outcome expected from the tests.

Summary by CodeRabbit

  • Documentation
    • Rewrote agent guidance to mark v2 as current and v1 deprecated; updated repository tagline punctuation.
    • Expanded architecture overview: data flow, workflow orchestration, collector responsibilities, concurrency model, and supporting concepts (archive, cluster resources, history, image transport).
    • Clarified development workflow: explicit build, cross-build, test (unit/integration) and verification targets with examples, and documented a pre-commit sanity check requirement.

@coderabbitai

coderabbitai Bot commented May 27, 2026

Copy link
Copy Markdown

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository: openshift/coderabbit/.coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: f7d0142e-79b4-48f0-906d-0cba00933d72

📥 Commits

Reviewing files that changed from the base of the PR and between 3ddb6cd and 5800204.

📒 Files selected for processing (2)
  • AGENTS.md
  • docs/dev-investigations/progress-bar-and-concurrency-investigation.md
✅ Files skipped from review due to trivial changes (1)
  • AGENTS.md

Walkthrough

Documentation-only rewrite of AGENTS.md marking v2 current, expanding architecture/collector guidance and batch-worker model, and broadening build, test, and validation developer instructions including explicit Makefile targets and build-tag examples.

Changes

oc-mirror Agent Guide Restructuring

Layer / File(s) Summary
Foundation and versioning
AGENTS.md
Repository tagline punctuation adjusted; v2 marked current and v1 declared deprecated/located under v1/ and not to be modified.
Architecture and collector responsibilities
AGENTS.md
Replaces previous architecture overview with detailed end-to-end data flow, collector location/purpose table, expected schemas, batch-worker concurrency/dependency model, archive/cluster resources, incremental-history, and image transport notes.
Build guidance
AGENTS.md
Adds make build emphasis, cross-build targets per architecture, and required build-tag usage for building binaries.
Testing guidance
AGENTS.md
Adds explicit unit vs integration make targets, coverage output locations, and go test examples that require specific build tags.
Validation and verification
AGENTS.md
Documents Makefile targets vet, format, tidy, sanity, and all, and reiterates running make sanity before committing.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Suggested reviewers

  • aguidirh

Important

Pre-merge checks failed

Please resolve all errors before merging. Addressing warnings is optional.

❌ Failed checks (2 errors, 2 warnings, 1 inconclusive)

Check name Status Explanation Resolution
Ote Binary Stdout Contract ❌ Error main() function uses klog (Fatal, Error, Errorf, Infof) without configuring stderr output via klog.LogToStderr or klog.SetOutput, violating OTE Binary Stdout Contract. Add klog.LogToStderr(true) at the start of main() or in init() to redirect klog output from stdout to stderr before any klog calls.
No-Weak-Crypto ❌ Error MD5 usage found in internal/pkg/operator/filtered_collector.go (line 151) used for computing filter digest hash of operator configurations. Replace MD5 with SHA-256 for the filter digest: use md5.Sum() → sha256.Sum() for improved cryptographic strength, even for non-cryptographic hashing use cases.
Microshift Test Compatibility ⚠️ Warning New Ginkgo e2e tests in tests/e2e/test/e2e/oc_mirror_v2.go use MicroShift-incompatible APIs: ClusterVersion (config.openshift.io/v1), Image Config (image.config.openshift.io), and openshift-marketp... Add [apigroup:config.openshift.io] tag to tests using ClusterVersion/Image Config APIs, or use [Skipped:MicroShift] label. Guard OLM-dependent tests with IsMicroShiftCluster() check and g.Skip().
Ipv6 And Disconnected Network Test Compatibility ⚠️ Warning New Ginkgo e2e tests added require external internet connectivity (https://stefanprodan.github.io/podinfo for Helm charts) without [Skipped:Disconnected] marker for IPv6-only disconnected CI enviro... Add [Skipped:Disconnected] to test names requiring Helm chart downloads, or mock/cache external Helm repositories for disconnected test environments.
Title check ❓ Inconclusive The title references the Jira issue (CLID-636) but provides no specific detail about what is being updated in AGENTS.md, making it vague about the actual changes. Revise the title to be more specific about the main changes, such as 'Update AGENTS.md with v2 workflow guidance and agent directory migration' or similar.
✅ Passed checks (10 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Stable And Deterministic Test Names ✅ Passed All Ginkgo test names in the repository use static, descriptive strings with no dynamic values like fmt.Sprintf, string concatenation, or generated identifiers.
Test Structure And Quality ✅ Passed PR is documentation-only (AGENTS.md rewrite), contains no test code changes or Ginkgo tests, making the test structure quality check not applicable.
Single Node Openshift (Sno) Test Compatibility ✅ Passed This PR only updates documentation in AGENTS.md and does not add any new Ginkgo e2e tests. The SNO test compatibility check does not apply.
Topology-Aware Scheduling Compatibility ✅ Passed PR is a documentation-only update to AGENTS.md with no deployment manifests, operator code, or controllers added/modified, so topology-aware scheduling check does not apply.
Container-Privileges ✅ Passed PR contains no container/K8s manifest files with privileged: true, hostPID, hostNetwork, hostIPC, allowPrivilegeEscalation: true, or unjustified root execution. SYS_ADMIN capability found in source...
No-Sensitive-Data-In-Logs ✅ Passed No instances of passwords, tokens, API keys, PII, session IDs, or customer data exposed in logging statements found in the PR changes.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@dorzel dorzel changed the title Update AGENTS.md and switch to .agents dir CLID-636: Update AGENTS.md and switch to .agents dir May 27, 2026
@openshift-ci-robot openshift-ci-robot added the jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. label May 27, 2026
@openshift-ci-robot

openshift-ci-robot commented May 27, 2026

Copy link
Copy Markdown

@dorzel: This pull request references CLID-636 which is a valid jira issue.

Details

In response to this:

Description

Updates content in AGENTS.md and moves from .claude to .agents dir, expecting users to have a local symlink for use with specific agents.

Previous PR was accidentally closed after I renamed my branch: #1402.

Github / Jira issue: https://redhat.atlassian.net/browse/CLID-636

Type of change

Please delete options that are not relevant.

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Code Improvements (Refactoring, Performance, CI upgrades, etc)
  • Internal repo assets (diagrams / docs on github repo)
  • This change requires a documentation update on openshift docs

How Has This Been Tested?

Please describe the tests that you ran to verify your changes. Provide instructions so we can reproduce. Please also list any relevant details for your test configuration.

Expected Outcome

Please describe the outcome expected from the tests.

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.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@AGENTS.md`:
- Line 23: In AGENTS.md update the two fenced code blocks that currently use
plain ``` to include a language identifier (e.g., change ``` to ```text) so
markdownlint MD040 is satisfied; locate the two triple-backtick blocks that
contain the directory trees (the oc-mirror/ and docs/ code blocks) and prepend
"text" after the opening backticks (retain the existing block content and
closing backticks).
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository: openshift/coderabbit/.coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: cbf5fc82-0f74-41c5-b8b9-6d6e148580ad

📥 Commits

Reviewing files that changed from the base of the PR and between f5796a9 and bbddff4.

📒 Files selected for processing (3)
  • .agents/commands/README.md
  • .agents/commands/generate-imageset.md
  • AGENTS.md

Comment thread AGENTS.md Outdated
@openshift-ci openshift-ci Bot requested review from adolfo-ab and r4f4 May 27, 2026 16:38

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@AGENTS.md`:
- Line 65: Update the doc entry string in AGENTS.md to correct the typo: replace
"progress-bar-and-concurrencty-investigation.md" with
"progress-bar-and-concurrency-investigation.md" wherever it appears (the listed
entry under the progress/concurrency design bullet); ensure any internal links
or references that use this filename are updated to the corrected "concurrency"
spelling as well.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository: openshift/coderabbit/.coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: d08effa8-297a-40cb-9ae5-11a288d06d95

📥 Commits

Reviewing files that changed from the base of the PR and between bbddff4 and 921c9ce.

📒 Files selected for processing (3)
  • .agents/commands/README.md
  • .agents/commands/generate-imageset.md
  • AGENTS.md

Comment thread AGENTS.md Outdated

@aguidirh aguidirh 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.

Thanks for the PR @dorzel, I added few comments. Please let me know if you have questions about them.

Comment thread AGENTS.md Outdated
Comment thread AGENTS.md Outdated
Comment thread AGENTS.md Outdated
Comment thread AGENTS.md Outdated
Comment thread AGENTS.md Outdated
Comment thread AGENTS.md
Comment thread AGENTS.md
Comment thread AGENTS.md Outdated
Comment thread AGENTS.md Outdated
Comment thread AGENTS.md Outdated
Comment thread AGENTS.md
Comment thread AGENTS.md Outdated
@openshift-ci openshift-ci Bot added the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label May 30, 2026
@dorzel dorzel changed the title CLID-636: Update AGENTS.md and switch to .agents dir CLID-636: Update AGENTS.md Jun 1, 2026
@openshift-ci openshift-ci Bot removed the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Jun 1, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 1

♻️ Duplicate comments (1)
AGENTS.md (1)

27-30: ⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add a language identifier to the fenced code block.

This block should use a language tag (for example, text) to satisfy MD040 markdown linting.

Suggested diff
-```
+```text
 ImageSetConfiguration → Collectors → Batch Worker → Output (Archive or ClusterResources)
                                                    → Metadata persisted for incremental runs
</details>

<details>
<summary>🤖 Prompt for AI Agents</summary>

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @AGENTS.md around lines 27 - 30, The fenced code block containing
"ImageSetConfiguration → Collectors → Batch Worker → Output (Archive or
ClusterResources) → Metadata persisted for incremental runs" needs a language
identifier to satisfy MD040; update the opening fence from totext so the
block becomes a text code block (leave the content and closing fence unchanged).


</details>

</blockquote></details>

</blockquote></details>

<details>
<summary>🤖 Prompt for all review comments with AI agents</summary>

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @AGENTS.md:

  • Line 7: Change the descriptor sentence that currently reads "This is the
    oc-mirror repository — an OpenShift command line tool for mirroring container
    registry content for disconnected cluster installs." to hyphenate the compound
    adjective: "This is the oc-mirror repository — an OpenShift command-line tool
    for mirroring container registry content for disconnected cluster installs."
    Update the string in AGENTS.md where that exact sentence appears.

Duplicate comments:
In @AGENTS.md:

  • Around line 27-30: The fenced code block containing "ImageSetConfiguration →
    Collectors → Batch Worker → Output (Archive or ClusterResources) → Metadata
    persisted for incremental runs" needs a language identifier to satisfy MD040;
    update the opening fence from totext so the block becomes a text code
    block (leave the content and closing fence unchanged).

</details>

<details>
<summary>🪄 Autofix (Beta)</summary>

Fix all unresolved CodeRabbit comments on this PR:

- [ ] <!-- {"checkboxId": "4b0d0e0a-96d7-4f10-b296-3a18ea78f0b9"} --> Push a commit to this branch (recommended)
- [ ] <!-- {"checkboxId": "ff5b1114-7d8c-49e6-8ac1-43f82af23a33"} --> Create a new PR with the fixes

</details>

---

<details>
<summary>ℹ️ Review info</summary>

<details>
<summary>⚙️ Run configuration</summary>

**Configuration used**: Repository: openshift/coderabbit/.coderabbit.yaml

**Review profile**: CHILL

**Plan**: Enterprise

**Run ID**: `718c0f69-fab3-4de7-9c1a-9a42e38da56f`

</details>

<details>
<summary>📥 Commits</summary>

Reviewing files that changed from the base of the PR and between 921c9ceb07547d6552c92452b375199491c2568f and f420f94b0c25c795955980c854965d17397e654f.

</details>

<details>
<summary>📒 Files selected for processing (2)</summary>

* `AGENTS.md`
* `docs/dev-investigations/progress-bar-and-concurrency-investigation.md`

</details>

</details>

<!-- This is an auto-generated comment by CodeRabbit for review status -->

Comment thread AGENTS.md Outdated
@dorzel

dorzel commented Jun 3, 2026

Copy link
Copy Markdown
Member Author

/retest

@aguidirh aguidirh 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.

Thanks for this PR @dorzel

I added a small comment suggesting the new containers/image URL. They migrated the repository and the old one is archived.

I will approve as soon as you update the URL.

Comment thread AGENTS.md Outdated
@openshift-ci

openshift-ci Bot commented Jun 11, 2026

Copy link
Copy Markdown

@dorzel: 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.

@aguidirh aguidirh 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.

Thanks @dorzel !

@openshift-ci

openshift-ci Bot commented Jun 12, 2026

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: aguidirh, dorzel

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:

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

@openshift-ci openshift-ci Bot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Jun 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. jira/valid-reference Indicates that this PR references a valid Jira ticket of any type.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants