🧠 Fundamentos

Claude Code es un agente de IA que se ejecuta en tu terminal: lee archivos, edita código y ejecuta comandos por ti. "Memoria" aquí es todo lo que puede tener presente para responder: lo que está en la conversación actual más lo que le indiques.

Sin una memoria externa, cada sesión empieza desde cero en proyectos grandes. Entender qué "recuerda" es el primer paso para darle un cerebro persistente.

Agente · sesión · contexto · memoria externa.

A ventana de contexto es la cantidad de texto que el modelo puede leer de una vez (medida en tokens — fragmentos de palabras). Es grande, pero finita: rara vez cabe un repositorio entero.

Cuando el contenido no cabe, el agente necesita elegir qué leer. Un mapa del conocimiento lo ayuda a elegir bien, en lugar de revisar todo a ciegas.

Token · ventana de contexto · costo · selección de contexto.

grep es la búsqueda literal de una palabra en los archivos. Encuentra dónde aparece el término, pero no sabe qué se relaciona sin el qué ni el porqué.

Es exactamente la brecha que llena el grafo: guarda las conexiones y el significado, no solo la ubicación del texto.

Búsqueda literal vs. semántica · relación · "mapa, no índice".

"Segundo cerebro" es una base de conocimiento externa y organizada que tú (o un agente) consultas. Aquí, el grafo + el vault guardan la comprensión de un proyecto.

Es la idea central del curso: sacar el conocimiento de la sesión efímera y ponerlo en un lugar persistente y navegable.

PKM · memoria externa · persistencia · base consultable.

Claude Code ya lee un archivo CLAUDE.md con instrucciones y tiene memoria propia. Es ideal para las reglas, pero no es un mapa de un repositorio entero.

Para saber dónde termina lo nativo y dónde empieza Graphify+Obsidian: se complementan, no compiten.

CLAUDE.md · memoria nativa · límites · complemento.

Graphify crea el mapa; Obsidian lo guarda como markdown navegable; Claude Code lo consulta en el contexto de tu proyecto. Juntos = segundo cerebro.

Es el recorrido de todo el curso. Saber el destino hace que cada paso práctico que sigue tenga sentido.

Stack · mapa → vault → agente · contexto del proyecto.

Un grafo son puntos (nodos) conectados por líneas (aristas). Piensa en estaciones de metro (nodos) y vías (aristas) entre ellas.

Es la estructura que produce Graphify. Sin esta imagen mental, lo demás se convierte en jerga.

Nodo · arista · vecindad · grado (cuántas conexiones).

En Graphify, los nodos son entidades (una idea, función, persona) y las aristas son relaciones tipadas. Cada una lleva procedencia: de qué archivo provino.

El video habla de "conceptos/conexiones"; la herramienta dice "entidades/relaciones". Conocer ambos términos evita confusiones en la práctica.

Entidad · relación tipada · procedencia · reconciliación (unir alias).

Una comunidad es un grupo de nodos muy conectados entre sí. El Leiden es el algoritmo que encuentra esos grupos automáticamente.

Las comunidades se convierten en «temas» del proyecto y, en Obsidian, en grupos con nombre en el canvas. Así el grafo se vuelve navegable.

Comunidad · clustering · Leiden · tema/asunto.

Un god node es la entidad más conectada: el hub que toca muchas otras. Ej.: «Context Window» que atrae decenas de conceptos relacionados.

Son los mejores puntos de partida para preguntarle al agente — y GRAPH_REPORT.md los enumera para ti.

Nodo God · grado alto · hub · punto de entrada.

RAG es «buscar fragmentos y dárselos al modelo». GraphRAG lo hace por grafo: además de los fragmentos, entrega las relaciones entre ellas.

Es la diferencia entre que el agente reciba una pila de páginas y que reciba un mapa anotado. Con un mapa, responde más rápido y mejor.

RAG · GraphRAG · recuperación · contexto estructurado.

Con el mapa, Claude Code sabe qué está cerca de qué. Preguntas sobre subagentes → encuentra «agent teams», «contexto separado», etc., sin revisar todo.

Es el argumento de venta de todo el stack: mejores respuestas en repositorios grandes.

Vecindario · navegación · respuesta contextual · eficiencia.

Graphify es una CLI (programa de terminal, el paquete graphifyy) que también instala una skill (un archivo de instrucciones) dentro de Claude Code.

Las dos caras hacen cosas distintas: la skill (/graphify) tiene el modo Obsidian; la CLI headless tiene extract/query. Vas a usar ambas.

CLI · skill · graphifyy · slash command.

Para código, Graphify lee la estructura (la AST, el «árbol» del código, mediante tree-sitter): rápido y sin API key. Para documentos, usa un LLM para extraer el sentido.

Define si necesitas una clave de API y qué tan «literal» o «semántica» será la extracción.

AST · tree-sitter · extracción semántica · LLM.

Todo termina en una carpeta graphify-out/: o graph.json (la verdad), el graph.html (visual interactivo) y el GRAPH_REPORT.md (auditoría con preguntas sugeridas).

Saber qué archivo es cada uno evita el pánico en la primera ejecución y te muestra por dónde explorar.

graph.json · graph.html · GRAPH_REPORT.md · caché.

Graphify apunta tanto a un base de código cuánto para uno corpus de documentos (PDF, markdown, etc.). En el curso, usamos documentos: la documentación de Claude Code.

La elección cambia el tipo de grafo y determina si lo llevas a Obsidian o lo dejas en el propio Graphify (tema de la Ruta 3).

Base de código · corpus · markdown · PDF.

La skill tiene --obsidian (un archivo markdown por nodo con backlinks + un canvas) y --wiki (artículos por comunidad, al estilo de Wikipedia).

Es el truco clave del video: transformar el grafo en un vault que Obsidian (y el agente) entiende.

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

Por sí solo, el grafo de Graphify vive aislado — solo conoce ese corpus. No se conecta con el resto de lo que guardas.

Es exactamente por eso que lo llevamos a Obsidian: para integrar este conocimiento en el contexto más amplio de tu proyecto.

Silo · vacío · contexto más amplio · integración.

O Obsidian es una aplicación de notas. Un vault es simplemente una carpeta de archivos markdown (texto simple con formato) que abre.

Como es solo una carpeta de archivos, Claude Code también puede leerlo todo: no hay ningún formato propietario de por medio.

Obsidian · bóveda · markdown · carpeta local.

Un wikilink é [[nome-da-nota]]: conecta una nota con otra. Obsidian crea los backlinks (quien apunta aquí) por sí solo.

Así es como las aristas del grafo se convierten en enlaces navegables. Cada relación de Graphify se convierte en un [[...]].

Wikilink · backlink · nota · vínculo bidireccional.

Obsidian tiene una «graph view», pero es solo un dibujo de los enlaces entre notas markdown. No es el grafo de conocimiento de Graphify, sino una representación visual de este.

El video advierte sobre esto: "no es exactamente un grafo de conocimiento, es un montón de archivos markdown conectados". Conocer la diferencia evita expectativas equivocadas.

Graph view · enlaces de notas · representación · ≠ grafo original.

Markdown es texto sin formato. El agente lo lee, hace grep, sigue los [[links]] — ninguna capa binaria en el medio.

Por eso el vault es el hogar ideal: el mismo archivo te sirve para leerlo en Obsidian y para que Claude Code lo consulte.

Texto sin formato · legible para humanos y máquinas · sin dependencia de un proveedor.

O Canvas es un tablero visual; los plugins extienden Obsidian. Graphify genera un graph.canvas con las comunidades ya agrupadas.

Mucha gente quiere el stack solo por la infraestructura de Obsidian (UI, complementos). Saber qué hay disponible ayuda a decidir.

Canvas · plugin · UI · complementos.

La exportación de Obsidian lee el graph.json y escribe un Markdown por nodo. Es el puente entre el mundo del grafo y el mundo de las notas.

Cierra la Ruta 1: entiendes los dos márgenes y el puente. La Ruta 2 cruza ese puente en la práctica.

graph.json → .md · puente · regeneración · siguiente paso práctico.