pilot-promotion-gate

Evaluate variant B promotion safety using cub-scout evidence and chained receipts.

14|Updated Jan 17, 2026
One-click install
npx skills add https://github.com/confighub/cub-scout --skill pilot-promotion-gate
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pilot-promotion-gate
Source: https://github.com/confighub/cub-scout/tree/main/skills/pilot-promotion-gate
Command: npx skills add https://github.com/confighub/cub-scout --skill pilot-promotion-gate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of deciding whether a proposed variant promotion is safe by providing a cross-variant, field-level verdict rooted in deterministic cub-scout evidence.

Core Features & Use Cases

  • Cross-variant safety verdict (variant A → variant B): Compares three-way outcomes, source-truth, and receipts from both variants to decide PASS/WATCH/ASK/BLOCK for promotion.
  • Binding-aware attribution (bindingSource diff): Uses per-field bindingSource graph shifts (connected mode) to detect whether the promotion changes what is ultimately sourced from upstream.
  • Chained receipts for auditability: Produces a promotion-target receipt that chains variant A evidence into variant B verification to establish an auditable gate input.

Quick Start

Ask Pilot to gate the promotion from variant A to variant B using cub-scout compare three-way, compare source-truth, bindingSource evidence, and chained receipt verification for a cross-variant safety verdict.

Frequently Asked Questions about pilot-promotion-gate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I evaluate promotion safety between two Kubernetes deployment variants?▼

A promotion gate evaluates cross-variant safety by synthesizing three-way compare outcomes, source-truth, and receipt verification from both variant A and variant B. It produces a PASS, WATCH, ASK, or BLOCK verdict based on deterministic, field-level evidence for your release decision.

What is a three-way compare in GitOps release decision-making?▼

A three-way compare in GitOps evaluates the live state, desired state, and target state for each variant to identify field-level diffs. The promotion gate uses this per-variant comparison alongside source-truth analysis to produce a deterministic cross-variant safety verdict.

Can I use a promotion gate for blue-green flips and canary progression?▼

Yes, a promotion gate applies to canary progression, blue-green flips, environment promotions, and cell-to-cell promotions. It evaluates cross-variant safety by synthesizing field-level diffs and attribution evidence across both variants to determine if the promotion target is safe.

How does bindingSource attribution detect upstream changes during a variant promotion?▼

BindingSource attribution detects upstream changes during a promotion by analyzing per-field bindingSource graph shifts in connected mode. This reveals whether the promotion alters what is ultimately sourced from upstream, adding attribution context to the safety verdict.

How do chained receipts verify auditability for cross-variant promotion gates?▼

Chained receipts verify auditability by producing a promotion-target receipt that links variant A evidence into variant B verification. This input attestation chaining establishes an auditable gate input, ensuring the cross-variant safety verdict is rooted in deterministic evidence.