Você Está Sentado em Cima de um Tesouro de Conhecimento e Nem Sabe
O Repositório Esconde Mais Conhecimento do Que Você Imagina
Aqui vai algo que deveria deixar qualquer CTO ou desenvolvedor sênior desconfortável: a compreensão mais sofisticada do seu negócio provavelmente mora em lugar nenhum além do código em produção.
Um artigo recente da equipe do ServiceMatch explora uma ideia provocadora. Eles argumentam que sistemas de software maduros não são apenas ferramentas que executam seu negócio — são representações executáveis de tudo o que a organização aprendeu sobre esse negócio. O problema? Esse conhecimento tem estado escondido à vista de todos, trancado dentro de repositórios que só eram lidos por compiladores e (ocasionalmente) humanos.
O Mito da Documentação
Todos já passamos por isso. Um novo desenvolvedor entra na equipe e recebe uma parede de páginas no Confluence, registros de decisões de arquitetura e entradas de Wiki. "Isso vai te colocar a par," alguém diz com otimismo.
Não vai.
A documentação captura o que alguém achou que valia a pena escrever, em um momento no tempo que pode ter sido anos atrás. Ela perde os casos de borda. Perde as discussões que aconteceram em reuniões e moldaram decisões. Perde a lógica de negócio que evoluiu através de milhares de commits, cada um wrestlando com um cenário do mundo real.
Segundo o argumento de Peter Naur em 1985 (sim, o mesmo Naur que nos deu a notação de Backus-Naur), a documentação de programas nunca pode capturar completamente a "teoria" por trás de um sistema. O entendimento real mora nas cabeças das pessoas. Quando essas pessoas saem, a teoria sai com elas.
Mas é aqui que as coisas ficam interessantes.
IA Muda o Problema do Leitor
O argumento de Naur era sobre dois tipos de leitores: compiladores (que executam código sem entendê-lo) e humanos (que o entendem de forma lenta e cara). A impossibilidade de recuperação da documentação assumia que nenhum outro tipo de leitor existia.
Modelos de linguagem grandes são um terceiro tipo de leitor. E eles são surpreendentemente bons em reconstruir as teorias implícitas embutidas no código.
O sistema ServiceMatch fornece evidências convincentes. A plataforma CMDB deles codifica conhecimento de gestão de configuração empresarial que preencheria volumes se fosse escrito como prosa. Mas aqui está o ponto — já está escrito, só que não em prosa. Está em código.
Considere a lógica de resolução de identidade. Em vez de um ensaio de consultor sobre "como funciona a identidade de dispositivos," eles têm um arquivo de configuração com pesos: número de série (25), hostname (25), etiqueta de ativo (25), endereço IP (20), endereço MAC (15). Além de limites de confiança e regras de resolução de conflitos. Cada número representa um argumento que alguém venceu. Cada tipo de conflito representa um incidente real que aconteceu em algum lugar.
Isso não é uma descrição da política. ISSO é a política, rodando todas as noites contra frotas reais de empresas.
O Que Isso Significa Para Sua Equipe
Para desenvolvedores e líderes técnicos, esta pesquisa tem implicações práticas:
Seu código é documentação que você não tem mantido — e isso tem suas próprias vantagens. Diferente de páginas wiki datadas, código que roda em produção é constantemente validado. Se a documentação discordar do código, a documentação está errada.
Ferramentas de IA estão ficando melhores em extrair esse conhecimento. Estamos caminhando para um mundo onde perguntar a uma IA sobre "como lidamos com conflitos de identidade de dispositivos" poderia retornar não apenas documentação, mas o raciocínio real codificado nos pesos e limites.
O conhecimento real mora nos casos de borda. Os fluxos principais geralmente são bem documentados. É o tratamento especial, as exceções, os casos extremos resolvidos ao longo de anos que contêm o conhecimento institucional profundo.
O Sinal de Alerta
Há um corolário desconfortável em tudo isso: se sua lógica de negócio está apenas no seu código, e seu código tem cobertura de testes fraca, nomenclatura confusa ou estrutura caótica, você está sentado em cima de um monte de conhecimento quase impossível de extrair.
A equipe do ServiceMatch descobriu que aclaim deles — que "o repositório basta" — se quebra de formas previsíveis. O resíduo tácito de Naur é real. Algum conhecimento genuinamente só mora nas cabeças das pessoas.
Mas a descoberta mais forte é que mais sobrevive no código do que pensávamos ser possível. O repositório captura muito mais teoria do que a documentação jamais poderia — só precisávamos de um novo tipo de leitor para extraí-la.
O Que Fazer Com Isso
Se você é uma startup ou empresa de tecnologia em crescimento, aqui vai um framework para pensar sobre isso:
- Confie mais no seu código do que nos seus docs quando os dois discordarem
- Escreva código que documenta seu raciocínio — nomes de variáveis significativos, funções claras, comentários que explicam POR QUÊ, não apenas O QUÊ
- Trate configuração como conhecimento institucional — esses pesos e limites são decisões que valem a pena preservar
- Comece a explorar ferramentas de IA que possam interrogar seu codebase como fonte de conhecimento
O código que você escreve hoje é o conhecimento institucional de amanhã. Faça valer a pena.