UI/UX Spec Genome

Overview

Extract a reusable UI/UX design spec from a frontend codebase by inventorying UI sources, documenting foundations, cataloging components, and capturing page-level patterns and behaviors. Exclude business logic and domain-specific workflows. Framework-agnostic: adapt to the actual stack in the target repo.

Prerequisites

• bash
• rg (ripgrep) is required by scripts/scan_ui_sources.sh
• Optional: git (used to resolve repo root)
• For replica lint: python3 (used by scripts/lint_replica_spec.sh)

When to use

• You want to create or update a ui-ux-spec/ doc bundle for a frontend codebase (tokens/styles/components/patterns/pages/a11y).
• You want a plan-driven, phased UI-only refactor based on an existing ui-ux-spec/ folder.

When NOT to use (anti-triggers)

• Bug fixes, debugging, performance tuning, or build failures.
• Any change that touches business logic, APIs, routing, data contracts, or domain workflows.