🛠️ Paso a paso práctico

Graphify está escrito en Python (necesita 3.10+) y el uv es un instalador rápido de herramientas de Python. Consulta su versión con python --version antes de continuar.

La base correcta garantiza que el graphify instálalo desde cero, sin conflictos de versiones. Es el requisito previo que evita la mayoría de los errores de instalación.

python --version · uv · PATH.

Ejecuta uv tool install graphifyy (el paquete tiene dos «y»); como alternativa, pipx install graphifyy o pip install graphifyy. Esto instala el binario graphify que vas a llamar.

Es el programa central del curso: sin él, nada funciona. Un solo comando hace que el graphify disponible en la terminal.

graphifyy · uv tool · uv tool update-shell.

graphify install escribe ~/.claude/skills/graphify/SKILL.md; con --project lo guarda dentro del repositorio actual. Es lo que le enseña a Claude Code a usar Graphify.

Es este paso el que activa el comando /graphify dentro de Claude Code. Sin registrar la skill, solo existe la CLI headless.

skill · SKILL.md · --project.

Descarga Obsidian en obsidian.md, instálalo y ábrelo: es gratis y funciona en el escritorio. Todavía no necesitas crear nada, solo déjalo listo.

Es donde vivirá y se navegará el vault generado. Tenerlo abierto ahora acorta el camino cuando llegue el markdown.

Obsidian · bóveda · escritorio.

En ejecución mediante /graphify dentro de Claude Code NO necesitas una clave; solo el modo headless (terminal puro para documentos) requiere la ANTHROPIC_API_KEY. La extracción de código mediante AST no usa ninguna clave.

Evita que te bloquees pensando que falta configurar una clave. Saber cuándo se necesita ahorra tiempo y confusiones.

ANTHROPIC_API_KEY · skill vs headless · tree-sitter sin clave.

Ejecuta graphify --help y comprueba que existe ~/.claude/skills/graphify/SKILL.md. Si ambos responden, el entorno está listo.

Detectar un problema ahora es mucho más barato que descubrirlo en medio de la extracción. Es la comprobación de cordura que cierra la instalación.

--help · checklist · sanity check.

Graphify acepta un base de código O uno corpus de documentos (PDF, markdown). La elección define el tipo de fuente que leerá.

Cambia cómo extrae: el código se convierte en un grafo mediante el AST (sin clave), y los documentos pasan por un LLM. Decidirlo pronto evita retrabajo.

base de código · corpus · elección.

Pídele al propio Claude Code que descargue la documentación oficial en una carpeta local, por ejemplo ./claude-code-docs. Es el corpus usado en el ejemplo del video.

Tener un corpus real y conocido facilita comparar tu resultado con el del video (allí dieron ~145 documentos). Es un buen punto de partida antes de usar tus propias fuentes.

carpeta local · docs · 145 docs (ejemplo).

Reúne los archivos en una carpeta dedicada y sin basura (borradores, temporales). Esa carpeta es exactamente lo que Graphify va a escanear.

Una raíz limpia genera un grafo más limpio, con menos ruido. Lo que entra en la carpeta se convierte en un nodo del grafo.

carpeta dedicada · estructura · ruido.

Empieza apuntando a un subconjunto de los archivos, no a todo el corpus de una vez. Amplía el alcance después de que el flujo funcione.

Una extracción más pequeña es más rápida y económica para probar y ajustar. Iterar en pequeño evita esperar (y pagar) por un grafo que quizá no sirva.

alcance · subconjunto · iterar.

Quita los binarios, las compilaciones, los duplicados y todo lo que no tenga significado. Deja solo los archivos que describen el conocimiento.

Cada archivo adicional es ruido potencial en el grafo. Menos basura significa nodos y relaciones más relevantes.

exclusiones · estilo .gitignore · señal/ruido.

Ejecuta Graphify en la raíz del proyecto; la salida se guarda en una carpeta graphify-out/ ahí mismo. El directorio actual (cwd) determina dónde aparecen los archivos.

Saber desde dónde ejecutar te permite prever las rutas de salida. Siempre sabes dónde encontrar el graph.json después.

cwd · graphify-out/ · raíz del proyecto.

Dentro de Claude Code, usa /graphify ./claude-code-docs; en la terminal pura usa graphify extract ./claude-code-docs. Ambos generan el mismo grafo por caminos diferentes.

Es el comando que da inicio a la extracción. Conocer los dos modos te permite elegir el que mejor se adapte al momento.

skill vs headless · extract.

Lee los archivos, extrae entidades y relaciones y detecta comunidades con el algoritmo Leiden. El resultado se guarda en caché para no repetir todo cada vez.

Entender la espera y la caché evita la ansiedad y las reejecuciones innecesarias. Sabes que el tiempo se está convirtiendo en nodos y aristas.

extracción · comunidades · caché.

Abre graphify-out/graph.html en el navegador — es un archivo self-contained, sin servidor. Muestra los nodos, las conexiones y las comunidades de forma interactiva.

Es la primera vez que ves tu grafo de verdad. Explorar la vista visual crea la intuición que el resto del curso aprovecha.

graph.html · navegador · interactivo.

O graphify-out/GRAPH_REPORT.md es una auditoría en texto que enumera los god nodes y sugiere preguntas. Funciona como un índice de lo que sabe el grafo.

Te indica por dónde explorar sin tener que adivinar: los hubs y las buenas preguntas ya vienen listos. Un excelente punto de entrada a un grafo grande.

GRAPH_REPORT.md · nodos God · preguntas sugeridas.

Usa graphify explain "Context Window", graphify path "Hooks" "Subagents" e graphify query "..." para consultar el grafo. Son respuestas directas de la estructura, sin abrir el vault.

Da respuestas rápidas sobre conceptos y las rutas entre ellos. Es la forma más ligera de usar el conocimiento ya extraído.

explain · path · query.

graphify update . reprocesa solo los archivos modificados; --watch se rehace automáticamente al guardar. Ambos evitan reprocesar todo el corpus.

Mantiene el grafo vivo a medida que cambia la fuente, sin pagar el costo total cada vez. La actualización incremental es lo que hace que el stack sea sostenible.

update · watch · incremental.

Dentro de Claude Code, ejecuta /graphify ./claude-code-docs --obsidian --obsidian-dir ~/vault/graphify/claude-code. O --obsidian activa la exportación del vault.

Este flag solo existe en la skill, no en el modo headless: es el detalle en el que mucha gente se equivoca. Es lo que transforma el grafo en notas.

--obsidian · --obsidian-dir · skill-only.

O --obsidian-dir define la carpeta de salida; sin él, la skill crea un directorio propio (una especie de cuarentena). Tú controlas dónde quedan los archivos.

Indicar el destino evita dispersar archivos markdown en el lugar equivocado. El valor predeterminado aislado es seguro, pero elegir permite organizarse.

destino · carpeta dedicada · predeterminado aislado.

Se genera un archivo .md por nodo, con [[wikilinks]] para los relacionados, más un graph.canvas con las comunidades agrupadas. Es el vault navegable.

Entender qué es cada archivo le quita el misterio a la exportación. Un nodo equivale a una nota: ese es el modelo mental de todo el vault.

md por nodo · wikilink · graph.canvas.

La exportación se regenera desde cero en cada ejecución, siempre a partir del graph.json. No hay que hacer merges manuales: el grafo es la fuente de verdad.

Significa que el vault siempre refleja el grafo actual, sin estados intermedios. Puedes volver a ejecutarlo cuando quieras sin miedo a inconsistencias.

regeneración · idempotente · fuente de verdad.

/graphify ./docs --wiki genera artículos por comunidad con un index.md de entrada. Es otro formato de exportación, orientado a la lectura.

Es una alternativa navegable en texto, buena para personas y agentes que prefieren leer artículos. Conviene conocerla antes de decidir entre un vault y una wiki.

--wiki · index.md · artículo por comunidad.

Mira la carpeta de destino: cuenta los archivos .md y fíjate si el graph.canvas está ahí. Es una comprobación rápida en el sistema de archivos.

Confirma que la exportación funcionó antes de invertir tiempo en Obsidian. Detecta exportaciones vacías o truncadas a tiempo.

recuento de notas · canvas · verificación.

En Obsidian, en la esquina inferior izquierda, abre Manage vaults → Abrir carpeta como bóveda y elige la carpeta generada. Obsidian empieza a tratar esa carpeta como un vault.

Hay que indicarle a Obsidian el directorio: no lo encuentra por sí solo. Este es el paso que conecta el markdown generado con la interfaz.

manage vault · open folder as vault · reconocer.

Abre una nota nodo y sigue los [[backlinks]] para los conceptos relacionados con ella. Cada clic te lleva de una idea a su vecina.

Es el segundo cerebro en acción: recorres el conocimiento mediante las relaciones, no con búsquedas. Practicar esta navegación es el objetivo del módulo.

nota-nodo · backlink · navegación.

Abre el graph.canvas en Obsidian y mira las comunidades como grupos con nombre en un tablero. Es la vista general de los temas del corpus.

El canvas ofrece una perspectiva general que las notas individuales no dan. Es útil para elegir con qué tema empezar a explorar.

canvas · comunidad · grupo con nombre.

Cada nodo guarda su procedencia en el graph.json; acerca los documentos fuente y vincula cada nodo con su archivo de origen (un señalizador). Así, el concepto apunta al texto completo.

Permite que el agente pase del concepto al documento completo cuando necesite más detalles. Cierra la brecha entre el resumen y la fuente.

procedencia · doc-fuente · enlace de origen.

La graph view de Obsidian dibuja los enlaces entre las notas markdown: es un espejo, no el grafo de Graphify. Muestra conexiones entre notas, no las relaciones tipadas originales.

El video advierte justamente sobre esto, para que no confundas una cosa con la otra. Ajustar las expectativas evita la frustración.

graph view · espejo · ≠ original.

Hay un prompt listo: pídele a Claude Code que traiga los documentos fuente y vincule cada nodo con su origen dentro de la carpeta del vault. Se encarga automáticamente de vincularlos.

Automatiza el trabajo manual del tema 4 con un comando. Es el atajo que hace práctica la conexión de las fuentes.

prompt · wire · automatización.

Mantén el vault generado como un vault propio y separado del principal. Funciona por sí solo, sin mezclarse con el resto.

Es útil para quien solo quiere el conocimiento dentro del ecosistema de Obsidian, sin integrarlo. Es el comportamiento predeterminado y el más seguro.

standalone · aislado · default.

Ponlo todo en una subcarpeta de tu vault principal (p. ej., graph-imports/claude-code-docs) que puedes borrar por completo. Se mantiene en el contexto, pero se puede aislar.

Acerca el conocimiento sin riesgo: si no te gusta, borras la carpeta y listo. Es el punto medio entre lo aislado y lo integrado.

cuarentena · subcarpeta · eliminable.

Pídele a Claude Code que traiga solo las notas relevantes (p. ej., las ~100 sobre subagents) e ignore el resto. Obtienes una selección, no todo el corpus.

Evita volcar 600 archivos que nunca vas a usar. La curaduría mantiene ordenado el vault principal.

recolección · selección · curación.

Claude Code redistribuye cada nota a la subcarpeta de tu vault que tenga más sentido. El conocimiento se diluye en tu estructura existente.

Te da la máxima coherencia con lo que ya tienes, pero es lo más difícil de revertir. Es una decisión consciente de cambiar reversibilidad por integración.

redistribución · coherencia · riesgo.

Prompt listo: pide mover la estructura del vault generado a una subcarpeta propia dentro del principal. Transfiere los archivos por ti.

Integra el contenido en menos de un minuto, sin arrastrar carpetas una por una. Es la ejecución práctica de la estrategia de cuarentena.

mover · subcarpeta · prompt.

Regla práctica: ¿base de código? Quédate con Graphify. ¿La quieres solo en Obsidian? standalone. ¿Integrarla de forma segura? cuarentena. ¿Curarla? harvest. ¿Coherencia total? redistribución.

Te da un camino para decidir y no quedarte atascado al integrar. Cada opción es un trade-off entre coherencia y reversibilidad.

decisión · compensación · reversibilidad.