En un rincón del repositorio hay una pull request con once días de antigüedad. Tiene 43 comentarios: diecisiete sobre formato, nueve sobre nombres de variables, una discusión filosófica sobre un patrón que nadie usa y un «LGTM» resignado de quien ya no quería discutir. El autor ha rebaseado cuatro veces y empieza a mirar ofertas de trabajo. Mientras tanto, la funcionalidad que resolvía un bug real sigue sin llegar a producción.
La code review es probablemente la práctica con mejor ratio coste-beneficio de todo el desarrollo — y la que peor se hace cuando se adopta sin pensar. Bien ejecutada, detecta errores antes de que cuesten dinero, reparte conocimiento y sube el nivel del equipo. Mal ejecutada, es un cuello de botella con opiniones. Esta guía va de cómo quedarse con lo primero.
Para Qué Sirve de Verdad (y Para Qué No)
La revisión tiene exactamente tres funciones:
- Cazar errores. Un segundo par de ojos ve el caso límite que el autor tenía delante y no veía. Es la función más obvia y no la más valiosa.
- Repartir conocimiento. Quien revisa aprende qué hace ese módulo y cómo se resolvió el problema; quien escribe recibe otra perspectiva. Es la función que más paga a largo plazo: convierte el conocimiento individual en patrimonio del equipo.
- Alinear criterios. La revisión es donde el equipo negocia, implícitamente, cómo se escribe el código aquí. Sin ella, cada desarrollador escribe su dialecto.
Y para lo que no sirve: para aplicar el estilo personal del revisor, para demostrar quién sabe más, ni como sustituto de los tests. Si la discusión es sobre gustos, no es revisión: es decoración. Y si el bug solo lo podía encontrar una persona leyendo, el problema es la falta de tests, no la falta de revisión — como vimos en la pirámide de testing, la primera red de seguridad es automática.
Las Reglas del Juego que lo Cambian Todo
Los equipos con revisiones sanas comparten cuatro reglas no escritas — hasta que las escriben:
- Pull requests pequeñas. Es la variable que más influye en la calidad de la revisión. Con 200 líneas cambiadas, el revisor lee; con 1.500, escanea. Si la funcionalidad es grande, se trocea en PRs encadenadas que se entienden por separado. La regla práctica: si la descripción necesita más de cinco líneas para explicar el cambio, probablemente son dos PRs.
- El autor prepara la revisión. Antes de asignar revisores: tests verdes, diff auto-revisado, y una descripción que explica el porqué — qué problema resuelve, qué alternativas se descartaron, dónde mirar primero. Revisar sin contexto es adivinar; la PR bien preparada se revisa en la mitad de tiempo y con el doble de acierto.
- Comentarios clasificados. Cada comentario lleva etiqueta: bloqueante (hay que cambiarlo o discutirlo), sugerencia (el autor decide), pregunta (quiero entender). Elimina el 90% de la fricción: nadie discute una sugerencia y nadie ignora un bloqueante.
- Respuesta en horas, no en días. La PR que envejece acumula conflictos de merge y desgaste. El estándar sano: primera revisión en el mismo día laborable. Si el equipo no llega, el problema no es la voluntad — es que hay demasiado trabajo en curso.
Cómo Comentar sin Herir (y sin Blandear)
La fricción rara vez viene del contenido del comentario: viene de la forma. Unas pautas que funcionan:
- Comenta el código, no a la persona. «Esta función mezcla dos responsabilidades» en vez de «siempre haces funciones gigantes». El código es del equipo; en cuanto el comentario es personal, la revisión se convierte en defensa.
- Pregunta antes de afirmar. «¿Hay algún motivo para no usar el cliente HTTP compartido aquí?» enseña más que «esto está mal» y a veces descubre que el autor tenía una razón que tú no veías.
- Propón, no ordenes. «¿Qué te parece extraer esto a un método?» convierte la revisión en conversación técnica. Y si la respuesta es «prefiero dejarlo así», la etiqueta de sugerencia te obliga a aceptarlo sin reabrir.
- Elogia lo bueno, con nombre y apellido. «Este test del caso vacío es justo el que siempre olvidamos» cuesta diez segundos y refuerza exactamente el comportamiento que quieres ver repetido. La revisión que solo señala errores enseña a esconderlos.
- Lo importante se habla en persona. Si un comentario va a necesitar tres respuestas, levántate o llama. Cinco minutos de conversación resuelven lo que veinte comentarios enconan.
Qué Revisar (y Qué Dejar a las Máquinas)
La atención del revisor es el recurso escaso: gástala en lo que ninguna herramienta puede hacer.
A las máquinas: formato, imports, linting, tipos, tests, cobertura, análisis estático, secretos filtrados. Todo eso va al CI y no se discute en comentarios — como decíamos en Clean Code en proyectos reales, la guerra de formatos se gana con un formatter, no con opiniones.
A las personas: si el diseño responde al problema, si los nombres dicen la verdad, si hay casos límite sin cubrir, si el cambio rompe alguna suposición de otra parte del sistema, si la próxima persona entenderá esto dentro de seis meses. Nada de eso lo automatiza ningún linter.
Errores Comunes
- La revisión como aduana. Un único revisor senior que debe aprobarlo todo no es control de calidad: es un cuello de botella con título. Mejor dos revisores con criterios claros que un guardián omnipotente.
- Reescribir la PR del otro. «Yo lo habría hecho distinto» no es un criterio de bloqueo. Si funciona, está testado y se entiende, se aprueba aunque no sea tu estilo.
- El nitpick masivo. Veinte comentarios de formato enseñan al autor a temer la revisión y no a escribir mejor. Si el formato importa, va al CI; si no, se deja pasar.
- Aprobar sin leer. El LGTM reflejo es peor que no revisar: da la seguridad falsa de que alguien miró. Si no hay tiempo, se dice y se reasigna.
- Revisar solo el diff. El cambio puede ser correcto línea a línea y romper el módulo entero. Antes de aprobar, mira el contexto: quién llama a esto, qué suposiciones hacía el código de alrededor.
En Resumen
La code review existe para cazar errores, repartir conocimiento y alinear criterios — no para imponer gustos. Funciona cuando las PRs son pequeñas, el autor prepara el contexto, los comentarios van clasificados y la primera respuesta llega el mismo día. Las personas revisan diseño y claridad; las máquinas, formato y tests. Y el tono importa tanto como el contenido: comenta el código, pregunta antes de afirmar y elogia lo bueno. La revisión que da miedo no eleva la calidad: la esconde.
Si las revisiones frenan a tu equipo o salen demasiados bugs a producción pese a revisar, podemos revisar vuestro proceso — y vuestro código — y proponer un ajuste concreto. Hablemos →
Sigue leyendo: Deuda técnica: qué es de verdad, cuándo es buena y cómo se paga.