Revisión de código en varios ejes: corrección, legibilidad, arquitectura, seguridad, rendimiento

Cómo revisar un cambio antes de que entre en la rama principal: cinco ejes de evaluación, tamaño de los cambios, severidad de los hallazgos y cómo revisar el trabajo de un agente.

Metodologíametodologiacode reviewqualitàingegneria del software19 de noviembre de 2026 · 3 min de lectura

Una revisión de código que se limita a comprobar si «funciona» deja pasar casi todo lo que importa: la función correcta pero ilegible, el módulo que rompe los límites de la arquitectura, el endpoint sin controles de acceso. Por eso la revisión se hace en varios ejes, cada uno con sus preguntas.

Los cinco ejes

1. Corrección. ¿Hace lo que declara? ¿Gestiona los casos límite (vacío, nulo, valores extremos, concurrencia)? ¿Las pruebas prueban el comportamiento, o solo que el código no explota? ¿Existe una prueba que habría fallado antes del cambio?

2. Legibilidad. ¿Se entiende sin preguntar al autor? Nombres que dicen lo que son, funciones con una responsabilidad, flujos lineales. Un código que requiere una explicación verbal cuesta en cada lectura futura.

3. Arquitectura. ¿Respeta los límites y las convenciones del proyecto? ¿Introduce una nueva forma de hacer cosas ya resueltas en otro sitio? ¿Añade dependencias? ¿Duplica una utilidad existente?

4. Seguridad. ¿Valida las entradas en las fronteras? ¿Comprueba quién puede hacer qué? ¿Expone datos que no debería? ¿Gestiona bien los secretos? ¿Registra información sensible?

5. Rendimiento. ¿Hay bucles que consultan la base de datos con cada elemento? ¿Operaciones costosas en caminos frecuentes? ¿Listas sin límite? Se juzga a partir de mediciones o de riesgos concretos, no de optimizaciones imaginarias.

El tamaño importa

Un cambio demasiado grande no se revisa: se aprueba por cansancio. Se prefieren cambios pequeños, con una única intención, acompañados de una descripción que explique qué cambia y por qué. Si un cambio supera lo que se lee con atención en una sesión, se pide dividirlo.

La severidad de los hallazgos

Cada hallazgo dice cuánto pesa, para que el autor sepa qué debe cambiar y qué puede discutir:

  • Bloqueante: debe corregirse antes de entrar (defecto, brecha de seguridad, ruptura del contrato).
  • Importante: por corregir, salvo buena razón.
  • Sugerencia: mejora opcional.
  • Nota: observación sin acción requerida.

Los hallazgos sin etiqueta convierten cada comentario en un ultimátum.

Revisar el trabajo de un agente

El código escrito por un agente se revisa con el mismo rigor, y con una atención más: tiende a ser verosímil, aparentemente completo, con pruebas que reflejan el código en lugar del comportamiento deseado. Se comprueba qué se ha ejecutado de verdad, que las dependencias existan y que el alcance del cambio sea el solicitado.

Qué decir y cómo

Se comenta el código, no a la persona. Se explica el porqué. Se propone una alternativa cuando se objeta. Se reconoce lo que está bien hecho: sirve para saber qué repetir.

Señales de alarma

  • Aprobar porque «las pruebas pasan» sin mirar qué prueban.
  • Un cambio demasiado grande para leerse.
  • Hallazgos sin severidad.
  • Ninguna atención a la seguridad porque «es interno».
  • Fiarse del código del agente porque «ha ejecutado las pruebas».

Un ejemplo

Un cambio añade un endpoint para exportar pedidos. En el eje de la corrección: funciona. En seguridad: ningún control de que el usuario pueda ver esos pedidos (bloqueante). En rendimiento: una consulta por pedido (importante). En legibilidad: un nombre poco claro (sugerencia). El autor sabe enseguida por dónde empezar.

Cuándo usarla

Antes de integrar cualquier cambio en la rama principal, al revisar código propio, de otra persona o de un agente, y al evaluar la calidad en varias dimensiones.

Este método deriva de la familia de skills de código abierto agent-skills de Addy Osmani (licencia MIT), reescrita y adaptada.

Este artículo es una skill de OIAR

Lo que acabas de leer es el contenido de una skill del catálogo de OIAR, escrito para las personas. Un conocimiento como este pero más rico y profundo, escrito para los agentes, guía las entrevistas, el análisis y el informe dentro de la plataforma. Las skills se usan en OIAR: para probarla en un proyecto tuyo necesitas una cuenta.

code-review-and-qualityMétodo para revisar un cambio en cinco ejes (corrección, legibilidad, arquitectura, seguridad, rendimiento) con hallazgos clasificados por severidad, también para código escrito por un agente. Úsese antes de integrar un cambio o al evaluar la calidad de código propio o ajeno.