Transforma um repositório inteiro (código, docs, PDFs, áudio, vídeo) num grafo de conhecimento consultável. Em vez de varrer arquivo por arquivo (grep/ctrl+F cegos queimando tokens e errando), o agente consulta o mapa.
Quando Ativar (gatilhos literais)
- "Graphify esse repo"
- "Como X conecta com Y no código?"
- "Mapa do repositório antes de mexer"
- "Onboarding nesse projeto herdado"
- "Resposta queimando token demais"
Exemplo
/graphify explain "como o login chega na tabela users?"
→ form → POST /login → authService → users(id)
1. Quando usar
- Perguntas sobre projeto grande: "como o login conecta com a tabela de usuários?" (cadeia form → endpoint → serviço → tabela).
- Onboarding em projeto novo ou herdado.
- Respostas com alucinação porque o agente não viu as conexões reais.
- Economizar tokens em consultas frequentes sobre a mesma base.
2. RAG vetorial vs grafo (tradeoff)
| RAG vetorial | Grafo | |
|---|---|---|
| Responde | "o que é parecido" | "como as coisas se conectam" |
| Ideal | Textos soltos por tema | Arquitetura/dependências |
| Mudança | Re-embeda TUDO de novo | Grafo vivo: atualiza só o que mudou |
3. Instalação/uso
- Open source, MIT, ~70k★ (
graphifyno GitHub). Funciona com qualquer agente. - Vem com skill embutida que ensina o próprio Claude a usar.
- Comandos principais:
/graphify(indexa o diretório),/graphify explain(consulta o grafo),/graphify claude install(fica sempre ligado, consulta o grafo em toda pergunta), flag Obsidian (/graphify obsidian). - 3 camadas de indexação: estrutura de código (determinística, sem LLM) → áudio/vídeo (whisper) → docs/imagens (semântica com LLM).
3b. Alternativa GRAFT (Batch 17f, #72)
GRAFT (open source, MIT): code graph via tree-sitter (structural layer,
sem AI key, sem DB server, .graft/ gitignored) + optional AI deep
build (summaries + concept nodes, custa tokens). Mesmo trabalho do
graphify para perguntas de estrutura; escolha um grafo por repo.
Fonte: video VW58Q8c5F0I (demo via Verdant).
4. Processo
- Confirme que o repo está indexado (ou rode
/graphify). - Para perguntas de conexão/arquitetura: force consulta ao grafo ("olhe o grafo antes de responder").
- Entregue a resposta com o caminho das conexões (nó → aresta → nó).
- Se o código mudou muito, re-indexe (grafo vivo atualiza só o afetado).
5. Regra
- Grafo é para RELAÇÕES. Conteúdo solto por tema ainda é caso de vetorial — não force grafo onde RAG resolve.