frontend-refactoring

Purpose

Treat large frontend visual rewrites as a migration problem, not a patching problem.

Use this skill when new UI keeps getting contaminated by old global CSS, generic classes, inherited selectors, !important, deep descendant chains, or legacy component structure.

This skill helps isolate new UI, reuse logic without reusing polluted presentation, and cut over safely from a legacy frontend surface to a v2 system.

Use This Skill When

• the user wants to redesign or modernize a legacy page or module
• global CSS, generic classes, or inherited styles keep breaking new work
• the target UI is meaningfully different from the old DOM or layout structure
• the team needs a migration path with feature flags, visual regression, and staged deletion
• a refactor must preserve business logic while rebuilding the view layer

Do Not Use This Skill When