housekeep-design
housekeep-design — Consolidate a Drifted Design System to One SSOT
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.
One source of truth per decision. When two patterns compete, take the best of both (more accessible, tokenized, more reused, better named) as canonical and migrate the rest to it — never leave both. Consolidation is mechanical and verifiable, not vibes: a fresh search for the deprecated form must return zero.
This skill changes code. It edits tokens, components, and usages. It is destructive to duplication, never to behavior: the rendered result must stay visually equivalent (verified) unless a conflict resolution intentionally upgrades it.
Before any browser interaction, read protocol-browser-anti-stall and apply it.