KubeVirt AI Helpers
A collection of Claude Code plugins to automate and assist with KubeVirt development workflows.
Overview
This project provides Claude Code plugins for KubeVirt development, including code review and linting workflows. For general Kubernetes, CI/CD, and development workflows, use the OpenShift AI Helpers.
Installation
From the Claude Code Plugin Marketplace
-
Add the marketplace:
/plugin marketplace add lyarwood/kubevirt-ai-helpers
-
Install a plugin:
/plugin install kubevirt@kubevirt-ai-helpers
-
Use the commands:
/kubevirt:review
/kubevirt:lint pkg/virt-controller/watch
/kubevirt:review-ci 12345
/kubevirt:vep-list --release 1.9
Related Helpers
This project is modeled after the OpenShift AI Helpers and focuses on KubeVirt-specific workflows.
When to Use OpenShift AI Helpers
Use OpenShift AI Helpers for:
- Jira workflows:
/jira:solve, /jira:create
- Git operations:
/git:commit-suggest, /git:branch-cleanup
- CI/CD:
/ci:trigger-periodic, /prow-job:analyze-test-failure
- Generic must-gather:
/must-gather:analyze
- Session management:
/session:start, /session:resume
When to Use KubeVirt AI Helpers
Use KubeVirt AI Helpers for:
- Code review: Review local branch changes using KubeVirt project best practices
- PR CI analysis: Analyze CI failures for specific PRs with root cause identification and remediation suggestions
- CI health monitoring: Track overall CI stability, analyze job lanes, and search for failure patterns
- Intelligent CI triage: AI-powered root cause analysis with prioritized recommendations
- CI reporting: Generate comprehensive health reports for stakeholders
- Linting: Run golangci-lint and generate a plan to fix issues with separate commits per linter
- VEP management: List, summarize, and groom KubeVirt Enhancement Proposals (VEPs)
Using Both Together
# Add both marketplaces
/plugin marketplace add openshift-eng/ai-helpers
/plugin marketplace add lyarwood/kubevirt-ai-helpers
# Install plugins from both
/plugin install jira@ai-helpers
/plugin install kubevirt@kubevirt-ai-helpers
# Use commands from both
/jira:solve OCPBUGS-12345 origin
/kubevirt:review
Available Plugins
For a complete list of all available plugins and commands, see PLUGINS.md.
Prerequisites
Healthcheck Tool (for CI analysis commands)
The CI analysis commands (/kubevirt:ci-*) require the healthcheck CLI tool:
# Clone and build healthcheck
git clone https://github.com/lyarwood/healthcheck.git
cd healthcheck
go build
sudo mv healthcheck /usr/local/bin/
# Verify installation
healthcheck --help
The healthcheck tool provides:
- Live Prow data crawling for job lane analysis
- Aggregated ci-health data for quick overviews
- Search capabilities via search.ci.kubevirt.io
- Optional MCP server for advanced AI-powered analysis
Ambient Workflows
These commands are also available as Ambient Code Platform workflows. When creating an Ambient session, attach a workflow from this repository:
workflow_git_url: https://github.com/lyarwood/kubevirt-ai-helpers.git
workflow_path: workflows/kubevirt-review
workflow_branch: main
Available workflows: kubevirt-review, kubevirt-lint, kubevirt-review-ci, kubevirt-vep-list, kubevirt-vep-summary, kubevirt-vep-groom, kubevirt-ci-lane, kubevirt-ci-health, kubevirt-ci-search, kubevirt-ci-triage, kubevirt-ci-report.
See workflows/README.md for details.
Plugin Development
Want to contribute or create your own plugins? Check out the plugins/ directory for examples.
Make sure your commands and agents follow the conventions for the Sections structure presented in the hello-world reference implementation plugin (see hello-world:echo for an example).
Ethical Guidelines
Plugins, commands, skills, and hooks must NEVER reference real people by name, even as stylistic examples (e.g., "in the style of ").
Ethical rationale:
- Consent: Individuals have not consented to have their identity or persona used in AI-generated content
- Misrepresentation: AI cannot accurately replicate a person's unique voice, style, or intent
- Intellectual Property: A person's distinctive style may be protected
- Dignity: Using someone's identity without permission diminishes their autonomy
Instead, describe specific qualities explicitly
Good examples:
