«Cada nuevo chat empieza de cero: vuelves a explicar una y otra vez tu negocio, tus ofertas y tus historias, y si te callas obtienes una respuesta pulida que serviría para cualquiera», con esa frase arranca el especialista en automatización con IA Julian Goldie su experimento de memoria para redes neuronales. Al abrir una sesión limpia en la consola, veo a un becario en su primer día de trabajo, que todavía no conoce ni nuestras reglas ni las decisiones pasadas.
¿Cómo enseñar al agente de terminal Claude Code de Anthropic a escribir textos y código teniendo en cuenta el historial de los proyectos, y no como un bot anónimo? Basta con convertir una carpeta de notas de Obsidian en un «segundo cerebro» mediante un archivo de reglas y habilidades, para que el agente se apoye desde el primer momento en los reglamentos y la experiencia del equipo.
Por qué los agentes sufren amnesia y por qué necesitan un ancla externa de conocimiento
Si una sesión en la terminal arranca de cero (como indica explícitamente la documentación de Anthropic), sin un apoyo externo el modelo devuelve frases genéricas. En cambio, si diriges al agente hacia un almacén de Obsidian (Vault), donde las notas en Markdown se enlazan con corchetes [[wikilinks]] formando un grafo, antes de responder estudia primero tu base.
Julian Goldie lo comprobó en Claude Code con la tarea de redactar una guía para configurar el primer agente SEO. Sin base, el modelo soltó relleno («Un agente SEO es una IA para tareas repetitivas»). Con una base de 39 notas, el agente cargó la habilidad en el segundo 9, leyó la política editorial con las palabras prohibidas (leverage, robust), encontró el reglamento del informe SEO y la reseña de Kirk. En 35 segundos montó una guía de 6 pasos con prompts, las herramientas Hermes Agent y Gemma, la cita de Kirk y enlaces a las notas.
Te preguntarás: «¿Para qué montar memoria sobre archivos de Obsidian si existen Notion en la nube, Mem.ai o bases vectoriales como Pinecone y Chroma?»
Comparé ambos enfoques. La nube ata el conocimiento al servidor de un tercero, mientras que un vault local en Obsidian (igual que en Logseq, Foam o Dendron) es una carpeta en disco con archivos Markdown y YAML frontmatter, versionable en Git. El patrón Index-First sustituye a las bases vectoriales: el agente lee primero el archivo índice y abre solo las notas necesarias, ahorrando tokens.
Tres pilares de la integración: almacén de notas, archivo de reglas CLAUDE.md y habilidades
El sistema se apoya en tres elementos:
- Almacén (Vault). En el caso de Goldie, la base se divide en 6 carpetas (
Brand,SOPs,Stories,Testimonials,Offers,Tools), mientras que en desarrollo se usan00-inbox,01-projectsy02-memory. - Memoria
CLAUDE.mdy automemoria. Al iniciar la sesión, el agente lee el estatutoCLAUDE.mdyauto memory. Cuando Goldie pidió terminar las guías con la línea «Haz esto hoy», el agente anotó en 23 segundos la regla enCLAUDE.md. En una nueva sesión sobre soporte, buscó por sí solo con la etiquetasupportlas historias de Jeremy y Tan y cerró el texto con la llamada adecuada. - Habilidades (
Claude Code Skills). La carpeta.claude/skillscon el archivoSKILL.md(y plugins como Claudian) fija el algoritmo de verificación de hechos antes de generar.
Para trazar la ruta por la base y proteger la configuración del editor, se coloca CLAUDE.md en la raíz:
# Reglas de trabajo de Claude Code con la base de Obsidian
- **Formato de notas:** Todos los archivos deben ser Markdown puro con YAML frontmatter. Conserva las etiquetas existentes.
- **Enlaces internos:** Para conectar conceptos usa la sintaxis estándar [[wikilinks]].
- **Restricciones del sistema:** Queda terminantemente prohibido modificar archivos dentro de la carpeta de servicio `.obsidian/`.
- **Protocolo de memoria:**
1. Antes de resolver una tarea, revisa las restricciones clave en `02-memory/decisions.md`.
2. Realiza la búsqueda mediante archivos índice (`01-projects/index.md`), sin leer todos los archivos seguidos.
3. Al terminar la tarea, añade un breve resumen en `00-inbox/changelog.md`.
Estas reglas protegen las etiquetas YAML frontmatter y bloquean el acceso a la carpeta de servicio .obsidian/ para que el agente no rompa los ajustes del almacén. El protocolo guía la búsqueda Index-First a través de decisions.md, index.md y el registro changelog.md, mientras que Git auto-sync protege frente a conflictos de edición.
Configuración paso a paso en 6 pasos
Puedes montar esta integración en seis pasos:
- Crea el almacén. Instala Obsidian y crea una carpeta vault (
Agent OS Vault). - Estructura las carpetas. Crea las secciones (
00-inbox,01-projects,02-memory) y el mapaindex.md. - Escribe 5 notas. Añade política editorial, un reglamento SOP, dos reseñas y un producto con enlaces
[[wikilinks]]. - Lanza el agente. En la terminal abre la carpeta de la base y escribe
claude. - Configura
CLAUDE.md. Define las reglas de estilo y la protección de.obsidian/. - Conecta una habilidad. Crea
.claude/skills/guide-writer/SKILL.mdy comprueba la búsqueda.
Sobre la conexión de notas al estilo Luhmann puedes leer en el análisis de la base de conocimiento con Claude y Obsidian. ¿Y qué regla o palabra prohibida anotarás hoy mismo en tu CLAUDE.md para no volver a explicársela dos veces a la red neuronal?

