¿Código heredado? ¿Dependencias olvidadas? ¿Un módulo que nadie toca? Eso también es
deuda técnica. El término no describe una vergüenza moral ni exige reescribirlo todo.
Describe una elección presente que aumenta el coste de una decisión futura. A veces es
deliberada: entregas una solución estrecha para comprobar una hipótesis. A veces aparece
sin permiso: una biblioteca deja de recibir soporte, una regla queda implícita o una
excepción se copia hasta parecer arquitectura. Primero, separa deuda de trabajo normal.
Un sistema puede ser simple y correcto; no necesita capas decorativas para parecer
serio. Hay deuda cuando una limitación conocida dificulta cambiar, probar, comprender o
operar el sistema. Busca señales observables: cambios que requieren tocar zonas no
relacionadas, pruebas que dependen del orden de ejecución, incidencias que se resuelven
con reinicios, documentación que contradice el comportamiento real y personas concretas
que se convierten en única fuente de conocimiento. No todo defecto merece la misma
prioridad. Una parte antigua, estable y poco utilizada puede esperar. Una parte pequeña
que bloquea varias entregas merece atención aunque no sea técnicamente impresionante. El
objetivo no es purificar el pasado. Es bajar el coste de las decisiones siguientes.
Después, construye un inventario breve y operativo. Para cada elemento, anota la causa
probable, el síntoma, el impacto, la frecuencia y una primera intervención segura. Evita
frases como “hay que mejorar el sistema”. Especifica: añadir una prueba para el caso
límite, sustituir una dependencia sin mantenimiento, registrar una excepción o dividir
una función que mezcla validación y persistencia. La descripción concreta permite
comparar opciones. Prioriza por combinación de impacto y probabilidad, no por disgusto
personal. Un cambio que reduce una interrupción recurrente puede valer más que una
refactorización elegante sin efecto observable. Antes de tocar una zona delicada, crea
una red de seguridad: prueba de comportamiento, registro suficiente, copia de
configuración y procedimiento de reversión. Si no puedes saber si la intervención
empeoró el sistema, todavía falta una medición. Trabaja en porciones pequeñas. Un cambio
pequeño puede revisarse, revertirse y asociarse con una señal. Una transformación
gigantesca mezcla causas y dificulta aprender. Documenta también lo que decides no
arreglar y por qué. Esa negativa no es abandono; es una decisión revisable con contexto.
Cuando cambien las prioridades, podrás recuperar el razonamiento en vez de repetir el
debate.
Finalmente, incorpora la deuda al trabajo cotidiano sin convertirla en un ritual vacío.
Cada nueva funcionalidad que toque una zona problemática puede dejar una mejora local:
un nombre más preciso, una prueba, una interfaz más estrecha o una nota de operación. No
prometas una limpieza total para justificar el esfuerzo. Explica el coste actual y la
reducción esperada. La dirección necesita consecuencias comprensibles: más tiempo para
cambios, más incidentes, mayor dependencia de una persona o dificultad para verificar
una publicación. El equipo técnico necesita límites claros: qué no se modifica, qué
señal confirma el progreso y cuándo se detiene la intervención. La verdad incómoda es
que la deuda nunca desaparece por completo. Los sistemas cambian, las restricciones
cambian y cada atajo puede generar una nueva obligación. La disciplina consiste en que
las obligaciones sean visibles, localizadas y revisables. Si un componente asusta, no lo
rodees para siempre: añade observabilidad, prueba un comportamiento y reduce el área
desconocida. Así conviertes miedo difuso en trabajo técnico. ¿Qué parte de tu sistema
consume más explicación que ejecución, y qué evidencia te permitiría repararla sin
adivinar?
