⚙️ Graphify por dentro
Qué hace la herramienta, cómo extrae conocimiento, qué produce y dónde encuentra sus límites. Sin jerga suelta: cada término (CLI, skill, AST, tree-sitter, graph.json) se define en el momento.
⚙️ Qué es Graphify (CLI + skill)
O Graphify es la herramienta que construye el segundo cerebro. Tiene dos caras que parecen lo mismo, pero cumplen funciones diferentes: una CLI (un programa que ejecutas en la terminal: el paquete se llama graphifyy, con dos "y") y una skill que instala dentro de Claude Code. Entender esta dualidad evita el 90% de la confusión de las próximas rutas.
🔰 ¿Eres nuevo aquí? Qué es una «CLI»
CLI = Interfaz de línea de comandos, o «programa de línea de comandos». Es un programa sin ventanas: escribes su nombre en el terminal y hace el trabajo. Aquí el programa se llama graphify (el paquete que instalas es el graphifyy).
🔰 ¿Eres nuevo aquí? Qué es una «skill»
Una skill es un archivo de instrucciones (SKILL.md) que enseña a Claude Code a realizar una tarea. Una vez instalada, la llamas con un slash command — un comando que empieza con "/", como /graphify. La skill es la cara «dentro de Claude Code»; la CLT pura es la cara «de la terminal».
En la práctica, lo instalas una vez y obtienes las dos facetas. El comando de instalación coloca la CLI en el sistema; un segundo comando registra la skill en Claude Code (escribe un SKILL.md en ~/.claude/skills/graphify/). Dentro de Claude Code, no necesitas una clave de API: la propia sesión proporciona el modelo.
# 1) instala a CLI (recomendado, com uv) uv tool install graphifyy # 2) registra a skill /graphify dentro do Claude Code graphify install
Una vez hecho esto, dentro de Claude Code ejecutas la skill indicando una carpeta. El <isto-voce-troca> es el camino de la fuente que quieres mapear:
/graphify <./pasta-da-fonte>
↑ Entra una fuente, el graphify procesa, y todo termina en graphify-out/. O graph.json es el centro: de él se derivan lo visual y el informe (tema 3).
🔑 Conceptos clave
🌳 Cómo extrae (AST vs LLM)
Graphify usa dos motores de extracción, y cuál de ellos se ejecuta depende de lo que hayas indicado. Si la fuente es código, lee la AST vía tree-sitter — rápido, determinístico y sin clave de API. Si la fuente es documento (markdown, PDF, imagen), usa un LLM para entender el sentido del texto y extraer de ahí las entidades y relaciones.
🔰 ¿Eres nuevo aquí? Qué son «AST» y «tree-sitter»
AST = Abstract Syntax Tree, el «árbol de sintaxis» del código: una representación estructurada que indica «esto es una función», «esto es una llamada», «esto importa aquello». El tree-sitter es la biblioteca que lee el código y construye ese árbol: entiende 12 lenguajes. Como es solo estructura (no interpretación), no necesitas un LLM ni una clave.
🔰 ¿Eres nuevo aquí? Por qué un documento necesita LLM
El texto en prosa no tiene un «árbol» mecánico como el código. Para saber que «ventana de contexto» se relaciona con «tokens», hay que entender lo que está escrito, y ese es el trabajo de un LLM (el modelo de IA). Por eso la extracción de documentos se llama semántica: se guía por el significado, no por la forma.
↑ Dos caminos, un mismo destino (el grafo). El código va por la forma (AST, sin clave); el documento va por sentido (LLM). Dentro de Claude Code, el modelo ya viene de la sesión — sin clave; solo el uso headless en la terminal pura requiere ANTHROPIC_API_KEY.
🔑 Conceptos clave
📂 Las salidas: graph.json, graph.html, GRAPH_REPORT.md
Cuando Graphify termina, no devuelve «una respuesta», sino que crea una carpeta llamada graphify-out/ con varios archivos. Saber cuál es cuál evita el pánico de «¿y ahora, qué abro?» en la primera ejecución. Hay tres protagonistas y un coprotagonista.
graph.json — la fuente de verdad
El grafo completo: todas las entidades, relaciones y comunidades. Todo lo demás se deriva de él. Es el archivo que consultarán Obsidian y Claude Code.
graph.html — el visual interactivo
Una página autocontenida: se abre directamente en el navegador, sin servidor. Es donde «ves» el grafo, arrastras nodos y exploras las conexiones con el mouse.
GRAPH_REPORT.md — la auditoría en texto
Un informe legible: los god nodes (nodos más conectados), los puentes entre comunidades y —lo mejor— una lista de preguntas sugeridas para empezar a explorar.
🔰 ¿Eres nuevo aquí? Qué significa «self-contained»
Autocontenido = «todo en un solo archivo». El graph.html ya incluye todo el JavaScript y los datos que necesita, así que haces doble clic y se abre; no necesitas instalar nada ni iniciar un servidor.
graphify-out/ ├── graph.json # fonte de verdade — tudo deriva daqui ├── graph.html # visual interativo (abre no navegador) ├── GRAPH_REPORT.md # auditoria: god nodes + perguntas sugeridas └── cache/ # cache por arquivo (não re-chama o LLM à toa)
El coadyuvante es la carpeta cache/: guarda el resultado por archivo (identificado por el hash del contenido) para no volver a pagar la llamada al LLM cuando nada ha cambiado. Por eso, la segunda ejecución suele ser mucho más rápida que la primera.
🔑 Conceptos clave
🧱 Código vs. documentos
Graphify apunta a dos tipos de fuente, y la elección cambia todo lo que viene después. Puedes mapear un base de código (un repositorio de código) o un corpus de documentos (una colección de PDF, markdown y notas). No es «mejor ni peor»: son objetivos diferentes.
🔰 ¿Eres nuevo aquí? «base de código» y «corpus»
Un base de código (o «base de código») es el conjunto de archivos de programa de un proyecto. Un corpus es una colección de textos tratada como un todo; en este caso, la documentación que quieres convertir en un mapa. En el curso usamos un corpus: la documentación oficial de Claude Code.
🧩 Base de código (código)
- ✓Extracción por AST (tree-sitter), sin clave.
- ✓Nodos como
Function,Module. - ✓Bueno para entender una arquitectura.
📄 Corpus (documentos)
- ✓Extracción semántica vía LLM.
- ✓Nodos como
Concept(conceptos). - ✓Bueno para entender un tema o la documentación.
Para mapear un repositorio de código en una terminal pura, el comando es la cara headless de la CLI. Cambia el <.> por la ruta del proyecto (el punto significa "carpeta actual"):
# extrai o grafo do repositório na pasta atual graphify extract <.> # ou de uma pasta específica graphify extract <./src>
La elección entre los dos corpus también determina el destino: el código suele generar un grafo que consultas en el propio Graphify (tema de la Ruta 3); la documentación es lo que vale la pena llevar a Obsidian para integrarla en el contexto más amplio del proyecto. En el curso seguimos el camino de los documentos.
🔑 Conceptos clave
📦 El modo Obsidian y el modo wiki
El grafo sin procesar (graph.json) es excelente para las máquinas, pero tú todavía quieres navegar ese conocimiento. Ahí es donde entran dos modos de exportación, y solo existen en la skill (/graphify, dentro de Claude Code), no en la CLI headless. Son el --obsidian e o --wiki.
--obsidian
- •Un
.mdpor nodo, con wikilinks[[nome]]para los vecinos. - •Genera un
graph.canvas: las comunidades se convierten en grupos en el Canvas de Obsidian. - •Es el truco clave del curso: el grafo se convierte en un vault navegable.
--wiki
- •Artículos por comunidad, al estilo de Wikipedia.
- •Menos atómico que Obsidian: agrupa conceptos relacionados en un texto.
- •Bueno para una lectura continua; no para el grafo de backlinks.
🔰 ¿Eres nuevo aquí? «wikilink» y «backlink»
Un wikilink es un enlace con el formato [[nome-da-nota]] que Obsidian entiende. Cuando la nota A apunta a la B, la B obtiene automáticamente un backlink ("quién me cita") — así aparece solo el grafo de conexiones en Obsidian.
El comando del modo Obsidian dentro de Claude Code indica la fuente y dónde guardar el vault. Cambia la ruta de la fuente y el --obsidian-dir por el destino que quieras:
# exporta um vault Obsidian (um .md por nó + canvas) /graphify <./docs> --obsidian --obsidian-dir <~/vault/graphify/claude-code> # ou: artigos por comunidade, estilo Wikipédia /graphify <./docs> --wiki
🔑 Conceptos clave
🫙 El grafo en el vacío: la limitación que Obsidian resuelve
Aquí está la realidad del módulo: por sí solo, el grafo de Graphify vive en un vacío. Conoce a fondo ese corpus que le enviaste y solo él. No conoce tus otras notas, tus otros proyectos ni el contexto más amplio en el que debería existir ese conocimiento. Es un silo: completo por dentro, aislado por fuera.
💡 La limitación, en una frase
O graph.json guarda la procedencia (de qué archivo fuente provino cada entidad), pero los documentos fuente no se copian junto al grafo — quedan en el proyecto. El grafo apunta hacia afuera, pero no trae el resto hacia dentro.
- •Completo: sabe todo sobre el corpus que recibió.
- •Aislado: no ve nada más allá de ese corpus.
- •Estático: no se conecta por sí solo a tu flujo de trabajo.
Y precisamente por eso el curso no termina en Graphify. Llevar el grafo a Obsidian (el modo --obsidian del tema 5) es lo que saca el conocimiento del vacío: dentro del vault encaja en el contexto más amplio — junto con tus otras notas, enlazable e integrable. El grafo deja de ser una isla y se convierte en un barrio de tu segundo cerebro.
🔰 ¿Eres nuevo aquí? Qué es un «silo»
En tecnología, silo es información que queda aislada en un solo lugar, sin conectarse con el resto. El grafo aislado es un silo de conocimiento; Obsidian es lo que abre las puertas de ese silo y lo conecta con lo que ya tienes.
🔑 Conceptos clave
✋ Autorrecuperación (opcional, no bloquea): de las tres salidas de Graphify, ¿cuál es la fuente de verdad de la que deriva todo lo demás?
📌 Resumen del módulo
graphifyy en la terminal y la skill /graphify dentro de Claude Code (sin clave).graphify-out/: graph.json (verdad), graph.html (visual), GRAPH_REPORT.md (auditoría).--obsidian (1 md por nodo + canvas) o --wiki (artículos por comunidad).Siguiente módulo
1.4 · Obsidian como memoria — por qué el vault es el lugar adecuado para que viva el grafo y cómo lo consulta el agente.