Qualidade da documentação agora define a qualidade da sua IA

O argumento central do texto de Ben Balter, publicado em 26 de outubro de 2026, é que ferramentas de IA só recuperam contexto útil quando o documento declara sua estrutura. Em Markdown, ## Deprecating the v1 API diz que aquilo é um título de segundo nível. No Word, o estilo Heading 2 faz o mesmo, mas o editor também deixa o autor apenas aumentar e engrossar a fonte. Para quem lê, os dois parecem iguais. Para um leitor de tela ou um modelo de linguagem, não. Na demonstração do autor, a versão com estilos virou um título e uma lista numerada no word2md. A versão formatada à mão virou uma frase em negrito e dois parágrafos que só começam com número.

Tabelas sofrem mais. Ao passar o mesmo arquivo pelo conversor de texto do macOS (textutil -convert txt), a tabela de três colunas virou doze linhas, uma célula por linha, sem ligação entre o 15 e sua coluna. Um .docx é um pacote XML zipado, feito para um aplicativo reabri-lo. Em 2014, a mesma amostra tinha 33.621 bytes em Word, 1.359 em HTML e 80 em Markdown. O autor lembra que janelas de contexto hoje são grandes, mas cita o estudo "Lost in the Middle" (Liu et al.), segundo o qual modelos usam a informação de forma menos confiável quando ela fica no meio de entradas longas.

O ciclo de ida e volta tem perdas. O word2md descarta comentários e aceita em silêncio todas as alterações rastreadas: em um teste, "Full-time employees" virou "All employees" sem qualquer marca. A recomendação é resolver comentários e revisar no Word antes de converter, e depois comparar com a fonte. O texto também lista o uso de npx word-to-markdown input.docx, o md2word.app para o caminho inverso, servidores MCP para agentes e arquivos como AGENTS.md e CLAUDE.md mantidos em Markdown no repositório.

A tese conversa com o que o CEVIU já vinha cobrindo. Em 5 de outubro de 2026, o CEVIU noticiou "Agentes de IA: Por que documentação estruturada supera a memória tradicional", que apontava falhas de atualidade e relevância em sistemas de vector-search usados como memória. Em 12 de junho de 2026, "Como preparar seu design system para IA" já defendia documentação clara e estruturada para resultados melhores. Agora a discussão desce ao formato do arquivo: cabeçalhos reais, listas nativas e uma única cópia viva, e não só a existência de documentação.

Para quem desenvolve, a leitura é que documentação virou entrada de pipeline. Se o README, o runbook ou a política interna estão em .docx com títulos feitos na mão, o assistente que você aponta para eles via MCP ou indexação do repositório recebe ruído. Manter a fonte em Markdown sob controle de versão, com diff revisável, é uma melhora barata. Quem converte legado precisa conferir a saída, porque comentários e revisões podem sumir sem aviso.