SuperAPI AI Directory

graphify

Coding & development

View repository

Updated 11-12 16:19

About this skill

Skill: Graphify — repositório vira grafo de conhecimento

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★ (graphify no 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

  1. Confirme que o repo está indexado (ou rode /graphify).
  2. Para perguntas de conexão/arquitetura: force consulta ao grafo ("olhe o grafo antes de responder").
  3. Entregue a resposta com o caminho das conexões (nó → aresta → nó).
  4. 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.