Menu
Enforces Conventional Commits format with type prefixes, scopes, and Signed-off-by for kubectl-mtv. Use when committing changes, creating commits, or writing commit messages.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | git-commit |
| description | Enforces Conventional Commits format with type prefixes, scopes, and Signed-off-by for kubectl-mtv. Use when committing changes, creating commits, or writing commit messages. |
All commits must follow the Conventional Commits format with a DCO sign-off.
<type>(<scope>): <short description>
<body - explain WHY, not WHAT>
Signed-off-by: Name <email>
Always sign off with -s and include a body:
git commit -s -m "$(cat <<'EOF'
fix(mcp): handle nil response from inventory API
Prevents panic when provider inventory returns empty body.
EOF
)"
| Type | When to use |
|---|---|
feat | New feature or capability |
fix | Bug fix |
refactor | Code restructuring, no behavior change |
docs | Documentation only |
test | Adding or updating tests |
ci | CI/CD changes (workflows, Makefile targets) |
build | Build system, dependencies, container images |
chore | Maintenance (deps update, cleanup) |
perf | Performance improvement |
style | Formatting, linting (no logic change) |
Area of the codebase in parentheses after the type:
| Scope | Area |
|---|---|
cli | CLI commands (cmd/, pkg/cmd/) |
mcp | MCP server and tools (pkg/mcp/, cmd/mcpserver/) |
inventory | Inventory API and provider client |
guide | Technical guide (guide/) |
deploy | Deployment manifests (deploy/) |
tui | Terminal UI (pkg/util/tui/) |
e2e | End-to-end tests (e2e/) |
Omit scope for cross-cutting changes.
Required. Explain why the change was made, not what changed (the diff shows that). Separate from the title with a blank line. Even for small changes, provide a brief rationale.
Every commit must include Signed-off-by: Name <email> (DCO sign-off). Use git commit -s to add it automatically.
When an AI agent contributes to a commit, ask the user whether to add a co-authorship trailer before committing. There are two levels:
Co-authored-by: AI Agent <noreply@github.com>
Co-authored-by: AI Agent (unit tests) <noreply@github.com>
Place the Co-authored-by line after the Signed-off-by line. If the user declines, omit it entirely.
feat(cli): add describe hook command
Allow users to inspect hook details including playbook
content and execution phase.
Signed-off-by: Yaacov Zamir <yzamir@redhat.com>
fix(mcp): handle nil response from inventory API
Prevents panic when provider inventory returns empty body.
Signed-off-by: Yaacov Zamir <yzamir@redhat.com>
Co-authored-by: AI Agent <noreply@github.com>
docs(guide): add chapter on warm migration workflow
Covers warm migration lifecycle, cutover timing, and
snapshot scheduling for vSphere providers.
Signed-off-by: Yaacov Zamir <yzamir@redhat.com>
refactor(tui): extract table rendering into reusable component
Reduces duplication across get commands and makes it
easier to add new table-based views.
Co-authored-by: AI Agent <noreply@github.com>
Signed-off-by: Yaacov Zamir <yzamir@redhat.com>
test(cli): add unit tests for describe hook command
Covers edge cases for missing hooks, empty playbooks,
and invalid hook phases.
Co-authored-by: AI Agent (unit tests) <noreply@github.com>
Signed-off-by: Yaacov Zamir <yzamir@redhat.com>
build: update forklift dependency to latest v1beta1
Picks up new DynamicProvider CRD types needed for
custom provider support.
Signed-off-by: Yaacov Zamir <yzamir@redhat.com>
Add ! after type/scope and include BREAKING CHANGE: in the body:
feat(mcp)!: rename mtv_query tool to mtv_read
BREAKING CHANGE: mtv_query has been renamed to mtv_read.
Update all MCP client configurations.
Signed-off-by: Yaacov Zamir <yzamir@redhat.com>
Step-by-step guide for syncing copy-offload (XCOPY) storage vendor drivers and their credential/secret properties between upstream kubev2v/forklift and kubectl-mtv. Use when adding a new offload vendor, updating vendor-specific secret fields, or auditing for upstream changes.
Step-by-step guide for updating the kubev2v/forklift Go dependency in kubectl-mtv. Use when bumping the forklift version, syncing settings or CRD types, or checking for upstream changes.
Guide for adding or modifying MCP tools and understanding command discovery in kubectl-mtv. Use when working on the MCP server, adding new tools, or changing how commands are exposed to AI assistants.
Guide for writing and running tests in kubectl-mtv, including Go unit tests, MCP e2e tests (Python/pytest), and linting. Use when adding tests, running the test suite, or debugging test failures.
Step-by-step guide for adding new CLI commands to kubectl-mtv. Use when creating new subcommands, adding verbs or resources, or wiring Cobra commands into the command tree.
Reference for Forklift CRD types, GVR constants, K8s client patterns, CRUD operations, and inventory API usage in kubectl-mtv. Use when working with Forklift resources, K8s API calls, or the inventory service.