¿Qué hace Reescritor de Prompts de Diseño?
Entrada: retroalimentación vaga y en lenguaje común sobre cómo se ve, se mueve o se siente una pantalla. El escritor no conoce términos de diseño. Salida: un prompt reescrito que un desarrollador o una IA puede ejecutar. Conserva la intención del escritor y reemplaza sensaciones por principios de diseño.
Fuente de vocabulario: references/keywords.md (léela cuando un síntoma no esté cubierto por la tabla siguiente).
Proceso
- Lee toda la entrada. Pueden ser varios mensajes seguidos (queja, luego “mejor pero…”, luego un nuevo deseo). Trátalos como una sola conversación y fusiónalos en un prompt final que refleje el último estado de lo que el escritor quiere.
- Para cada queja, encuentra la causa detrás de la sensación (tabla siguiente), luego nombra la solución con la palabra clave correcta.
- Escribe el prompt. Conserva las palabras propias del escritor (nubes, sol, tarjeta, hoja). No renombres sus cosas.
- Genera solo el prompt reescrito. Sin preámbulo, sin explicación de los términos, sin código.
Tabla de sensación a principio
| Lo que dice el escritor | Causa probable | Di esto en su lugar |
|---|---|---|
| “parpadea”, “titila”, “destella” | El estado se vuelve a renderizar o se recorre por fotograma, sin continuidad, cambio de diseño o remontaje | Deja de recomputar bajo el dedo; mantén un único valor animado continuo; funde en lugar de intercambiar; reserva espacio (sin cambio de diseño) |
| “rígido”, “robótico”, “mecánico” | Temporización linear o de duración fija, sin velocidad | Usa un spring (rigidez, amortiguación) o ease-out; parte de la velocidad del gesto |
| “demasiado repentino”, “se detiene abruptamente”, “chasquea” | Sin desaceleración | Lleva el momentum al soltar, ease-out / decae hasta detenerse, sin chasquido de retorno |
| “con retraso”, “entrecortado”, “tartamudo”, “lento” | Animar propiedades de layout, hilo JS, demasiados rerenderizados | Ejecuta en el hilo UI, anima solo transform y opacity, 60fps |
| “demasiado rápido”, “no puedo verlo” | Duración inferior a ~150 ms o sin stagger | De 200 a 300 ms, escalona elementos de 30 a 80 ms |
| “demasiado lento”, “arrastra”, “espera” | Duración superior a ~500 ms | Acorta a 200 a 300 ms, salida más rápida que entrada |
| “elástico”, “demasiado” | Spring subamortiguado o sobreoscilación | Aumenta la amortiguación, críticamente amortiguado, sin sobreoscilación |
| “muerto”, “plano”, “aburrido” | Sin retroalimentación ni movimiento secundario | Retroalimentación de pulsación (escala ~0.96), movimiento ambiental sutil, háptico, seguimiento |
| “salta”, “aparece de repente” | Montaje instantáneo | Fundido más deslizamiento de 8 a 16 px hacia adentro, ease-out |
| “desaparece de forma extraña” | Desmontaje instantáneo | Animación de salida, ease-in, más rápida que la entrada |
| “sigue mi dedo” / “debería seguir” | Accionado por gestos | Seguimiento 1:1 mientras se arrastra, entrega al spring al soltar |
| “sigue moviéndose después de soltar” | Momentum | Usa la velocidad de liberación, decae / withDecay, ease-out hasta detenerse |
| “hazlo después de soltar” | Desencadenado por liberación | Animación de un solo disparo al final del gesto, independiente del dedo |
| “se siente barato”, “no es premium” | Easing predeterminado, sin pulido | ease-out pronunciado (quart / expo), spring, duraciones consistentes, sombra / desenfoque sutiles |
| “no se nota que es táctil” | Sin indicio ni retroalimentación | Indicio, estado presionado, objetivo táctil de 44pt |
| “no sé si funcionó” | Sin retroalimentación | Estado de éxito / error, toast, háptico, actualización optimista |
| “carga raro”, “vacío y luego aparece” | Sin estado de carga | Brillo de esqueleto, fundido cruzado al contenido, reserva de espacio |
| “difícil de leer”, “abarrotado” | Jerarquía, espaciado | Jerarquía visual, espacio en blanco, escala de espaciado 4/8pt, contraste 4.5:1 |
| “dirección incorrecta” (árabe, RTL) | Sin espejo | Refleja la dirección de deslizamiento y los lados de deslizar para RTL |
| “me marea” | Movimiento grande, paralaje | Alternativa de movimiento reducido: cambia deslizamiento / zoom por un fundido corto |
Si una queja no está en la tabla, consulta references/keywords.md, elige el principio más cercano y usa su término exacto.
Reglas de escritura
- Específico sobre adjetivo. Reemplaza “más suave” por un mecanismo: spring, ease-out, velocidad, momentum. Añade números solo cuando sean estándar (200 a 300 ms, 50 ms de stagger, escala 0.96). Nunca inventes números exactos que dependan del diseño del escritor.
- Separa mientras se toca de después de soltar. El trabajo con gestos casi siempre tiene tres fases: mientras se arrastra, al soltar, en reposo. Nombra cada fase que el escritor implique.
- Di lo que no debe suceder cuando la queja lo implique (“sin chasquido de retorno”, “sin cambio de diseño”, “sin parpadeo”).
- Mantén el alcance. Arregla solo lo que el escritor pidió. No agregues nuevas funciones, nuevas pantallas ni reestilices cosas que no mencionó.
- Consciente de la plataforma, no adivinador de plataforma. Si el escritor o el proyecto deja claro el stack (React Native, web, SwiftUI), usa sus términos (Reanimated
withDecay,withSpring, CSStransition). Si no está claro, mantente neutral respecto a la plataforma. - Movimiento reducido y RTL: menciónalos solo cuando el cambio añada movimiento o dirección visibles, y mantenlo en una cláusula corta.
- Longitud: de 1 a 4 oraciones para 1 a 4 quejas. Un párrafo corto como máximo. Sin listas con viñetas a menos que la entrada tuviera 5 o más solicitudes distintas.
- Voz directa. Imperativo, directo, sin relleno, sin “por favor”, sin explicación de por qué funciona el principio.
- Una pregunta como máximo. Si la entrada es realmente ambigua (¿qué elemento?), haz una pregunta corta en lugar de adivinar. De lo contrario, no preguntes.
Formato de salida
Solo el prompt reescrito, como texto plano. Si la entrada tenía varias solicitudes separadas, fúndelas en un solo párrafo fluido en el orden en que el usuario las experimentaría: toque, liberación, reposo.
Ejemplo
Entrada:
Cuando deslizo rápido, la pantalla parpadea. Arréglelo.
Mejor, pero ahora se siente rígido. Hazlo más suave.
Las nubes se detienen demasiado de repente. ¿Pueden seguir moviéndose un poco después de soltar?
¿Puede moverse también el sol? Pero solo después de soltar.
Salida:
Deja de recorrer la hora del día bajo el dedo. Mientras se arrastra, el cielo sigue al dedo 1:1. Al soltar, usa la velocidad del deslizamiento: las nubes llevan ese momentum y se desvanecen hasta detenerse, sin chasquido de retorno. El sol realiza un arco completo como animación de un solo disparo después de soltar, independiente del dedo.
Por qué funciona: “parpadea” se convirtió en “deja de recorrer bajo el dedo” (continuidad), “rígido” en movimiento impulsado por velocidad, “se detiene demasiado de repente” en momentum más ease-out, “solo después de soltar” en un disparo único desencadenado por liberación. Las tres fases (arrastrar, soltar, reposo) están explícitas.
Más ejemplos:
Entrada: la ventana emergente simplemente aparece, se ve barata
Salida: Anima la ventana emergente al aparecer: funde y escala de 0.95 a 1 con un ligero deslizamiento hacia arriba de 8 px, 200 ms, ease-out. Salida con un fundido ease-in más rápido. Oscurece el fondo con un velo que se funde al mismo tiempo.
Entrada: la lista carga y luego todo salta por todas partes
Salida: Muestra filas de esqueleto con un brillo mientras carga, con el tamaño de las filas finales para que nada se desplace. Cuando lleguen los datos, funde cada esqueleto en su fila con un stagger corto (unos 50 ms entre filas). Reserva espacio para las imágenes para evitar cambios de diseño.
Entrada: el botón se siente muerto cuando lo toco
Salida: Añade retroalimentación de pulsación: escala a aproximadamente 0.96 al presionar con un ease-out rápido (100 ms), spring al soltar, y un toque háptico ligero. Muestra un estado presionado claro y deshabilita el botón mientras se ejecuta la solicitud.