Biblioteca · Repositório

safishamsi/graphify

Métodos, contexto e grafos de conhecimento · Python · MIT

É uma ferramenta que transforma uma pasta de código, planilhas e documentos num mapa visual navegável de como tudo se conecta. Em vez de ler arquivo por arquivo, você enxerga a arquitetura e as relações de uma vez.

O que é, em uma frase honesta

Graphify é uma habilidade para assistentes de IA que converte um projeto inteiro num grafo de conhecimento consultável. Você aponta para uma pasta, e ele transforma código, scripts, esquemas de banco, documentos, até imagens e vídeos, num mapa de relações que dá para explorar e perguntar. Entrega três coisas: uma visualização em HTML, um relatório com os conceitos-chave, e um grafo em JSON para consulta.

Funciona acoplado a várias ferramentas de IA de código, como Claude Code, Cursor e outras.

Para que serve na prática

Serve para entender rápido um sistema que ninguém mais domina por inteiro. Aquele software legado que só um veterano entendia, a base que cresceu sem documentação, o emaranhado de scripts e planilhas: o Graphify mapeia as conexões, aponta o que depende do quê e até analisa o impacto de uma mudança antes de você fazê-la. Cobre dezenas de linguagens e tipos de arquivo, então não é só para código puro.

O caso típico é onboarding de gente nova, auditoria de um sistema herdado, ou decisão de mexer numa peça sem saber o que ela derruba.

Quando faz sentido pra você que lidera

Faz sentido quando o conhecimento da sua operação está preso na cabeça de poucas pessoas e isso virou risco. Tornar visível a arquitetura de um sistema é tornar discutível uma decisão que antes só o especialista podia tomar: você sai da posição de aprovar mudanças no escuro. Use como ferramenta de redução de dependência e de due diligence técnica, por exemplo antes de uma aquisição ou de uma grande refatoração.

O ganho é transformar caixa-preta em mapa que mais gente consegue ler.

Por que está no mapa

Porque ataca um problema caro e universal: ninguém entende o sistema inteiro, e isso trava decisão e cria dependência de pessoas-chave. Transformar código e documentos em mapa navegável é o tipo de alavanca que muda quem consegue opinar sobre arquitetura. Está no mapa como exemplo de IA que não escreve nem executa, mas explica, e explicar bem é metade do trabalho de liderança técnica.

Ver no GitHub →
O que você achou desta página?
Recomendaria esta página para alguém do seu time?