🧠 Por qué Claude Code necesita un segundo cerebro
La diferencia entre una sesión que lo olvida todo y un agente con memoria externa consultable. Aquí adquieres el vocabulario y el «porqué», sin términos sueltos.
🤖 El agente y su "memoria"
O Claude Code es un agente de IA que vive en tu terminal. A diferencia de un chat común, actúa: lee archivos del proyecto, edita código, ejecuta comandos y encadena pasos para completar una tarea. Cuando hablamos de su "memoria", nos referimos a todo lo que puede tener a la vista al responder.
🔰 ¿Eres nuevo aquí? Qué es un «agente»
Un LLM es el modelo de IA que funciona detrás de ChatGPT/Claude. Un agente es este modelo con herramientas: cosas que hace por su cuenta: abrir un archivo, ejecutar un comando, editar una línea. Claude Code es exactamente eso, dentro de tu terminal.
La memoria del agente tiene dos fuentes: la conversación actual (lo que dijiste y lo que leyó en esta sesión) y lo que apunta para que consulte (archivos, reglas, índices). El problema: la conversación desaparece cuando termina la sesión, y señalar "todo el repositorio" rara vez cabe. Esa es la brecha que resuelve el curso.
✓ Memoria real
- ✓Persiste entre sesiones.
- ✓Se puede consultar: el agente encuentra lo que necesita.
- ✓Guarda relaciones, no solo texto suelto.
✗ Solo la sesión
- ✗Lo olvida todo al cerrar.
- ✗Empieza desde cero en proyectos grandes.
- ✗Vuelve a aprender el mismo contexto cada vez.
🔑 Conceptos clave
🪟 La ventana de contexto y sus límites
A ventana de contexto es la cantidad de texto que el modelo puede leer de una vez. Se mide en tokens — fragmentos de palabras (de unos 3 a 4 caracteres cada uno). Es grande, y los modelos más nuevos llegan a 1 millón de tokens, pero aun así es finita: un repositorio entero, con cientos de archivos, rara vez cabe junto.
🔰 ¿Eres nuevo aquí? Qué es un «token»
Un token es la unidad que lee el modelo. La palabra «memoria» puede convertirse en 2 o 3 tokens. Cuanto más metes en la ventana, más «paga» por leerlo, y hay un límite. Por eso, elegir qué leer importa tanto.
↑ En la ventana cabe un puñado de archivos; el repositorio entero se desborda. Por eso el agente necesita elegir bien qué leer, y un mapa ayuda a elegirlo.
🔑 Conceptos clave
🔍 Por qué buscar texto (grep) no es suficiente
Cuando el agente no tiene un mapa, su herramienta es el grep: la búsqueda literal de una palabra dentro de los archivos. Encuentra dónde el término aparece, pero no sabe qué se relaciona sin el qué ni el porqué. «Encontrar» no es «entender».
🔰 ¿Eres nuevo aquí? Qué es «grep»
grep es un comando clásico de terminal que busca una palabra en archivos y devuelve las líneas donde aparece. Es útil, pero limitado: no conoce sinónimos, contexto ni conexiones.
↑ grep devuelve una lista de posiciones; el mapa devuelve el concepto e tus vecinos. Es la diferencia entre una lista de direcciones y un mapa del barrio.
🔑 Conceptos clave
🧩 Qué es un "segundo cerebro"
"Segundo cerebro" es un término de productividad personal: una base de conocimiento externa y organizada que consultas en vez de intentar recordarlo todo. Aquí adaptamos la idea para el agente: el segundo cerebro es el grafo + o vault que guardan la comprensión de un proyecto fuera de la sesión efímera.
💡 La idea central del curso
Sacar el conocimiento de una conversación que desaparece y ponerlo en un lugar persistente, navegable y consultable, para que tú e por el agente.
- •Persistente: no desaparece cuando se cierra la sesión.
- •Navegable: conceptos conectados por enlaces, no archivos sueltos.
- •Consultable: el agente encuentra lo que necesita sin revisar todo.
🔰 ¿Eres nuevo aquí? Qué es «PKM»
PKM (Personal Knowledge Management, gestión personal del conocimiento) es la práctica de guardar y conectar lo que aprendes. Obsidian es una herramienta de PKM, y por eso encaja tan bien aquí.
🔑 Conceptos clave
📝 Lo que Claude Code ya incluye de forma nativa
Claude Code no es amnésico de fábrica. Ya lee un archivo CLAUDE.md en la raíz del proyecto con instrucciones y preferencias, y tiene su propia memoria. Eso es excelente para reglas ("siempre ejecuta las pruebas", "usa portugués") — pero no es un mapa de un repositorio entero.
# Projeto X - Sempre responda em português. - Rode os testes antes de dizer "pronto". - A documentação de referência está em ./docs.
Observa: el CLAUDE.md dice "la documentación está en ./docs", pero no dice cómo se conectan los conceptos de la documentación. Ahí es donde entra Graphify: no compite con la herramienta nativa, sino que complementa: el nativo guarda reglas; el grafo guarda el mapa.
🔑 Conceptos clave
🎯 La promesa del stack Graphify + Obsidian
Al juntarlo todo: el Graphify crea el mapa a partir de un repositorio o de documentos; el Obsidian guarda este mapa como markdown navegable; el Claude Code consulta el mapa en el contexto de tu proyecto. Juntos, son el segundo cerebro.
Graphify crea el mapa
Extrae entidades, relaciones y comunidades de una fuente. Resultado: el grafo.
Obsidian guarda el mapa
Un archivo markdown por concepto, con backlinks. Persistente y navegable.
Claude Code consulta el mapa
Responde sobre el proyecto en el contexto adecuado, sin releerlo todo.
🔑 Conceptos clave
✋ Autorrecuperación (opcional, no bloquea): por qué un mapa del conocimiento ayuda más que solo grep?
📌 Resumen del módulo
Siguiente módulo
1.2 · Grafo de conocimiento sin misterios — nodos, aristas, comunidades y god nodes.