Refactorización de código heredado con cursor (pruebas primero, valor después)
Un módulo de 600 líneas sin pruebas cumplió con Cursor. El flujo de trabajo que lo refactorizó sin interrumpir la producción tenía menos que ver con IA y más con secuenciación.
El módulo tenía 600 líneas, diez años de antigüedad, soportaba carga y se probó únicamente con tráfico de producción. Cursor lo refactorizó bien, pero la IA fue quizás un tercio de la historia. Los otros dos tercios fueron la secuencia: pruebas, límites y negarse a permitir que el agente se moviera rápido.
El primer paso son las pruebas de caracterización, y Cursor es realmente bueno para ayudar a escribirlas. Le pedí que leyera el módulo y enumerara todos los comportamientos observables: entradas, salidas, casos extremos, rutas de error. Luego, generar pruebas que afirmen el comportamiento actual, incluidas las cosas raras, etiquetadas explícitamente como 'caracterización: afirma el comportamiento actual, no la corrección'. Esas pruebas son la red de seguridad que hace posible todo lo posterior.
El segundo paso son los límites antes de la cirugía. Primero hice que Cursor extrajera funciones puras en las costuras (análisis, cálculo, formato) sin cambiar ningún comportamiento, cada extracción se verificó en verde. Sólo entonces comenzó la verdadera refactorización, función por función, con la instrucción más importante: "cambiar una cosa por pasada, ejecutar las pruebas, detener". Los agentes que refactorizan audazmente, reescriben con confianza y rompen sutilmente. Pequeños pases con verificación entre ellos son la forma de mantener el control.
El paso que nadie espera que importe: hice que Cursor explicara cada cambio en una oración antes de aplicarlo. Las explicaciones detectaron dos cosas que las pruebas no detectaron: una mutación de un objeto compartido que solo se mordía en concurrencia y un reordenamiento de las operaciones que era seguro en la zona horaria de las pruebas y no en la de producción. Leer el razonamiento de una frase son diez segundos por cambio y captó lo que las redes perdieron.
Recuento final: el módulo ahora tiene 300 líneas con una estructura que un nuevo empleado puede leer, un comportamiento verificado idéntico por el conjunto de caracterización y cero incidentes de producción. La IA mecanografió. La disciplina hizo la refactorización. Ambos eran necesarios; sólo uno de ellos era opcional.