Freebuff en la práctica: leer el código de un agente antes de fusionarlo

Una suite de tests en verde no es una revisión

Los tests comprueban los casos en los que alguien pensó. Un agente que cambia el comportamiento puede dejar todos los tests en verde, porque solo verificaban el comportamiento anterior de forma laxa o porque nada cubría ese camino. El verde demuestra que el cambio se ejecuta, no que sea correcto.

Lo mismo vale para un resumen ordenado: la descripción de lo que hizo el agente es una afirmación del mismo sistema que hizo el cambio. Lee el diff, no la nota de portada, y trata los tests como una señal entre varias.

Empieza desde un estado limpio y reversible

Antes del primer prompt: confirma o guarda tu trabajo, crea una rama y ten claro cómo volver. Un agente con acceso al terminal puede ejecutar migraciones, reescribir configuración y borrar archivos; un punto de partida reversible convierte un accidente en una molestia.

Si la tarea toca algo regulado o confidencial, usa una copia desechable del proyecto y una conversación sin secretos. Los términos y la documentación de datos del proveedor deciden qué sale de tu equipo: léelos en vez de suponer dónde está la frontera.

Lee el diff en el orden en que duele

Un cambio generado grande se revisa mejor en un orden deliberado que de arriba abajo.

• Puntos de entrada: rutas, manejadores, permisos y todo lo que cambia quién llega a qué.
• Datos: esquema, migraciones, serialización y consultas, sobre todo lo que borra o reescribe.
• Configuración: variables de entorno, pasos de build, CI y ajustes de despliegue.
• El resto: nombres, estructura, duplicación y los retoques cosméticos que agrandan el diff.

Después lee los tests que añadió y pregúntate qué no cubren. Un agente que escribió código y test puede grabar dos veces el mismo malentendido.

Dependencias, secretos y las líneas que nadie lee

Las dependencias nuevas son el riesgo más silencioso de un parche generado: un nombre de paquete familiar, una versión salida de la nada, un lockfile reescrito entero. Comprueba qué se añadió, por qué, y si el proyecto ya tenía algo que sirviera.

Busca credenciales, tokens y URL internas que no deberían estar en un commit, y verifica que el logging no imprima ahora datos de clientes. Son las líneas que se hojean, y justo aquellas por las que un agente no tiene motivo para ser cuidadoso: optimiza para la petición, no para tu modelo de amenaza.

Cuándo tirarlo

Si el diff es mayor que la tarea, si no puedes explicar un bloque sin adivinar, o si el cambio resuelve el síntoma y no la causa, borra la rama. Empezar de nuevo con una petición más estrecha cuesta menos que mantener código que nadie entiende.

La misma regla vale para tu prompt: la lista de revisión de nuestra guía de Manus y los consejos de estructura de nuestra guía de Prompt Cowboy acortan el diff. Para el producto, empieza por nuestra reseña de Freebuff; cómo tratamos los enlaces de recomendación está en nuestra divulgación de afiliación.