Configuración de diseño
Resumen
Antes de la primera pantalla, acuerda qué es el producto, para quién es, cómo debe sentirse y cómo nunca debe verse. Escríbelo en DESIGN.md, el resumen que toda decisión de diseño posterior leerá primero. Pregunta, no inventes: una marca creada por el agente es una suposición que la persona tendrá que deshacer. Lee lo que existe, entrevista a la persona una pregunta a la vez, escribe el resumen, detente para aprobación y luego construye los fundamentos.
Cuándo usarlo
- Una tarea de diseño y no hay
DESIGN.mden la raíz del proyecto. - "Configurar el diseño", "definir nuestro estilo / marca / guías",
/craft-setup(/craft:craft-setupen el plugin de Claude Code).
Cuándo NO usarlo
DESIGN.mdexiste y la tarea es de diseño: usacraft.- Cambiar un token o una guía: usa
craft-system.
Pasos
- Lee primero. README, docs, CSS existente o tokens, el archivo de diseño, carpetas de marca, cualquier borrador antiguo de
DESIGN.md. Anota lo que ya responden. Si el código ya tiene un sistema de diseño (un paquete UI, archivos de tokens, una biblioteca de componentes), dímelo con conteos y escribe "Fuente del sistema de diseño:<ruta>" en la sección Marca del resumen. En el paso 6, ofrece importarlo al tool de diseño en lugar de crear fundamentos; las preguntas de marca que responda se saltan. Dos paquetes UI → pregunta cuál es la fuente antes de saltar cualquier pregunta de marca. Nunca preguntes algo que estos archivos respondan. Confírmalo en una línea ("Tu README dice solo pt-BR y miembros mayores de 60, así que diseñaré para texto de 18px y toques de 48px"). - Entrevista, una pregunta por mensaje. Sigue la entrevista en su orden: producto, audiencia y voz, estado de ánimo, marca, referencias, restricciones.
- Ofrece 3–5 opciones más "algo más" siempre que puedas.
- Salta cualquier pregunta ya respondida.
- Detente cuando las respuestas sean suficientes para diseñar la primera pantalla. Seis buenas respuestas superan a quince.
- Las referencias son obligatorias. Pide de 2 a 5 productos, sitios o imágenes que les gusten. Para cada uno, pregunta qué tomar y qué evitar. Si es un enlace o imagen que puedas abrir, míralo y di lo que ves antes de preguntar.
- Escribe
DESIGN.mden la raíz del proyecto usando la plantilla, con las ocho secciones: Producto, Audiencia y voz, Estado de ánimo, Marca, Referencias, Restricciones, Registro de decisiones, Preguntas abiertas.- Usa sus palabras cuando puedas.
- Todo lo que hayas inferido y no hayan confirmado va a Preguntas abiertas, no al resumen como hecho.
- Detente y muestra a la persona
DESIGN.md. Cámbialo hasta que lo aprueben. - Fundamentos.
- Sistema de diseño ya en código: ofrece la importación. En caso afirmativo, SUB-SKILL OBLIGATORIO:
craft-sync(importar). Muestra un inventario y pregunta qué componentes dibujar. En caso negativo, registra " — Importación a rechazada" en el registro de decisiones. Ofrécelo incluso después de "saltar": se trata del tool de diseño, no del resumen. - Sin sistema en código: SUB-SKILL OBLIGATORIO:
craft-systemen modo creación para los fundamentos (tokens, tipografía, espaciado, reglas de interacción). Tiene su propia parada de aprobación. - Los tokens y estilos existentes son el punto de partida: extiéndelos, no los renombres ni los muevas sin preguntar.
- Sistema de diseño ya en código: ofrece la importación. En caso afirmativo, SUB-SKILL OBLIGATORIO:
Si la persona dice "saltar" o "solo diseñalo"
No sigas preguntando. Escribe un DESIGN.md mínimo a partir de lo que leíste y lo que dijeron:
- cada vacío se convierte en una Pregunta abierta;
- cada suposición se marca como "(asumido)".
Di en una línea qué suposiciones importan más. "Saltar" omite la entrevista y la parada de aprobación del resumen, nunca el paso 6:
- sistema de diseño en código → aún así haz la pregunta de importación única ("¿Importarlo a ahora? Te mostraré lo que hay y tú eliges los componentes"), luego continúa;
- aún sin tokens → el paso de fundamentos y su parada aún se ejecutan, porque
craftsolo puede dibujar con piezas del sistema.
Luego continúa con la tarea que pidieron.
Antes de empezar
- Si ningún adaptador en
references/adapters/coincide con tu herramienta, haz los mismos verbos en tu herramienta y di cuáles mapeaste manualmente. Sin tool de diseño, construye en HTML (html.md). Si solo tienes una imagen, di que los valores leídos de ella son estimaciones. DESIGN.mdes un archivo Markdown simple en el repositorio en cualquier tool. Solo el tablero de referencias opcional vive en el tool de diseño.
Reglas
| Regla | Por qué |
|---|---|
| Una pregunta por mensaje, con opciones | Un muro de preguntas se hojea y se responde a medias |
| Lee antes de preguntar; nunca preguntes lo que dicen los archivos | Preguntar qué hay en el README les dice que no miraste |
| No inventes marca: los colores, fuentes y estado de ánimo vienen de ellos o se marcan como "(asumido)" | Una marca inventada es una suposición que tienen que deshacer pantalla por pantalla |
| Las referencias siempre vienen con tomar/evitar | "Me gusta Stripe" no sirve; "tomar el espaciado calmado, evitar los degradados" es una regla |
| "Nunca como..." se pregunta explícitamente | Lo que evitar acota el diseño más rápido que lo que buscar |
| No rediseñes archivos existentes durante la configuración | La configuración registra decisiones; cambiar su CSS es una tarea de diseño que aún no pidieron |
| Sin pantallas durante la configuración | Las pantallas vienen de craft, después de que el resumen y los fundamentos estén aprobados |
Hecho cuando
DESIGN.md está aprobado con sus ocho secciones, y los fundamentos están resueltos: creados y aprobados a través de craft-system, o (con un sistema en código) importados a través de craft-sync o la importación rechazada y registrada. Después de un "saltar": DESIGN.md está escrito con sus suposiciones marcadas, los fundamentos existen (aprobados, o ya en el proyecto), y la tarea original ha continuado.
Errores comunes
| Pensamiento | Realidad |
|---|---|
| "Elegiré una bonita paleta y fuentes, pueden cambiarlo" | No pueden cambiar lo que no sabían que se decidió. Pregunta, o márcalo como "(asumido)". |
| "Ya que estoy aquí, haré maquetas de las pantallas principales" | Eso es trabajo de craft, después de la aprobación. La configuración termina en el resumen y los fundamentos. |
| "Déjame preguntar las seis preguntas a la vez para ahorrar tiempo" | Una por mensaje, con opciones. Es más rápido para ellos responder. |
| "Sus tokens son un desastre, los reestructuraré" | Extiéndelos. Reestructurar es un cambio separado y aprobado. |
| "No dieron referencias, omitiré esa sección" | Pídelas. Si no tienen, ofrece tres que encajen con el estado de ánimo y pregunta qué tomar y evitar de cada una. |