Skip to content

docs(#3502): add UBI base image bump guidance to AGENTS.md - #3504

Open
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/3502-agents-md-ubi-bump-guidance
Open

docs(#3502): add UBI base image bump guidance to AGENTS.md#3504
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/3502-agents-md-ubi-bump-guidance

Conversation

@fullsend-ai-coder

Copy link
Copy Markdown
Contributor

What:

Add a new "UBI Base Image Updates" section to AGENTS.md documenting the base image bump workflow, multi-branch update strategy, and review guidance for release branch scope.

Why:

On PR #3498, the review agent flagged a stale-reference finding because acceptance/kubernetes/kind/acceptance.Dockerfile was not updated on a release-v0.7 branch UBI bump. The finding was technically correct (the file is in the coordinated set in hack/ubi-base-image-bump.sh) but contextually wrong — release branches intentionally use a narrower scope. AGENTS.md had no guidance about this workflow, so the agent had no way to calibrate severity.

This adds the missing context so the review agent can distinguish intentional release-branch scope from actual stale references.

Tickets:


Closes #3502

Post-script verification

  • Branch is not main/master (agent/3502-agents-md-ubi-bump-guidance)
  • Secret scan passed (gitleaks — 09cafb4dd350366ac857b1fc71ee20fd388b2b40..HEAD)
  • PR body secret scan passed (gitleaks — no-git)

Document the UBI base image update workflow and multi-branch
strategy so the review agent understands that release-v*
branches intentionally update only production Dockerfiles.

Add a new "UBI Base Image Updates" section covering:
- The three coordinated Dockerfiles and the bump script
- Multi-branch strategy: main updates all three files,
  release branches may update only production files
- Review guidance: do not flag missing acceptance.Dockerfile
  updates on release branches as stale references

Note: pre-commit could not run (sandbox network restriction
blocked git fetch for hook environment setup). Manual
verification of pre-commit hooks is required.

Closes #3502
@fullsend-ai-review

fullsend-ai-review Bot commented Aug 18, 2026

Copy link
Copy Markdown

🤖 Finished Review · ✅ Success · Started 6:44 PM UTC · Completed 6:56 PM UTC

Commit: 87c4a29 · View workflow run →

@fullsend-ai-review

Copy link
Copy Markdown

Review

Findings

Medium

  • [protected-path] AGENTS.md — This PR modifies AGENTS.md, which is a protected governance file. The PR links to issue Add AGENTS.md guidance for UBI base image bump workflow and release branch scope #3502 and the description explains the rationale (adding review guidance to prevent false-positive stale-reference findings on release branch UBI bumps). Human approval is always required for protected-path changes, regardless of context.

Low

  • [technical-accuracy] AGENTS.md:100 — The statement "The coordinated update set defined in hack/ubi-base-image-bump.sh applies to main branch bumps only" is misleading. The script itself contains no branch-aware logic — it unconditionally updates all three Dockerfiles (DOCKER_FILES=(Dockerfile Dockerfile.dist acceptance/kubernetes/kind/acceptance.Dockerfile) at line 33). The narrower scope on release branches arises because the script is either not used, or a different mechanism (e.g., Renovate) generates updates independently. Attributing branch-specific behavior to the script implies conditional logic that does not exist.
    Remediation: Rephrase to clarify that the script always updates all three files, but release-branch bump PRs may use a different mechanism that naturally omits acceptance test infrastructure.

  • [naming-convention] AGENTS.md — Subsection headings use sentence case (### Multi-branch strategy, ### Review guidance) instead of title case. All existing ### subsection headings in AGENTS.md use Title Case (### Acceptance Tests, ### Test Tags).
    Remediation: Rename to ### Multi-Branch Strategy and ### Review Guidance.


Labels: PR modifies only documentation (AGENTS.md)

@fullsend-ai-review fullsend-ai-review 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.

See the review comment for full details.

Comment thread AGENTS.md
`acceptance/kubernetes/kind/acceptance.Dockerfile` as stale references. The coordinated update set
defined in `hack/ubi-base-image-bump.sh` applies to `main` branch bumps only.

## Troubleshooting

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[low] technical-accuracy

The statement 'The coordinated update set defined in hack/ubi-base-image-bump.sh applies to main branch bumps only' is misleading. The script itself contains no branch-aware logic — it unconditionally updates all three Dockerfiles. The narrower scope on release branches arises because the script is either not used, or a different mechanism (e.g., Renovate) generates updates independently.

Suggested fix: Rephrase to clarify that the script always updates all three files, but release-branch bump PRs may use a different mechanism that naturally omits acceptance test infrastructure.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This is all madness.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Why does the agent reviewing the a release branch PR even mention files that don't exist in the release branch?

@fullsend-ai-review fullsend-ai-review Bot added requires-manual-review Review requires human judgment documentation Improvements or additions to documentation labels Aug 18, 2026
@codecov

codecov Bot commented Aug 18, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

Flag Coverage Δ
acceptance 54.38% <ø> (ø)
generative 12.28% <ø> (ø)
integration 23.59% <ø> (ø)
unit 72.20% <ø> (ø)

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

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@simonbaird simonbaird left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I don't think we should merge this.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation requires-manual-review Review requires human judgment size: XS

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add AGENTS.md guidance for UBI base image bump workflow and release branch scope

1 participant