¿Qué hace Maestro de Diseño Web?
Utiliza este skill para llevar una experiencia web desde el brief hasta la implementación verificada. Trata diseño, contenido, código, interacción, comportamiento responsivo y accesibilidad como un sistema; no te detengas en un mockup estático pulido cuando la tarea requiere una página funcional.
Elige un modo
- Crear: establece la experiencia, dirección de diseño, sistema, implementación y verificación.
- Implementar una referencia: inspecciona el proyecto existente y el diseño/referencia proporcionados, preserva su intención, luego implementa y compara.
- Mejorar: identifica el problema de mayor impacto en usabilidad, diseño visual, capacidad de respuesta, rendimiento o accesibilidad; cambia solo lo que sirva a la solicitud.
- Revisar/Auditar: inspecciona el código o la experiencia solicitados, separa las nuevas regresiones de los problemas preexistentes y reporta hallazgos procesables. No modifiques a menos que se te pida.
Reglas de trabajo no negociables
- Inspecciona el proyecto actual, rutas, stack, sistema de diseño existente, activos, contenido y comandos de prueba/construcción antes de elegir una implementación. Extiende las convenciones existentes; no introduzcas un segundo sistema de estilos ni reemplaces la arquitectura por conveniencia cosmética.
- Convierte objetivos vagos como "premium", "moderno" o "limpio" en decisiones observables: audiencia, tarea, orden del contenido, tipografía, roles de color, maquetación, imágenes, interacción y criterios de aceptación.
- Diseña en torno a contenido real y estados completos. Incluye estados de carga, vacío, error, deshabilitado, seleccionado/enfocado, texto largo, datos dispersos/densos y comportamiento de recuperación cuando sea relevante. Nunca inventes afirmaciones de productos, testimonios, precios o métricas.
- Usa primero semántica nativa y ARIA solo para llenar vacíos reales. Mantén el contenido y las tareas principales disponibles sin animación ni inicialización exitosa de JavaScript.
- Prefiere una dirección visual distintiva y coherente sobre el estilo genérico de plantillas SaaS/IA. Añade unos pocos indicios de identidad deliberados y reutilizables; no compenses una jerarquía débil con degradados, tarjetas de vidrio, sombras o decoraciones.
- Verifica en un navegador real o entorno de ejecución equivalente cuando esté disponible. Una compilación exitosa no es prueba de calidad visual, responsiva, de interacción o de accesibilidad.
- Separa la implementación de la evaluación. Utiliza los criterios de aceptación y la evidencia real del navegador para criticar el resultado; no trates los elogios del generador como una revisión.
Escalar según el tamaño de la tarea
- Cambio pequeño (un componente, error, ajuste de copia o estilo): haz solo los pasos 1, 5, 8 y 10 para el área afectada, omite la comparación de dirección y un contrato de diseño completo, y expresa la verificación de aceptación en una o dos líneas.
- Mediano (una página o flujo): contrato completo en forma breve, una dirección elegida con una justificación corta y todos los pasos de verificación.
- Grande (nuevo sitio o sistema de diseño): ejecuta el flujo de trabajo completo a continuación.
- Responde en el idioma del usuario.
Flujo de trabajo integral
- Inspeccionar y definir alcance. Identifica el modo, rutas/componentes afectados, stack y convenciones existentes, referencias, contenido/datos, métodos de entrada compatibles, restricciones y herramientas de validación disponibles. Para trabajo de revisión, fija la línea base y lee el diff completo relevante, incluidas las eliminaciones.
- Escribir un contrato de diseño. Registra la audiencia, tarea principal, objetivo de conversión/CTA principal, personalidad de la marca, evidencia de confianza, contenido requerido, restricciones, criterios de éxito, viewports compatibles y objetivo de accesibilidad. Consulta contrato y captación.
- Establecer dirección de arte y orden del contenido. Para trabajo nuevo, compara dos o tres direcciones genuinamente distintas, elige una y registra la razón. Define la narrativa de la página y el wireframe basado en contenido antes de los componentes detallados. Consulta dirección de arte y contenido.
- Definir el sistema útil más pequeño. Reutiliza tokens/componentes existentes cuando sea posible. De lo contrario, establece tokens semánticos, escalas de tipografía y espaciado, contenedores, contratos de componentes y estados requeridos antes de multiplicar patrones. Consulta tokens y componentes.
- Construir el núcleo semántico. Implementa primero la tarea principal y el contenido real con enlaces, botones, encabezados, etiquetas de formulario y maquetación nativa. Mantén la interfaz comprensible en su estado estático/sin animación.
- Añadir comportamiento responsivo. Comienza con la maquetación estrecha; usa las necesidades de contenido/contenedor para elegir puntos de reflujo. Prueba anchos intermedios y contenido realista, no solo dispositivos con nombre. Consulta responsividad y resiliencia del contenido.
- Añadir interacciones y animación deliberadamente. Trata los controles como máquinas de estados. Usa CSS para transiciones de estado simples; introduce una biblioteca de línea de tiempo solo para secuenciación genuina o complejidad vinculada al desplazamiento. Respeta teclado, táctil, movimiento reducido y fallbacks ante fallos. Consulta animación e interacción.
- Compilar y verificar en tiempo de ejecución. Ejecuta las comprobaciones de tipo, lint, prueba y compilación de producción del proyecto existente. Inspecciona errores de consola/red, comportamiento de carga y recuperación, estado de URL, activos y estabilidad de maquetación. Consulta compilación y verificación runtime.
- Realizar una verificación de accesibilidad. Apunta a WCAG 2.2 AA a menos que la tarea especifique un estándar más estricto. Combina comprobaciones automatizadas con verificaciones de teclado, zoom/reflujo, contraste y tecnología de asistencia apropiadas para la experiencia. Consulta accesibilidad.
- **Revisar visualmente y regresiones.**Corrige viewport, navegador, fuentes, contenido, locale, DPR, posición de desplazamiento y estado de animación antes de comparar capturas de pantalla. Clasifica los hallazgos como introducidos, regresión o preexistentes; prioriza por impacto en el usuario. Consulta QA visual y publicación.
- Cerrar el ciclo. Aplica correcciones de alta prioridad, vuelve a ejecutar las comprobaciones afectadas e informa qué cambió, qué se verificó y los estados no verificados importantes. No reclames cobertura que no fue probada.
Reglas de decisión
- Mantén el framework existente y las convenciones de diseño a menos que bloqueen un requisito; si lo hacen, realiza el cambio aislado más pequeño.
- Usa dirección de arte para crear identidad y tokens/componentes para mantener las decisiones recurrentes coherentes. No conviertas cada diferencia de maquetación única en una variante del sistema de diseño.
- Prefiere maquetación fluida, dimensionamiento intrínseco, Grid/Flex y reglas conscientes del contenedor. Usa medición con JavaScript solo cuando la maquetación nativa del navegador no pueda satisfacer una necesidad demostrada.
- Prefiere CSS para cambios de estado visual simples. Usa GSAP u otra herramienta de línea de tiempo solo cuando la secuenciación, el progreso de desplazamiento, el anclaje o las líneas de tiempo coordinadas justifiquen la dependencia.
- Preserva el desplazamiento nativo del documento por defecto. Usa anclaje/snap solo por una razón narrativa o de tarea clara, con fallbacks para móvil, teclado, movimiento reducido y sin script.
- Elige un comportamiento accesible sobre una especificación visual conflictiva. Documenta la desviación y mantén la intención del diseño cuando sea posible.
- Usa evidencia real para el contenido del producto. Usa marcadores de posición claramente etiquetados cuando los hechos no estén disponibles; nunca inventes pruebas sociales ni precios.
- Para una solicitud de solo revisión, devuelve hallazgos priorizados en lugar de corregirlos en silencio. Mantén los defectos preexistentes separados de los defectos introducidos por el cambio solicitado.
Definición de terminado
No des el trabajo por completo hasta que todas las compuertas aplicables hayan pasado o los vacíos restantes sean explícitos. Si una compuerta no puede ejecutarse (sin navegador, sin herramientas de compilación), menciónala como no verificada en lugar de bloquear o afirmar que pasó:
- Intención: la audiencia, la tarea principal, la jerarquía de contenido, la CTA principal única y la dirección visual son claras.
- Identidad y artesanía: el resultado tiene al menos dos decisiones de identidad deliberadas más allá de un valor predeterminado de biblioteca de componentes; la tipografía, el espaciado, el color, las imágenes, los iconos y los estados son coherentes.
- Responsivo: se han comprobado teléfono estrecho, tableta, escritorio, ultra ancho y un ancho intermedio; no hay desbordamiento, recorte, superposición o orden roto no intencionado.
- Funcionalidad: los flujos principales funcionan con controles reales; se manejan los estados de carga, vacío, error, deshabilitado y recuperación cuando corresponda.
- Accesibilidad: se han revisado nombres/roles semánticos, ruta de teclado, foco visible no obstruido, contraste, zoom/reflujo y movimiento reducido; las herramientas automatizadas no son la única evidencia.
- Ingeniería: las comprobaciones/compilaciones existentes pasan; no hay nuevos errores de consola, hidratación o red; se abordan los cambios de maquetación evidentes y la vibración de animación evitable.
- Evidencia: las comparaciones visuales utilizan condiciones fijas; cada hallazgo significativo tiene una reproducción y condición de aceptación; las áreas no probadas se nombran.
Cargar referencias según sea necesario
Lee solo las referencias relevantes para la tarea actual; cada una está directamente enlazada aquí para mantener el flujo de trabajo principal ágil.
- 01 — Contrato y captación: requisitos, reconocimiento del repositorio, alcance y criterios de aceptación.
- 02 — Dirección de arte y contenido: dirección distintiva, indicaciones, narrativa de aterrizaje/precios y reglas de contenido.
- 03 — Tokens y componentes: tokens de diseño, tipografía, componentes, temas y contratos de estado.
- 04 — Responsividad y resiliencia del contenido: maquetación mobile-first, puntos de interrupción, contenido real y matriz de viewports.
- 05 — Animación e interacción: CSS vs herramientas de línea de tiempo, animación de desplazamiento, rendimiento y fallbacks.
- 06 — Accesibilidad: implementación de WCAG 2.2 AA y revisión manual.
- 07 — Compilación y verificación runtime: compilación, navegador, interacción, rendimiento y pruebas de fallos.
- 08 — QA visual y publicación: comparación de capturas de pantalla, hallazgos de revisión, priorización y compuertas de publicación.
- 09 — Mapa de fuentes: familias de fuentes incorporadas y referencias primarias seleccionadas para una búsqueda más profunda.