Existe una versión de la deuda técnica que se puede ver. Lógica duplicada. Cadenas hardcodeadas. Una clase haciendo siete cosas a la vez. Esa aparece en un diff. La corriges con la conciencia tranquila.

La otra clase es invisible. Vive en la forma del sistema. En los nombres que casi encajan. En las abstracciones que eran suficientemente buenas cuando las escribiste, pero que se alejan más de la realidad con cada nuevo requerimiento. Esa deuda no aparece en los análisis estáticos. Se acumula en la cabeza de todos los que leen el código después de ti.

Marco Aurelio escribió: no te regodees en los sueños de lo que no has hecho — cuenta lo que tienes. Aplicado al código: deja de imaginar el refactor limpio que harás algún día. Observa lo que estás escribiendo ahora. Ese es el único momento donde existe la elección.

Fëanor conocía el oficio. Los Silmarils eran la cima de lo que cualquier artesano podía lograr — luz capturada en piedra, tres estrellas sostenidas en la palma. Pero puso tanto de sí mismo en ellos que ya no podía ver más allá. La obra se convirtió en identidad. Cuando la obra fue amenazada, todo lo demás se volvió negociable. Sus hijos juraron un juramento que los arruinó a todos. Lo que comenzó como devoción al oficio se convirtió en esclavitud a él. Las joyas no lo corrompieron — el apego sí.

Hay una lección ahí que no tiene nada que ver con joyas. Cuando escribes una abstracción brillante y te aferras a ella — resistiendo el feedback, reacio a verla cambiar — llevas algo más pesado que el código. Llevas la afirmación de que tu juicio pasado fue correcto. Que todavía lo es. Que el contexto no ha cambiado.

Por lo general, sí lo ha hecho.

El movimiento estoico no es dejar de preocuparte por la calidad. Es preocuparte por la calidad sin convertirla en una posesión. Escríbelo bien. Déjalo ir. Deja que la siguiente persona lo mejore. El código no eres tú.

Lo que le debes al código es tu mejor juicio hoy, aplicado con honestidad, y luego soltado. No la perfección. No la permanencia. Solo la integridad de hacer un buen trabajo y la humildad de saber que necesitará cambiar.

La deuda invisible está hecha de apego, no de pereza.


¿Qué cambiaría en cómo escribes código si asumieras que la siguiente persona que lo lea necesitará mejorarlo — no solo entenderlo?