Craft UI
Referencia visual, layout funcional — pero solo después de entender el producto y la solicitud.
El fallo que esta habilidad busca prevenir: una página de apariencia plausible hecha de secciones aleatorias, texto de relleno, degradados por defecto y bandas vacías. Ocurre cuando un agente diseña a partir de hábitos de género en lugar de evidencia. Aquí, cada decisión estructural y visual debe rastrearse hasta una de tres fuentes: el producto real, la solicitud del usuario o una referencia realmente vista. Si falta una fuente, recopílala o pídela. Nunca llenes el vacío con un valor por defecto.
Reglas innegociables
- Sin código antes del Contrato de Diseño (paso 2). Sin excepción para páginas "rápidas":
discovery: liteacorta el contrato, no lo elimina. La economía la maneja el enrutador, no saltando el contexto. - Evidencia sobre valores por defecto. Cada token, sección y línea de texto cita de dónde proviene. "Típico para páginas de aterrizaje" no es una fuente.
- La estructura es una columna vertebral, no un bufé. Las secciones existen solo si responden a una pregunta del visitante o a un objetivo de la solicitud. Consulta
references/anti-ai-slop.md. - Contenido real. El nombre del producto, etiquetas, datos e idioma provienen del sitio/solicitud. Sin lorem ipsum, sin logos falsos, sin métricas inventadas, sin "Tu producto aquí" a menos que el usuario haya aprobado un marcador de posición.
- Responde en el idioma del usuario y construye la UI en el idioma del producto (un producto en pt-BR recibe texto en pt-BR).
- Una animación memorable, no un fade-up en cada sección.
- Tokens antes que componentes. Los colores, radios, tipografía, espaciado, sombras y easing viven en variables CSS; los componentes solo leen esas variables.
- La economía es una decisión. El enrutador establece la verbosidad y qué habilidades se ejecutan. Lee solo las secciones de referencia que apliquen.
- Estándar de calidad profesional.
references/quality-bar.mdes la definición de completado: contenido, fidelidad visual, responsive, WCAG AA, rendimiento y entrega.terselo verifica en silencio; nunca se omite.
Flujo de trabajo
0. Triaje (agente principal, segundos)
- Captura la solicitud del usuario textualmente; anota cualquier URL, archivo adjunto, restricción "no quiero" y pistas de verbosidad ("solo el código", "rápido", "explícame").
- Verifica qué está disponible: herramienta de subagente/Task, navegador o fetch web, repositorio local, lista de habilidades/MCP.
- Si la solicitud es un pequeño ajuste a un archivo existente (un color, un valor de espaciado), indícalo al enrutador — puede que establezca
discovery: lite. Una página nueva o un rediseño siempre obtienendiscovery: full. - Si el usuario dice que el layout existente es "amateur", "necesita mejorar", "arregla esta landing page" o señala un sitio en vivo con código, lee
references/polish-existing-site.mdy sigue esa ruta: pulido aditivo del código base real, no una reconstrucción. Ejecutagit statusantes de tocar archivos.
1. Tres agentes de descubrimiento (ejecutar en paralelo)
Usa tu herramienta de subagente — OpenCode subagent, Claude Code Task/Agent, Codex spawn_agent, Cursor background agent. Si no hay herramienta de subagente, ejecuta las tres pasadas secuencialmente en el agente principal y etiqueta cada una con su encabezado. Los agentes de descubrimiento no escriben código.
| Agente | Misión | Alimenta el contrato con |
|---|---|---|
| A — Analista del sitio en producción | Entender el sitio tal como existe en producción: producto, audiencia, texto real, estructura actual, tokens de marca, restricciones. | BRIEF DE CONTEXTO DEL SITIO |
| B — Analista de solicitud y referencias | Decodificar la solicitud real y extraer ADN de estilo solo de referencias realmente vistas; buscar referencias cuando no se haya dado ninguna. | BRIEF DE SOLICITUD + ADN DE ESTILO |
| C — Enrutador de habilidades / economía | Elegir el conjunto mínimo de habilidades/herramientas extra para esta ejecución y establecer la verbosidad. | DECISIÓN DE ENRUTAMIENTO |
Especificaciones completas, esquemas de salida y presupuestos de palabras: references/agents.md. Pasa a cada agente la ruta raíz absoluta de la habilidad, su especificación de rol, la solicitud sin procesar del usuario y las URLs/archivos adjuntos. Limita las respuestas a sus presupuestos de palabras.
Cuando una imagen de referencia esté involucrada, lee también references/pattern-transfer.md. Los tokens de estilo viajan; las recetas de composición no. Nunca adoptes un patrón de héroe o sección solo de la referencia — debe estar justificado por el producto (A) y la solicitud (B).
2. Contrato de Diseño — puerta estricta
Lee references/design-contract.md. Fusiona A + B + C en un solo contrato. Luego verifica:
- La columna vertebral de la estructura está ordenada; cada sección tiene un trabajo, una fuente, una topología copiada literalmente de la referencia y contenido real; no hay bandas vacías.
- Cada token y línea de texto cita una fuente; los valores desconocidos están marcados, no inventados.
- Los conflictos entre agentes/sitio/referencia se resolvieron preguntando al usuario una pregunta consolidada (máx. 3 elementos), no adivinando.
- La verbosidad y la lista de habilidades provienen de C; ninguna habilidad se ejecuta "solo porque existe".
- Existe un registro de adopción de patrones: cada
adoptar/adaptar/descartarcita A y B; ninguna receta de héroe/sección provino solo de la referencia (verreferences/pattern-transfer.md). - La composición no sería plausible para un producto no relacionado en un campo diferente. Los tokens son portátiles; la receta del héroe no lo es.
Los subagentes de descubrimiento nunca preguntan al usuario — solo informan Brechas / Desconocidos. El agente principal recopila los tres briefs, hace una pregunta consolidada (máx. 3 elementos) y mantiene la puerta cerrada hasta que se responda. Si un hecho material sigue siendo desconocido (nombre del producto, audiencia, contenido real, imagen de referencia), pregunta y detente. No comiences el paso 3.
3. Planificar
Plan compacto: tokens, wireframe ASCII de la columna vertebral, banco de texto/datos real y el momento de la animación única con su disparador y motivo. Compara con la referencia y el brief del sitio; cualquier cosa que sea un valor por defecto en lugar de algo observado se revisa o descarta.
4. Construir
- Un solo archivo HTML autónomo por defecto (variables CSS como tokens, Google Fonts con fallbacks reales). Usa el React/Tailwind existente del proyecto solo si el proyecto del usuario ya lo usa.
- Recetas de animación:
references/motion-and-effects.md. GSAP desde una versión fija de cdnjs. - Mantén el código limpio: sin bibliotecas ni abstracciones que el layout no necesite.
- Responsive en 1440 / 768 / 390, estados de foco visibles, respeta
prefers-reduced-motion. - Vuelve a leer
references/anti-ai-slop.mdmientras construyes — especialmente las filas de bandas vacías y bufé de secciones.
5. Verificar visualmente
Renderiza y compara lado a lado con la referencia y el brief del sitio. Usa una herramienta de navegador cuando esté disponible (enrutada por C). Ejecuta el protocolo de verificación en references/quality-bar.md: capturas de pantalla de página completa en 1440 / 768 / 390, orden de secciones y presencia de contenido, sin bandas vacías ni texto recortado, sin desplazamiento horizontal, contraste de píxeles reales, foco de teclado, movimiento reducido y errores de consola. Verifica jerarquía, ritmo de espaciado, consistencia de radio/sombra, densidad e idioma. Rondas de corrección: 1 cuando la verbosidad es terse, hasta 3 cuando es full; corrige la diferencia visual más grande primero y detente cuando la lista de verificación pase.
6. Responder
Formato según la verbosidad de C. terse: 3–5 líneas — qué se construyó, evidencia utilizada, resultado de la verificación. full: también lista qué rasgos de referencia se tomaron de dónde, habilidades utilizadas/omitidas y un cambio sugerido a continuación. Sigue los criterios de entrega en references/quality-bar.md, indica las limitaciones conocidas una vez y escribe siempre en el idioma del usuario.
Uso de otras habilidades
El agente C decide esto por ejecución; primero verifica qué está realmente disponible en la sesión. Habilidad faltante → usa el plan de contingencia y menciónalo una vez al final.
| Fase | Si C dice usar | Plan de contingencia |
|---|---|---|
| Planificar / dirección de diseño | Impeccable (/impeccable shape, luego craft); ejecuta su paso de contexto una vez por sesión | frontend-design, o el plan del paso 3 |
| Revisar y pulir | Impeccable critique, polish, audit | Auto-revisión contra el contrato |
| Calidad de animación | emil-design-eng para easing, duración, springs, hover/press | references/motion-and-effects.md |
| Verificación visual | Browser MCP (Chrome DevTools / Claude in Chrome / developer-mcp-chrome): captura de pantalla en 3 anchos, verifica consola | Describe las verificaciones y pide al usuario una captura de pantalla |
| Logo u objeto 3D | img2threejs solo si la referencia contiene un objeto 3D que valga la pena reconstruir; indica su límite: una imagen no puede revelar lados ocultos | SVG plano o CSS |
| Mantener código pequeño | ponytail antes de agregar cualquier dependencia | CSS simple + una línea de tiempo de GSAP |
Solo llama a una habilidad cuando su fase aplique. Una página de aterrizaje estática no necesita img2threejs.
Originalidad y seguridad
- Recrea patrones, no activos. Nunca reutilices el logotipo, ilustraciones, nombre de marca o texto exacto de una referencia. Usa la marca del usuario y el contenido real de A/B.
- Muchos pins enlazan a kits de UI comerciales. Iguala solo estilo y estructura.
- La apariencia de una referencia es un punto de partida. Si perjudica la usabilidad (bajo contraste, texto pequeño), mantén el estado de ánimo, corrige el problema y dilo.
Archivos
references/agents.md— los tres agentes de descubrimiento, esquemas y presupuestos.references/design-contract.md— plantilla de fusión y puerta estricta.references/anti-ai-slop.md— síntomas y correcciones para layouts genéricos, apilados y vacíos.references/quality-bar.md— definición profesional de completado y protocolo de verificación.references/pattern-transfer.md— evita que las imágenes de referencia trasplanten la misma receta de héroe a productos no relacionados.references/polish-existing-site.md— flujo de trabajo aditivo cuando la tarea es elevar un layout de producción existente.references/categories.md— líneas base de género (viabilidad mínima, no menús de secciones).references/style-dna.md— plantilla de lectura de referencias; requiere evidencia.references/motion-and-effects.md— efectos CSS y recetas de GSAP.assets/refs.json— enlaces de referencia conocidos (aún requieren visualización).