🧠 Fundamentos

O Claude Code é um agente de IA que roda no seu terminal — lê arquivos, edita código e roda comandos por você. "Memória" aqui é tudo que ele consegue ter em mente para responder: o que está na conversa atual mais o que você apontar.

Sem uma memória externa, cada sessão começa do zero sobre projetos grandes. Entender o que ele "lembra" é o primeiro passo para dar a ele um cérebro persistente.

Agente · sessão · contexto · memória externa.

A janela de contexto é o quanto de texto o modelo consegue ler de uma vez (medido em tokens — pedaços de palavra). É grande, mas finita: um repositório inteiro raramente cabe.

Quando o conteúdo não cabe, o agente precisa escolher o que ler. Um mapa do conhecimento ajuda ele a escolher bem, em vez de varrer tudo às cegas.

Token · janela de contexto · custo · seleção de contexto.

grep é a busca literal por uma palavra nos arquivos. Acha onde o termo aparece, mas não sabe o que se relaciona com o quê nem o porquê.

É exatamente a lacuna que o grafo preenche: ele guarda as conexões e o significado, não só a localização do texto.

Busca literal vs semântica · relação · "mapa, não índice".

"Segundo cérebro" é uma base de conhecimento externa e organizada que você (ou um agente) consulta. Aqui, é o grafo + o vault que guardam o entendimento de um projeto.

É a ideia central do curso: tirar o conhecimento de dentro da sessão efêmera e colocá-lo num lugar persistente e navegável.

PKM · memória externa · persistência · base consultável.

O Claude Code já lê um arquivo CLAUDE.md com instruções e tem memória própria. É ótimo para regras, mas não é um mapa de um repositório inteiro.

Para saber onde o nativo termina e o Graphify+Obsidian começa — eles se complementam, não competem.

CLAUDE.md · memória nativa · limites · complemento.

Graphify cria o mapa; Obsidian o guarda como markdown navegável; o Claude Code o consulta no contexto do seu projeto. Juntos = segundo cérebro.

É o roteiro do curso inteiro. Saber o destino faz cada passo prático adiante fazer sentido.

Stack · mapa → vault → agente · contexto do projeto.

Um grafo são pontos (nós) ligados por linhas (arestas). Pense em estações de metrô (nós) e trilhos (arestas) entre elas.

É a estrutura que o Graphify produz. Sem essa imagem mental, o resto vira jargão.

Nó · aresta · vizinhança · grau (quantas conexões).

No Graphify, os nós são entidades (uma ideia, função, pessoa) e as arestas são relações tipadas. Cada uma carrega procedência: de qual arquivo veio.

O vídeo fala "conceitos/conexões"; a ferramenta diz "entidades/relações". Saber os dois evita confusão na prática.

Entidade · relação tipada · procedência · reconciliação (juntar apelidos).

Uma comunidade é um grupo de nós muito conectados entre si. O Leiden é o algoritmo que acha esses grupos automaticamente.

Comunidades viram "temas" do projeto — e, no Obsidian, grupos nomeados no canvas. É como o grafo fica navegável.

Comunidade · clustering · Leiden · tema/assunto.

Um god node é a entidade mais conectada — o hub que toca muitas outras. Ex.: "Context Window" puxando dezenas de conceitos relacionados.

São os melhores pontos de partida para perguntar ao agente — e o GRAPH_REPORT.md os lista pra você.

God node · grau alto · hub · ponto de entrada.

RAG é "buscar trechos e dar pro modelo". GraphRAG faz isso por um grafo: além dos trechos, entrega as relações entre eles.

É a diferença entre o agente receber uma pilha de páginas e receber um mapa anotado. Mapa responde mais rápido e melhor.

RAG · GraphRAG · recuperação · contexto estruturado.

Com o mapa, o Claude Code sabe o que está perto de quê. Pergunta sobre sub-agentes → ele acha "agent teams", "contexto separado" etc. sem varrer tudo.

É o argumento de venda do stack inteiro — respostas melhores em repositórios grandes.

Vizinhança · navegação · resposta no contexto · eficiência.

Graphify é uma CLI (programa de terminal, o pacote graphifyy) que também instala uma skill (um arquivo de instruções) dentro do Claude Code.

As duas faces fazem coisas diferentes: a skill (/graphify) tem o modo Obsidian; a CLI headless tem extract/query. Você vai usar as duas.

CLI · skill · graphifyy · slash command.

Para código, o Graphify lê a estrutura (a AST, a "árvore" do código, via tree-sitter) — rápido e sem API key. Para documentos, usa um LLM para extrair o sentido.

Define se você precisa de chave de API e quão "literal" ou "semântica" será a extração.

AST · tree-sitter · extração semântica · LLM.

Tudo cai numa pasta graphify-out/: o graph.json (a verdade), o graph.html (visual interativo) e o GRAPH_REPORT.md (auditoria com perguntas sugeridas).

Saber qual arquivo é o quê evita pânico na primeira execução e mostra por onde explorar.

graph.json · graph.html · GRAPH_REPORT.md · cache.

O Graphify aponta tanto para um code base quanto para um corpus de documentos (PDFs, markdown, etc.). No curso, usamos documentos: a doc do Claude Code.

A escolha muda o tipo de grafo e se você leva pro Obsidian ou para no próprio Graphify (tema da Trilha 3).

Code base · corpus · markdown · PDF.

A skill tem --obsidian (um markdown por nó com backlinks + um canvas) e --wiki (artigos por comunidade, estilo Wikipédia).

É o pulo do gato do vídeo: transformar o grafo num vault que o Obsidian (e o agente) entende.

--obsidian · --wiki · graph.canvas · backlink.

Sozinho, o grafo do Graphify vive isolado — só sabe daquele corpus. Não se conecta ao resto do que você guarda.

É exatamente por isso que levamos pro Obsidian: para encaixar esse conhecimento no contexto maior do seu projeto.

Silo · vácuo · contexto maior · integração.

O Obsidian é um app de notas. Um vault é simplesmente uma pasta de arquivos markdown (texto simples com formatação) que ele abre.

Como é só uma pasta de arquivos, o Claude Code também lê tudo — sem formato proprietário no caminho.

Obsidian · vault · markdown · pasta local.

Um wikilink é [[nome-da-nota]]: liga uma nota a outra. O Obsidian cria os backlinks (quem aponta pra cá) sozinho.

É assim que as arestas do grafo viram links navegáveis. Cada relação do Graphify vira um [[...]].

Wikilink · backlink · nota · ligação bidirecional.

O Obsidian tem uma "graph view" — mas é só um desenho dos links entre notas markdown. Não é o grafo de conhecimento do Graphify, é uma representação visual dele.

O vídeo alerta pra isso: "não é exatamente um knowledge graph, é um monte de markdown conectado". Saber a diferença evita expectativa errada.

Graph view · links de notas · representação · ≠ grafo original.

Markdown é texto puro. O agente lê, faz grep, segue os [[links]] — nenhuma camada binária no meio.

É por isso que o vault é o lar ideal: o mesmo arquivo serve para você ler no Obsidian e para o Claude Code consultar.

Texto puro · legível por humano e máquina · sem lock-in.

O Canvas é um quadro visual; os plugins estendem o Obsidian. O Graphify gera um graph.canvas com as comunidades já agrupadas.

Muita gente quer o stack só pela infra do Obsidian (UI, add-ons). Saber o que tem disponível ajuda a decidir.

Canvas · plugin · UI · add-ons.

O export Obsidian lê o graph.json e escreve um markdown por nó. É a ponte entre o mundo do grafo e o mundo das notas.

Fecha a Trilha 1: você entende as duas margens e a ponte. A Trilha 2 atravessa essa ponte na prática.

graph.json → .md · ponte · regeneração · próximo passo prático.