Revisión de código
Examinar un cambio antes de aceptarlo: qué hace, si hace lo que se pidió, si rompe algo y si se entiende.
✦Apagada: responde bien la pregunta del final para encenderla
También lo verás como: code review · revisar código · revisión
Analogía
El inspector de obra que revisa antes de firmar. No puso los ladrillos, pero responde por ellos.
Las tres capas, en este orden
| Capa | Pregunta | Cómo |
|---|---|---|
| 1. Qué cambió | ¿tocó solo lo que pedí? | git status y git diff → diff |
| 2. Si funciona | ¿cumple cada criterio? ¿también en el móvil? | abrirlo y probarlo contra los criterios de aceptación |
| 3. Si lo entiendo | ¿podría explicar cada bloque? | preguntar a la IA hasta entenderlo |
La regla
No lo acepto si no lo entiendo.
No hace falta saber escribirlo. Sí hace falta poder explicar qué hace cada parte y por qué está ahí. Lo que no entiendes no lo puedes mantener, ni arreglar, ni defender ante un cliente.
Las cuatro preguntas después de cada tarea
- Enumera todos los archivos que cambiaste y qué cambiaste en cada uno.
- ¿Qué diste por supuesto que yo no te dije?
- ¿Qué parte es más probable que esté mal?
- ¿Hay algo de lo que pedí que no hayas hecho?
La IA puede repasar sus propios criterios —es útil y encuentra cosas—, pero su autorrevisión no sustituye la tuya.
Lo que vendrá
En la Fase 10 la revisión se completa con pruebas automáticas; en la Fase 13, con revisiones hechas por otra IA. La decisión final sigue siendo tuya.
Un paso más: revisar sin saber programar
Puedes revisar mucho antes de saber escribir código, porque gran parte de la revisión no es técnica:
| Lo que compruebas | Qué necesitas saber |
|---|---|
| ¿Tocó solo los archivos esperados? | leer una lista de nombres |
| ¿Los datos coinciden con los míos? | comparar dos textos |
| ¿Hace lo que pedí? | usar la página |
| ¿Hay algo que no pedí? | haber escrito bien el encargo |
Lo técnico entra en la tercera capa (¿lo entiendo?), y ahí la herramienta es preguntar: "explícame este bloque línea por línea, como a un principiante". Cada fase del roadmap amplía lo que puedes juzgar por ti mismo.
Lo que nunca cuenta como revisión: que la IA diga que está bien.
¿En qué orden se revisa un cambio de la IA?
Ver también
diff · criterios de aceptación · alucinación · la checklist de revisión