Mi yo futuro era un extraño que heredó mi desorden

La persona que más problemas me ha causado en todo este proyecto es alguien desconocido que no para de heredar mi trabajo y que no tiene la menor idea de por qué todo está hecho como está. Ese yo futuro abre archivos que escribí, contempla decisiones que tomé y no logra reconstruir lo que estaba pensando por más que se esfuerce. Esa persona desconocida, claro está, soy yo mismo, solo que unos meses más tarde.

Antes pensaba que la documentación era una tarea para equipos, algo que se hace para que otras personas puedan entender tu trabajo. Me costó mucho tiempo darme cuenta de que la persona más importante para quien estaba escribiendo era una versión futura de mí que no compartiría nada de mi contexto actual, y que estaría calladamente furiosa por lo poco que me molesté en dejar atrás.

La ilusión de que vas a acordarte

La raíz del problema es una ilusión muy convincente. Cuando tomas una decisión, el razonamiento que hay detrás es vívido, evidente y está presente. Toda la red de consideraciones —qué intentabas lograr, qué acababas de descartar, qué restricción te forzó la mano— está ahí mismo, en tu mente, viva y completa. En ese momento es genuinamente imposible imaginar que algún día lo olvidarás. Por supuesto que recordarás por qué hiciste esto. Es obvio.

Así que no lo anotas. ¿Para qué? Y esta es exactamente la trampa, porque el contexto se evapora a una velocidad asombrosa, casi violenta. La rica red de razonamiento que hizo que una elección pareciera inevitable se disuelve en cuestión de semanas, y lo que deja atrás es una elección desnuda, ahí sentada, sin ninguna razón visible asociada.

Volver como un extraño a mi propio trabajo

Así que meses después abría mi propio código y me topaba con decisiones que sencillamente no podía explicar. ¿Por qué está hecho de esta manera concreta? ¿Por qué este valor específico y no otro? ¿Por qué este orden, esta extraña excepción, este pequeño y torpe rodeo? Alguna versión pasada de mí había conocido la respuesta con total claridad. La versión presente solo había heredado la conclusión, con todo el razonamiento arrancado de cuajo.

Es una sensación genuinamente desorientadora: ser un extraño en tu propio trabajo, desconfiar de las elecciones de alguien a quien no puedes interrogar y que resulta ser tú mismo. Es como recibir la última línea de una larga demostración con cada paso que condujo a ella borrado. La respuesta está ahí mismo. Solo que no tienes forma de saber si confiar en ella, ni qué se rompería si la cambiaras.

El “qué” es visible; el “porqué” ha desaparecido

Aquí está la asimetría que había subestimado por completo. El código es excelente para registrar lo que hiciste. Es, por su propia naturaleza, un registro preciso de las acciones tomadas. Pero casi nunca registra por qué las hiciste, y el porqué es a la vez lo más difícil de reconstruir y lo más importante de conservar.

El qué siempre lo puedo recuperar, porque está ahí mismo, delante de mí, listo para releerse. El porqué —la intención, las alternativas rechazadas, la razón concreta por la que esta forma extraña era necesaria— desaparece en el instante en que sale de mi cabeza, a menos que hiciera el esfuerzo deliberado de capturarlo. Y sin el porqué, el qué resulta casi inútil para lo único que realmente necesito hacer, que es decidir si cambiarlo y cómo. Un registro de decisiones sin un registro de razones es un mapa con todas las etiquetas borradas.

Las decisiones sin documentar se vuelven intocables

La consecuencia más insidiosa es lo que le ocurre a una elección cuya razón se ha olvidado. Pasa a ser un punto de carga estructural de un modo que no puedes evaluar. No sabes por qué está ahí, lo que significa que no sabes qué depende de ella, lo que significa que te da miedo tocarla. Y así se osifica, no porque sea buena, sino porque es un misterio.

Un sistema se va llenando poco a poco de estos pequeños misterios congelados: decisiones que todo el mundo, incluido su propio autor, está ahora demasiado nervioso para perturbar. La cruel ironía es que los construí yo mismo, y mi propio olvido los convirtió en cosas que tenía que tratar con cautela supersticiosa. No puedes cambiar con seguridad lo que no entiendes, y resulta que es facilísimo no llegar a entender algo que escribiste con tus propias manos, sencillamente porque no anotaste por qué.

La documentación es una carta a un extraño

El cambio de enfoque que finalmente lo hizo encajar fue dejar de pensar en las notas como algo para mí, en algún sentido vago e intemporal, y empezar a pensar en ellas como una carta a una persona desconocida concreta: la versión futura de mí que aterrizará en este código sin nada de mi contexto presente, sin nada de mi razonamiento reciente, y con la cabeza llena de problemas completamente distintos.

Esa persona merece algo mejor que lo que yo le estaba dejando. Cuando escribo para ella con generosidad —explicando qué estaba pensando, por qué elegí esto en lugar de aquello, con qué hay que tener cuidado— estoy haciendo una de las cosas más amables y prácticas que están a mi alcance. Y cuando no le dejo nada, le estoy tendiendo una emboscada a alguien que, en todo lo que importa, está de mi lado. Anotar las cosas dejó de sentirse como burocracia y empezó a sentirse como simple decencia hacia alguien en quien inevitablemente me convertiré.

Escribe el porqué, no el qué

La disciplina no consiste en documentarlo todo, que quede claro. Narrar amorosamente lo obvio es su propia clase de ruido, y un comentario que se limita a repetir lo que el código hace de forma evidente es peor que nada, porque añade desorden y tiende a quedar desactualizado. La sobredocumentación entierra la señal con la misma seguridad con que la subdocumentación la deja famélica.

Lo que merece la pena capturar es precisamente la parte que no sobrevivirá por sí sola: el porqué. El razonamiento. La alternativa que consideraste y rechazaste, y por qué la rechazaste. La restricción nada evidente que forzó una elección fea. Aquello que más adelante parecerá un error a quien haya olvidado el contexto, sobre todo cuando ese alguien eres tú. Una sola frase honesta de “porqué” vale muy a menudo más que páginas de “qué”, porque el qué nunca fue la parte que corría peligro de perderse.

La lección más profunda: tu contexto no es duradero

Por debajo de todo está el error que más necesitaba corregir: había creído, sin examinar nunca esa creencia, que mi comprensión presente simplemente persistiría. No lo hace. Todo lo que ahora mismo se siente cristalino en tu cabeza está siendo borrado en silencio, un poco cada día, y la única forma de comprensión que de verdad perdura es la que externalizas: la sacas de tu cabeza y la pones en algo que sobrevivirá a la memoria.

Así que ahora intento tratar mi claridad actual exactamente por lo que es: un recurso perecedero, vívido hoy y desaparecido para el próximo trimestre. Mientras existe, intento anotarla, no porque dude de mi memoria en abstracto, sino porque he conocido a la persona desconocida que hereda mi olvido, y le debo más de lo que solía dar. Al fin y al cabo, va a ser yo mismo.

— Sin señales, sin rendimientos, esto no es asesoramiento de inversión.