mcpField
R
rhdh-prow-release-branch

rhdh-prow-release-branch

github.com/redhat-developerCloud & DevOps1945 installsUpdated 1d ago
Repository

About rhdh-prow-release-branch

A skill for enabling or removing Prow CI configuration for a `redhat-developer/rhdh` release branch. It guides local configuration changes and generated job updates, while requiring confirmation of version-specific settings and gated publication.

Key features

  1. 01Commission release-branch CI
  2. 02Decommission end-of-life branch CI
  3. 03Update configuration with make update
  4. 04Validate release-specific settings
  5. 05Gate commits, pushes, and pull requests

Use cases

  1. 01Set up CI for a new release branch
  2. 02Remove CI for an end-of-life branch
  3. 03Review generated Prow job files
  4. 04Plan rollback before destructive removal

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/redhat-developer/rhdh-skills --skill rhdh-prow-release-branch

After installing, type/rhdh-prow-release-branchin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
references/
release-branch-config.md
workflows/
commission-release.md
decommission-release.md

Details

From the project README

RHDH release-branch Prow configuration

Turn the CI configuration for one release-{version} branch of redhat-developer/rhdh on or off in openshift/release. Both directions need a local checkout because both end in make update.

This skill is about Prow configuration, not about the product release. What is open against a release is /rhdh-release-status, its milestone dates are /rhdh-release-schedule, and its freeze announcement is /rhdh-release-announce. Individual test entries and cluster pools on a branch that already has jobs belong to /rhdh-prow-jobs.

Route

IntentLoad
Create CI configuration for a new release branchworkflows/commission-release.md
Remove CI configuration for an end-of-life release branchworkflows/decommission-release.md

references/release-branch-config.md holds the file paths, the release-vs-main differences, and the Slack alert setup that both workflows use. Read it with whichever workflow you loaded.

Local preparation and publication

Creating the local review branch, copying or deleting the config, editing _prowconfig.yaml, and running make update are local preparation authorized by the user's commission or decommission request. Make and validate those local changes without a write gate.

Follow /mutation-gate for commit, push, and pull request creation only. Treat them as one ordered publication set, name every reviewed path and external target, and stop before each later operation when an earlier one fails.

  • Never hardcode the branch-protection block or the release-branch adjustments. Read the latest existing release branch and copy its current shape; required status-check contexts and presubmit settings change over time.
  • Confirm the version-specific values with the user before finalizing: which OCP test entries to include, MAPT_KUBERNETES_VERSION, the OSD version, releases.latest.release, and the build_root tag.
  • Decommissioning is destructive. Name every file and block to be removed, and the rollback, before removing anything.
  • The Slack channel, its incoming webhook, and the Vault key SLACK_ALERTS_WEBHOOK_URL_{X}_{Y} are human steps outside the repository. Ask the user to perform them; do not treat the config change as finished while reporter_config.channel points at a channel that does not exist.

Completion

Commissioning is complete when ci-operator/config/redhat-developer/rhdh/redhat-developer-rhdh-release-{version}.yaml exists with zz_generated_metadata.branch set to release-{version}, the release-branch adjustments from the reference have been applied, the release-{version} branch-protection entry sits in version order in _prowconfig.yaml, make update has run, and the generated ci-operator/jobs/redhat-developer/rhdh/redhat-developer-rhdh-release-{version}-*.yaml files are listed by name. State the Slack channel and Vault key status, and note that the jobs will not fire until the release-{version} branch itself exists in redhat-developer/rhdh.

Decommissioning is complete when the config file is deleted, the release-{version} block is gone from _prowconfig.yaml with surrounding indentation intact, make update has removed the generated job files, and every removed file and block is named alongside its rollback. In both directions, state the push and pull-request state explicitly — including "not pushed".

Comments

Markdown supported