What problem does it solve?
Validating whether a Zephyr code change improves or regresses pipeline performance requires a controlled benchmark, but ad-hoc comparisons often mix mismatched workloads, noisy wall-clock readings, and incomplete metrics. This Skill standardizes the entire A/B workflow so performance verdicts on PRs are reproducible and defensible.
Core Features & Use Cases
- Controlled benchmark launches: Creates git worktrees for the merge-base control and PR-head treatment, then launches matched Iris jobs on GCP or CoreWeave against an immutable pre-normalized sample.
- Finelog metric comparison: Collects execution IDs from job logs and queries the zephyr.stage namespace to compare CPU time, elapsed time, items, bytes, and peak memory per stage with provided SQL.
- Comparability validation and reporting: Verifies workload fingerprints, item/byte parity, OOMs, and infrastructure churn before publishing a sentinel-marked verdict comment (pass, regression, tradeoff, or inconclusive) on the PR.
- Use Case: A reviewer asks whether a shuffle-stage change speeds up dedup. You run this Skill to benchmark the merge base against the PR head on the 100B sample, compare per-stage CPU and elapsed deltas, and post a verdict comment on the PR.
Quick Start
Ask the agent to A/B test the current PR's Zephyr changes against the merge base using the default europe-west4 sample and report the Finelog stage metric comparison.