ci-utils
Shared utilities to standardize and simplify build, test, and deployment pipelines for the OSSM team.
Table of Contents
Claude Code Plugin
This repository is a Claude Code skills marketplace. Team members can install plugins into any project to get AI-powered utilities as slash commands.
Available plugins:
ossm-ci — CI utilities: release confidence scoring, E2E test generation, AWS resource inventory, and Prow CI metricscode-reviewer — Multi-phase code review with auto-maintained project conventionscodebase-scribe — Generate, enrich, and maintain agentic development documentation for any codebase
Installation
Plugins hosted on GitHub must be added as a marketplace first, then installed individually.
Step 1: Add the marketplace
/plugin marketplace add openshift-service-mesh/ci-utils
This registers the repo as a marketplace using the name field from its .claude-plugin/marketplace.json. The marketplace is registered as ci-utils.
Step 2: Install the plugin(s)
/plugin install ossm-ci@ci-utils
/plugin install code-reviewer@ci-utils
/plugin install codebase-scribe@ci-utils
Step 3: Reload plugins
/reload-plugins
What does NOT work
| Command | Why it fails |
|---|
/plugin install ossm-ci@openshift-service-mesh/ci-utils | The org/repo format is not a registered marketplace name |
/plugin install openshift-service-mesh/ci-utils | Treated as a plugin name, not a marketplace |
The target GitHub repo must contain .claude-plugin/marketplace.json with a plugins array listing available plugins.
Commands — ossm-ci
/ossm-ci:confidence
Calculates a data-driven release confidence score (1–10) for an OSSM build by analyzing test results from Report Portal. Determines the required test scope (FULL/CORE/BASIC), validates test matrix coverage across platforms and environments, and provides a scored breakdown with a GO/NO-GO release recommendation.
Requires: Report Portal MCP server configured in Claude Code.
/ossm-ci:generate-e2e-tests
Generates production-ready Go E2E tests using BDD Ginkgo from a project's documentation. Validates documentation quality against a scoring threshold (7/10 minimum), extracts hidden tags for retry/timeout/validation logic, and produces organized test files with helpers.
Run from the root of the target project. Copy the config template to get started:
cp <ci-utils>/plugins/ossm-ci/skills/generate-e2e-tests/documentation-e2e-generator.yaml ./documentation-e2e-generator.yaml
/ossm-ci:aws-scan
Gives you the exact commands to download and run the audited inventory script yourself. The script outputs two tables directly in your terminal: potentially dangling resources and a complete inventory. Claude does not execute anything — you run the script, you see the results.
curl -O https://raw.githubusercontent.com/openshift-service-mesh/ci-utils/main/scripts/aws-scan-audited.sh
bash aws-scan-audited.sh
Requires: AWS CLI configured with valid credentials. See scripts/aws-scan-audited.sh for the full read-only script.
/ossm-ci:prow-metrics
Collects and presents Prow CI execution data for OSSM repositories (istio, proxy, sail-operator, ztunnel). Shows summary statistics, median execution times by job type, infrastructure usage, failed/pending jobs, and exports a TSV file for Excel import. Fetches directly from the Prow API — works from any project.
Requires: python3 available in PATH.
Commands — code-reviewer
/code-reviewer:setup
Onboard a project for code review. Analyzes your codebase, discovers existing standards and patterns, and interactively generates reference docs (style guide, testing practices, etc.). Run this once before your first review.
/code-reviewer:review
Run a multi-phase code review pipeline on your current branch changes. Dispatches three specialized review subagents in parallel (adversarial, style, testing), consolidates findings with deduplication, and produces a verdict.
Supports phase-specific variants:
/code-reviewer:review # Full pipeline — all three phases
/code-reviewer:review:adversarial # Adversarial phase only
/code-reviewer:review:style # Style phase only
/code-reviewer:review:testing # Testing phase only
