qualia-polish

What problem does it solve?

Qualia-polish removes AI-generated UI artifacts and enforces a coherent, human-crafted design system so products feel intentionally designed rather than templated. It targets visual sameness, scattered styles, poor accessibility, and missing interactive states that degrade user trust and usability.

Core Features & Use Cases

• AI Slop Detection: Run deterministic grep-based checks to find generic fonts, repetitive card grids, blue-purple gradients, hardcoded widths, and other common AI-generated patterns.
• Typography, Color & Layout Passes: Establish hierarchy, fluid type scaling, a single source of color tokens, layered surfaces, and responsive full-width layouts.
• Interaction, Motion & Accessibility: Add hover/focus states, loading skeletons, reduced-motion fallbacks, semantic HTML, and WCAG checks.
• Harden & Verify: Read DESIGN.md when present, run TypeScript checks, produce a single commit, and transition the project state to polished.
• Use Case: Run after the verify phase to convert a verified feature release into a production-quality UI that meets brand, accessibility, and responsive requirements.

Quick Start

Run the design polish pass on the current project to remove AI-generated artifacts and enforce typography, color, interaction, and accessibility standards.