# Cómo revisar código generado por IA antes de hacer merge

> Una checklist práctica para revisar código generado con IA: alcance, comportamiento, permisos, datos, pruebas y evidencia antes de integrar un cambio.

Canonical: https://www.gilbertsahumada.com/blog/revisar-codigo-generado-por-ia/
Last updated: 2026-10-20

Programación con IA · Revisión de código · Pruebas

Revisar código generado por IA exige comprobar el comportamiento que estás incorporando al proyecto. Que el diff tenga buena presentación, incluya comentarios o venga acompañado de un resumen no demuestra que cumpla el requisito.

El siguiente método sirve para revisar tu propio cambio o un pull request. Usa como ejemplo una funcionalidad que permite asignar una solicitud de servicio a una persona responsable. Puedes adaptar las preguntas a tu proyecto.

## 1. Comienza por el requisito

Antes de leer las líneas, escribe qué debería poder hacer el usuario. En el ejemplo: una persona autorizada asigna un responsable y ve el cambio reflejado en la solicitud.

Aclara también lo que debe seguir protegido. Una persona de otra organización no puede reasignar la solicitud. Un identificador que no existe produce un error entendible. La interfaz no anuncia éxito si la API rechaza la operación.

Si no puedes describir ese resultado, la revisión todavía no tiene una referencia clara. Pide criterios concretos antes de debatir detalles de estilo. La [guía para programar con IA](https://www.gilbertsahumada.com/blog/programar-con-ia-guia-practica/) explica cómo preparar una tarea acotada.

## 2. Recorre el diff completo

Mira qué archivos cambiaron, incluyendo configuración, migraciones y lockfiles. Para cada archivo, relaciona el cambio con un criterio. Una dependencia nueva, un cambio de permisos o una eliminación de validaciones merecen una explicación específica.

```sh
git diff --stat
git diff --check
git diff
```

Comprueba cuál es la base que estás comparando. Un diff de cambios sin confirmar y un diff entre ramas responden preguntas diferentes. La [referencia oficial de git diff](https://git-scm.com/docs/git-diff) describe ambas formas.

Evita una revisión basada solo en el último archivo abierto. Una interfaz puede parecer correcta mientras la ruta de escritura acepta identificadores de cualquier organización. También puede ocurrir que una migración cambie datos que la interfaz no muestra.

## 3. Sigue una escritura de extremo a extremo

En la asignación de responsable, localiza el evento de la interfaz, el cuerpo enviado a la API, la validación de entrada, la comprobación de acceso y la actualización de datos.

Pregúntate de dónde sale la identidad del usuario. Un campo enviado por el navegador no debería ser la única prueba de que alguien puede modificar una solicitud. Revisa que la autorización suceda en el servidor y se aplique al recurso concreto.

Observa además qué pasa cuando falla la escritura. El botón puede quedar bloqueado, el formulario perder su contenido o un mensaje optimista permanecer visible pese al error. Verifica esos estados en el recorrido que estás cambiando, no solo en una función aislada.

## 4. Revisa lo que se almacena y lo que se devuelve

Comprueba nombres de campos, tipos y límites. ¿El responsable admite un valor vacío? ¿Se comprueba que pertenezca a la organización? ¿El historial conserva quién hizo el cambio? ¿La respuesta devuelve datos que ese usuario no necesita ver?

Si hay una migración, entiende qué ocurre con registros existentes. Una prueba sobre una base vacía no demuestra que la actualización preserve la información anterior. Usa datos de prueba representativos y un procedimiento de recuperación adecuado al cambio.

También revisa logs, mensajes de error y archivos añadidos para evitar exponer credenciales o datos personales. Cuando una tarea usa agentes con herramientas, limita sus permisos a lo necesario. El [proyecto de seguridad de IA generativa de OWASP](https://genai.owasp.org/llm-top-10/) documenta riesgos relacionados con manejo de salidas, información sensible y autonomía excesiva.

## 5. Busca una prueba que rechace un resultado equivocado

Una prueba útil distingue la implementación correcta de otra que simplemente devuelve éxito. Para esta funcionalidad, podrías comprobar:

* Una persona autorizada puede asignar un responsable válido.
* La escritura realmente modifica la solicitud esperada.
* El intento desde otra organización se rechaza y no cambia los datos.
* Un responsable inexistente no deja una asignación parcial.
* Si la API falla, la interfaz conserva una forma de reintentar.

No necesitas una prueba por cada línea. Elige las que cubran los riesgos del cambio. Una modificación puramente visual puede verificarse con una revisión de tamaños, contraste y foco; una modificación de permisos necesita evidencia sobre accesos permitidos y rechazados.

Lee las pruebas añadidas. Si el asistente cambió una expectativa para que coincida con su implementación, verifica que el nuevo resultado siga respondiendo al requisito. Cuando el requisito sí cambió, deja esa razón visible en la descripción.

## 6. Ejecuta y registra las comprobaciones reales

Usa los comandos del repositorio y anota cuáles ejecutaste, su resultado y el entorno relevante. Distingue entre pruebas unitarias, compilación y revisión en navegador. Cada una observa una parte diferente del sistema.

Si una comprobación falla antes de tu cambio, investiga si es un fallo previo y registra cómo lo verificaste. No conviertas automáticamente un error en «algo del entorno». Tampoco repitas una suite que ya pasó sin una razón nueva: dedica ese tiempo a la parte todavía incierta.

Un resultado simulado sirve para probar un comportamiento concreto, pero no demuestra que el proveedor real esté disponible. Por ejemplo, una API falsa puede verificar el estado de error del formulario; no confirma que una candidatura haya llegado a producción.

## 7. Decide qué queda pendiente

Antes de hacer merge, enumera las limitaciones materiales. Puede faltar probar una migración con una copia representativa, revisar un flujo de teclado o comprobar la configuración del entorno de destino.

Pide al asistente que identifique supuestos y riesgos, pero contrasta su respuesta. Para investigar una zona difícil, prepara [contexto e instrucciones concretas](https://www.gilbertsahumada.com/blog/contexto-instrucciones-agentes-programacion/) y pide referencias a los archivos leídos.

## Una plantilla breve para tu revisión

Puedes dejar un resumen con cuatro puntos:

1. **Cambio:** qué comportamiento incorpora y para quién.
2. **Datos y acceso:** qué se guarda y qué impide modificar recursos ajenos.
3. **Evidencia:** comandos y recorridos verificados, con resultados.
4. **Pendientes:** qué falta comprobar antes o después del despliegue.

El criterio para integrar no es que la IA parezca segura de su respuesta. Es que el cambio tenga una explicación coherente y evidencia suficiente para su riesgo.

En la [academia de desarrollo con IA](https://academia.gilbertsahumada.com/) practicarás este tipo de revisión sobre tres entregas de una aplicación común. El programa está dirigido a personas que ya programan y quieren mejorar su forma de construir, verificar y mantener software con ayuda de IA.

## Related

* [Contexto e instrucciones para agentes de programación: cómo preparar una tarea con IA](https://www.gilbertsahumada.com/blog/contexto-instrucciones-agentes-programacion/)
* [Cómo programar con IA: una guía práctica para aprender y verificar tus cambios](https://www.gilbertsahumada.com/blog/programar-con-ia-guia-practica/)
