Web Design Playbook
Flujo de trabajo de implementación de diseño para reproducir la calidad con un método estructurado. El núcleo es la iteración con el siguiente «archivo de acumulación»: absorber buen diseño y escribir de vuelta las lecciones aprendidas, para que, cuanto más se use, más se convierta en un método personalizado para ese usuario.
Archivo de acumulación (el centro de esta skill)
Registro maestro de las preferencias de diseño y sitios de referencia de cada usuario. La ubicación es ~/.claude/design-taste.md. Si no existe, se crea con esta plantilla la primera vez:
# Design Taste — Acumulación de diseño personal
## Principios probados
<!-- Agregar una línea por cada «patrón que funciona / no funciona» basado en reacciones al diseño creado -->
## Colección de sitios de referencia
<!-- Agregar sitios que te gusten, con una breve explicación de qué los hace buenos -->
| Sitio | URL | Qué lo hace bueno |
|---|---|---|
Cuándo añadir (absorber)
- Cuando el usuario comparta una URL diciendo «me gusta este sitio», «úsa esto como referencia» o «algo así», visitar el sitio inmediatamente y añadir una línea a la colección de referencia explicando qué lo hace bueno (diseño general, paleta de colores, tipografía, animaciones, arquitectura de información).
- Cuando la reacción del usuario a un diseño muestre claramente «este patrón funciona / este no funciona», añadir una línea a los principios probados.
Cuándo leer (usar)
- Leerlo siempre antes de empezar cualquier implementación de diseño (paso 1 del flujo de trabajo). Sirve como criterio para la dirección visual, paleta de colores y animaciones.
Flujo de trabajo
1. Cargar la capa de referencia (obligatorio antes de implementar)
Leer en este orden de prioridad:
DESIGN.mden la raíz del proyecto — registro maestro específico del proyecto. Máxima prioridad.- Archivo de acumulación
~/.claude/design-taste.md— preferencias probadas del usuario. - «Principios de diseño (valores iniciales)» más abajo — valores por defecto si los dos anteriores no aplican.
2. Definir la dirección
- Si el tono no está definido, presentar primero un borrador de una pantalla (hero + sección representativa) para acordar la dirección. Cambiar de dirección después de haber creado todas las páginas es lo más costoso.
- Una vez definida la dirección, fijarla en el proyecto usando el formato DESIGN.md (tokens YAML + prosa de intención). Así, cualquier implementador futuro (persona o IA) podrá leerlo y mantener el tono consistente.
3. Implementación
- Antes de crear componentes decorativos desde cero (botones, encabezados, tarjetas, cargadores, patrones de fondo, etc.), verificar si existen componentes prefabricados en Web Bento.
- Páginas individuales:
https://amix-design.com/tl/web-bento/parts/<slug>.htmlslug = gradient / heading / button / card / text-effect / divider / hover / glass-shadow / badge / loading / form / background-pattern / speech-bubble / list / alert / table - Al reutilizar, adaptarlos a los colores, bordes redondeados y tipografía del proyecto (uso comercial permitido, sin crédito requerido. Solo está prohibida la redistribución como colección de componentes, por lo que no se deben incluir en el repositorio).
- Páginas individuales:
- Considerar animaciones desde implementaciones ligeras: CSS / Framer Motion → Rive / Lottie → Three.js. Respetar siempre
prefers-reduced-motion.
4. Verificación en dispositivo real (obligatorio antes del despliegue)
- Tomar capturas de pantalla en el navegador con al menos 3 anchos: 390 / 880 / 1280px (usando Chrome DevTools MCP o similar). Que la compilación pase y que el diseño se vea bien son dos cosas distintas.
- Revisión de japonés: comprobar que no haya saltos de línea incorrectos en encabezados (partículas aisladas al inicio de línea, palabras partidas), elementos recortados, o información que solo sea visible al hacer hover.
- Manejo de saltos de línea en japonés: dividir en bloques
nowrappor unidades de significado, usarword-break: auto-phrase, y envolver palabras que no deben separarse en spans connowrap.
5. Retroalimentación de aprendizajes
- Cuando la reacción del usuario muestre «este patrón funciona / este no funciona», añadir inmediatamente una línea a los «Principios probados» del archivo de acumulación.
- Repitiendo esto, el criterio de diseño pasará de ser «opiniones generales» a «preferencias probadas de este usuario». Ese es el verdadero valor de este playbook.
Principios de diseño (valores iniciales)
Valores por defecto hasta que el archivo de acumulación tenga suficientes principios probados. Son solo iniciales; si no funcionan, se pueden cambiar:
- Base blanca + un color de acento + tipografía grande + motivo concreto del tema. Los diseños multicolor u oscuros con dorado (lujo) suelen verse demasiado genéricos y como salidos de una IA.
- Animaciones lúdicas que respondan a la interacción + sentido de evento, pero sin sacrificar la legibilidad de la información.
- La emoción se comunica a través de la metáfora del tema (ejemplo: sitio de torneo de fútbol → portada de periódico; evento de proyección → festival cultural). No conformarse con la combinación genérica de gradiente + tarjeta de cristal.
Guía de personalización (cambia esto según tus necesidades)
| Aspecto | Cómo personalizarlo |
|---|---|
| Principios de diseño (valores iniciales) | Una vez que tengas suficientes principios probados, el archivo de acumulación es la referencia principal. Elimina esta sección o reescríbela con tus propios principios. |
| Ubicación del archivo de acumulación | Si trabajas en equipo, colócalo dentro del repositorio (ej. design/taste.md) y actualiza la ruta en el texto. |
| Anchos de verificación (390/880/1280px) | Ajústalos a los breakpoints reales de tu proyecto. |
| Revisión de japonés | Si el sitio es multilingüe, cambia a la revisión tipográfica del idioma correspondiente (guiones, etc.). |
| Fuentes de inspiración | Si tienes diseñadores o escuelas que prefieras, añade sus referencias al paso 1 del flujo de trabajo. |
Prohibiciones
- No crear IPs, personajes o productos ficticios con generación de imágenes de IA (esto es especialmente problemático en contextos que tratan con IPs reales). La decoración debe limitarse a geometría abstracta, tipografía, colores de marca, activos oficiales y fotografías reales.
- No incluir en el repositorio colecciones de materiales o contenido de terceros que no permitan redistribución (enlázalos en su lugar).
Recomendaciones de uso conjunto (opcional)
- Taste Skill — control de calidad contra slop:
npx skills add Leonxlnx/taste-skill -g -s design-taste-frontend(+high-end-visual-design/redesign-existing-projects) - Validación de DESIGN.md:
npx @google/design.md lint