normalize

Analyze and redesign the feature to perfectly match our design system standards, aesthetics, and established patterns.

MANDATORY PREPARATION

Use the frontend-design skill — it contains design principles, anti-patterns, and the Context Gathering Protocol. Follow the protocol before proceeding — if no design context exists yet, you MUST run teach-impeccable first.

---

Plan

Before making changes, deeply understand the context:

1. Discover the design system: Search for design system documentation, UI guidelines, component libraries, or style guides (grep for "design system", "ui guide", "style guide", etc.). Study it thoroughly until you understand:

   • Core design principles and aesthetic direction
   • Target audience and personas
   • Component patterns and conventions
   • Design tokens (colors, typography, spacing)

   CRITICAL: If something isn't clear, ask. Don't guess at design system principles.

2. Analyze the current feature: Assess what works and what doesn't:

   • Where does it deviate from design system patterns?
   • Which inconsistencies are cosmetic vs. functional?
   • What's the root cause—missing tokens, one-off implementations, or conceptual misalignment?

3. Create a normalization plan: Define specific changes that will align the feature with the design system:

   • Which components can be replaced with design system equivalents?
   • Which styles need to use design tokens instead of hard-coded values?
   • How can UX patterns match established user flows?

   IMPORTANT: Great design is effective design. Prioritize UX consistency and usability over visual polish alone. Think through the best possible experience for your use case and personas first.

Execute

Systematically address all inconsistencies across these dimensions:

• Typography: Use design system fonts, sizes, weights, and line heights. Replace hard-coded values with typographic tokens or classes.
• Color & Theme: Apply design system color tokens. Remove one-off color choices that break the palette.
• Spacing & Layout: Use spacing tokens (margins, padding, gaps). Align with grid systems and layout patterns used elsewhere.
• Components: Replace custom implementations with design system components. Ensure props and variants match established patterns.
• Motion & Interaction: Match animation timing, easing, and interaction patterns to other features.
• Responsive Behavior: Ensure breakpoints and responsive patterns align with design system standards.
• Accessibility: Verify contrast ratios, focus states, ARIA labels match design system requirements.
• Progressive Disclosure: Match information hierarchy and complexity management to established patterns.