La carpeta con tus notas. Es lo que importa y es tuya.
~/notas/Le cuentas tu proyecto entero a Claude. Le explicas quién eres, a qué te dedicas, qué llevas montado, qué decidiste el mes pasado y por qué. Trabajáis bien dos horas. Al día siguiente abres una ventana nueva y no se acuerda de nada.
Esta guía monta lo contrario: una carpeta de archivos de texto que Claude lee al empezar y escribe al terminar, sin que se lo pidas. No es otra inteligencia artificial ni una suscripción más. Son archivos .md en tu disco, gratis, que siguen siendo tuyos el día que decidas no usar Claude.
01 el problema
Lo caro no es que se olvide. Lo caro es el rato que tardas en devolverle el contexto, y que ese rato se repite cada vez que abres una ventana nueva.
Haz la cuenta con tu propio caso antes de seguir leyendo, porque el número decide si esto te compensa. Si trabajas con Claude tres veces por semana y cada arranque te cuesta doce minutos de ponerle al día, son más de dos horas al mes que no producen nada: son dos horas de repetir lo que ya habías dicho.
Y hay una segunda factura, más silenciosa. Cuando le vuelves a explicar el proyecto, no se lo explicas igual. Cuentas lo que recuerdas hoy, no lo que decidiste entonces. Al cabo de un mes trabajas sobre una versión resumida y algo deformada de tu propio proyecto, y ni tú ni él sabéis qué se ha caído por el camino.
Si no vas a medir tus arranques durante una semana, no montes esto todavía.
Puede que tu caso sean veinte minutos al mes y no merezca la pena. **Medir
primero es el método, no una formalidad.**
Es lo primero que hace todo el mundo: un documento con «contexto del proyecto» que copias y pegas al abrir cada sesión. Funciona una semana y luego se rompe por dos sitios.
decisiones importantes de la última quincena no están ahí.
Pegar veinte páginas para preguntar una cosa es caro y además lo distrae.
lo que estás tocando esta semana.
La diferencia entre un resumen pegado y una bóveda es la misma que entre contar de memoria y poder abrir el archivo.
02 el concepto
Una bóveda de Obsidian es una carpeta de tu ordenador con archivos .md dentro. Nada más. No hay servidor, no hay cuenta obligatoria, no hay base de datos. Si borras Obsidian mañana, los archivos siguen ahí y los abre cualquier editor de texto.
Obsidian es el programa que los enseña bonito y los enlaza entre sí. La bóveda es la carpeta, no el programa, y esa distinción es la que hace que esto no sea una jaula: el día que quieras irte, te llevas la carpeta.
La carpeta con tus notas. Es lo que importa y es tuya.
~/notas/El programa que las lee, las enlaza y las busca. Gratis para uso personal.
obsidian.mdLe enseñan a Claude a escribir en el formato de Obsidian.
kepano/obsidian-skillsLas instrucciones permanentes. El paso que casi nadie da.
~/notas/CLAUDE.mdAquí no hace falta ninguna IA todavía. Una bóveda es una carpeta ordenada, y
mucha gente saca la mitad del beneficio sin conectar nada: por fin tiene sus
decisiones escritas en un sitio que puede buscar.
03 el formato
Tú te defiendes en inglés. Pero piensas en español, y en tu idioma vas más rápido, entiendes a la primera y te equivocas menos. Con Claude pasa exactamente lo mismo.
Se traga un PDF, una hoja de cálculo, una captura de pantalla, lo que le eches. Pero cada uno de esos formatos hay que convertirlo antes de que pueda leerlo, y en la conversión se pierde cosas: la maquetación de un PDF, las fórmulas de una hoja, el texto de una imagen que el reconocimiento lee regular.
El markdown no hay que convertirlo. Es texto plano con marcas, que es exactamente la forma en la que un modelo de lenguaje está entrenado a leer y a escribir. Gasta menos en leerlo y se entera mejor.
| Formato | Qué pasa al leerlo | Qué se pierde |
|---|---|---|
| Markdown | Se lee tal cual | Nada |
| Texto plano | Se lee tal cual | La estructura, si la tenía |
| Hay que extraer el texto | Columnas, tablas, orden de lectura | |
| Hoja de cálculo | Hay que volcarla a texto | Las fórmulas, que son la lógica |
| Captura | Reconocimiento óptico | Lo que esté torcido o pequeño |
Hay una consecuencia práctica que se nota enseguida: Claude no solo lee mejor el markdown, sino que lo escribe. Puede dejar una nota nueva en tu bóveda con el mismo esfuerzo con que te contesta. Con un PDF eso no pasa.
No conviertas tus PDF a markdown en masa «por si acaso». Convierte **lo que vayas
a usar**, cuando lo vayas a usar. Una bóveda con cuatrocientas notas basura es
peor que no tener bóveda: la búsqueda deja de servir.
04 manos a la obra
Antes del paso importante hay tres cosas, y las tres son de cinco minutos. Se hacen una vez.
Es gratis para uso personal y no pide tarjeta. Al abrirlo te pregunta dónde quieres la bóveda: elige una carpeta y recuérdala, porque la vas a nombrar en los dos pasos siguientes.
Están publicadas y abiertas en GitHub. Le enseñan a Claude el formato de Obsidian: los enlaces entre notas, las propiedades de la cabecera, los avisos de color, las vistas de tabla.
Éste es el paso que la gente se salta y luego se pregunta por qué no funciona. No configuras tú: le dices dónde está la carpeta y que se prepare él.
El repositorio se instala como plugin, con dos líneas dentro de Claude Code:
/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skillsY si prefieres no pasar por el mercado de plugins, el propio repositorio documenta esta otra:
npx skills add https://github.com/kepano/obsidian-skillsEl clonado a mano, si lo buscas, tiene truco
La forma que parece obvia —git clone del repo dentro de
~/.claude/skills/obsidian— no funciona, y no avisa. El repositorio no es
una skill: es un contenedor con cinco dentro. Te deja los SKILL.md en
~/.claude/skills/obsidian/skills/<nombre>/SKILL.md, o sea un nivel más abajo
de donde Claude Code los busca. No carga ninguna, no da ningún error, y tú te
quedas pensando que las tienes.
Si quieres hacerlo a mano, lo que dice el repositorio es esto otro: copiar su
contenido a una carpeta .claude/ en la raíz de tu bóveda. Así quedan en
.claude/skills/<nombre>/ y además viajan con la bóveda, que para esta guía
tiene bastante sentido.
Comprueba que han entrado. Es lo que casi nadie hace y evita media hora de desconcierto: la instalación rota y la buena se ven exactamente igual hasta que le pides algo y no lo hace.
ls ~/.claude/skillsTienen que aparecer las cinco por su nombre: defuddle, json-canvas, obsidian-bases, obsidian-cli y obsidian-markdown. Si en su lugar ves una sola carpeta con un README.md dentro, has caído en lo del aviso de arriba.
Con las skills dentro, abre Claude Code en la carpeta de tu bóveda y pégale esto. No lo pegues en un chat del navegador: tiene que ser en la carpeta, porque la gracia es que vea los archivos.
Esta carpeta es mi bóveda de Obsidian y va a ser tu memoria entre sesiones. Antes de proponer nada, haz esto en orden: 1. Recorre la carpeta y dime qué hay: cuántas notas, cómo están organizadas hoy, y si detectas alguna convención que yo ya esté usando sin saberlo. 2. Dime qué NO vas a tocar. Quiero saber los límites antes de darte permiso. 3. Propón una estructura de carpetas por TIPO de nota, no por tema. Los temas cambian cada trimestre; los tipos duran años. 4. Escribe un borrador de CLAUDE.md para esta carpeta que diga: - qué es esta bóveda y para qué la uso - dónde escribes tú y dónde no - qué formato tiene una nota nueva - qué haces al terminar una sesión de trabajo No crees ni muevas ningún archivo todavía. Enséñame el plan y espera.
La última línea no es cortesía. Sin ella empieza a mover cosas, y una bóveda reorganizada sin que la hayas mirado es exactamente el desastre que esta guía existe para evitar.
05 las piezas
Las skills son carpetas con instrucciones que Claude carga cuando le hacen falta. Las de Obsidian están publicadas por el responsable del propio Obsidian, que es la razón de que hablen el formato con exactitud.
El formato de Obsidian: enlaces entre notas, incrustaciones, avisos de color y las propiedades de la cabecera. Es la que usarás siempre.
.md con wikilinksLeer, crear y buscar notas desde la terminal, hablando con el Obsidian que tienes abierto. También vale para desarrollar plugins.
obsidian search query="reunión"Las vistas de base de datos: tablas y tarjetas con filtros y fórmulas sobre tus propias notas.
.baseLos lienzos visuales: mapas mentales y diagramas de flujo como archivo abierto.
.canvasConvierte una página web en markdown limpio, sin menús ni publicidad. Gasta mucho menos que tragarse el HTML entero.
defuddle <url>obsidian-cli no funciona recién instalada
Es la única de las cinco que pide algo más, y si no lo haces no da error: no
hace nada. Tres cosas. Uno, el binario se llama obsidian, no
obsidian-cli —el nombre de la skill no es el nombre del comando—. Dos, hace
falta el instalador 1.12 de Obsidian, versión 1.12.7 o superior. Y tres,
hay que encenderla en Ajustes → General → Command line interface.
Y una cosa más que conviene saber: habla con el Obsidian que está abierto.
Si lo tienes cerrado, el primer comando te lo abre. No es una vía para tocar la
bóveda con el programa apagado.
Si es tu primer día, la que importa es obsidian-markdown. Las otras cuatro entran solas cuando el trabajo las pide. Instalar las cinco y usar una no es un problema: no ocupan nada y no se cargan hasta que hacen falta.
defuddle no parece de Obsidian y es la que más se acaba usando. Cuando le pasas un enlace a Claude, por defecto se traga la página entera: menús, pies, banners de galletas y el artículo. Con defuddle recibe solo el artículo, en markdown. Es más barato, es más rápido y se entera mejor, que es el mismo argumento del apartado anterior aplicado a la web.
06 el paso que falta
Aquí es donde esto deja de ser «una carpeta con notas» y pasa a ser memoria.
El CLAUDE.md es un archivo de texto en la raíz de tu bóveda con instrucciones permanentes. Claude Code lo lee al arrancar en esa carpeta, siempre, sin que se lo pidas. Es la diferencia entre tener que decirle qué hacer y que ya lo sepa.
# Esta bóveda Es mi memoria de trabajo. Lo que no esté escrito aquí, no existe. ## Qué eres tú aquí Lees esta carpeta al empezar y escribes en ella al terminar. No me pidas permiso para leer. Sí me lo pides para borrar o mover. ## Dónde escribes - `diario/AAAA-MM-DD.md` — lo que se ha hecho hoy y qué queda abierto - `decisiones/` — una nota por decisión, con la fecha y el porqué - `proyectos/<nombre>/` — el estado vivo de cada proyecto ## Dónde NO escribes - `archivo/` — es pasado, se lee y no se toca - Cualquier nota cuya cabecera diga `bloqueada: true` ## Qué haces al terminar una sesión Sin que te lo pida, y en este orden: 1. Añade al diario de hoy qué se ha tocado y qué queda a medias. 2. Si se ha decidido algo, escríbelo en `decisiones/` con la fecha y el motivo por el que se descartó la alternativa. El motivo es lo importante. 3. Actualiza el estado del proyecto si ha cambiado. 4. Dime en una línea qué has escrito. No me enseñes el contenido entero. ## Cómo escribes - Español, frases cortas, sin adornos. - Una decisión por nota. Nada de notas cajón de sastre. - Fecha siempre. Una nota sin fecha deja de valer a las tres semanas. - Si algo es una suposición, escribes que es una suposición.
Anotar por qué se descartó la alternativa parece burocracia y es lo único que te salva dentro de tres meses. Vas a volver sobre una decisión, vas a pensar «esto se podría haber hecho de otra forma», y sin esa línea vas a rehacer un debate que ya tuviste. Con esa línea tardas veinte segundos en recordar que ya lo miraste.
«Usamos texto plano.» Dentro de tres meses no te dice nada y vuelves a debatirlo desde cero como si fuera nuevo.
«Usamos texto plano; se descartó la base de datos porque no queríamos depender de un servicio.» Cierra el debate en veinte segundos.
07 el orden
La tentación es organizar por tema: una carpeta de «marketing», otra de «clientes», otra de «personal». Aguanta seis semanas. Después tienes notas que son de dos temas, temas que se han quedado vacíos y una carpeta «varios» que se come el resto.
Organiza por tipo, que es lo que no cambia:
diario/ — qué pasó cada día. Se escribe una vez y no se toca más.decisiones/ — una nota por decisión tomada, con su fecha y su porqué.proyectos/ — el estado vivo. Se reescribe encima.referencia/ — lo que consultas y no cambia: procesos, plantillas, datos.archivo/ — lo que ya no está vivo pero no quieres borrar.El tema no desaparece: vive en las etiquetas de la cabecera de cada nota, que es donde puedes tener tres a la vez sin que se rompa nada.
mkdir -p diario decisiones proyectos referencia archivoObsidian lee unas propiedades al principio del archivo, entre tres guiones. Son las que permiten después filtrar y montar tablas sin plugins raros.
--- titulo: fecha: 2026-08-31 tipo: decision estado: vivo etiquetas: [proyecto-x, precios] --- ## Qué se decidió ## Por qué ## Qué se descartó, y el motivo ## Cuándo hay que volver a mirarlo
El último apartado es el que casi nadie pone y el que más rentabiliza: una fecha de revisión convierte una nota muerta en un aviso.
08 los límites
Una bóveda conectada a un asistente es una carpeta en la que ese asistente puede entrar a mirar cuando le convenga. Eso conviene tenerlo presente antes de volcar cosas dentro.
usa un identificador y guarda la equivalencia fuera.
es lo que está hecho para eso.
entre leerlo tú y leerlo una herramienta.
aparecer en una respuesta dentro de tres meses, no entra.
Cualquier nota puede acabar en una respuesta
Esto no es una advertencia genérica de las que se ponen para cubrirse, pero
conviene decirla con precisión. Claude no carga la carpeta entera: busca y
abre lo que necesita, que es justo por lo que esto escala a mil notas.
Lo que importa es otra cosa: **no puedes saber de antemano qué va a decidir
abrir.** Cualquier nota de la bóveda es candidata en cualquier sesión futura, y
no hay un botón de «olvida esa nota» que funcione de verdad. La regla práctica no
cambia por el matiz: si no quieres que algo pueda aparecer citado dentro de tres
meses, no lo metas aquí.
09 lo que sale mal
Cuatrocientas notas importadas de tres sitios distintos, sin formato común. La búsqueda deja de discriminar y tú dejas de fiarte. Empieza con la bóveda vacía y deja que crezca con el trabajo de cada día.
Sin él tienes una carpeta bonita que hay que explicar cada vez, que es exactamente el problema de partida con un paso extra.
Ya está explicado arriba. Aguanta seis semanas.
Una nota sin fecha no se puede ordenar, no se puede caducar y no se puede auditar. A las tres semanas no sabes si describe cómo funcionan las cosas o cómo funcionaban.
Cuando le das permiso para mover archivos, míralo la primera vez. Después ya sabrás si te fías. La primera vez, míralo.
Y hazte el seguro, que son dos líneas y convierte este error en un susto:
cd tu-boveda && git init && git add -A && git commit -m "antes de tocar nada"Con la bóveda en git, un git diff te enseña exactamente qué movió y un git checkout . lo deshace entero. Son archivos de texto: git está hecho literalmente para esto. Coge la costumbre de commitear al cerrar el día.
El error de montaje, y el más silencioso de los seis. Si las skills no quedan donde Claude Code las busca —un SKILL.md por carpeta, colgando directamente de ~/.claude/skills/— no cargan y no hay ningún mensaje de error: Claude escribe markdown del corriente en vez de markdown de Obsidian, y tú tardas una semana en notarlo.
Es el que produce el clonado que parece obvio, porque deja las skills un nivel más abajo. La comprobación con ls del apartado del montaje existe justo para esto, y es el motivo de que insista tanto con ella.
10 el arranque
No montes el sistema entero de golpe. Hoy:
ls que están.te proponga. No apruebes nada que no entiendas.
Y al terminar tu próxima sesión de trabajo de verdad, escribe a mano la nota del diario. Una sola. Sirve para dos cosas: ves si el formato te encaja, y le das a Claude un ejemplo de cómo escribes tú antes de pedirle que escriba él.
La cuarta cosa —el CLAUDE.md con el ritual de cierre— la pones cuando lleves una semana y sepas qué quieres que anote. Ponerlo el primer día es escribir instrucciones para un trabajo que todavía no has hecho.
11 el hábito
Montar la bóveda es media hora. Lo que decide si sirve dentro de tres meses es lo que pasa en los dos minutos finales de cada sesión.
El ritual tiene tres piezas y las tres las ejecuta Claude si el CLAUDE.md se lo pide, pero la primera vez conviene dispararlo a mano para ver qué escribe.
Cierra la sesión. En este orden y sin preguntarme: 1. Añade a `diario/` la nota de hoy: qué se ha tocado, qué ha quedado a medias y qué es lo siguiente que hay que hacer. Tres o cuatro líneas. 2. Si se ha decidido algo, escribe una nota en `decisiones/` con: - la decisión, en una frase - por qué - qué alternativa se descartó y el motivo exacto - la fecha Si no se ha decidido nada, no inventes una decisión para rellenar. 3. Si el estado de un proyecto ha cambiado, actualiza su nota en `proyectos/`. Reescribe encima, no acumules versiones. Cuando acabes, dime en UNA línea qué has escrito y dónde. No me pegues el contenido: si quiero leerlo, abro el archivo.
Porque vas a descubrir dos cosas que no se ven leyendo: cómo de largo escribe —casi siempre más de lo que quieres— y qué considera una decisión. Las dos se corrigen añadiendo una línea al CLAUDE.md, y es mucho más barato corregirlas el primer día que después de treinta notas.
Antes de que te pida nada: 1. Lee la nota de `diario/` más reciente y dime en dos líneas dónde lo dejamos. 2. Mira si hay algo marcado como pendiente o a medias. 3. Si alguna nota de `decisiones/` tiene fecha de revisión y ya ha pasado, avísame. Una sola línea por cada una. No leas la bóveda entera. Con lo último basta para empezar.
La última instrucción no es un detalle. Sin ella se lee todo cada vez, y entonces has cambiado el problema de repetirte por el problema de pagar por leerlo todo en cada arranque.
12 qué esperar
Conviene decir esto porque la mayoría de las guías de este tipo terminan en el montaje y te dejan sin saber qué es normal.
Lo que mejora enseguida: el arranque. Abres, te dice dónde lo dejaste, y empiezas. Eso se nota el segundo día.
Lo que tarda: que la bóveda te devuelva algo que habías olvidado del todo. Para eso hace falta volumen, y el volumen tarda semanas. Las primeras dos no vas a buscar nada porque te acuerdas de todo.
Lo que no arregla: no te va a ordenar el trabajo. Una bóveda es un espejo fiel: si trabajas a saltos, tendrás notas a saltos. Lo que sí hace es que los saltos queden escritos y puedas verlos.
Cuando busques algo en la bóveda antes de preguntárselo a Claude. Ese día ha dejado de ser una carpeta que él escribe y ha pasado a ser tuya.
13 dudas
Los archivos están en tu disco, y Obsidian por sí solo no sube nada: su sincronía entre dispositivos es un servicio aparte y de pago que tú decides si contratas.
Pero la pregunta de verdad es la otra, así que la contesto entera: lo que Claude lee, viaja a los servidores de Anthropic. Es un modelo que corre en la nube; para responderte sobre una nota tiene que enviarla. Que el archivo viva en tu disco no significa que su contenido se quede ahí.
Por eso el apartado de qué no meter en la bóveda no es papeleo. Si esa frase te cambia la decisión sobre algún tipo de nota, hazle caso: es exactamente la información con la que hay que tomarla.
No. Es gratis, y desde hace un tiempo también para uso comercial — mucha guía por ahí arrastra la regla vieja de que usarlo en una empresa obligaba a pagar. La licencia comercial existe, pero es voluntaria y de apoyo.
Empieza vacío igualmente. Importa una nota que uses de verdad, trabaja con ella una semana, y decide después. Importar cuatrocientas antes de saber si el sistema te encaja es el error número uno de la lista de arriba.
A medias. Puedes subir archivos a un proyecto y funciona para leer. Lo que no tienes es que escriba en la carpeta al terminar, que es justo el paso que convierte esto en memoria. El CLAUDE.md es una pieza de Claude Code.
No, y conviene saberlo porque las búsquedas te van a decir que sí. La organización de Obsidian no publica ningún servidor MCP. Lo que existe es la vía de las skills —publicadas por el propio responsable de Obsidian— y algún servidor de la comunidad que funciona a través de un plugin de API local. Uno de los que más aparece en artículos viejos está archivado: no lo instales.
Ninguna cifra. Lo que hace falta es una semana de ritual de cierre cumplido. Con veinte notas bien fechadas la bóveda ya te devuelve cosas; con doscientas mal fechadas, no.
Es una carpeta: se comparte como cualquier carpeta. Pero antes lee el apartado de qué no meter dentro, porque compartir una bóveda es compartir todo lo que un programa ha ido escribiendo ahí durante meses.
14 cuando falla
Casi todo lo que falla aquí falla en silencio: no hay error, simplemente el resultado no es el que esperabas. Por eso el orden importa, y por eso conviene no reescribir el CLAUDE.md entero a la primera contrariedad.
Mira, en este orden:
común con diferencia. El CLAUDE.md solo se lee en la carpeta donde vive.
CLAUDE.md, en mayúsculas?última instrucción es larga, el ritual compite con ella.
ls -la CLAUDE.md && head -5 CLAUDE.mdY si pasa a menudo, deja de pedírselo y oblígale. Una instrucción del CLAUDE.md compite con toda la conversación: si la sesión ha sido larga, pierde. Un *hook* no compite, porque no es una instrucción — lo ejecuta el programa. El de tipo Stop se dispara cuando Claude termina de responder, y ahí puedes enganchar el cierre para que ocurra siempre, hayáis hablado de lo que sea.
Es la diferencia entre pedir un hábito y montar un mecanismo, y es lo que separa esta bóveda de una carpeta con buenas intenciones. Pídeselo a él —«móntame un hook de Stop que escriba el cierre del día en la bóveda»— que sabe hacerlo.
El CLAUDE.md dice las rutas y él las interpreta. Si tu carpeta se llama Diario con mayúscula y ahí pone diario/, va a crear una segunda. Corrige la ruta en el archivo, no muevas las notas: en dos días vuelve a pasar.
Es el más frecuente a la segunda semana. Las notas de diario salen de quince líneas y dejas de leerlas, que es lo mismo que no tenerlas.
Corrige el ritual de cierre con estas reglas y actualiza el CLAUDE.md: - La nota de diario son CUATRO líneas como máximo. Si no cabe, es que ha pasado más de una cosa: escribe solo la principal. - Nada de resumir lo que ya está escrito en otra nota. Enlázala. - Nada de adjetivos sobre el trabajo. «Se ha montado X» y punto, no «se ha montado con éxito un potente X». - Si un día no ha pasado nada reseñable, escribe una línea diciendo eso. No rellenes.
Casi siempre es que las notas no tienen la cabecera con propiedades, así que la única búsqueda posible es por texto literal. Añade tipo y etiquetas a lo que escribas de aquí en adelante; lo viejo se puede dejar como está.
No le pidas que «arregle todas las notas antiguas» de una pasada. Va a tocar
docenas de archivos a la vez y no vas a poder revisarlo. Si hace falta, pídeselo
por carpeta y de diez en diez.
15 adaptarlo
El archivo de más arriba es el genérico. Estas tres variantes son el mismo esqueleto con las prioridades cambiadas, y se pegan debajo del bloque base.
## Clientes Cada cliente tiene su carpeta en `clientes/<codigo>/`. El código es una letra y dos cifras, nunca el nombre real: la equivalencia vive fuera de esta bóveda y no la vas a encontrar aquí. Al cerrar sesión, si se ha trabajado sobre un cliente: - actualiza `clientes/<codigo>/estado.md` con lo que ha cambiado - si hay un compromiso con fecha, ponlo en `clientes/<codigo>/compromisos.md` con la fecha delante Nunca mezcles dos clientes en la misma nota, ni siquiera para comparar.
## Esta bóveda la lee más gente Escribe pensando en alguien que no estuvo en la conversación: - Nada de «como hablamos» ni «lo de siempre». - Los nombres de personas, por rol: «el responsable de compras», no el nombre de pila. - Toda decisión lleva quién la tomó y cuándo, aunque fuera obvio ese día. - Si algo está sin decidir, escríbelo como pregunta abierta, no como hecho.
## Código Esta bóveda NO es el repositorio. Aquí va el porqué; en el repositorio, el qué. - Una decisión de arquitectura se escribe en `decisiones/` con el problema, las dos opciones y por qué se eligió una. Sin código. - Los fragmentos de código en las notas son ilustrativos y pueden estar obsoletos. La fuente es el repositorio, siempre. - Si una nota describe cómo funciona algo que puede cambiar, ponle `caduca: <fecha>` en la cabecera.
diluyen y empieza a saltarse las que están en medio.
archivo con dos reglas opuestas produce un comportamiento que parece aleatorio y que te va a costar media tarde entender.
16 honestidad
No es memoria dentro de una misma conversación. Si en un chat largo se le olvida algo del principio, eso es otra cosa y la bóveda no lo arregla. Lo que arregla es el salto entre sesiones.
No decide qué es importante. Escribe lo que el ritual le manda escribir. Si el ritual está mal calibrado, tendrás cien notas de lo irrelevante y ninguna de lo que importaba. Por eso se dispara a mano la primera vez.
No sustituye tu criterio sobre qué se guarda. El apartado de qué no meter en la bóveda no es una advertencia de formulario: es la única parte de este montaje que no se puede automatizar y que tienes que sostener tú cada vez.
17 el ejemplo
Esto es lo que yo haría si empezara hoy. No hace falta seguirlo al pie de la letra; sirve para ver el ritmo, que es lo que casi nadie cuenta.
Obsidian, la bóveda vacía, las skills clonadas y comprobadas con ls. Abres Claude Code en la carpeta, pegas el prompt de arranque y lees el plan sin aprobarlo. Veinte minutos y se acabó el día.
Haz tu trabajo normal. Al terminar, escribe tú la nota del diario. A mano, sin pedírsela. Cuatro líneas. Esto le da un ejemplo de cómo escribes tú.
Trabaja, y al final pega el prompt del ritual de cierre. Mira lo que escribe y compáralo con tu nota del martes. Aquí vas a descubrir que escribe de más.
Con lo que viste ayer, escribe el CLAUDE.md. Ya sabes qué quieres que anote y qué no, que es información que el lunes no tenías.
Abre y no digas nada: deja que te cuente dónde lo dejasteis. Si te dice algo útil, el sistema funciona. Si te suelta un resumen genérico, el ritual de cierre está escribiendo mal y hay que apretarlo.
En serio. Un sistema de notas que hay que alimentar en fin de semana no sobrevive a la tercera semana.
Que el CLAUDE.md te sale largo. Es normal y conviene recortarlo antes de guardarlo: cuatro reglas que se cumplen valen más que veinte que se diluyen. Si dudas, quita todo lo que sea preferencia de estilo y quédate con lo que dice dónde escribir y qué anotar.
Que te olvidas del ritual dos días seguidos y aparece un hueco en el diario. No lo rellenes hacia atrás inventando: escribe una nota que diga que esos dos días no se anotaron. Un hueco reconocido vale; un hueco rellenado de memoria contamina todo lo demás, porque a los tres meses no vas a saber cuál de las dos cosas estabas leyendo.
18 qué viene después
Una vez que Claude tiene memoria, las dos guías hermanas de esta bitácora funcionan bastante mejor, y no es casualidad: las tres piezas se apoyan entre sí.
instalarlos y pasa a ser recordar qué probaste y qué descartaste. Eso es una nota en decisiones/ por cada uno.
diseño que se olvidan en cuanto cierras. Con la bóveda montada, se quedan.
No hace falta hacerlo en ese orden. Pero si vas a hacer las tres, ésta primero ahorra trabajo en las otras dos.
Las fuentes, para que lo compruebes tú
Nada de esta guía se cita de memoria. Cada enlace se abrió y se comprobó el día que se escribió: qué es, qué licencia tiene y si sigue mantenido. Si algo de aquí ya no cuadra, gana la fuente.
Esto que acabas de leer es formación y herramientas, y en tu empresa tendrá otra forma. Si quieres, lo miramos sobre tu proceso: media hora basta para saber si hay algo que automatizar o si se arregla ordenando lo que ya tienes.
Ver las sesionesRevisada el 2026-08-31. Publicada el 2026-08-31.
De esto hablo en mi Instagram, donde lo cuento en un minuto.