Dívida de Intenção: A Terceira Dívida Que Seus Agentes Não Pagam

Addy Osmani publicou esta semana um texto que completa um modelo que a indústria vinha montando em partes. Margaret-Anne Storey nos deu a dívida cognitiva: a erosão do entendimento compartilhado sobre por que um sistema funciona como funciona. Osmani acrescenta a terceira perna do que chama de Modelo da Tripla Dívida de Storey. Ao lado da dívida técnica e da dívida cognitiva, existe a dívida de intenção: o porquê não escrito, e já corroído, por trás do próprio código.

A distinção importa por causa de uma propriedade exclusiva dessa terceira dívida. A dívida técnica e a dívida cognitiva podem ser pagas pelos agentes que hoje escrevem a maior parte do código. A dívida de intenção, não. Ela é o único insumo que precisa vir de um humano, toda vez, ou simplesmente não existe.

O Que É a Dívida de Intenção

A definição de Osmani é precisa. Intenção é o objetivo, a restrição, a razão que estava na cabeça de alguém quando uma decisão foi tomada. Por que esta arquitetura e não a alternativa óbvia. Por que este serviço espera por aquele outro. Por que um campo que parece redundante sustenta uma regra de conformidade que ninguém documentou.

Quando esse raciocínio fica na cabeça de alguém, ou numa thread de Slack, ou na memória de uma reunião que aconteceu oito meses atrás, o código carrega a decisão, mas não a razão dela. O comportamento é preservado. A intenção é perdida. Essa perda é a dívida.

Isso soa próximo da dívida cognitiva, e é, mas as duas não são a mesma coisa. Dívida cognitiva é a erosão do entendimento compartilhado por um time. Dívida de intenção é mais específica: é a ausência do raciocínio original como artefato escrito. Você pode ter um time que entende um sistema de modo geral (dívida cognitiva baixa) e ainda assim não ter registro nenhum de por que uma decisão crítica foi tomada (dívida de intenção alta). A primeira é sobre compreensão distribuída. A segunda é sobre um registro recuperável.

Por Que os Agentes Não Pagam Essa Dívida

Aqui está o fato estrutural que torna a dívida de intenção diferente das outras duas. Osmani coloca de forma direta: agentes começam toda sessão do zero.

Um engenheiro humano acumula contexto ao longo de meses. Ele estava na sala. Lembra do debate que produziu a decisão. Um agente não tem nada disso. Ele abre uma sessão com o que está escrito e nada mais. Tudo que não foi externalizado em um artefato legível simplesmente não existe para ele.

Agora acompanhe o que cada dívida significa sob essa restrição.

A dívida técnica vive no código. Um agente lê o código, enxerga a duplicação ou o acoplamento frágil, e refatora. Agentes pagam dívida técnica rotineiramente; é uma das coisas que fazem melhor.

A dívida cognitiva vive na distância entre código e entendimento. Aqui o agente também ajuda. Ele lê um módulo emaranhado, explica o que faz, gera documentação e reconstrói um modelo mental funcional a partir do artefato à sua frente. O entendimento é recuperável a partir do código, porque o código é a fonte da verdade sobre o comportamento.

A dívida de intenção é diferente em natureza. O porquê não está no código. O código registra qual foi a decisão, nunca por que ela foi escolhida em vez da alternativa. Um agente lendo o código não consegue recuperar a intenção, porque a intenção nunca esteve lá para ser recuperada. Então o agente faz a única coisa que pode: fabrica uma razão plausível. Ele infere uma intenção que combina com o comportamento visível, segue em frente com confiança, e às vezes erra de forma catastrófica, porque a razão real era uma restrição que ele não tinha como enxergar.

Essa é a assimetria. Para a dívida técnica e a cognitiva, o código basta como fonte para o agente fazer reparo de verdade. Para a dívida de intenção, a fonte era uma mente humana, e se essa mente nunca escreveu nada, não há o que o agente recupere. Ele só pode adivinhar.

Plausível-Mas-Errado É o Modo de Falha

O perigo da dívida de intenção não é o agente travar. É o agente não travar. Ele produz uma resposta confiante construída sobre uma justificativa inventada.

Um time remove o que parece uma etapa de validação redundante, porque nenhum comentário a explica. O agente concorda: a validação é inalcançável, o dado já vem limpo da origem, remover simplifica o fluxo. Cada parte desse raciocínio está localmente correta. Também está errada, porque a validação existia para capturar um payload malformado de uma integração parceira que dispara duas vezes por ano. A intenção era real. Só nunca foi escrita. O agente não conseguia vê-la, então reconstruiu uma história que combinava com tudo que era visível, e a história era plausível e errada.

É por isso que a dívida de intenção é mais perigosa do que parece. Ela não se manifesta como erro. Manifesta-se como uma mudança confiante, limpa e bem fundamentada que silenciosamente viola uma restrição que ninguém registrou. A verificação passa. Os testes passam. A razão de existir se foi, e com ela a proteção que oferecia.

Externalizar Intenção É um Ato de Governança

Se a intenção é o único insumo que só um humano pode fornecer, então escrevê-la deixa de ser higiene e vira função de governança. É a camada de autoridade humana tornada durável. A decisão que uma pessoa tomou, e a razão por trás dela, capturadas numa forma que um agente lendo do zero consegue de fato usar.

Osmani aponta os mecanismos, e eles não são exóticos. Um arquivo AGENTS.md que funciona como um livro-razão de intenção: não uma lista de comandos, mas um registro das restrições e razões que governam o código, as coisas que um agente precisa saber antes de tocar em qualquer coisa. Registros de decisão arquitetural que capturam não só o que foi escolhido, mas o que foi rejeitado e por quê. Especificações com uma definição explícita de pronto, para que o objetivo fique fixado por escrito antes de o agente começar a inferi-lo.

O fio comum é que cada um tira a intenção da cabeça de um humano e a coloca num artefato. É esse o movimento inteiro. Intenção que vive só numa pessoa é invisível para todo agente e se corrói a cada saída de funcionário e a cada reunião esquecida. Intenção escrita num artefato legível é dívida paga: visível, durável e utilizável pelo próximo agente que começa do zero.

Isso reformula o trabalho. Escrever o porquê não é custo de documentação competindo por tempo com a entrega. É o ato de manter as decisões sob autoridade humana depois que os agentes passam a implementar. O time que externaliza intenção está governando seus agentes. O time que não externaliza está delegando o porquê a qualquer coisa que o agente decida inventar.

Faça Isto Agora

Escolha as três decisões mais consequentes do seu sistema atual, aquelas em que reverter sairia caro ou perigoso, e faça uma pergunta sobre cada uma: se um agente começasse do zero amanhã, ele conseguiria recuperar a razão pela qual isto foi feito? Se a resposta é não, essa decisão é dívida de intenção sentada no balanço. Escreva a razão, num livro-razão AGENTS.md ou num ADR, incluindo a alternativa que você rejeitou e por quê. Você acabou de pagar a única dívida que seus agentes nunca conseguiriam.

---

Fontes

• Addy Osmani. “The Intent Debt.” Junho de 2026.

A Victorino ajuda times a externalizar intenção em artefatos de governança que os agentes conseguem ler: contato@victorino.com.br | www.victorino.com.br