Un diff es la lista de diferencias entre dos versiones de un archivo o de un proyecto: qué líneas se agregaron, cuáles se quitaron y dónde. Las agregadas suelen marcarse con un signo más y las quitadas con un signo menos. Herramientas como git lo usan para mostrar qué cambió de verdad, sin depender de lo que alguien cuente.
Una pregunta de la app. Elige una respuesta.
Pides renombrar una función y el diff toca muchos archivos. ¿Qué haces primero?
Renombrar toca cada lugar donde se usa la función. El tamaño solo no lo condena.
Que sea esperable no te dice que no se coló otra cosa entre tantos cambios.
Un diff grande pide revisar su alcance. Si cada cambio es el renombre, va bien; si hay algo más, eso se discute.
Con montos inventados, en pesos: una tienda online sube el mínimo para el envío gratis. El diff muestra «- envioGratisDesde = 50000» y debajo «+ envioGratisDesde = 60000». No es que haya dos líneas nuevas: cambiar una línea se ve como quitar la vieja y agregar la nueva.
Alrededor aparecen unas líneas sin signo: no cambiaron, están para que ubiques el cambio. Cada bloque empieza con una línea que indica en qué parte del archivo está, y muchas herramientas pintan de verde lo agregado y de rojo lo quitado.
Un agente de código termina con un resumen: «traduje los mensajes de error». El resumen es lo que dice que hizo; el diff, lo que hizo. Mirar las líneas en rojo de los tests es un buen hábito: si un test no pasaba, el agente puede haberlo borrado o aflojado para que pase.
Una regla en tu CLAUDE.md como «no borres tests para que pasen» ayuda, pero el agente puede olvidarla. El diff no se olvida: si se quitó un test, ahí está.
Que un diff sea grande no lo hace malo: actualizar una librería o aplicar un formateador puede tocar decenas de archivos. El riesgo es que entre 2.000 líneas de espacios y comas se esconda un cambio de verdad. Empieza por la lista de archivos: si aparece uno que no tiene nada que ver con el pedido, como la configuración de pagos, ábrelo primero.
Dos trucos: pídele al agente que deje el formato en un cambio aparte, y usa la opción de ocultar los cambios de espacios que tienen muchas herramientas. Así lo que queda a la vista es lo que importa.
«Si los tests pasan, no hace falta leerlo.» Los tests no te avisan de un cambio que nadie pidió. «El diff dice si funciona.» No: dice qué cambió. «Todo está en el diff.» Casi: un archivo nuevo que git todavía no sigue puede no aparecer, y uno binario, como una imagen, aparece sin detalle.