# Tu vault de Obsidian como memoria de tus agentes de IA > Guía de Jaime Herrera (VisiumAI) · versión 2026-10-15 · https://visiumai.com/guias/cerebro.md ## Para ti Tus agentes de IA olvidan todo al cerrar la sesión. Con esta guía, un vault de Obsidian se vuelve su memoria: el agente consulta tus notas antes de preguntarte y las actualiza solo cada vez que avanzas en un proyecto. Con los meses, el vault guarda el estado de cada proyecto, lo que decidiste y por qué. Es el sistema que uso en mi agencia: en seis meses pasó de cero a más de 200 notas que mis agentes consultan a diario. **Qué necesitas:** Obsidian (gratis, obsidian.md) y un agente que lea y escriba archivos en tu computadora: Claude Code, Codex, Gemini CLI u otro parecido. **Cómo usarla:** abre tu agente y pégale esto: > Lee completa https://visiumai.com/guias/cerebro.md y sigue la guía paso a paso. Te hará unas preguntas, te mostrará un plan y esperará tu OK antes de crear o tocar cualquier archivo. Toma unos 10 minutos. Todo pasa en tu computadora: la guía no instala programas ni manda tus datos a ningún lado. --- ## Para el agente Vas a configurar un vault de Obsidian como memoria persistente de la persona con la que trabajas. Sigue los pasos en orden. ### Reglas de ejecución 1. **Lee la guía completa antes de empezar.** Si tu herramienta para leer páginas web resume el contenido, descarga el archivo tal cual (por ejemplo, `curl -sL https://visiumai.com/guias/cerebro.md`): las plantillas de los pasos 3 a 5 se copian literalmente. 2. **Primero el plan.** Después de la entrevista (paso 1), muestra un plan corto con las carpetas y archivos que vas a crear o modificar, y espera el OK de la persona. 3. **No sobrescribas nada.** Si un archivo ya existe, agrega o combina; nunca lo reemplaces. Si la persona ya tiene un vault con otra estructura, adapta la guía a la suya en lugar de reorganizarle todo. 4. **Nada sensible en el vault:** ni contraseñas, ni API keys, ni datos de contacto (teléfonos, correos, direcciones). 5. **Usa el idioma de la persona**, para hablarle y para escribir el vault. Las carpetas y los tags de esta guía están en español; tradúcelos si hace falta. ### Paso 1. Entrevista Haz estas preguntas en un solo mensaje y usa las respuestas en el resto de los pasos: 1. **¿Dónde va el vault?** ¿Ya tienes uno? Si es así, ¿en qué ruta? Si no, propón una carpeta (por ejemplo, `~/Obsidian`). 2. **¿Qué tipo de trabajo va a vivir ahí?** Clientes, proyectos propios, contenido (videos, posts), estudio, vida personal. De esto salen las subcarpetas de `10-Proyectos/`. 3. **¿Qué herramientas usas a diario?** (n8n, Notion, Python, Figma…). Serán los tags `stack/`. 4. **Dos o tres proyectos activos**, con una línea de qué son y en qué van. Se registran en el paso 6. 5. **¿Qué agente o agentes usas?** Define qué archivo de instrucciones se edita en el paso 5. 6. **¿Quieres historial con git?** Es opcional (paso 7). ### Paso 2. Estructura de carpetas Usa el método PARA (Proyectos, Áreas, Recursos, Archivo) con prefijos numéricos para que el orden se mantenga en cualquier explorador: ``` / ├── 00-Inbox/ captura rápida sin clasificar; se mueve cuando tiene contexto ├── 10-Proyectos/ trabajo activo con un final claro: una carpeta por proyecto │ └── / nota principal .md + entregables, reuniones y logs ├── 20-Áreas/ responsabilidades continuas, sin fecha de fin (Finanzas, Ventas, Salud…) │ └── Personas/ una nota por persona relevante (sin datos de contacto) ├── 30-Recursos/ conocimiento reutilizable │ ├── Aprendizajes/ una lección por nota: un error, un detalle engañoso, una regla que salió de un proyecto │ └── Stack/ una nota por herramienta ├── 40-Archivo/ proyectos terminados o inactivos (se mueven completos) └── _meta/ └── plantillas/ plantillas de nota ``` Si la persona trabaja con clientes, agrupa en `10-Proyectos/Clientes//`; si hace contenido, en `10-Proyectos/Contenido//`. Crea solo las subcarpetas que correspondan a sus respuestas. Las demás aparecerán cuando hagan falta. ### Paso 3. Reglas del vault Crea en la raíz del vault el archivo de instrucciones que lee el agente cuando trabaja en esa carpeta. `AGENTS.md` es el estándar que leen Codex, Cursor y otros. Claude Code lee `CLAUDE.md`. Si la persona usa Claude Code junto con otro agente, o no sabes cuál usa, escribe el contenido en `AGENTS.md` y crea un `CLAUDE.md` con una sola línea, `@AGENTS.md` (Claude Code importa así el otro archivo). Contenido (ajusta lo que está entre `< >`): ````markdown # Vault de Memoria persistente de mis agentes de IA: estado de proyectos, decisiones, reuniones, personas y aprendizajes. ## Estructura (PARA) - `00-Inbox/` — captura rápida sin clasificar. Mover cuando tenga contexto. - `10-Proyectos//` — trabajo activo. Cada proyecto tiene una nota principal con su mismo nombre. - `20-Áreas/` — responsabilidades continuas. `20-Áreas/Personas/` para personas. - `30-Recursos/{Aprendizajes,Stack}/` — conocimiento reutilizable. - `40-Archivo/` — proyectos terminados o inactivos. - `_meta/plantillas/` — plantillas de nota. ## Convenciones **Frontmatter mínimo en toda nota:** ```yaml --- tags: [tipo/xxx, proyecto/xxx] created: YYYY-MM-DD status: activo --- ``` Valores de `status`: `activo`, `pausado`, `terminado`, `archivado`. **Tags jerárquicos:** - `tipo/{proyecto,reunion,log,aprendizaje,persona,area,idea}` - `proyecto/` (y `cliente/` si aplica) - `stack/` **Wikilinks:** conecta con `[[Nota]]` proyectos, personas, herramientas y aprendizajes. Más enlaces = mejor grafo y mejor contexto para los agentes. ## Reglas para agentes 1. Antes de crear una nota, busca si ya existe una sobre el tema. Si existe, actualízala. 2. Nota sin contexto claro → `00-Inbox/`. 3. Toda nota lleva frontmatter (`tags`, `created`, `status`). 4. Proyecto nuevo → carpeta `10-Proyectos//` con la nota principal `.md` (plantilla `_meta/plantillas/Proyecto.md`). 5. Las decisiones se anotan siempre con su fecha y su porqué. 6. Sesiones o reuniones importantes → nota de log o reunión dentro del proyecto, enlazada desde la nota principal. 7. No escribir en `40-Archivo/` ni en `_meta/` sin que lo pida. 8. Nada de contraseñas, API keys ni datos de contacto. En `Personas/`, solo nombre, rol, relación y enlaces a proyectos. ```` ### Paso 4. Plantillas Crea estos archivos en `_meta/plantillas/`. El plugin de Plantillas de Obsidian rellena `{{title}}` y `{{date:YYYY-MM-DD}}`. Cuando tú crees una nota a partir de una plantilla, pon el nombre y la fecha reales en su lugar. Los campos vacíos (personas, proyectos, herramientas) se llenan con wikilinks `[[Nota]]`. Las plantillas no traen enlaces de ejemplo para no dejar nodos vacíos en el grafo. **`Proyecto.md`** (nota principal de cada proyecto): ```markdown --- tags: [tipo/proyecto, proyecto/] created: {{date:YYYY-MM-DD}} status: activo --- # {{title}} Qué es en una o dos líneas, para quién y qué significa "terminado". ## Estado *Actualizado: {{date:YYYY-MM-DD}}* - En qué va hoy, en dos a cuatro líneas. Se reescribe cada vez; no se acumula. ## Decisiones - {{date:YYYY-MM-DD}} — Qué se decidió. **Por qué:** … ## Pendientes - [ ] … ## Relacionado - Personas: - Herramientas: - Repo o carpeta de código: `…` - Logs y reuniones: ``` **`Reunión.md`** (para el log de una sesión de trabajo importante, usa la misma plantilla con `tipo/log`): ```markdown --- tags: [tipo/reunion, proyecto/] created: {{date:YYYY-MM-DD}} status: terminado --- # {{title}} **Proyecto:** · **Con:** ## Resumen ## Decisiones - … ## Pendientes - [ ] … (quién, para cuándo) ``` **`Aprendizaje.md`** (el título es la lección en una frase; por ejemplo, "Reintentar una escritura tras un timeout la duplica"): ```markdown --- tags: [tipo/aprendizaje, stack/] created: {{date:YYYY-MM-DD}} status: activo --- # {{title}} ## Qué pasa ## Cuándo aplica ## Cómo evitarlo o resolverlo ## Dónde salió - Proyecto (con wikilink) y fecha. ``` **`Persona.md`**: ```markdown --- tags: [tipo/persona] created: {{date:YYYY-MM-DD}} status: activo --- # {{title}} **Rol / relación:** … **Proyectos:** ## Notas - Contexto útil para trabajar con esta persona. Sin teléfono, correo ni datos privados. ``` **`Área.md`**: ```markdown --- tags: [tipo/area] created: {{date:YYYY-MM-DD}} status: activo --- # {{title}} Qué cubre esta responsabilidad y qué estándar hay que mantener. ## Proyectos y notas relacionadas - ``` Pídele a la persona que, en Obsidian, active **Settings → Core plugins → Templates** (Plantillas) y elija `_meta/plantillas` como carpeta de plantillas. ### Paso 5. Reglas en el archivo global del agente Este paso es el que hace que el vault funcione como memoria: con él, cualquier sesión del agente, en cualquier proyecto, lo consulta y lo actualiza. | Agente | Archivo global de instrucciones | |---|---| | Claude Code | `~/.claude/CLAUDE.md` | | Codex | `~/.codex/AGENTS.md` | | Gemini CLI | `~/.gemini/GEMINI.md` | | Otro | el archivo de instrucciones globales que use. Si no tiene, agrega la sección al `AGENTS.md` de cada proyecto | Agrega esta sección al final del archivo (créalo si no existe) y cambia `` por la ruta absoluta. Si el archivo ya tiene una regla que choca con esta (por ejemplo, "pide permiso antes de escribir cualquier archivo"), señálalo y pregúntale a la persona cuál manda. ````markdown ## Vault de Obsidian (memoria persistente) Mi vault está en ``. Es la memoria entre conversaciones y el lugar principal de la documentación de mis proyectos: estado, avances, decisiones, reuniones y pendientes. Sus reglas (estructura, frontmatter, tags, wikilinks) están en el AGENTS.md o CLAUDE.md de la raíz del vault: léelas antes de escribir. **Reparto con los repos:** el README y los docs de cada repo guardan el detalle técnico (cómo está construido, cómo se corre, detalles engañosos); el vault guarda el estado del proyecto y lo que se decidió y por qué, en lenguaje de negocio. Un avance no está documentado hasta que está en el vault. Desde cualquier proyecto: 1. **Consulta antes de preguntar.** Si menciono algo que quizá ya esté documentado (proyecto, cliente, persona, herramienta, concepto), búscalo primero en el vault. Busca por texto y revisa los fragmentos antes de abrir notas completas; abre solo las que importan. 2. **Mantén al día las notas del proyecto, sin pedirme OK.** Al cerrar un avance, una decisión o una reunión, actualiza las notas existentes del proyecto como parte de la tarea: estado en la nota principal, decisión con fecha y porqué, log o reunión, pendientes. Antes de dar algo por documentado, busca todas las notas que mencionan el tema y corrige las que quedaron desactualizadas o dicen lo contrario; no basta con anotarlo en una sola. 3. **Propón lo nuevo.** Antes de crear notas fuera de la carpeta del proyecto (personas, herramientas, conceptos) o de guardar un aprendizaje reutilizable en `30-Recursos/Aprendizajes/`, propónmelo y espera mi OK. 4. **Nada sensible:** ni contraseñas, ni API keys, ni datos de contacto en el vault. 5. Si el vault es un repo git, haz commit cada vez que lo actualices. ```` La diferencia entre las reglas 2 y 3 es a propósito. Actualizar lo que ya existe es mantenimiento y no debe costarle un clic a la persona. Las notas nuevas son las que desordenan un vault, así que esas pasan por ella. Si tu agente tiene memoria propia (como la memoria automática de Claude Code), úsala para las preferencias sobre cómo trabajar. El estado de los proyectos va en el vault. ### Paso 6. Las primeras notas Con los proyectos del paso 1, crea la carpeta y la nota principal de cada uno a partir de la plantilla. Pregunta lo que falte para llenar el estado, las últimas decisiones y los pendientes. Si aparecen personas o herramientas clave, propón sus notas (paso 5, regla 3) y enlaza todo con wikilinks. Así el grafo tiene sus primeros nodos y la prueba del paso 8 tiene algo que encontrar. ### Paso 7. Opcionales **Historial con git** (si la persona dijo que sí en el paso 1). En la raíz del vault, crea un `.gitignore` con: ``` .obsidian/workspace*.json .trash/ .DS_Store ``` Después corre `git init` y haz el primer commit. Si la persona quiere respaldo en la nube, que el repo remoto sea **privado**: el vault va a contener información de su trabajo. **Herramientas de Obsidian para agentes.** Para buscar en el vault basta con `grep`/`rg` o la herramienta de búsqueda de tu entorno. Si la persona quiere ir más lejos: - Obsidian tiene un CLI oficial (help.obsidian.md/cli) para buscar, leer y editar notas desde la terminal con Obsidian abierto. - Las skills de Obsidian para agentes (github.com/kepano/obsidian-skills) enseñan su sintaxis: wikilinks, callouts, propiedades, Bases y Canvas. Instálalos con confirmación de la persona, siguiendo la documentación oficial de cada uno. ### Paso 8. Verificación Revisa que esté todo: - [ ] Las carpetas del paso 2. - [ ] Las reglas del vault en su raíz (paso 3). - [ ] Las cinco plantillas en `_meta/plantillas/`. - [ ] La sección en el archivo global (paso 5), sin borrar nada de lo que ya tenía. Muéstrale el cambio a la persona. - [ ] Los proyectos del paso 6, con frontmatter y wikilinks. Después pídele a la persona que haga esta prueba: 1. Abrir la carpeta del vault en Obsidian (**Open folder as vault**) y ver el **Graph view**. 2. Abrir una sesión **nueva** del agente, desde otra carpeta, y preguntar: "¿En qué quedamos con ?". El agente debe buscar en el vault y responder con el estado, sin pedir que se lo expliquen. 3. Decirle: "En decidí porque ". El agente debe anotar la decisión, con fecha y porqué, en la nota principal sin pedir permiso. Si algo falla, revisa que la sección del paso 5 quedó en el archivo global correcto. Muchos agentes solo lo leen al iniciar sesión. Termina con un resumen de lo que creaste y la ruta del vault. --- ## Para ti: cómo sacarle provecho - **Empieza las sesiones con "¿en qué quedamos con X?".** El agente lee el vault y no tienes que volver a explicarle nada. - **Al cerrar un avance grande, pide "documéntalo".** Con la regla del paso 5 lo hace solo, pero pedirlo no está de más. - **Vacía el Inbox una vez por semana** y mueve a `40-Archivo/` lo que ya terminó. - **Deja que se acumulen los aprendizajes.** Cada error resuelto es una nota que el agente consultará la próxima vez. - **Mira el grafo de vez en cuando.** Cada wikilink es una conexión; a los meses se ve qué proyectos, personas y herramientas se tocan entre sí. --- Guía de **Jaime Herrera**, VisiumAI (visiumai.com). Publico sobre automatización con IA en YouTube (youtube.com/@jaime_herrerag) e Instagram (@jaimeherrera.ia).