GuideIntermediate

Graphify · dê à sua IA o mapa completo do seu projeto (a peça mais avançada)

Esta é a peça mais avançada do conhecimento da sua IA — o grafo, uma das três partes do brain que você acabou de ver. Você já deu memória à sua IA, já salva no GitHub, já sabe quando usar um RAG e o que é um brain. Mas chega um ponto em que a busca por semelhança fica curta: quando seu projeto fica TÃO grande que a IA já não entende como tudo se conecta — o que depende do quê, o que quebra se você mexer em uma peça. Aí ela começa a ler arquivos às cegas, a gastar tokens a mais, a repetir erros e a quebrar coisas que funcionavam. O Graphify resolve isso pela raiz: converte seu projeto inteiro —código, esquemas de banco de dados, documentos, papers, até imagens e vídeos— em um grafo de conhecimento que a IA consulta com uma única pergunta. É open-source, gratuito, e hoje é uma \"skill\" que se instala com um comando. E olha: não é só para programadores — aqui você vai ver vários cenários para diferentes tipos de usuário.

Jun 19, 202611 min

A peça mais avançada do conhecimento da sua IA

Este guia aprofunda o grafo, a terceira peça do brain que você viu no recurso anterior: [memória](/recursos/memoria-para-tu-ia-herramientas) → [RAG](/recursos/rag-sin-humo-cuando-lo-necesitas) → [brain](/recursos/el-brain-cerebro-de-tu-app) → grafo a fundo. Você não precisa programar para entender, e vai ver cenários além do código (documentos, pesquisa, seu negócio).

Quando surge a necessidade? (para além de buscar)

A necessidade surge quando seu projeto deixa de ser "um monte de coisas para buscar" e vira "uma rede de coisas conectadas". Sinais: você pede uma mudança à IA e ela quebra algo que estava na outra ponta do projeto; você pergunta "o que acontece se eu mudar isso?" e ela não sabe; ou você tem tanta informação que nem a memória nem o RAG dão à IA a foto completa de como tudo se encaixa.

A dor: a IA que "conserta" uma coisa e quebra outra

É a dor mais frustrante de construir com IA em escala. A IA mexe em um arquivo sem saber que outras cinco peças dependiam dele → o que conserta de um lado, quebra do outro. Não é que ela seja burra: é que ela busca por semelhança, mas não entende as conexões. O grafo dá exatamente o que falta a ela.

Memória vs RAG vs grafo · a diferença em uma frase

Os três dão conhecimento à sua IA, mas resolvem coisas diferentes. Esta é a diferença que quase ninguém explica com clareza:

As três, sem confundir

Memória → lembra das suas regras e do seu projeto entre sessões. (Continuidade.)

RAG → busca por semelhança e traz os pedaços dos seus documentos que se parecem com a sua pergunta. (Encontrar.)

Grafo → entende as conexões: o que depende do quê, o que quebra se você mudar algo. (Raciocinar sobre a estrutura.)

Imagine assim · o mapa do metrô

Sem grafo, sua IA é um turista numa cidade enorme perguntando o caminho em cada esquina (isso gasta tokens e se perde). Com um grafo de conhecimento, você dá a ela o mapa do metrô: ela vê a cidade inteira de uma olhada, sabe qual estação conecta com qual, e chega direto. O RAG te diz "aqui tem ruas parecidas com a que você procura"; o grafo te diz "esta rua leva àquela, e se você fechar esta, trava a região toda".

O que é o Graphify? (em bom português)

O Graphify é uma ferramenta gratuita e open-source que pega uma pasta inteira —seu código, seus esquemas de banco de dados, seus documentos, papers, até imagens e vídeos— e a converte em um grafo de conhecimento: um mapa onde cada coisa é um ponto e cada conexão é uma linha. A IA, em vez de ler 50 arquivos às cegas, pergunta ao mapa "como X se conecta com Y?" e obtém a resposta em uma única consulta.

Hoje o Graphify funciona como uma "skill" (igual às do recurso das 5 skills de escritório): instala-se uma vez e seu assistente de IA —Claude Code, Cursor, Codex, Gemini CLI e mais— a usa quando precisa. E é multimodal: não entende só código, mas também SQL, scripts, documentos, papers e mais.

safishamsi/graphify

REPO

Graphify — converte qualquer pasta (código, esquemas SQL, scripts, documentos, papers, imagens, vídeos) em um grafo de conhecimento consultável, para assistentes de IA (Claude Code, Codex, Cursor, Gemini CLI e mais). Open-source, mantido por Safi Shamsi.

PythonMITView on GitHub

Para todo tipo de usuário · 4 cenários reais

O Graphify não é só para quem programa. Qualquer pessoa com um monte de informação conectada se beneficia. Estes são quatro cenários diferentes:

1 · Quem constrói um app (código)

O caso clássico: seu projeto cresceu e a IA se perde entre os arquivos. Com o grafo, antes de mexer em qualquer coisa, ela sabe o que depende do quê — e para de quebrar o que funcionava. Menos bugs, menos tokens, mudanças mais seguras.

2 · O pesquisador ou estudante (papers e documentos)

Você tem 80 papers ou um monte de documentos de tese. O grafo conecta ideias entre eles: "quais autores se relacionam?", "qual conceito conecta este paper com aquele?". Sua IA raciocina sobre TODA a sua biblioteca, não documento por documento.

3 · O dono de um negócio (sua operação)

Seus processos, políticas, produtos e clientes estão conectados de mil formas. Um grafo deixa sua IA entender essas relações: "se eu mudar esta política, quais processos ela afeta?". Deixa de responder fatos soltos e passa a entender seu negócio como um sistema.

4 · Quem mistura tudo (dados + docs + código)

O mais poderoso: o Graphify coloca em UM só grafo seu código, seu esquema de banco de dados e sua documentação. Sua IA vê o app, os dados e as decisões como uma única rede — o contexto completo que nenhum arquivo solto dá a ela.

Instalação · um comando (você precisa de Python)

O Graphify se instala com um único comando. Você precisa ter Python no seu computador. (Atenção: o pacote se chama graphifyy, com dois "y".)

Instalar o Graphifybash

pip install graphifyy && graphify install

Se o comando falhar

No macOS ou se você ver um erro de "externally-managed-environment", use pipx install graphifyy (cuida de tudo sozinho). No Windows, se ele não reconhecer o graphify após instalar, pipx install graphifyy também resolve. E o mais fácil: se você usa um agente de código, passe o prompt abaixo para ele e deixe que ele lide com a instalação.

Como se usa · você pergunta ao mapa

Depois de instalada, o Graphify é uma skill que você invoca com /graphify. Você constrói o grafo da sua pasta uma vez e depois faz perguntas em linguagem natural. Assim de simples é uma consulta real:

Consultar seu grafo (exemplo real)bash

/graphify query "o que conecta o login com o banco de dados de usuários?"

O hábito que o torna valioso

O grafo não é de uma vez só: transforme em reflexo consultá-lo ANTES de uma mudança grande ("o que quebra se eu mexer aqui?") e reconstruí-lo quando o projeto mudar bastante. Um mapa velho desorienta; um fresco te poupa horas. Igual em toda a série: a ferramenta vale pelo hábito, não por instalá-la uma vez.

Prompt 1 · Deixe sua IA instalar e construir o grafo

Se você não quer mexer no terminal, deixe seu agente de código fazer tudo. Copie e cole para ele:

Cole no seu agente · instalar e construir o grafotexto

Quero usar o Graphify (https://github.com/safishamsi/graphify) para converter este projeto em um grafo de conhecimento que você possa consultar. Me guie e faça você onde puder, em linguagem simples.

1. Verifique se está instalado; se não, instale (pip install graphifyy && graphify install, ou pipx install graphifyy se o pip falhar).
2. Construa o grafo sobre a raiz deste projeto.
3. Me explique o que foi gerado (o grafo visual, o arquivo consultável e o relatório) em palavras simples.
4. Faça uma consulta de teste para confirmar que funciona, por exemplo como se conectam duas partes-chave do meu projeto.
5. Se tiver algo que só eu possa fazer, me diga com passos exatos.

Prompt 2 · Use antes de cada mudança grande (anti-quebrar-coisas)

Este é o que de verdade te poupa dor de cabeça. Antes de pedir uma mudança importante à IA, faça com que ela consulte o grafo primeiro:

Cole no seu agente · mudar sem quebrartexto

Antes de fazer esta mudança: [descreva a mudança que você quer], consulte o grafo de conhecimento do Graphify para entender o impacto.

1. Pergunte ao grafo quais partes do projeto dependem do que eu vou mexer.
2. Me diga o que poderia quebrar e o que precisa ser revisado depois da mudança.
3. Só então proponha a mudança, levando em conta essas conexões.
4. Quando terminarmos e funcionar, me lembre de salvar o progresso no GitHub.

A ideia é não quebrar nada que esteja conectado por baixo.

Por que ele coroa o conhecimento (e potencializa o C-A-R)

Aqui tudo se junta

O grafo faz com que a fase de auditar do protocolo C-A-R seja muitíssimo mais potente: a IA audita entendendo como TUDO se conecta, não só o arquivo que ela mexeu. E se apoia nos degraus anteriores: salve o grafo e suas mudanças no GitHub, use-o quando o RAG ficar curto para entender estrutura. É o topo da escada do conhecimento da sua IA.

No NeuralOS, o grafo é parte do cérebro

O grafo de conhecimento é justamente o tipo de "cérebro estrutural" que estamos levando para o NeuralOS: que cada projeto e agente entenda como tudo o seu se conecta, sem que você monte nada. A visão já está desenhada na interface; o motor é parte do caminho que construímos.

RAG sem enrolação · o degrau anterior

Antes do grafo, quase sempre o que você precisa é de um bom RAG. Comece por aí se você pulou.

O protocolo C-A-R · construir sem bugs

O método que combina perfeitamente com o Graphify para software à prova de balas.

#contexto#grafo#open-source#claude-code

Ready to build?