O Meu Eu do Futuro Era um Estranho que Herdou a Minha Bagunça

A pessoa que mais me deu trabalho em todo este projeto é um estranho que vive herdando o meu trabalho e não tem a menor ideia do porquê de nada estar do jeito que está. Esse eu do futuro abre arquivos que escrevi, encara decisões que tomei e não consegue reconstruir o que eu estava pensando, por mais que se esforce. O estranho, claro, sou eu — só que alguns meses depois.

Eu costumava encarar a documentação como uma tarefa chata feita para equipes, algo que você faz para que outras pessoas entendam o seu trabalho. Levei muito tempo para perceber que a pessoa mais importante para quem eu estava escrevendo era uma versão futura de mim mesmo, que não compartilharia nada do meu contexto atual e que ficaria silenciosamente furiosa com o quão pouco eu me dei ao trabalho de deixar registrado.

A ilusão de que você vai lembrar

A raiz do problema é uma ilusão muito convincente. Quando você toma uma decisão, o raciocínio por trás dela é vívido, óbvio e presente. Toda a teia de considerações — o que você estava tentando alcançar, o que você acabara de descartar, qual restrição forçou a sua mão — está bem ali na sua mente, viva e completa. Naquele momento, é genuinamente impossível imaginar algum dia esquecê-la. Claro que você vai lembrar por que fez isso. É óbvio.

Então você não anota. Por que anotaria? E é exatamente aí que está a armadilha, porque o contexto evapora de forma espantosamente, quase violentamente, rápida. A rica teia de raciocínio que fez uma escolha parecer inevitável se dissolve em semanas, e o que ela deixa para trás é uma escolha nua, ali parada, sem nenhuma razão visível associada a ela.

Voltar como um estranho ao meu próprio trabalho

Então, meses depois, eu abria o meu próprio código e me deparava com decisões que eu simplesmente não conseguia explicar. Por que isso foi feito exatamente desta forma? Por que este valor específico e não outro? Por que esta ordem, esta exceção estranha, este desvio desajeitado? Alguma versão passada de mim havia sabido a resposta com total clareza. A versão presente havia herdado apenas a conclusão, com todo o raciocínio arrancado.

É uma sensação genuinamente desorientadora — ser um estranho no seu próprio trabalho, desconfiar das escolhas de alguém que você não pode interrogar e que, por acaso, é você mesmo. É como receber a última linha de uma longa demonstração com cada passo que levou até ela apagado. A resposta está bem ali. Você só não tem como saber se deve confiar nela, ou o que quebraria se você a mudasse.

O “o quê” está visível; o “porquê” desapareceu

Aqui está a assimetria que eu havia subestimado por completo. O código é excelente em registrar o que você fez. Ele é, por natureza, um registro preciso das ações tomadas. Mas ele quase nunca registra por que você as fez, e o porquê é ao mesmo tempo a coisa mais difícil de reconstruir e a mais importante de preservar.

O “o quê” eu sempre consigo recuperar, porque está ali bem na minha frente para ser relido. O porquê — a intenção, as alternativas rejeitadas, a razão específica pela qual esta forma estranha era necessária — desaparece no instante em que deixa a minha cabeça, a menos que eu tenha feito o esforço deliberado de capturá-lo. E sem o porquê, o “o quê” é quase inútil para a única coisa que eu de fato preciso fazer, que é decidir se e como mudá-lo. Um registro de decisões sem um registro das razões é um mapa com todos os rótulos apagados.

Decisões não documentadas se tornam intocáveis

A consequência mais insidiosa é o que acontece com uma escolha cuja razão foi esquecida. Ela se torna estrutural de um jeito que você não consegue avaliar. Você não sabe por que ela está ali, o que significa que você não sabe o que depende dela, o que significa que você passa a ter medo de mexer nela. E assim ela se cristaliza — não porque é boa, mas porque é misteriosa.

Um sistema vai aos poucos se enchendo desses pequenos mistérios congelados: decisões que todos, inclusive o próprio autor, agora têm nervosismo demais para perturbar. A ironia cruel é que fui eu mesmo que os construí, e o meu próprio esquecimento os transformou em coisas que eu tinha de tratar com cautela supersticiosa. Você não pode mudar com segurança aquilo que não entende, e acontece que é muito fácil deixar de entender algo que você escreveu com as próprias mãos, simplesmente porque você não anotou o porquê.

Documentação é uma carta a um estranho

A reformulação que finalmente fez a ficha cair foi parar de pensar nas anotações como sendo para mim, em algum sentido vago e atemporal, e começar a pensar nelas como uma carta a um estranho específico: a versão futura de mim que vai aterrissar neste código sem nada do meu contexto presente, sem nada do meu raciocínio fresco, e com a cabeça cheia de problemas completamente diferentes.

Esse estranho merece coisa melhor do que aquilo que eu vinha deixando. Quando escrevo para essa pessoa com generosidade — explicando o que eu estava pensando, por que escolhi isto em vez daquilo, com o que tomar cuidado — estou fazendo uma das coisas mais gentis e práticas ao meu alcance. E quando não deixo nada, estou armando uma emboscada para alguém que está, em tudo o que importa, do meu lado. Anotar as coisas deixou de parecer burocracia e passou a parecer simples decência para com alguém em quem eu inevitavelmente vou me tornar.

Escreva o porquê, não o quê

A disciplina não é documentar tudo, que fique claro. Narrar carinhosamente o óbvio é um tipo de ruído por si só, e um comentário que apenas reafirma o que o código claramente faz é pior do que nada, porque adiciona desordem e tende a ficar desatualizado. A documentação em excesso enterra o sinal com a mesma certeza com que a documentação de menos o deixa à míngua.

O que vale a pena capturar é precisamente a parte que não sobreviverá por conta própria: o porquê. O raciocínio. A alternativa que você considerou e rejeitou, e por que a rejeitou. A restrição não óbvia que forçou uma escolha feia. A coisa que mais tarde parecerá um erro a alguém que esqueceu o contexto — especialmente quando esse alguém é você. Uma única frase honesta de “porquê” muitas vezes vale mais do que páginas de “o quê”, porque o “o quê” nunca foi a parte em risco de se perder.

A lição mais profunda: o seu contexto não é durável

Por baixo de tudo isso está o erro que eu mais precisava corrigir: eu acreditava, sem nunca ter examinado essa crença, que o meu entendimento presente simplesmente persistiria. Ele não persiste. Tudo o que parece cristalino na sua cabeça agora está sendo silenciosamente apagado, um pouco a cada dia, e a única forma de entendimento que de fato perdura é a forma que você externaliza — tira da cabeça e coloca em algo que sobreviverá à memória.

Então agora eu tento tratar a minha clareza atual exatamente pelo que ela é: um recurso perecível, vívido hoje e desaparecido no próximo trimestre. Enquanto ela existe, eu tento anotá-la, não porque duvide da minha memória em abstrato, mas porque eu conheci o estranho que herda o meu esquecimento, e devo a essa pessoa mais do que eu costumava dar. Afinal, essa pessoa vai ser eu.

— Sem sinais, sem retornos, isto não é aconselhamento de investimento.