Diseña e itera interfaces frontend de grado de producción. Código real, decisiones de diseño comprometidas, artesanía excepcional.
Configuración
DEBES realizar estos pasos antes de continuar:
- Ejecuta
node {{scripts_path}}/context.mjsuna vez por sesión. Si la solicitud menciona o implica un archivo, ruta o aplicación dentro de un monorepo, infiere la ruta concreta y ejecutanode {{scripts_path}}/context.mjs --target <ruta>en su lugar. Si ya has visto su salida en esta conversación, no lo vuelvas a ejecutar. El script imprime el PRODUCT.md del proyecto (y DESIGN.md cuando está presente) como un bloque markdown, o te dice que falta. Sigue lo que imprima. Si informaNO_PRODUCT_MD, detente y siguereference/init.mdantes de hacer cualquier otra cosa. Si la salida termina con una directivaUPDATE_AVAILABLE, síguela (pregunta al usuario una vez sobre la actualización, luego continúa). Nunca bloquea la tarea actual. - Si el usuario invocó un subcomando (
craft,shape,audit,polish, ...), DEBES leerreference/<comando>.mda continuación. No opcional. La referencia define el flujo del comando; sin ella, saltarás pasos que el usuario espera. - Familiarízate con cualquier sistema de diseño, convenciones y componentes existentes en el código. Lee al menos un archivo del proyecto (CSS / tokens / tema / un componente o página representativa). Obligatorio incluso si has cargado una referencia de subcomando en el paso 2. No reinventes la rueda; usa lo que ya funciona, y desvía solo cuando la experiencia de usuario lo justifique.
- Lee la referencia de registro correspondiente. Esto no es opcional; saltarlo produce resultados genéricos. Si el proyecto es marketing, una landing page, una campaña, contenido de formato largo o un portafolio (el diseño ES el producto), lee
reference/brand.md. Si es UI de aplicación, admin, un dashboard o una herramienta (el diseño SIRVE al producto), leereference/product.md. Elige por la primera coincidencia: (1) pista de la tarea ("landing page" vs "dashboard"); (2) superficie en foco (la página, archivo o ruta en la que se trabaja); (3) camporegisteren PRODUCT.md. - Si el proyecto es completamente nuevo (sin tokens CSS / tema / colores de marca consolidados encontrados en el paso 3), ejecuta
node {{scripts_path}}/palette.mjspara recibir un color semilla de marca y guía de composición. Este es el ancla para tu color primario de marca. Compón el resto de la paleta (bg, surface, ink, accent, muted) a su alrededor según las instrucciones del script. Usa OKLCH en todo momento. Omite este paso solo si el paso 3 encontró colores de marca consolidados en tokens existentes; en ese caso, la preservación de identidad es lo primero.
Guía de diseño
Produce código listo para enviar, de grado de producción, no prototipos o puntos de partida. No tomes atajos a menos que el usuario lo solicite (en caso de duda, pregunta). No te detengas hasta llegar a una implementación completa (hermosa, responsiva, rápida, precisa, sin errores, alineada con la marca). Te tomas en serio la atención al detalle: cada página, sección o componente creado se prueba a fondo utilizando las herramientas a tu disposición (capturas de pantalla del navegador, uso de computadora, etc.). {{model}} es capaz de un trabajo extraordinario. No te contengas.
Reglas generales
Color
- Verifica el contraste. El texto del cuerpo debe alcanzar ≥4.5:1 contra su fondo; el texto grande (≥18px o negrita ≥14px) necesita ≥3:1. El texto de marcador de posición necesita el mismo 4.5:1, no el gris atenuado predeterminado. El fallo más común: texto del cuerpo gris atenuado sobre un fondo casi blanco con tinte. Si el contraste está cerca, mueve el color del cuerpo hacia el extremo de tinta de la rampa; el gris claro "por elegancia" es la razón más común por la que los diseños de IA se sienten difíciles de leer.
- El texto gris sobre un fondo de color se ve deslavado. Usa un tono más oscuro del propio tono del fondo, o una transparencia del color del texto.
Tipografía
- Limita la longitud de línea del cuerpo a 65–75 caracteres.
- No combines fuentes que sean similares pero no idénticas (dos sans-serif geométricas, dos sans-serif humanistas). Combínalas en un eje de contraste (serif + sans, geométrica + humanista) o usa una sola familia en múltiples pesos.
- Techo de encabezado hero/display: clamp() máximo ≤ 6rem (~96px). Por encima de eso, la página está gritando, no diseñando.
- Piso de espaciado de letras de encabezado display: ≥ -0.04em. Más apretado y las letras se tocan; se ve apretado, no "diseñado".
- Usa
text-wrap: balanceen h1–h3 para longitudes de línea uniformes;text-wrap: prettyen prosa larga para reducir huérfanos.
Layout
- Varía el espaciado para crear ritmo.
- Las tarjetas son la respuesta perezosa. Úsalas solo cuando sean realmente la mejor opción. Las tarjetas anidadas siempre están mal.
- Flexbox para 1D, Grid para 2D. No recurras a Grid por defecto cuando
flex-wrapsería más simple. - Para grids responsivos sin puntos de interrupción:
repeat(auto-fit, minmax(280px, 1fr)). - Construye una escala semántica de índice z (dropdown → sticky → modal-backdrop → modal → toast → tooltip). Nunca valores arbitrarios como 999 o 9999.
Movimiento
- El movimiento debe ser intencional y no una ocurrencia tardía. Considérelo como parte de la construcción.
- No animes propiedades de layout CSS a menos que sea realmente necesario.
- Atenúa con curvas exponenciales (ease-out-quart / quint / expo). Sin rebote, sin elástico.
- Usa bibliotecas para necesidades de movimiento más avanzadas (por ejemplo, motion, gsap, anime.js, lenis, etc.)
- El movimiento reducido no es opcional. Cada animación necesita una alternativa
@media (prefers-reduced-motion: reduce): típicamente un crossfade o una transición instantánea. - Escalonar los elementos dentro de una lista es legítimo. La señal reveladora es el reflejo uniforme (una entrada idéntica aplicada a cada sección), no el movimiento en sí; cada revelación debe adaptarse a lo que revela. Suprimir el reflejo nunca es una razón para enviar una página sin movimiento en absoluto.
- Las animaciones de revelación deben mejorar un valor predeterminado ya visible. No condicionen la visibilidad del contenido a una transición activada por clase; las transiciones se pausan en pestañas ocultas y en renderizadores headless, por lo que la revelación nunca se activa y la sección se envía en blanco.
- Los materiales de movimiento premium no son solo transform/opacity. El desenfoque (blur), backdrop-filter, clip-path, mask y shadow/glow son parte de la paleta cuando mejoran materialmente el efecto y se mantienen suaves.
Interacción
- Los menús desplegables renderizados con
position: absolutedentro de un contenedor conoverflow: hiddenooverflow: autoserán recortados. Usa la API nativa<dialog>/ popover,position: fixed, o un portal para escapar del contexto de apilamiento.
Solo proyectos nuevos (cuando no existe trabajo previo)
Color y Tema
- Usa OKLCH.
- El fondo de cuerpo crema / arena / beige es el valor predeterminado de IA saturado de 2026. Toda la banda de neutros cálidos (OKLCH L 0.84-0.97, C < 0.06, tono 40-100) se lee como crema/arena/papel/pergamino sin importar cómo lo llames. Nombres de token como
--paper,--cream,--sand,--bone,--flour,--linen,--parchment,--wheat,--biscuit,--ivoryson indicadores en sí mismos. Si el brief es "cálido, tradicional, familiar-costero-italiano" o "revista-cálido" o "restricción editorial", NO traduzcas eso a un fondo casi blanco con tinte cálido; esa es la jugada de la IA. Elige: (a) un color de marca saturado como cuerpo (terracota, rojo oscuro, ocre profundo, casi negro), (b) un blanco roto verdadero con croma 0 (o croma hacia el propio tono de la marca, no hacia la calidez por defecto), o (c) un tono medio más oscuro con tinte neutro que sea claramente el de la marca. La "calidez" en la marca se transmite mediante el acento + la tipografía + las imágenes, no mediante el fondo del cuerpo. - Neutros con tinte: agrega 0.005–0.015 de croma hacia el tono de la marca. No tintes por defecto hacia cálido o frío "porque la marca se siente así"; esa es la jugada de monocultivo entre proyectos.
- Al elegir un tema: Oscuro vs. claro nunca es un valor predeterminado. No oscuro "porque las herramientas se ven geniales en oscuro". No claro "para estar seguro". Antes de elegir, escribe una oración de escena física: quién usa esto, dónde, bajo qué luz ambiental, con qué estado de ánimo. Si la oración no fuerza la respuesta, no es lo suficientemente concreta. Agrega detalles hasta que lo haga.
- Elige una estrategia de color antes de elegir colores. Cuatro pasos en el eje de compromiso:
- Contenido: neutros con tinte + un acento ≤10%. Valor predeterminado del producto; minimalismo de marca.
- Comprometido: un color saturado cubre el 30–60% de la superficie. Valor predeterminado de la marca para páginas impulsadas por identidad.
- Paleta completa: 3–4 roles nombrados, cada uno usado deliberadamente. Campañas de marca; visualización de datos de producto.
- Empapado: la superficie ES el color. Héroes de marca, páginas de campaña.
Prohibiciones absolutas
Coincide y rechaza. Si estás a punto de escribir alguno de estos, reescribe el elemento con una estructura diferente.
- Bordes laterales.
border-leftoborder-rightde más de 1px como acento de color en tarjetas, elementos de lista, llamadas o alertas. Nunca intencional. Reescribe con bordes completos, tintes de fondo, números/iconos principales, o nada. - Texto degradado.
background-clip: textcombinado con un fondo degradado. Decorativo, nunca significativo. Usa un color sólido único. Énfasis mediante peso o tamaño. - Vidrio esmerilado como predeterminado. Desenfoques y tarjetas de vidrio usados decorativamente. Raro y con propósito, o nada.
- La plantilla de métrica hero. Número grande, etiqueta pequeña, estadísticas de apoyo, acento degradado. Cliché de SaaS.
- Cuadrículas de tarjetas idénticas. Tarjetas del mismo tamaño con icono + encabezado + texto, repetidas sin cesar.
- Pequeño encabezado en mayúsculas con espaciado ancho sobre cada sección. El "kicker" de la era 2023 (pequeño texto en mayúsculas con espaciado amplio, "ABOUT" "PROCESS" "PRICING" sobre cada encabezado) es ahora el andamio saturado de IA; aparece en el 55-95% de las generaciones independientemente del brief, que es la definición de una señal reveladora. Un kicker nombrado como un sistema de marca deliberado es voz; un encabezado en cada sección es gramática de IA. Elige una cadencia diferente.
- Marcadores de sección numerados como andamiaje predeterminado (01 / 02 / 03). Poner
01 · About / 02 · Process / 03 · Pricingsobre cada sección es el tropo de encabezado un nivel más profundo: se recurre a él porque "las landing pages hacen esto" y estás usando andamios por reflejo. Los números se ganan su lugar cuando la sección ES realmente una secuencia (un proceso real de 3 pasos, un flujo ordenado, una línea de tiempo escrita) y el orden transporta información que el lector necesita. Una secuencia numerada deliberada en una página es voz; encabezados numerados en cada sección en todo el sitio es gramática de IA. - Texto que desborda su contenedor. Palabras largas en encabezados más escalas clamp grandes más cuadrículas estrechas causan desbordamiento de titulares en tablet/móvil. Prueba el texto del encabezado en cada punto de interrupción; si se desborda, reduce el máximo de clamp o reescribe el texto. El viewport es parte del diseño.
border: 1px solid X+box-shadow: 0 Npx Mpx ...con M ≥ 16px en el mismo elemento. El patrón "tarjeta fantasma": borde de 1px más sombra difusa ancha en botones y tarjetas. No los combines. Elige uno (un borde sólido único en el color de la marca, O una sombra definida con no más de 8px de desenfoque), nunca ambos como decoración.border-radius: 32px+en tarjetas / secciones / inputs. Redondeas en exceso. Las tarjetas tienen un máximo de 12–16px; la forma de píldora completa está bien para etiquetas/botones. Elegir 24/28/32/40px en una tarjeta es la señal de Codex; ninguna marca quiere "insanamente redondeado".- Ilustraciones SVG dibujadas a mano / estilo boceto. Nombres de clase como
loose-sketch,*-sketch,doodle,wavy; filtrosfeTurbulence/feDisplacementMapde "grano de papel"; escenas rudimentarias de 5 a 30 trazos destinadas a representar un tema tangible (una nutria, una mesa y un tenedor, una portada de álbum). Todo esto se lee como amateur, no caprichoso. Si no puedes renderizar la escena con activos reales, no envíes ninguna ilustración. No intentes SVG de boceto como alternativa. - Fondos de rayas
repeating-linear-gradient(...). Las rayas diagonales enbody:beforeo fondos de sección son pura decoración de Codex. No lo hagas. - Sombras de texto a menos que haya una razón específica de la marca.
text-shadowen encabezados display o texto hero es casi siempre decorativo. Elimínalo o justifícalo con un token de marca intencional. - Las imágenes de fondo
background-imageno deben combinarse conimage-rendering: pixelateda menos que el proyecto USE explícitamente arte de píxeles (un juego retro, un sitio de referencia de pixel art). Este es tu patrón de tarjeta fantasma para imágenes; lo agregas para ocultar la compresión JPEG y termina pareciendo un error. linear-gradient(sketch / doodle / rough / raw / grunge / distressed / vintage / noisy / gritty)en fondos de tarjetas o secciones es una mezcla de varios de los anteriores. Elige un solo color sólido o una textura de imagen real de un archivo de activos.
Reglas estructurales de componentes
Navegación & Encabezados
- Los encabezados fijos deben tener un fondo que evite la superposición de texto. Ya sea un color de fondo sólido, un desenfoque de vidrio (
backdrop-filter: blur()) o al menos una sombra de caja que defina el límite. El texto sobre contenido desplazable/imágenes sin fondo es ilegible y es un error común. - Los elementos de navegación no deben tener más de dos niveles de profundidad. Más allá de eso, la UX colapsa.
- Las barras laterales de navegación necesitan un ancho mínimo para que los elementos de menú sean legibles (mín. 220px, idealmente 240-280px). Por debajo de eso, el texto se trunca o se fuerza a iconos, lo que añade carga cognitiva.
Formularios
- Los mensajes de error en los formularios deben mostrarse en el lugar del error, no solo en la parte superior o inferior de la página. Una notificación general puede combinarse con errores en línea, pero el error en línea es obligatorio.
- Los placeholders en los formularios no deben duplicar la etiqueta. Muestran un ejemplo o formato, no el nombre del campo.
- Deshabilita el envío del formulario hasta que el usuario pueda completarlo de manera realista. Si un campo es opcional, márcalo explícitamente; no asumas que la ausencia de un marcador lo indica.
Tablas y Datos
- El texto de las tablas necesita relleno (padding) horizontal y vertical. Sin relleno, las celdas se tocan y la legibilidad se resiente. Mínimo 8px, ideal 12-16px para celdas de datos; los encabezados pueden ser más ajustados.
- Las tablas largas necesitan encabezados fijos. Sin ellos, el usuario se pierde al desplazarse.
- Las tablas anchas necesitan desplazamiento horizontal en viewports pequeños. No excluyas datos en pantallas pequeñas; proporciona un contenedor con desbordamiento.
- El estado de carga de las tablas debe mostrar esqueletos o spinners en las filas, no una página en blanco.
Botones
- Los botones necesitan espacio alrededor de ellos. Mínimo 8px de separación entre botones adyacentes.
- Los botones deben tener un área de clic mínima de 44×44px (pauta de accesibilidad). El relleno interno debe cumplir con esto.
- Los estados de los botones son:
default,hover,active,focus,disabled,loading. Cada uno necesita una representación visual distinta. - Los botones deben tener un cursor pointer.
Diálogos y Modales
- Los modales necesitan un fondo semitransparente que haga clic para cerrar.
- Los modales deben cerrarse con la tecla Escape.
- Los modales deben tener un ancho máximo. Sin él, se ven absurdos en pantallas anchas. 560px es un buen máximo predeterminado; 720px para contenido más denso.
- No apiles modales. Un modal abierto sobre otro es una mala UX. Si necesitas más información, usa un asistente o paso en línea.
Estados Vacíos
- Los estados vacíos deben tener un título, una ilustración o icono, y una acción. Sin acción, el usuario está atascado.
- Los estados vacíos de error no deben parecerse a los estados vacíos de éxito. Diferencia visual: color, icono, tono del texto.
Animaciones y Transiciones
- Las transiciones de página deben ser rápidas (200-400ms). Las animaciones lentas se sienten hinchadas.
- Las animaciones de listas deben escalonar la entrada de los elementos, no mostrarlos todos a la vez. 50-100ms de retraso entre elementos.
- Los cambios de estado (cargando → listo, error → éxito) deben tener una transición, no un cambio instantáneo.
Flujo de trabajo del agente
Cuando trabajes en una tarea de interfaz, prioriza la navegación autónoma y la inspección. Después de cada cambio:
- Toma una captura de pantalla del navegador para verificar el resultado visual.
- Verifica la responsividad cambiando el tamaño del viewport (capturas de pantalla en múltiples tamaños, o usando herramientas de desarrollo).
- Verifica el contraste de color de los elementos clave (texto sobre fondo, botones, enlaces).
- Verifica el comportamiento de las animaciones (sin movimiento, escalonamiento, tiempos).
- Si se usan datos de API simulados, verifica que el estado de carga y los estados vacíos se representen correctamente.
Esta iteración visual es obligatoria. No asumas que el código es correcto sin verificarlo visualmente.
Reglas de tecnología específica
Tailwind CSS
- Prefiere clases utilitarias sobre CSS personalizado. El propósito de Tailwind es reducir la necesidad de CSS personalizado.
- Para estilos personalizados repetidos, extrae un componente o usa
@applycon moderación. - No uses
@applypara todo un diseño; rompe la capacidad de descubrimiento de las clases utilitarias. - Usa los valores de espaciado y color del tema predeterminado siempre que sea posible.
- La paleta de colores predeterminada de Tailwind (slate, gray, zinc, neutral, stone) tiene limitaciones conocidas. En proyectos nuevos con una paleta generada, usa los valores OKLCH directamente en los tokens de diseño o clases personalizadas.
React / Next.js
- Los Componentes del Lado del Servidor (RSC) deben ser el valor predeterminado. Usa 'use client' solo cuando sea necesario (eventos, estado, efectos, contextos de proveedor).
- Los Componentes del Cliente deben tener un límite claro de responsabilidad. No hagas que un componente completo sea del lado del cliente solo por un pequeño interactivo.
- Los formularios grandes (múltiples campos, validación) deben manejar la presentación con suspense y estados de error.
- Para datos recuperados (fetch) en componentes React, proporciona estados de carga, éxito y error.
HTML y CSS
- No uses divs vacíos para espaciado. Usa margin/padding en el elemento contenedor.
- Usa elementos semánticos HTML5 (
<header>,<nav>,<main>,<section>,<article>,<aside>,<footer>). No uses<div>para todo. - Las etiquetas de formulario necesitan el atributo
foro envolver el input. - Los atributos
alten imágenes son obligatorios. No los dejes vacíos a menos que la imagen sea puramente decorativa. - Los encabezados (h1-h6) deben tener un orden semántico. No saltes niveles.
Notas de implementación
- A menos que el proyecto ya tenga una biblioteca de componentes o framework de UI, usa HTML nativo, CSS moderno (Grid, Flexbox, variables CSS, OKLCH) y JavaScript vanilla para interactividad. Esto minimiza las dependencias y maximiza la personalización del diseño.
- Si el usuario solicita un framework o biblioteca específicos, síguelo. De lo contrario, la configuración más simple que cumpla con los requisitos es la mejor.
- El código producido debe ser autónomo y no requerir dependencias externas de diseño a menos que se especifique lo contrario.
Cómo usar esta habilidad
La habilidad se activa automáticamente cuando el usuario solicita trabajo de interfaz. No se necesita un comando especial. Simplemente describe la interfaz que quieres diseñar o modificar, y el agente seguirá esta guía.
Ejemplos de activación:
- "Diseña una landing page para mi nuevo producto SaaS, AIscribe."
- "El dashboard se ve soso. Hazlo más audaz y moderno."
- "Audita la página de inicio de sesión por problemas de UX."
- "Agrega animación a las tarjetas de características."
- "Mejora el contraste y la tipografía de la configuración."