ima2 UI/UX: Descubrimiento de Intención, Patrones y Vocabulario de Producto
Configuración
npm install -g ima2-gen # instalar globalmente (Node.js >= 20)
ima2 setup # autenticación inicial (se recomienda OAuth de GPT)
ima2 serve # iniciar servidor local
ima2 ping # verificar
ima2 status # estado de configuración y OAuth
Arranque del agente: ejecuta ima2 ping primero. Si no responde: ima2 serve &. Si no está instalado: npm install -g ima2-gen && ima2 setup. Usa ima2 skill path para localizar los skills; lee ../ima2-uiux/SKILL.md (este archivo) para la dirección de diseño, ../ima2-front/SKILL.md para los activos de implementación.
Se activa según la superficie de cambio cuando:
- La dirección de diseño del usuario es vaga ("깔끔하게", "모던하게", "solo haz que se vea bien")
- Se está construyendo UI de onboarding, estado vacío, estado de error o estado de carga
- El usuario hace referencia a la estética de un producto ("estilo Notion", "como Linear")
- Se inicia un nuevo sistema de diseño o se genera una paleta de colores
- Se eligen patrones de layout o arquitectura de navegación
- Se configuran favicons, logotipos de producto o elementos de identidad de marca
- Se manejan variantes de modo oscuro de logotipos, imágenes OG o metadatos de redes sociales
Léelo antes de referencias de estilo específicas cuando el usuario no pueda articular una dirección de diseño clara.
Para la detección de 'slop' y patrones prohibidos, remítete a ima2 skill front ref anti-slop, especialmente el presupuesto de degradados de 2026 y la prohibición de temas de una sola nota.
Prohibición de emojis (resumen): no se permiten emojis como elementos visuales de UI (ESTRICTO). Regla canónica, alcance y exenciones: ima2-front §5 / ima2 skill front ref anti-slop § Emoji Slop.
Separación de roles: Este skill posee el juicio de diseño: descubrimiento de intención, arquitectura de información, significado del estado de UX, dirección de tipografía/color/layout, personalidad del producto, vocabulario de marca, juicio de patrones anti-slop y decisiones del sistema de diseño. ima2-front posee la implementación: HTML/CSS/componentes, mecánicas responsivas, cableado de accesibilidad, comportamiento en tiempo de ejecución y verificación renderizada. Después de elegir la dirección de diseño aquí, carga ima2-front para la implementación concreta.
Evidencia externa/actual de diseño: Para afirmaciones de referencia a productos en vivo, documentación actual de sistemas de diseño, comportamiento de API del navegador, guías de accesibilidad que puedan haber cambiado o evidencia de fuente renderizada en navegador, busca en la web y sigue sus reglas de reescritura de consultas, obtención de fuentes y estado de evidencia. Usa browser fetch/open/text/get-dom/snapshot solo después de que existan URLs candidatas.
Trabajo C0/C1 (parches locales pequeños): Para parches pequeños, omite la cadena de referencia completa.
Nota de clase de regla (UX-STYLE-01): Todo en este skill que exprese gusto — personalidades de producto, ismos de diseño, tokens preestablecidos, vocabulario estético — es
STYLE_SAMPLE: ejemplos de los que basarse, nunca requisitos universales. La corrección objetiva de UX (cobertura de estados, accesibilidad, legibilidad) es propiedad deima2-front§1.5 y se mantiene como ESTRICTO/PREDETERMINADO.
Referencias Modulares
Recomendado: instala los skills en el directorio de skills de tu agente.
ima2 skill install --dir <ruta-del-skill-del-agente> # el agente proporciona su propia ruta ima2 skill install --tmp # fallback efímeroEl agente determina su propio directorio de skills y lo pasa mediante
--dir. Después de la instalación, SKILL.md yreferences/están en disco para lectura nativa.Lectura ad-hoc (sin instalación):
ima2 skill uiux refs # lista todos los módulos de referencia con recuento de líneas ima2 skill uiux ref design-isms # imprime un módulo (coincidencia de nombre base)
| Archivo | Cuándo Leerlo | Qué Cubre |
|---|---|---|
references/design-isms.md | El usuario nombra un estilo/movimiento | 16 movimientos de diseño con firmas CSS, incl. Liquid Glass + kit predeterminado Liquid Editorial (2025-2026) + AI Serif Editorial + Organic Capsule (verificado 2026-07-09) |
references/design-award-sources.md | Buscando referencias de diseño reales | Guía de fuentes por niveles: sitios de premios y galerías, para qué es mejor cada uno y cómo buscar |
references/compositional-patterns.md | Componiendo hero, navegación, movimiento o estructura de contenido | Patrones compositivos canónicos de investigación de premios con puertas de acceso responsivas y de accesibilidad |
references/design-trends.md | Verificando prevalencia fechada, técnicas emergentes o estado de promoción | Instantánea del eje de frecuencia 2026-07-14, señales de técnica, libro de firmas y protocolo de re-rastreo |
references/design-read-example.md | Aprendiendo o revisando el formato Design Read | Ejemplo de Design Read completo + configuración de dial |
references/product-personalities.md | El usuario hace referencia a un producto | 10 perfiles de ADN de producto con tokens exactos, incl. pastel de producto AI 2026 + orgánico warm-sans de OpenAI + serif bookish de Anthropic |
references/layout-macrostructures.md | Eligiendo layout de página/componente | Layouts de componente + composiciones a nivel de página |
references/ux-states.md | Construyendo cualquier UI con estado | Onboarding, vacío, error, carga, divulgación progresiva |
references/color-system.md | Generando colores/paletas | Generación de paletas basada en OKLCH, presupuesto de matiz, neutros teñidos, modo oscuro, accesibilidad |
references/design-system-bootstrap.md | Nuevo proyecto / sistema de diseño | Arquitectura de tokens, jerarquía de componentes, formato DESIGN.md (google-labs-code/design.md) |
references/responsive-nav.md | Trabajo responsivo o de navegación | Puntos de quiebre, consultas de contenedor, patrones de nav por densidad |
references/ux-preflight.md | Antes de la entrega | Lista de verificación de estado de UX |
references/typography-line-breaks.md | Siempre para UI con mucho texto | Calidad de saltos de encabezado, categoría de descriptor corto (subtítulo de hero, descripción de tarjeta — usa balance no pretty), prevención de huérfanos, unidades ch, criterios de huérfanos en coreano, conflicto -webkit-line-clamp |
references/favicon-logo.md | Trabajo de favicon, logotipo de producto o identidad de marca | Conjunto de archivos de favicon, modo oscuro SVG, logotipo en nav/footer, variantes de modo oscuro, imágenes OG, tokens de marca, errores comunes |
references/logo-trust-sections.md | Logotipos de integración/socio/cliente | Decisión entre marquesina y cuadrícula, anti-patrones, tratamiento en escala de grises, ubicación |
references/visual-hierarchy.md | Cualquier decisión de layout / composición | 6 palancas: escala de tamaño, contraste de peso, énfasis de color, espaciado, posición, densidad |
references/form-patterns.md | Formularios, asistentes, autenticación, carga de archivos | Momento de la validación, múltiples pasos, UX de contraseñas, carga de archivos, búsqueda/filtro |
references/mobile-native-ux.md | Decisiones de UX para aplicaciones móviles nativas | iOS HIG vs Material 3, gestos, enlaces profundos, privacidad en coreano, UX de tienda de aplicaciones |
references/intent-discovery-ladder.md | Profundización opcional UX-INTENT-01 (Pasos 1-6) | Escalera de estado de ánimo/luminosidad/densidad/forma/viewport/referencia, desambiguación de solicitudes vagas |
references/korean-design-vocabulary.md | Briefs de diseño en coreano o UI primero-coreano | Traducción de descriptor coreano → token CSS, tabla de coincidencia rápida, pautas de selección de fuentes |
Puerta de Usuario Perezoso (UX-LAZY-01, PREDETERMINADO — disciplina de la coleta aplicada a UX)
Diseña para el usuario cognitivamente frugal: los usuarios no leen, escanean; se satisfacen; intercambiarán elección por una acción obvia a seguir. Antes de enviar cualquier punto de decisión orientado al usuario — opción, configuración, paso, confirmación, campo de entrada, modo — justifica su existencia a la manera de la coleta, en orden:
- No hacer nada: ¿puede un valor predeterminado correcto eliminar esta decisión por completo?
- Eliminar: ¿el paso/campo se gana su costo en la tasa de finalización (ley de Hick)?
- Absorber: ¿puede el sistema tomar la complejidad en lugar del usuario (ley de Tesler)?
- Degradar: aún necesario para algunos usuarios → divulgación progresiva, nunca una bifurcación de nivel superior.
Cada pantalla tiene UNA acción principal. Condicional de superficie: los flujos de consumo/de un solo uso minimizan las DECISIONES; las herramientas de trabajo repetitivo (perfiles densos) minimizan los MOVIMIENTOS repetidos — colapsar controles expertos en asistentes es el fallo inverso. Exenciones ESTRICTAS: acciones destructivas/irreversibles, consentimiento/privacidad/legal, confirmación de pagos y provisiones de accesibilidad nunca se colapsan en valores predeterminados mágicos.
Contrato de Estado de UX (UX-STATE-01)
Para trabajo de onboarding, vacío, carga, error o divulgación progresiva, el cuerpo debe responder al significado del estado antes que al estilo. Los patrones profundos residen en references/ux-states.md.
- Onboarding enseña la primera acción significativa, no todo el producto.
- Vacío explica por qué existe el estado y nombra la siguiente acción.
- Carga elige esqueleto para estructura conocida, spinner/progreso para esperas desconocidas cortas, y evita la finalización falsa.
- Error expone reintento, recuperación o escalamiento; nunca deja al usuario sin salida.
- Divulgación progresiva nombra lo que permanece oculto, por qué permanece oculto y dónde estará disponible.
Selector de IA (UX-IA-01)
Arquitectura de navegación predeterminada según la forma de trabajo; lee references/responsive-nav.md para detalles responsivos.
| Forma de trabajo | IA predeterminada |
|---|---|
| Trabajo repetitivo denso de escritorio | Barra lateral + paleta de comandos |
| Trabajo seccionado mediano | Pestañas o navegación segmentada |
| Flujo de consumo principalmente móvil | Navegación inferior, hoja o acciones en zona del pulgar |
| Asistente/autenticación/configuración | Stepper o flujo lineal apilado |
1. Protocolo de Descubrimiento de Intención del Usuario
Cuando la solicitud de diseño del usuario es vaga ("깔끔하게 해줘", "모던하게", "solo haz que se vea bien"), no produzcas una salida genérica. Ejecuta el flujo de ambigüedad compacto (UX-INTENT-01):
- Produce el Design Read de la §2 usando las señales disponibles.
- Si una decisión aún bloquea la dirección, haz UNA pregunta de la mejor bifurcación aclaratoria con opciones binarias/ternarias.
- Procede con la respuesta; si el usuario no responde y la tarea puede continuar, elige el valor predeterminado más correcto para el dominio y establece la suposición. En superficies EXPRESIVAS (landing/consumo/creativo/producto-AI), ese valor predeterminado es la Dirección Predeterminada Sin Brief a continuación (UX-DEFAULT-ISM-01); las superficies tranquilas mantienen valores predeterminados correctos para el dominio tranquilos.
Omite esta sección si el usuario proporcionó especificaciones de diseño explícitas o si se trata de un parche de ≤5 líneas.
Dirección Predeterminada Sin Brief (UX-DEFAULT-ISM-01, PREDETERMINADO — contenido del kit STYLE_SAMPLE)
Este es el PASO-3 de RESERVA de UX-INTENT-01, nunca un bypass: se activa solo después del Design Read y después de que la bifurcación bloqueante se resuelva o quede sin respuesta, y la dirección aplicada SIEMPRE se declara como una suposición explícita en el entregable. Una dirección nombrada, específica y limitada por dominio reemplaza los valores predeterminados genéricos del LLM; NO debe reintroducir el gusto genérico de vidrio esmerilado/tarjeta centrada/beige predeterminado bajo una nueva etiqueta.
Kit predeterminado para superficies expresivas: Liquid Editorial (compuesto 2026, decidido 2026-07-07 a partir de investigación de tendencias de Nivel 2 — consulta references/design-isms.md §1.14 para la firma completa):
- Estructura: composición editorial liderada por tipografía (escala de encabezado de autor sobredimensionada, grotesk predeterminado, serif display solo con justificación editorial según UX-TYPE-01), textura táctil/fotográfica sobre lavados de degradado plano, layout asimétrico con peso en el contenido.
- Acento material: Liquid Glass o cromo de píldora casi opaco SOLO en capas funcionales flotantes (nav/barras de herramientas/grupos de chips); unidades de contenido de píldora de chip; la capa de contenido permanece sólida (
ima2-frontFE-LIQUID-LAYER-01). Los hijos dentro del cromo de píldora no llevan bordes/contornos de cápsula en reposo — énfasis solo mediante rellenos/matices (ima2-frontFE-PILL-NEST-01); estados de desplazamiento de la barra superior segúnima2-front/references/top-bar.mdFE-TOPBAR-STATE-01. - Movimiento: línea base de retroalimentación + un momento de firma (chips de proximidad del puntero o revelación impulsada por desplazamiento) + >= 1 revelación de desplazamiento de apoyo en superficies de cubo de aterrizaje (piso 2, techo ~4 —
ima2-front/references/motion.mdFE-MOTION-BUCKET-01); solo retroalimentación en otros lugares, según las puertas de dominio de movimiento. - Color: acento único derivado de OKLCH + neutros teñidos (presupuesto de matiz,
references/color-system.md).
Puerta de dominio (ESTRICTO): los paneles de control, administración, operaciones, finanzas, gobierno y herramientas de trabajo repetitivo B2B NUNCA reciben este kit por defecto — "elegante" nunca anula la corrección del dominio (§ Selector de IA + perfiles de densidad de producto de ima2-front).
Profundización opcional: usa la escalera a continuación solo cuando la primera bifurcación falla o el usuario quiere explícitamente una exploración guiada.
- Usa opciones binarias/ternarias, no preguntas abiertas.
- Haz referencia a productos conocidos: los usuarios reconocen lo que quieren más rápido de lo que lo articulan.
- Si el skill de diagramas está disponible, ofrece: "참고로 스타일 비교를 다이어그램으로 보여드릴 수도 있어요."
- Si el usuario nombra una referencia de producto específica, omite los pasos restantes y mapea directamente mediante
references/product-personalities.md.
Para la escalera guiada completa de 6 pasos (Estado de Ánimo → Luminosidad → Densidad → Forma → Viewport → Referencia) y la tabla de desambiguación de solicitudes vagas, lee references/intent-discovery-ladder.md. Cárgala solo cuando el flujo compacto anterior necesite una exploración guiada más profunda.
2. Design Read (OBLIGATORIO para páginas, componentes o layouts nuevos. Opcional para parches de ≤5 líneas — consulta la sección de desarrollo §0.1 Ruta Rápida de Parches.)
Antes de generar CUALQUIER código frontend, produce un Design Read. Si el proyecto tiene un archivo DESIGN.md, léelo primero — sus tokens y prosa anulan todo lo siguiente.
Soporte de herramientas nativas (estructura/60): lee referencias visuales — pantallas existentes, capturas de competidores, exportaciones de diseño — en contexto con view_image antes de escribir el Design Read; produce los activos de mapa de bits necesarios (iconos, ilustraciones, imágenes simuladas) con ima2 (prueba ima2 status, intenta ima2 serve si está caído; ima2 es la herramienta principal solo cuando ima2 no está realmente disponible) en lugar de dejar cuadros de marcador de posición; y verifica el resultado construido visualmente según la verificación visual (captura de pantalla del navegador -> view_image).
Formato de salida (mini DESIGN.md)
Ejemplo completo: references/design-read-example.md.
---
name: <nombre-del-proyecto>
colors:
primary: "<hex>"
accent: "<hex>"
background: "<hex>"
typography:
heading: { fontFamily: <fuente>, fontSize: <tamaño> }
body: { fontFamily: <fuente>, fontSize: <tamaño> }
---
Leyendo esto como: <tipo de página> para , con un lenguaje de . <1-2 oraciones: referencia específica, no adjetivos. "Folleto de clase de los 70" > "moderno y limpio">
Hacer: <positivo específico del contexto del brief> No hacer: <negativo específico del contexto del brief> ...