skills/ui-variations/references/promotion-checklist.md

Promotion Checklist

Use this checklist after the user selects a winning variation.

Promote The Winner

• Move the chosen variation into the real production path or component.
• Rename experiment-oriented files and symbols so the final code reads normally.
• Update call sites, imports, tests, stories, snapshots, and docs that depend on the old surface.

Remove Comparison Artifacts

• Delete the preview route or preview-only page if it no longer serves a purpose.
• Remove the floating variant switcher.
• Delete losing variations.
• Remove preview-only helpers, fixtures, state, comments, and wrappers.
• Remove orphaned styles and unused assets.

Re-Verify

• Re-run the relevant lint, typecheck, test, or build commands.
• Verify the real integrated page, not just the preview surface.
• Confirm mobile and desktop still behave correctly when relevant.
• Confirm no preview controls or experiment labels remain.

Report

• State which variation won.
• State where it was integrated.
• State what temporary files or routes were removed.
• State which checks were run and whether anything remains unresolved.