Eu rodo agentes autônomos de código no meu projeto. Código limpo. Testes passam. PRs mergeados.

Mas às vezes abro um arquivo e não faço ideia de por que foi construído daquele jeito. O agente decidiu. Eu só aprovei.

Isso tem nome: dívida cognitiva. O código tá ótimo. O entendimento nunca chegou na sua cabeça.

O que eu mudei: todo PR agora documenta não só o que mudou, mas por quê. Pro eu do futuro.

Cognitive Debt: The Real Cost of AI-Generated Code

The agent solved the problem. The theory stayed in the prompt, not in my head. AI already knows the WHAT. Your job is to preserve the WHY.

LEO CARDZ