Dale a tu agente una tarea que se pueda terminar y revisar

“Arregla la aplicación” es un estado de ánimo, no una tarea. Entiendo el ánimo, pero un agente necesita una meta que otra persona pueda reconocer. Un contrato útil es breve y concreto; no es un formato mágico que vuelva fiable cualquier modelo.

Describe el resultado visible

Empieza con desencadenante y resultado: “Al subir un CSV vacío, muestra un mensaje útil y conserva el espacio actual”. Añade un ejemplo saneado y nombra repositorio y rama o worktree. No dejes que el agente adivine por el directorio abierto.

Define qué puede cambiar. Una corrección de validación no implica rediseñar autenticación o migrar la base. Si descubre una dependencia real, debe traer evidencia antes de ampliar el alcance. Indica también si hay publicación ya autorizada; un comentario o recuerdo no concede permiso.

Pide evidencia adecuada

“El archivo vacío produce el error esperado, el dataset anterior sigue legible y una importación válida funciona” se puede comprobar. Elige verificaciones por riesgo, no por ejecutar todas las herramientas disponibles.

Objetivo: importación de CSV vacío
Área: importador e interfaz de error
Aceptación: sin pérdida; importación válida funciona
Evidencia: reproducción, checks y archivos cambiados
Entrega: resultado, límites y próxima acción necesaria

Es un ejemplo original, no la configuración de un harness. No pongas credenciales ni archivos de clientes en la tarea; utiliza fixtures autorizados.

Reconoce avances parciales

Si el fallo está en una dependencia que no puede cambiar, el informe debe explicar qué reprodujo, qué modificó, qué falta y qué comprobación respalda cada afirmación. Un plan no es implementación; editar no equivale a probar; pasar localmente no equivale a desplegar.

Revisa la entrega contra la aceptación original. Si cambia el objetivo, actualiza el contrato en lugar de acumular mensajes contradictorios. Un límite claro permite decisiones rutinarias autónomas sin perder de vista dónde termina la autorización.