La revisión de código con IA consiste en que un segundo modelo lea el código que escribió un agente e informe de problemas. La trampa con los agentes es la velocidad: un agente cambia decenas de archivos en un turno, y leerlo todo línea por línea te devuelve el tiempo que el agente te ahorró. Un paso de revisión cierra esa brecha; la salida del agente pasa por un segundo par de ojos antes de que tú la mires.
Este artículo explica cómo hacer que se revise lo que producen los agentes, cómo valorar los hallazgos y cómo mantener bajo control el bucle de revisión.
¿Por qué revisar por separado lo que produce el agente?
El agente que escribió el código es ciego a sus propias suposiciones. Cuando un agente marca un cambio como «hecho», a menudo se le escapa:
- Falta de rollback o limpieza en las rutas de error
- Casos límite: entrada vacía, peticiones concurrentes, timeouts
- Seguridad: tokens reutilizables, entrada sin validar
- Imports sin usar, código muerto, nombres inconsistentes
Un segundo modelo que lee el mismo código con contexto limpio, fijándose solo en el diff, los nota con más facilidad.
En qué se fija una buena revisión de código con IA
Los hallazgos solo ayudan cuando puedes actuar sobre ellos. Un buen hallazgo tiene:
| Parte | Ejemplo |
|---|---|
| Severidad | Alta, media, baja |
| Ubicación | src/auth/session.ts:88 |
| Problema | «Se emite un token nuevo antes de revocar el anterior.» |
| Por qué importa | «No se detecta la reutilización de tokens.» |
La severidad fija la prioridad. La ubicación te lleva directo a la línea. Los comentarios vagos del tipo «mejora el código» no sirven de nada.
Cuándo revisar
Tres enfoques:
- Automáticamente tras cada turno. La revisión empieza en cuanto el agente termina su turno, así que los problemas se detectan mientras el agente aún tiene el contexto.
- Antes de fusionar. Revisa el diff completo antes de que la rama entre en la rama principal.
- Bajo demanda. Revisa un commit o el árbol de trabajo del que dudas.
Con agentes, el primero ahorra más tiempo, porque los problemas salen antes de propagarse al siguiente turno.
Revisión de código automática en AgentVera
La revisión de código de AgentVera se activa en los ajustes del proyecto y aparece en la pestaña Reviews del panel derecho:
- Activa la revisión automática en los ajustes del proyecto y elige un modelo Claude.
- Elige qué se revisa: los commits del turno o todos los cambios.
- Elige si los hallazgos vuelven al agente.
- Cuando el agente termina su turno, se ejecuta la revisión; los hallazgos se listan con severidad y enlaces archivo:línea.
También puedes revisar a mano el árbol de trabajo, los cambios en stage o un solo commit.
Acota el bucle de retroalimentación
Devolver los hallazgos al agente automáticamente es tentador, pero un bucle sin fin es arriesgado: el agente arregla un problema y introduce otro, la revisión lo encuentra, y así sucesivamente. Por eso AgentVera limita la retroalimentación a un máximo de dos rondas seguidas. Después, la decisión es tuya.
Cómo valorar los hallazgos
No tienes que aceptar todos los hallazgos. Un orden práctico:
- Alta: riesgos de seguridad y pérdida de datos. Corrige antes de fusionar.
- Media: rutas de error, tests que faltan. Suele ser barato arreglarlos en el mismo turno.
- Baja: estilo, imports sin usar. Límpialos en bloque o con herramientas automáticas.
No dudes en rechazar los falsos positivos. El modelo revisor también puede equivocarse; tú conoces mejor el contexto.
Combina la revisión con otras redes de seguridad
La revisión sola no basta. Es más fuerte junto con:
- Tests: la revisión detecta errores de lógica, los tests detectan errores de comportamiento.
- Turnos: si una revisión muestra que un turno fue por mal camino, deshazlo con los turnos.
- Notificaciones: recibe un aviso en Telegram cuando aparezca un hallazgo importante.
- Flows: añade un agente de revisión o de tests después del agente constructor.
Un informe de revisión de ejemplo
En un turno, el agente añadió un flujo de refresh token e hizo tres commits. Cuando termina el turno, la revisión produce:
| Severidad | Hallazgo | Ubicación |
|---|---|---|
| Alta | No se detecta la reutilización del refresh token; se emite un token nuevo antes de revocar el anterior. | src/auth/session.ts:88 |
| Media | La transacción de base de datos no se revierte en la ruta de error. | src/auth/store.ts:41 |
| Baja | Import sin usar. | src/auth/index.ts:3 |
¿Qué haces con esto?
- Envía el hallazgo alto al agente. Es un problema de seguridad y el agente aún tiene el contexto, así que arreglarlo es barato.
- Añade el hallazgo medio al mismo turno. El comportamiento de la ruta de error necesita un test; pide al agente que lo escriba.
- Agrupa el hallazgo bajo. Un linter o la siguiente pasada de limpieza se encargará.
Cuando el agente lo arregla, la revisión se ejecuta de nuevo. Si tras la segunda ronda siguen abiertos hallazgos, el bucle automático se detiene y la decisión es tuya.
Elegir modelo y alcance para la revisión
La revisión también tiene un coste. Revisar cada turno con el modelo más potente puede salir caro. Un enfoque práctico:
- Para los turnos del día a día, elige un modelo Claude más rápido y barato.
- Antes de fusionar, plantéate revisar a mano el diff completo con un modelo más potente.
- Limitar el alcance a los commits del turno mantiene pequeño el diff revisado; revisar todos los cambios también detecta el trabajo sin commit.
Devuelve la revisión al rol del agente
Si ves los mismos patrones en los hallazgos una y otra vez, llévalos al rol del agente. Si la revisión marca constantemente la falta de tests en rutas de error, añade una línea como esta:
For every new function, write at least one error-path test next to the happy-path test.Así el mismo problema deja de aparecer en cada turno; el agente lo previene desde el principio. Con el tiempo los informes se acortan y los hallazgos que importan destacan.
Leer las revisiones junto al historial también ayuda. La búsqueda de conversaciones de AgentVera hace búsqueda de texto completo en todas las conversaciones de Claude y Codex, así que puedes encontrar la sesión donde ya se habló de un problema y retomarla en un agente nuevo.
Lista de comprobación
- ¿Está activada la revisión automática en los ajustes del proyecto?
- ¿Encaja el alcance de la revisión (commits del turno o todos los cambios) con tu trabajo?
- ¿Se cerraron los hallazgos de severidad alta antes de fusionar?
- ¿Está acotado el bucle de retroalimentación?
- ¿Se ejecutaron los tests con independencia de la revisión?
Para terminar
La revisión de código con IA te permite aprovechar la velocidad de los agentes sin renunciar a la calidad. Un segundo modelo que lee el código tras cada turno detecta problemas mientras el agente aún tiene el contexto, y los hallazgos con severidad y ubicación te dicen dónde mirar primero.
En AgentVera activas la revisión por proyecto y envías los hallazgos al agente con un clic. Úsala junto con los pasos de fusión de git worktrees para agentes en paralelo, o empieza con el plan gratuito.