O agente conclui o ticket, abre o pull request e passa nos testes. Dias depois, alguém tenta operar, revisar ou evoluir o sistema e descobre que a decisão ficou apenas no diff. O problema não é falta de texto: é conhecimento crítico deixar de acompanhar a mudança que o tornou necessário.
29.669 PRs, 2.585 repositórios e uma medida simples
Pesquisadores da Monash University analisaram 29.669 pull requests atribuídos a cinco agentes no conjunto AIDev, cobrindo contribuições entre dezembro de 2024 e agosto de 2025. A medida foi coalteração: um PR que modificou pelo menos um arquivo de código também modificou algum arquivo classificado como documentação? Em 18.751 PRs, ou 63,2% da amostra, a resposta foi não; 10.918 coalteraram documentação [1][2].
A taxa variou por tipo de tarefa: 55,2% das mudanças classificadas como feature e 77,5% das classificadas como refactor não coalteraram documentação. Entre agentes, o intervalo reportado foi de 48,1% a 72,8%. Isso mostra heterogeneidade; não autoriza transformar 63,2% em uma constante universal [1][2].
Ausência de coalteração não prova documentação incorreta
O próprio paper trata a métrica como proxy. Um refactor interno pode não exigir documentação; um CHANGELOG sem relação com o código pode contar como coalteração; comentários, docstrings, wikis e portais externos não aparecem no método. Portanto, o estudo mede presença de mudança documental no mesmo PR — não consistência semântica nem qualidade do conhecimento.
Arquivos sem documentação associaram-se a mais correções posteriores
As análises posteriores usaram 19.881 PRs mesclados de 1.513 repositórios, com 177.743 alterações de arquivos de código e 4.526 PRs classificados como correção. Após controlar a exposição pelo tamanho, arquivos alterados sem coalteração documental foram tocados por uma correção posterior 8,6% a 11,7% mais vezes nas janelas de 30 a 90 dias [1][2].
A associação é temporal, não causal. A correção posterior pode tratar um defeito antigo, uma intervenção intermediária ou outro aspecto do mesmo arquivo. Os autores também não controlaram todos os fatores possíveis, como complexidade, fluxo do repositório e tipo de tarefa em todas as análises. O dado é um sinal para investigação, não a prova de que a falta de documentação causou o bug.
O conhecimento que não acompanha a mudança tende a continuar atrasado
Dentro de 90 dias, arquivos previamente alterados sem documentação voltaram a aparecer em um PR com documentação em cerca de 24% dos casos; entre os que já haviam sido coalterados, a taxa foi 48%. A métrica não prova que uma dívida específica foi paga, mas enfraquece a ideia de que a equipe poderá documentar tudo depois [1][2].
O contrato de conhecimento que precisa acompanhar o código
- Classifique a mudança: comportamento público, integração, dado, segurança, operação e decisão arquitetural exigem evidências diferentes.
- Inclua documentação, runbook, observabilidade, migração e rollback nos critérios de aceite quando forem afetados.
- Peça ao agente para localizar conhecimento impactado antes de editar, não apenas gerar texto ao final.
- Valide semanticamente se a explicação corresponde ao comportamento entregue; presença de um arquivo alterado não basta.
- Registre por que uma mudança não exige documentação, em vez de tratar silêncio como decisão implícita.
- Monitore dívida por domínio e criticidade, não apenas quantidade de páginas ou cobertura genérica.
Limites, conflito de interesse e contraponto
- O conjunto cobre projetos open source e um período encerrado em agosto de 2025; agentes, modelos e fluxos mudaram desde então.
- A amostra é desequilibrada: Codex responde por 65,8% dos PRs e Claude Code por 1,4%.
- Não existe baseline humano com a mesma granularidade; não é possível afirmar que agentes documentam pior do que pessoas.
- As janelas de acompanhamento são censuradas à direita e podem subestimar eventos posteriores.
- Os autores são afiliados à Monash University; não identificamos interesse comercial direto declarado nem resposta específica de fornecedores até o corte editorial.
- O paper foi aceito como Early Research Achievement no APSEC 2026 e disponibiliza scripts de classificação e análise, mas não localizamos replicação independente completa.
A regra prática: o merge precisa carregar memória operacional
Quando a IA aumenta a quantidade e a velocidade das mudanças, a empresa precisa aumentar também a capacidade de preservar contexto. Código, decisão e operação são partes do mesmo produto. Se apenas o primeiro chega ao repositório, a automação entrega hoje e transfere o custo para quem precisar entender amanhã.
Nota editorial e de responsabilidade
Números, população, período, método, afiliações e limitações foram atribuídos às fontes diretas. O artigo separa resultados reportados pelos pesquisadores de interpretação editorial e recomendações profissionais. Pontos de vista pessoais e profissionais do autor não são fatos universais nem garantia de resultado. O conteúdo é informativo e não substitui avaliação técnica, jurídica, regulatória, financeira ou de segurança. Autores, instituições, agentes e produtos citados pertencem aos respectivos titulares; não há patrocínio ou endosso. Tech Human e Trustyu atuam comercialmente em desenvolvimento e governança de produtos digitais. Pesquisa, estrutura e redação tiveram assistência de IA; revisão factual, aprovação autoral e autorização de publicação foram confirmadas por Fernando Parreiras em 21/10/2026, sem revisão humana independente adicional. Este paper permanece em acompanhamento e o artigo poderá receber correções se surgirem nova versão, replicação ou contestação relevante.