🗺️ Ejecutar Graphify y leer el grafo
Ya tienes la fuente preparada. Ahora da el comando, espera la extracción y aprende a leer lo que salió — el mapa interactivo, el informe con los hubs y las preguntas, y los comandos para conversar con el grafo directamente en la terminal.
▶️ Ejecutar /graphify o graphify extract
Existen dos rutas para generar el mismo grafo. Dentro de Claude Code usas la skill (el comando slash /graphify); en la terminal sin interfaz gráfica, usas el subcomando headless graphify extract. Ambos leen la fuente y producen la carpeta graphify-out/ — elige lo que te sirva en este momento.
🔰 ¿Eres nuevo aquí? Skill vs. headless
Skill = la forma dentro de Claude Code: la sesión proporciona el modelo, así que no necesitas una API key, y obtienes extras como --obsidian, --update e --watch. Headless = el mismo motor en la terminal pura (CI, script); para documentos requiere ANTHROPIC_API_KEY.
🎯 Objetivo: extraer el grafo de tu carpeta de documentos sin necesitar una API key.
/graphify ./claude-code-docs
Cambia <isto-voce-troca>: ./claude-code-docs → la ruta de TU fuente preparada en el módulo 2.2.
✓ Cómo verificar: al terminar, aparece la carpeta graphify-out/ con graph.json, graph.html e GRAPH_REPORT.md.
🎯 Objetivo: la misma extracción fuera de Claude Code (útil en CI o en un script).
graphify extract ./claude-code-docs
En headless, los documentos requieren ANTHROPIC_API_KEY en el entorno. El código puro (tree-sitter) no lo necesita.
✓ Cómo verificar: mismo resultado de la skill: la carpeta graphify-out/ se crea en el directorio.
🔑 Conceptos clave
⏳ Qué sucede durante la extracción
La barra no está ahí sin motivo. Mientras esperas, Graphify lee los archivos y extrae entidades (los nodos) y relaciones (las aristas tipadas), y después agrupa todo en comunidades usando el algoritmo Leiden. Cada archivo procesado va a un caché, así que la siguiente ronda no vuelve a procesar lo que no cambió.
🔰 ¿Eres nuevo aquí? Leiden y caché
Leiden es el algoritmo que encuentra grupos de nodos muy conectados entre sí: las comunidades, los «barrios» del grafo. El caché guarda el resultado por archivo (según el hash del contenido); si el archivo no cambió, Graphify lo reutiliza y no vuelve a llamar al modelo.
↑ La espera es trabajo real: archivos → entidades → relaciones → comunidades. El caché lo de abajo es lo que hace que la 2.ª ronda sea económica.
🔑 Conceptos clave
🖥️ Abrir graph.html
Todo en la carpeta graphify-out/ deriva de un único archivo: el graph.json, la fuente de verdad. De ahí surgen la visualización graph.html y el informe GRAPH_REPORT.md. O graph.html é self-contained: se abre directamente en el navegador, sin iniciar ningún servidor.
↑ Ejecutas graphify sobre el corpus; registra graph.json; y de él deriva el graph.html (visual) y el GRAPH_REPORT.md (texto).
🎯 Objetivo: ver el grafo real — nodos, conexiones y comunidades, interactivo.
# macOS open graphify-out/graph.html # Linux xdg-open graphify-out/graph.html
✓ Cómo verificar: abre una página con la red de nodos; arrastra, haz zoom y haz clic en un nodo: todo sin servidor.
📦 Lo que hay dentro de graphify-out/
| Archivo | Qué es |
|---|---|
| graph.json | Grafo completo — la fuente de verdad; todo lo demás se deriva de él. |
| graph.html | Visualización interactiva autocontenida; se abre en el navegador, sin servidor. |
| GRAPH_REPORT.md | Auditoría en texto: god nodes, conexiones entre comunidades y preguntas sugeridas. |
| cache/ | Caché por archivo (hash del contenido) para no volver a llamar al LLM sin necesidad. |
🔑 Conceptos clave
📋 Leer GRAPH_REPORT.md
O GRAPH_REPORT.md es tu punto de entrada a un grafo grande. En vez de adivinar por dónde explorar, ya te entrega los god nodes — las entidades más conectadas, los hubs — y una lista de preguntas sugeridas que el grafo sabe responder bien. Es un índice de lo que conoce el mapa.
🔰 ¿Eres nuevo aquí? «God node»
Un god node es la entidad con más conexiones en el grafo: el hub. Si un concepto aparece conectado con decenas de otros, probablemente sea central en el proyecto. Empezar por él suele ser el camino más corto para entender el conjunto.
# Graph Report ## God nodes (mais conectados) 1. Context Window — 38 conexões 2. Hooks — 31 conexões 3. Subagents — 27 conexões ## Perguntas sugeridas - Como funcionam os hooks? - O que liga Subagents a Context Window? - Quais comunidades giram em torno de MCP?
🎯 Objetivo: ver god nodes y preguntas sugeridas en texto plano.
cat graphify-out/GRAPH_REPORT.md
✓ Cómo verificar: aparece la sección Nodos God con el recuento de conexiones y la lista de Preguntas sugeridas.
🔑 Conceptos clave
🔎 explain / path / query en la terminal
Sin abrir el navegador ni la bóveda, puedes conversar con el grafo directamente en la terminal. explain describe un nodo en lenguaje sencillo; path muestra el camino más corto entre dos nodos; query responde una pregunta en texto libre. Son respuestas extraídas de la estructura: rápidas y económicas.
🎯 Objetivo: explicar un concepto, encontrar el vínculo entre dos y hacer una pregunta abierta.
graphify explain "Context Window" graphify path "Hooks" "Subagents" graphify query "como funcionam os hooks?"
Cambia <isto-voce-troca>: los términos entre comillas de los nodos de TU grafo (consulta los god nodes en el informe).
✓ Cómo verificar: cada comando responde con texto: una explicación, la secuencia de nodos del recorrido o una respuesta a la pregunta.
explain
Describe un nodo en lenguaje sencillo.
path
Ruta más corta entre dos nodos.
query
Haz una pregunta en texto libre al grafo.
🔑 Conceptos clave
🔁 --update y --watch (volver a ejecutar a bajo costo)
La fuente cambia con el tiempo y no quieres volver a pagar por toda la extracción. El --update reprocesa solo los archivos modificados (gracias a la caché); el --watch lo hace automáticamente cada vez que guardas. Es lo que mantiene el grafo vivo sin el costo total cada vez.
🎯 Objetivo: volver a ejecutar solo lo que cambió — sin interfaz o dentro de Claude Code.
# headless: só os arquivos alterados graphify update ./claude-code-docs # dentro do Claude Code /graphify ./claude-code-docs --update /graphify ./claude-code-docs --watch
✓ Cómo verificar: la ejecución termina mucho más rápido que la 1.ª extracción: la caché reutiliza lo que no cambió.
✓ Incremental (--update / --watch)
- ✓Vuelve a procesar solo lo que cambió.
- ✓Reutiliza la caché por archivo.
- ✓Mantiene el grafo vivo junto con la fuente.
✗ Extraer desde cero cada vez
- ✗Vuelve a llamar al LLM sobre todo el corpus.
- ✗Vuelve a tardar y a costar lo mismo.
- ✗Desincentiva mantener el grafo actualizado.
🔑 Conceptos clave
✋ Autorrecuperación (opcional, no bloquea): cuál archivo de graphify-out/ ¿lista los god nodes y las preguntas sugeridas?
📌 Resumen del módulo
/graphify (skill, sin key) y graphify extract (headless).Siguiente módulo
2.4 · Generar el vault de Obsidian — transformar el grafo en un archivo Markdown por concepto, con wikilinks y backlinks.