perf-fix-with-proof
Installation
SKILL.md
Performance Fix with Proof
Ships perf fixes as two stacked PRs so CI automatically proves the improvement.
Why Two PRs
The ci-perf-report.yaml workflow compares PR metrics against the base branch baseline. If you add a new @perf test in the same PR as the fix, that test doesn't exist on main yet — no baseline, no delta, no proof. Stacking solves this:
- PR1 (test-only) — adds the
@perftest that exercises the bottleneck. Merges to main. CI runs it on main → baseline established. - PR2 (fix) — adds the optimization. CI runs the same test → compares against PR1's baseline → delta shows improvement.
Workflow
Step 1: Create the test branch
git worktree add <worktree-path> -b perf/test-<name> origin/main