Prototipo primero
Soy diseñador. Juzgo el trabajo mirándolo y haciendo clic a través de él, no leyendo un plan. Un prototipo cuesta minutos. Construir lo incorrecto cuesta un montón de PRs y un día de revisión.
Este skill hace una cosa: obtiene una elección de diseño de mi parte antes de que se escriba código. Nunca abre un PR para un prototipo, nunca envía un prototipo como producto, y nunca construye una dirección que no haya elegido.
Reglas estrictas
- Nunca abras un PR para un prototipo, ni siquiera un borrador. Los PRs son para código destinado a llegar a
main. Un PR de prototipo añade ruido de revisión y CI para algo que se descartará. - Detente después de cada ronda. Envía las variantes en el formato a continuación, luego espera mi respuesta. No empieces a construir "la opción más probable" mientras yo miro. Si elijo otra cosa, ese trabajo es desperdicio y además tengo que revisarlo.
- El prototipo elegido es la especificación. La construcción debe verse como él. Las retroalimentaciones posteriores solo cambian lo que yo nombre. Comparo la construcción con la imagen que elegí, por lo que cualquier desviación se lee como un error, no como una mejora.
- Las etiquetas de prototipo se quedan en los archivos de prototipo. "B2", "dirección A" y apodos de variantes nunca aparecen en código, tokens, commits, PRs o issues. Solo significaron algo durante la elección. En el repositorio son ruido que alguien tiene que decodificar más tarde.
- Mira las referencias como imágenes. Cuando nombre sitios o aplicaciones de referencia, mira capturas de pantalla de ellos. Una búsqueda solo de texto pierde todas las cualidades visuales que hicieron buena la referencia, y el resultado se lee como genérico.
¿Debería ser esto un prototipo?
¿El cambio tiene una respuesta obvia (un valor de espaciado, una etiqueta, un token de color)?
├── Sí → Constrúyelo y di qué cambió. Omitir el prototipo es un buen resultado.
└── No
├── ¿Nueva pantalla, nuevo flujo, rediseño o 2+ respuestas razonables?
│ └── Sí → Prototipo.
│ ├── ¿Necesita datos reales, navegación real o comportamiento nativo?
│ │ └── Sí → Rama desechable `proto/<tema>` desde main
│ └── No → Archivo HTML independiente, compartido en el chat o hilo del issue
└── No estoy seguro → Pregunta en una línea: "¿prototipo esto o solo lo construyo?"
Nunca escondas un prototipo dentro del producto detrás de una ruta /lab o un flag de desarrollo.
Flujo de trabajo
Fase 1: Referencias y preguntas
- Recopila capturas de pantalla de cada referencia que nombré. Recorta páginas largas en secciones.
- Escribe observaciones concretas para cada una: el tipo, el tratamiento del encabezado, cómo se muestra el producto, cómo está estructurado el diseño y el momento que destaca. Di por qué funciona cada una.
- Cuestiona la solicitud. Si lo que pedí es UX débil, dilo y explica por qué. Piensa desde el lado del usuario final, no desde la solución literal que describí.
- Hazme algunas preguntas cortas y numeradas sobre lo que no puedas inferir, como el tipo, la densidad, el tono y qué conservar de la versión actual.
Hecho cuando: cada referencia tiene observaciones escritas, y he respondido tus preguntas o no tenías ninguna.
Fase 2: Construir las variantes
- Muestra de 2 a 4 variantes, etiquetadas A, B, C y D. Una variante no te enseña nada sobre mi gusto. Más de cuatro es ruido.
- Al menos una variante es tu propia idea mejorada si te opusiste en la Fase 1. Ponla junto a la que pedí.
- Maqueta en contexto. Muestra la ventana o sección completa, no un componente flotando en una página en blanco.
- Usa el diseño real. Usa los tokens, tipo y componentes actuales de la aplicación. Muestra claro y oscuro si la aplicación tiene ambos.
- Usa datos realistas. Nombres, números y longitudes de texto que parezcan reales. Nunca lorem ipsum, y nunca datos de personas o lugares reales.
- Haz los flujos cliqueables. Para cualquier cosa con pasos o estados, construye un archivo HTML con un selector de escenario, un interruptor claro/oscuro, interacciones funcionales y una nota en lenguaje sencillo sobre lo que significa cada estado.
- Iguala el pulido a la pregunta. Para una dirección visual, debe verse como el producto terminado, porque la apariencia es lo que estoy juzgando. Para un flujo, debe verse como la aplicación y funcionar, y el pulido de bordes puede esperar, porque estoy juzgando si me pierdo.
Hecho cuando: cada variante está maquetada en contexto con tokens reales y datos realistas, y cada flujo es cliqueable.
Fase 3: Enviar la ronda y detenerse
Envía la ronda en el formato bajo "Formato de salida requerido". Luego detente.
Hecho cuando: la ronda está enviada. No pasa nada más hasta que responda.
Fase 4: Leer mi elección
| Yo digo | Significa | Tú haces |
|---|---|---|
| "C" | Construir C como se muestra | Ir a Fase 5 |
| "D, pero 1.5px no 3px" | D con exactamente ese cambio | Cambiar solo eso, luego Fase 5 |
| "Los botones de A, la barra de búsqueda de C" | Una mezcla | Tomar cada parte nombrada de la variante de la que la nombré. La parte que digo que me gusta más domina. No te desvíes hacia la variante que fue más fácil de construir. |
| "Me gusta B pero quiero probarlo" | Una elección provisional | Construir B, y mantener el segundo lugar hasta que haya probado B en la aplicación real o en el dispositivo |
| Retroalimentación sobre una variante | Iterar | Mostrar la siguiente ronda solo de esa variante, de vuelta a Fase 3 |
| "No entiendo este prototipo" | Dejar de prototipar | Construir la cosa real en un PR |
| "ninguna de estas" | No captaste mi intención | Volver a las referencias y mis palabras. No hagas una cuarta versión de la misma idea. |
Pregunta por qué cuando no lo digo. Si eliges sin dar una razón, haz una pregunta corta: "¿qué hizo ganar a B?" Registra mi respuesta junto con la decisión. Una elección sin su razón no le enseña nada al próximo agente sobre mi gusto.
Hecho cuando: sabes qué variante, o qué mezcla de partes, construir, y por qué.
Fase 5: Construir a partir de la elección
- Informa a quien lo construya con el enlace del prototipo y los valores exactos: colores, tamaños, espaciado y tipo. Nadie lo reconstruye de memoria.
- Describe el diseño por lo que es ("tabla densa, píldoras de estado, carril izquierdo"), nunca por su etiqueta.
- Aplica retroalimentación general posterior ("demasiado ocupado", "sin jerarquía") solo donde señalé. No es permiso para eliminar cosas que me gustaron en el prototipo. Antes de eliminar o cambiar un elemento del prototipo, nómbralo y pregunta.
Hecho cuando: la construcción coincide con la elección, y ninguna etiqueta de prototipo aparece en el código, commits, PR o issues.
Formato de salida requerido
Cada ronda se ve así:
**Dónde verlo:** <enlace o adjunto>, o `git checkout proto/<tema> && <comando de ejecución>`
| Variante | Apuesta por | Compensación |
| --- | --- | --- |
| A | <una línea: la idea que esta variante prueba> | <lo que sacrifica> |
| B | ... | ... |
**En lo que me opuse:** <una o dos líneas, o "nada">
Responde con una letra, una mezcla (`x de A, y de C`), o `ninguna`.
Mantenlo así. El prototipo hace la explicación.
Variantes de invocación
| Invocación | Comportamiento |
|---|---|
/prototype-first | Flujo completo desde la Fase 1, se detiene después de la Fase 3 |
/prototype-first <variante> | Iterar sobre una variante de la última ronda, de vuelta a Fase 3 |
/prototype-first compare | Un prototipo con un interruptor AHORA / PROPUESTO contra la UI actual |