Ideia principal

O Graphify, uma ferramenta que transforma um repositório de código em grafo de conhecimento, encadeia duas etapas: uma construção, em que uma IA lê cada arquivo para deduzir os elementos e suas relações, e depois uma exploração — divisão em grupos, mapa interativo, relatório, busca de caminhos. A segunda etapa não lê os arquivos: ela lê um grafo no formato padrão da biblioteca NetworkX, e não verifica de onde ele vem.

Essa indiferença à origem divide a ferramenta em duas partes separáveis. Dá para manter a exploração e trocar a construção por qualquer produtor do mesmo formato: um script de 160 linhas que lê os links internos de um wiki do Obsidian basta para alimentar toda a parte seguinte da cadeia, sem chave de API.

O ponto de encaixe não é escolhido ao acaso: é o formato de troca entre as etapas, e é exatamente ali que a etapa mais cara entrega o seu resultado.

Por que isso importa

Isso dá uma forma de ler uma ferramenta antes de adotá-la ou descartá-la: procurar o formato que circula entre as etapas. Uma ferramenta feita para outro uso vira reaproveitável assim que você sabe produzir, por outro caminho, o que a etapa anterior produzia.

Isso também desloca a questão do custo. O que você paga numa ferramenta assim não é a ferramenta inteira, é a etapa que você não sabe substituir.

Nuances e limites

Um formato aceito não é um formato compreendido. A ferramenta continua esperando o que a etapa original produzia: com notas, ela emite 12 884 avisos porque os links não têm arquivo de origem, uma noção que só faz sentido para código. O uso alternativo funciona, mas à margem do contrato implícito da ferramenta, e uma atualização pode quebrá-lo sem aviso.

Questões em aberto

• Uma etapa posterior que nunca foi testada com um grafo vindo de fora produz resultados errados sem avisar, ou apenas avisos?