Simplificar el código sin cambiar su comportamiento

Cómo aclarar un código que funciona pero cuesta leer: la valla de Chesterton, la regla de tres, pasos pequeños con las pruebas en verde y cuándo no tocar.

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

El código que funciona pero que nadie quiere tocar es una deuda que se paga en cada cambio. Simplificarlo significa aclararlo sin cambiar su comportamiento: mismo resultado, menos esfuerzo para quien lo lea después.

Primera regla: el comportamiento sigue igual

Una simplificación que cambia el comportamiento es un cambio, y debe tratarse como tal (con pruebas, revisión, descripción). Por eso se trabaja con las pruebas en verde, a pasos pequeños, y cada paso se prueba. Si no hay pruebas, primero se escriben las que fijan el comportamiento actual.

Entender antes de tocar

Ante un trozo de código que parece inútil o raro vale la valla de Chesterton: antes de quitar una valla, se averigua por qué alguien la puso. Se lee la historia del cambio, se busca quién lo usa, se intenta entender el caso que protege. Si tras el examen no se encuentra ninguna razón, se quita; si se encuentra, se documenta con un comentario.

Qué buscar

  • Anidamientos profundos. Una cascada de condiciones se aplana con salidas anticipadas.
  • Funciones largas con varias responsabilidades. Se dividen en funciones con nombres que describan lo que hacen.
  • Nombres poco claros. Un nombre que necesita un comentario para entenderse es un mal nombre.
  • Duplicaciones. Pero un elemento común se extrae solo tras el tercer caso (regla de tres): dos parecidos pueden ser una coincidencia, y una abstracción prematura cuesta más que la duplicación.
  • Código muerto y banderas que nunca se usan. Se eliminan.
  • Complejidad accidental. Estructuras genéricas construidas para un futuro que no ha llegado.
  • Comentarios que repiten el código. Se quitan; quedan los que explican el porqué.

Cómo proceder

Una simplificación cada vez; pruebas después de cada una; un commit por cada una con un mensaje que diga «sin cambio de comportamiento». Quien revisa debe poder comprobar en pocos minutos que nada ha cambiado.

Cuándo no tocar

  • Código que no se entiende y no tiene pruebas: primero se escriben las pruebas.
  • Código a punto de ser sustituido o eliminado.
  • Código crítico para el rendimiento, donde la versión «fea» es así por una razón medida.
  • Cuando la simplificación es un pretexto para reescribirlo todo: el riesgo supera la ventaja.

Señales de alarma

  • Cambiar el comportamiento junto con la estructura en el mismo paso.
  • Quitar algo sin entender por qué estaba.
  • Extraer una abstracción tras solo dos usos.
  • Una «limpieza» que toca decenas de archivos sin pruebas.
  • Una simplificación que deja el código más corto pero más oscuro.

Un ejemplo

Una función con cuatro if anidados comprueba un pedido. Con las pruebas en verde, cada condición se lleva a una salida anticipada («si el pedido está cancelado, sal»), se da un nombre a la condición compuesta («pedido_modificable») y se elimina una rama inalcanzable tras comprobar que no tiene usos. El comportamiento es idéntico y la función se lee de arriba abajo.

Cuándo usarlo

Al refactorizar para ganar claridad sin cambiar el comportamiento, cuando el código funciona pero es más difícil de leer, mantener o ampliar de lo que debería, o cuando en una revisión se ve complejidad acumulada sin motivo.

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-simplificationMétodo para simplificar código que funciona sin cambiar su comportamiento: pruebas como red de seguridad, valla de Chesterton, regla de tres, pasos pequeños, cuándo no tocar. Úsese cuando el código funciona pero es difícil de leer, mantener o ampliar.