housekeep-design — Consolidate a Drifted Design System to One SSOT

Degree of freedom: MIXED. Canonical-form judgment [HIGH freedom]; inventory searches, migration batches, and the zero-hit re-search [LOW freedom — run exactly].

Multiple sessions and multiple devs leave a design system full of competing truths: three button variants that look the same, --brand, --primary, and #3B82F6 all meaning the same blue, text-[13px] next to text-sm, Lucide and Heroicons side by side. This skill picks one canonical form for each conflict, migrates everything to it, and locks the door behind you.

How to reason

1. Observe — which tokens, components, or icon libraries compete?
2. Interpret — is this duplication or an intentional variant?
3. Classify — merge-to-canonical / keep-as-variant / ask (visible brand change)
4. Severity — a second Button that ships in prod outranks a unused hex alias