Dívida de intenção: o custo oculto da falta de documentação no desenvolvimento de software

A dívida de intenção não é um novo tipo de débito técnico, é uma falha estrutural antiga que agora se tornou crítica por causa da IA. Diferente da dívida técnica clássica (código mal escrito, testes ausentes), ela nasce da ausência de registros humanos sobre o 'porquê' das decisões: por que aquele endpoint foi feito assim, por que a regra de negócio ignora o caso X, por que o fallback foi implementado com delay de 3s. Agentes de IA não inferem intenção; eles replicam padrões. Quando não há documentação explícita da lógica de negócios ou dos trade-offs tomados, os agentes geram soluções que parecem corretas tecnicamente, mas violam restrições invisíveis, como compliance, SLA ou acordos contratuais. Isso já foi observado em casos reais de equipes que usaram agentes para manutenção de sistemas financeiros legados: sem histórico de decisões, os modelos otimizaram performance e quebraram auditorias.

O CEVIU já havia apontado, em 26 de maio, que a memória organizacional é o ativo mais valioso para agentes, mas memória só funciona se for estruturada, versionada e acessível. A dívida de intenção é exatamente o vácuo entre o que está no código e o que está na cabeça de quem decidiu. E, ao contrário do que muitos imaginam, não se resolve com mais prompts: se o contexto de decisão não foi registrado, nenhum modelo consegue recuperá-lo.

Em 3 de junho, o CEVIU destacou os riscos de segurança e dependências caóticas trazidos por agentes, mas tratava de dívida técnica *operacional*. Agora, a dívida de intenção é um salto conceitual: não é sobre o que o sistema faz, mas sobre o que ele *não deveria fazer*, e por quê. O artigo de 8 de maio já sinalizava que convenções implícitas são incompatíveis com IA, mas não nomeava o problema como 'dívida de intenção'. Esse termo, embora usado em círculos acadêmicos desde 2022, só ganhou peso prático agora, com relatos de equipes que tiveram de reescrever 40% do código gerado por agentes após descobrir que decisões críticas (ex.: não validar CPF em certa etapa por restrição legal) nunca tinham sido documentadas.

Porque a dívida de intenção é invisível até que algo quebre, e quando quebra, quebra em produção, com impacto regulatório ou financeiro real. Equipes que adotam agentes sem mapear intenções primeiro estão trocando velocidade inicial por custos de retrabalho exponenciais. Não é questão de ferramenta ou prompt melhor: é questão de processo. Documentar intenção não é burocracia, é criar o 'mapa de guerra' que os agentes precisam para não invadir território proibido. Sem isso, cada sprint com IA vira uma loteria de conformidade.