¿Qué hace craft?
Resumen
La puerta de entrada para crear cualquier elemento visual. Convierte "diseña la página de precios" en un diseño terminado y revisado. Trabaja a partir del brief del proyecto, cubre todos los estados, ofrece opciones solo cuando la dirección está abierta, utiliza únicamente las piezas del sistema de diseño y verifica su propio trabajo antes de mostrarlo. Invoca a las demás habilidades de diseño en puntos fijos; no las reemplaza.
Cuándo usarlo
- "Diseñar / crear / maquetar / rediseñar <página, pantalla, flujo, elemento>",
/craft(/craft:craften el plugin de Claude Code). - Varias páginas a la vez ("diseña la incorporación: bienvenida, registro, verificación").
Cuándo NO usarlo
- Una pequeña edición que la persona describió exactamente (un valor, una etiqueta, un tamaño): hazlo directamente.
- Solo una revisión ("¿qué tiene de malo esto?"):
craft-critique. Solo opciones:craft-explore.
Antes de empezar
- Si no hay un adaptador en
references/adapters/que coincida con tu herramienta, realiza las mismas acciones en tu herramienta e indica cuáles mapeaste manualmente. Sin ninguna herramienta de diseño, crea en HTML (html.md). Si solo tienes una imagen, indica que los valores leídos de ella son estimaciones.
Las paradas son reales
Una parada significa: termina tu turno con la pregunta y espera. Siempre puedes hacerlo, incluso en una sesión de un solo mensaje o sin cabeza, donde tu mensaje final es la pregunta. Nunca decidas una parada por la persona porque la sesión "no puede esperar" o "para ahorrar un viaje de ida y vuelta". Decidirla tú mismo convierte una respuesta de cinco segundos en horas de rehacer.
Pasos
- Contexto.
- Lee
DESIGN.mden la raíz del proyecto. Si falta, o no tiene sección de Producto (un registro solo de sincronización) → SUB-HABILIDAD REQUERIDA:craft-setup, luego vuelve aquí. - Lee el sistema de diseño (tokens, componentes, guía) y las pantallas relacionadas con esta.
- Cuando el brief y el código discrepen (el brief dice verde azulado, los tokens dicen azul): sigue el código, indícalo en una línea, añade el conflicto a
DESIGN.md› Preguntas abiertas, y ofrece actualizar lo que sea incorrecto. Nunca sobrescribas tokens dentro del CSS de una página. - Cuando la guía de la herramienta de diseño y el código difieran y exista un
design-sync.json, no consideres la guía como desactualizada. Clasifícalo con él: código cambiado → ofrece actualizar la guía antes de dibujar; guía cambiada → es un cambio de la persona que espera una exportación, así que dibuja con él y menciona la exportación pendiente.
- Lee
- Alcance en palabras. Enumera cada página o elemento a crear, cada uno con su función y su siguiente acción.
- Las palabras ambiguas reciben una interpretación claramente expresada ("página de precios = la lista de precios de la panadería, no los planes de suscripción").
- Pausa y confirma la lista cuando haya más de un elemento o la solicitud sea vaga. Un elemento claro: continúa.
- Para cada elemento, en orden:
- SUB-HABILIDAD REQUERIDA:
craft-states. Su lista de estados escrita y su pausa son lo primero. - ¿Dirección abierta? Solo cuando la persona pidió ideas, o cuando dos estructuras de diseño diferentes sean plausibles y ni el brief ni el sistema elijan entre ellas → SUB-HABILIDAD REQUERIDA:
craft-exploreantes de dibujar los estados. Para varias páginas, pregunta en la pausa del alcance qué página (si alguna) recibe opciones; nunca ejecutes una ronda de opciones por página por defecto. Luego, los estados se dibujan en la dirección elegida. Una pantalla que sigue un patrón existente va directamente al dibujo. - Dibuja el estado principal, luego los otros estados, usando solo las piezas y tokens del sistema. Algo nuevo (un componente, un color, un tamaño que la escala no tiene) → SUB-HABILIDAD REQUERIDA:
craft-system(modo añadir) antes de usarlo. Un componente que existe en código pero no está dibujado en la herramienta ("solo en código" en el índice) → SUB-HABILIDAD REQUERIDA:craft-sync(importación de un componente), dibujando solo ese componente primero. Si la persona rechazó la importación (verDESIGN.md), pregunta una vez antes de importar; si aún dicen que no, construye a partir de los valores del código en el propio tablero y anótalo. Nunca dibujes un imitación, y nunca codifiques un nuevo valor en una página. - SUB-HABILIDAD REQUERIDA:
craft-critiqueen modo autoverificación en cada tablero: renderiza, corrige lo que encuentre dentro del alcance de esta tarea, y renderiza de nuevo.
- SUB-HABILIDAD REQUERIDA:
- Cerrar.
- Muestra el resultado con el resumen a continuación.
- Añade las decisiones a
DESIGN.md› Registro de decisiones (fecha, decisión, por qué). - Mueve cualquier pregunta que haya sido respondida fuera de Preguntas abiertas.
Resumen de cierre (la forma de tu mensaje final)
Hecho: <páginas/elementos> — <dónde: archivos o tableros>
Decisiones: <cada una, una línea con su por qué> (también en DESIGN.md › Registro de decisiones)
Cambios del sistema: <piezas o tokens añadidos/cambiados> — afecta a: <pantallas>
Autoverificación corregida: <lo que craft-critique cambió antes de que lo vieras>
Preguntas abiertas: <lo que la persona aún tiene que decidir>
Reglas
| Regla | Por qué |
|---|---|
DESIGN.md primero, siempre | Sin el brief, cada pantalla inventa su propio estilo |
| Alcance confirmado antes del trabajo cuando hay más de un elemento | Tres páginas construidas sobre una lectura incorrecta son tres páginas desperdiciadas |
Lista de estados antes de dibujar (mediante craft-states) | El camino feliz es uno de muchos estados |
| Opciones solo cuando la dirección está abierta | Opciones sobre un patrón resuelto desperdician la atención de la persona |
Solo piezas y tokens del sistema; los nuevos pasan por craft-system | Los valores codificados en páginas son donde comienza la deriva |
| El código prevalece sobre un brief desactualizado; anótalo, no lo sobrescribas | Los tokens son lo que se envía; el brief se actualiza por decisión, no en silencio |
| Autoverificación antes de mostrar | La persona debe revisar el diseño, no atrapar errores |
Las decisiones van a DESIGN.md | La próxima sesión de diseño comienza desde ellas, no de la memoria |
Hecho cuando
Cada elemento del alcance confirmado tiene sus estados dibujados y autoverificados, cualquier cambio del sistema ha pasado por craft-system, se ha dado el resumen de cierre y se ha actualizado el registro de decisiones de DESIGN.md.
Errores comunes
| Pensamiento | Realidad |
|---|---|
| "Tres páginas son suficientemente claras, solo las construiré" | Confirma la lista primero. Cuesta un mensaje. |
| "Haré botones de 52px aquí; el token dice 44, pero este público necesita más grande" | Esa es una decisión del sistema. Propónlo mediante craft-system, luego úsalo en todas partes. |
| "El brief dice verde azulado, así que sobrescribiré el azul en el CSS de esta página" | El código gana. Marca el conflicto y pregunta; nunca parchees tokens localmente. |
| "Lo mostraré, ellos me dirán qué está mal" | Ejecuta craft-critique en modo autoverificación primero, y di lo que corrigió. |
| "Las decisiones están en mi mensaje, eso es suficiente" | Los mensajes se pierden. Añádelas a DESIGN.md. |
| "Esta sesión no puede detenerse por respuestas, así que tomaré las decisiones yo mismo y las enumeraré" | Terminar tu turno con la pregunta es detenerse. Haz eso; no construyas nada más allá de la primera pausa abierta. |
| "Para ahorrar un viaje de ida y vuelta pondré ambas pausas en un solo mensaje" | Está bien, si luego te detienes. Pregunta ambas, no construyas nada, espera. |