Agente atascado: cómo salir del bloqueo

Cuando un agente de código se descarrila, más instrucciones casi nunca ayudan: lo que funciona es una rutina clara para recuperarte.

Primero, para

Cuando un agente está confundido, añadir otra instrucción no ayuda. Más texto solo empeora un contexto que ya es un lío. Para antes de escribir nada más.

Diagnostica antes de reparar

No te fíes de lo que el agente cuenta sobre su propio trabajo. Mira lo que realmente hizo: el diff, los logs, los archivos que de verdad tocó. El resumen del agente y el cambio real pueden estar muy alejados.

Reinicia en pequeño en vez de discutir

Discutir con un agente confundido casi nunca sirve: el contexto malo sigue ahí. Una sesión nueva y limpia con instrucciones concretas y ajustadas suele ganarle a diez mensajes de ida y vuelta.

Git es tu botón de deshacer

Si el agente lo dejó hecho un desastre, vuelve al último estado bueno: git checkout o git revert (ver Git y GitHub para vibe coders). Eso casi siempre es más rápido que arreglar el error en medio del caos.

Divide la tarea en trozos más pequeños

En vez de 'construye toda la función', dale al agente un bocado: un archivo, una función, un test. Las tareas pequeñas son más fáciles de revisar, y el agente se desvía menos.

Cuándo cambiar de rumbo, cuándo hacerlo tú mismo

Si el agente comete el mismo error dos veces, un tercer intento idéntico rara vez cambia algo. Cambia de enfoque o de modelo. Y a veces 10 minutos escribiéndolo tú mismo le ganan a 60 minutos peleando con un agente: en ese caso, hazlo tú.