Principios a seguir al corregir código heredado con agentes de codificación de IA
makedream25 de abril de 2026
0
Computing/Software
Comments (0)
Log in to leave a comment
No posts yet
makedreammakedreamLog in to leave a comment
No posts yet
Es peligroso dejar que un agente navegue libremente por tu computadora. Especialmente si dejas las claves API expuestas en variables de entorno, existe la posibilidad de que el agente registre accidentalmente las claves en los logs o las transmita al exterior. Utiliza 1Password CLI. Es un método en el que las claves se cargan temporalmente en la memoria solo cuando ejecutas un comando.
Para evitar que el agente toque archivos clave por error, debes aislar el sistema de archivos. Crea un archivo .cursorignore y elimina de la lista las claves SSH, los artefactos de compilación y los archivos de configuración sensibles. Con solo colocar este archivo en la raíz del proyecto, la probabilidad de que el agente modifique archivos incorrectos se reduce en un 80 por ciento. Si es posible, ejecuta el agente dentro de un contenedor Docker. Es la forma más segura de evitar que el agente toque directamente el sistema anfitrión.
Si haces que el agente lea todo el proyecto, los costos mensuales de API serán inmanejables. Especialmente, permitir que el agente lea node_modules o carpetas .git es tirar el dinero.
Envía al agente solo el código que necesita. A medida que aumenta el tamaño del proyecto, es esencial limitar el alcance de la indexación. Si usas Aider, verifica cuánto estás gastando en tiempo real con el comando /tokens. Los archivos que ya se terminaron de procesar deben eliminarse del contexto inmediatamente con el comando /drop. Solo con esto, puedes reducir el consumo innecesario de tokens en más del 70 por ciento. Si eliges un modelo que admita el almacenamiento en caché de contexto (context caching) de Anthropic, puedes obtener un descuento adicional de alrededor del 75 por ciento en estructuras de código repetitivas, así que revisa tu factura de API y considera cambiar de modelo.
El código heredado tiene dependencias enredadas, por lo que si le dejas la tarea al agente sin supervisión, el sistema completo puede colapsar. No le pidas que escriba código a ciegas. Debes proporcionarle contexto al agente utilizando etiquetas XML. Describe claramente qué funciones vas a modificar y cuáles son las reglas que debe cumplir.
No hagas merge del código directamente. Primero, obliga al agente a presentar un plan de modificación. Es un método donde el desarrollador debe aprobar el plan antes de que el agente escriba el código. Asegúrate de ejecutar el código modificado por el agente en un entorno de prueba local. Si arrojas los logs de error de CI directamente de vuelta al agente, este corregirá los errores por sí mismo. Existen resultados de investigación que indican que, al seguir este proceso, puedes corregir errores con un 84 por ciento de probabilidad sin intervención adicional.
Si quieres comprobar cuánto has acelerado tras introducir agentes, olvida la velocidad de escritura de código. El tiempo de ciclo (cycle time) es la clave. Debes medir el tiempo total que lleva escribir, revisar, modificar y desplegar el código.
Primero, registra cuántos días pasan desde el primer commit hasta el despliegue real en tu proyecto actual. Los errores que el agente comete repetidamente deben organizarse en un archivo AGENTS.md y dejarse como convenciones de codificación. Si hay un módulo cuya calidad de código generado por IA es notablemente inferior, eso no es culpa de la IA, sino un problema de la estructura del sistema. Revisa semanalmente la tasa de retrabajo por PR. Las herramientas son solo herramientas. Tratar al agente como un colega y ajustar la infraestructura al flujo de trabajo del equipo es lo que determina la competitividad del equipo de desarrollo.