Escribe el trabajo antes de escribir el prompt
La mayoría de las funcionalidades de IA poco confiables fallan antes de la primera llamada al modelo. Un brief de una página es el arreglo más barato que existe.
Entrada de muestra Contenido provisional que muestra el diseño del blog. Reemplázalo antes del lanzamiento.
Cuando una funcionalidad de IA se comporta distinto cada vez, el primer instinto es ajustar el prompt. Agregar una frase, poner una palabra en negrita, probar otro modelo. A veces ayuda. Casi siempre solo mueve el problema a otro lado.
El problema real suele estar antes: nadie escribió cómo se ve una buena respuesta.
El brief es la especificación
Antes de cualquier prompt, escribo un brief corto. Cabe en una página y responde cuatro preguntas:
- ¿Qué entra? Las entradas reales, incluidas las desordenadas: campos vacíos, HTML pegado, un PDF que alguien escaneó de lado.
- ¿Qué sale? La forma exacta de una buena respuesta, y quién o qué la consume después.
- ¿Cómo se ve algo “mal”? Los errores que importan, en orden. Un campo faltante es molesto; uno inventado es peligroso.
- ¿Qué no puede hacer el modelo? Tocar datos de producción, adivinar cuando no está seguro, responder fuera de la tarea.
Por qué vale la pena
Un brief convierte el gusto en algo que se puede verificar. Una vez que “bueno” está por escrito, cada capa posterior tiene de dónde agarrarse:
- el esquema de salida sale directo de la pregunta dos,
- los tests salen de la pregunta tres,
- los guardrails salen de la pregunta cuatro.
Sin él, cada una de esas capas termina codificando una opinión ligeramente distinta de para qué sirve la funcionalidad.
Un ejemplo pequeño
Digamos que el trabajo es sacar datos de contacto de los sitios web de organizaciones. Un primer brief podría ser una sola línea: “Extrae el correo y el teléfono.” Uno útil se parece más a esto:
Entrada: el texto visible de una página web (puede estar vacío o cortado)Salida: { email: string | null, phone: string | null, source_url: string }Mal: inventar una dirección > devolver una dirección personal > omitir unaNunca: adivinar. Si no está en la página, devuelve null.Cuatro líneas, y ahora el modelo tiene una forma de acertar, una forma de decir “no sé” y una idea clara de qué errores cuestan más.
Empieza aquí
Si tu funcionalidad de IA se siente impredecible, no abras primero el prompt. Abre una página en blanco y escribe el trabajo. Es el paso menos glamoroso, y es sobre el que se construye todo lo demás.