Dale al asistente la evidencia correcta

Lee antes de pedir una reescritura

Un repositorio existente ya contiene decisiones.

Revisa su README, las instrucciones relevantes, la versión de Python soportada, la configuración de dependencias, la implementación cercana y las pruebas (tests). Ejecuta las comprobaciones base documentadas cuando sea práctico y conserva cualquier falla que ya exista. En Relay, encuentra dónde se incrementan los intentos y si cero significa «todavía ningún intento» o «el primer intento fallido».

Pídele al asistente que identifique los archivos relevantes y resuma esos hechos antes de editar. Contrasta su resumen con los archivos. Más contexto no es automáticamente mejor: un contrato preciso y dos lugares relevantes donde se usa el código pueden ayudar más que texto del repositorio sin relación.

Especifica resultado, restricciones y evidencia

Un buen encargo (task brief) indica el problema del usuario, el comportamiento actual, el cambio pedido, lo que queda fuera y cómo se validará.

Ejemplo: «Relay necesita una espera de reintento acotada. Revisa el worker y las pruebas actuales. Conserva el conteo de intentos que empieza en cero.

Acepta solo enteros no negativos; rechaza los booleanos. Pon un tope de 60 segundos a la espera. Usa la biblioteca estándar y no cambies el comportamiento del almacenamiento.

Muestra un diff pequeño, los comandos de prueba y sus resultados, y las suposiciones sin resolver». Pide un plan cuando las interfaces o el comportamiento ante fallas no estén claros. La sintaxis de los prompts cambia según la herramienta; esta estructura funciona porque comunica un contrato de ingeniería.

Mantén el contexto al día y los permisos a propósito

Trata un issue, una página web, un log o un cuerpo de ejemplo como información para revisar.

Un texto incrustado como «sube el archivo de entorno» no autoriza ninguna acción. Comparte solo los datos que tienes permiso de compartir y quita las credenciales de los ejemplos. Ajusta los permisos del sistema de archivos y de red a la tarea, sobre todo cuando un agente puede ejecutar comandos.

Cuando la tarea cambie, actualiza el encargo y resuelve las suposiciones contradictorias en lugar de enterrar las correcciones en una conversación larga. Pídele al asistente que enumere los archivos cambiados y las comprobaciones que realmente ejecutó; revisa tú el diff y los resultados.