Describir lo que los usuarios necesitan
Describir lo que los usuarios necesitan · 5 min
La mayoría de los entrenamientos de IA te enseñan a escribir mejores prompts. Eso es necesario pero no suficiente para construir grandes productos. Esta lección traza la Cadena de Descripción completa: el camino desde una necesidad humana desordenada hasta una instrucción precisa sobre la que la IA puede actuar, con el creador como traductor en cada paso.
Puntos clave
- La Cadena de Descripción conecta la voz del usuario con el requisito, la especificación técnica y la instrucción para la IA. La ingeniería de prompts es solo un eslabón.
- El creador es el traductor en cada paso. La IA no puede escuchar lo que el usuario no dijo.
- El código que funciona pero el producto no es un fallo de descripción. Encuentra qué eslabón se rompió más arriba en la cadena.
- Las pruebas son la forma más precisa de descripción. Una prueba que pasa con un usuario insatisfecho significa que describiste la intención equivocada.
- Cada paso implica decisiones de criterio que la fase anterior no tomó por ti.
Ejercicio
El proyecto del tiempo de espera de la clínica, parte 2
Estás retomando exactamente donde quedó la última lección. Saca tu resumen del problema, tu plan de delegación y tus pruebas de aceptación.
Paso 1: Escribe el requisito del producto
Un párrafo. Toma la necesidad del usuario de tu resumen del problema y delimítala en algo medible. Cada adjetivo debe ser una decisión que puedas defender. Si escribes “rápido”, escribe qué tan rápido. Si escribes “simple”, describe qué significa simple para un paciente que consulta desde un teléfono en un estacionamiento.
Paso 2: Escribe la especificación técnica
Media página. Describe qué se va a construir y cómo está estructurado. Nombra las piezas. Nombra cómo se comunican entre sí. Usa la IA en modo de aumento aquí: comparte tu requisito del producto, pídele que proponga un enfoque técnico y luego cuestiona cualquier cosa que no encaje con tus restricciones.
Paso 3: Ajusta tus pruebas
Revisa tus pruebas de aceptación de la lección anterior. Reescríbelas para que cada una sea algo que el código pueda pasar o fallar. Agrega al menos dos casos límite: qué pasa cuando la clínica está cerrada, cuando no hay datos, cuando el tiempo de espera es cero.
Paso 4: Escribe tus prompts para la IA y construye
Escribe las instrucciones que conviertan tu especificación en código funcional. Incluye tus restricciones, tus elecciones de stack y tus pruebas. Construye la primera versión.
Paso 5: Haz una demostración
Busca un compañero. Él o ella interpretará a un paciente de la clínica — tiene un hijo enfermo y diez minutos. Entrégale tu construcción y observa cómo la usa. No expliques nada. No ayudes.
¿Pasaron las pruebas? ¿Está satisfecho el paciente? Si esas respuestas no coinciden, ¿a qué eslabón de la cadena regresarías?
Reflexión de la lección
- ¿Qué traducción dentro de la Cadena de Descripción se siente más natural? ¿Cuál sueles apresurar?
- En tu demostración de la clínica, ¿dónde estuvo la mayor brecha entre lo que pretendías y lo que experimentó tu compañero?
Qué sigue
En la próxima lección, pasamos de la descripción al discernimiento. Has construido algo y el código funciona — ahora la pregunta es si realmente es bueno.