Tu segundo cerebro no es JARVIS mientras necesites estar sentado enfrente.
Un vault ordenado con Claude Code adentro es un asistente buenísimo, y sigue siendo una herramienta que abres. Un agente es otra cosa: tiene memoria que sobrevive a la sesión, habilidades que carga solo cuando le sirven, un equipo al que le delega, sentidos que alcanzan tu calendario y tu correo, y un latido que lo despierta el martes a las 7 sin que tú hagas nada. Son cinco capas, y esta guía las arma una por una sobre un caso real: capturar, conectar, hacer el brief y escribir en tu voz. El esqueleto no es de contenido — es el mismo si tu agente vende, cobra o estudia. Y Obsidian es opcional: aquí es la ventana, no el cerebro.
Las quince paradas · de un vistazo
Qué vas a construir y cuál de los tres caminos es el tuyo
Lo que tienes montado al final, las tres formas de montarlo, y qué temas se quedan en otras guías.
Las cinco capas de un agente personal
Memoria, habilidades, equipo, sentidos y latido: qué es cada una, en qué archivo vive y qué te cuesta.
¿De verdad necesitas Obsidian?
Carpeta pelada, Obsidian encima o claude-mem: qué ganas y qué te cuesta en cada camino.
De abrir la terminal a Claude Code respondiendo
Node, la CLI y el login con tu suscripción. Si ya usas Claude Code todos los días, sáltatela.
Organizar por tipo, no por tema
La estructura corregida, por qué el CLAUDE.md va en la raíz, y el prompt que la construye sola.
Las tres memorias que se confunden
Cuál escribes tú, cuál escribe Claude, cuál no viaja entre máquinas, y qué gana cuando se pelean.
Las cuatro skills, en el formato que sí carga
El archivo oficial, la descripción como disparador, y por qué una skill personal no llega a la nube.
Tres subagentes con memoria propia
El archivista, el tejedor y el escriba: contexto aparte, herramientas recortadas y lo que aprenden se queda.
Qué alcanza fuera del vault
Lo que no es MCP aunque se lo digan, los conectores que sí valen, y qué sale de tu máquina cada vez.
Que siga trabajando con la laptop cerrada
Los tres relojes, cuál ve tus archivos, y por qué tu vault tiene que ser un repositorio privado.
Lo que dispara aunque Claude opine otra cosa
Hooks al abrir la sesión, al cerrarla y después de escribir: la capa que no depende de que entienda.
Veinte minutos al día, treinta el domingo
El ritual diario, semanal y mensual, marcado por capa y por lo que ya no tienes que hacer tú.
Tus notas se vuelven tus skills
Después de noventa días el vault sabe cosas que tú no le has dicho a Claude. Aquí se cobran.
Diez errores: cinco de conducta, cinco mecánicos
Del CLAUDE.md vago hasta la skill que no viaja a la nube y la tarea que corre sin pedir permiso.
El mismo esqueleto, otro dominio
Ventas, finanzas o estudio con las mismas cinco capas, y el prompt maestro que lo escribe entero.
Guía comunidad · verificada a agosto de 2026
El dato que decide si tu JARVIS es real: una tarea en la nube no ve los archivos de tu computadora — clona un repositorio. Para que tu segundo cerebro siga trabajando con la laptop cerrada, tiene que ser un repo privado de GitHub, y tus skills tienen que estar adentro de él.
Las catorce paradas están arriba, así que aquí va lo que no dicen. Se monta en un fin de semana, y el orden importa: la memoria primero y el latido hasta el final, porque automatizar algo que todavía no funciona a mano solo repite el error más rápido y en tu ausencia. Corre con tu suscripción de Claude Pro o Max, sin API key y sin escribir una línea de código: donde haría falta editar un archivo de configuración a mano, lo que copias es un prompt en español que se lo pide a Claude Code. Y hay tres cosas que a propósito no vas a encontrar aquí, porque ya viven completas en otras guías de la bóveda y esta página las enlaza en vez de repetirlas: cómo se opera una tarea programada, cómo se redacta una skill desde cero, y el segundo cerebro sin base de datos.
cómo se usa esta página
Qué vas a construir, cuál de los tres caminos es el tuyo, y qué se queda en otras guías
Esta página construye un agente personal encima de tus notas, de principio a fin. No es una lista de trucos: es un sistema con cinco capas que se montan una por una, y cada parada deja una capa funcionando antes de pasar a la siguiente.
Antes de tocar nada conviene tener claras tres cosas: qué te queda armado al terminar, cuál de los tres caminos de montaje te toca, y qué temas esta guía no re-explica porque ya viven completos en otra página de la bóveda. Las tres caben aquí.
Qué tienes al final
Al cerrar esta página tienes un agente personal trabajando sobre tus notas. No una carpeta ordenada con Claude Code al lado: un sistema que arranca sabiendo quién eres, carga sus habilidades solo cuando le sirven, le delega lo pesado a un equipo, dispara reflejos que no dependen de que entienda, y se despierta solo a la hora que le dijiste.
Son cinco piezas y se montan en este orden. Ninguna necesita a la siguiente para servirte: si te quedas en la tercera, tienes tres capas andando y no un sistema a medias.
Una carpeta que Claude conoce de memoria
Tus notas en archivos de texto y, en la raíz de esa carpeta, un CLAUDE.md que Claude Code lee al empezar cada sesión: qué guardas, cómo lo nombras y cómo quieres que te hable. Dejas de explicarle tu sistema cada vez que abres la terminal.
Cuatro habilidades que se disparan solas
Procesar la bandeja, buscar conexiones, armar un brief y escribir en tu voz. Cada una en su propia carpeta dentro del vault, y Claude las carga cuando lo que pediste coincide con su descripción, no cuando te acuerdas de invocarlas.
Tres subagentes con memoria propia
El archivista, el tejedor y el escriba. Cada uno trabaja en su propia ventana de contexto y guarda lo que aprende en su propia carpeta, así que lo que descubre de tus notas sigue ahí la semana que viene.
Reflejos que disparan sin pedirte permiso
Órdenes que corren solas al abrir la sesión, al cerrarla y cada vez que se escribe una nota. Un reflejo corre pase lo que pase; una instrucción escrita en un archivo solo pide por favor, y esa diferencia es toda la capa.
Una tarea programada que trabaja sin ti
El domingo temprano tu agente lee la semana, busca conexiones y te deja los briefs escritos. Corriendo en la nube lo hace con la laptop cerrada; corriendo en tu máquina, mientras la tengas despierta.
lo que cuesta
Un fin de semana para montarlo, veinte minutos al día para que sirva
- tiempo de montaje
- Un fin de semana si lo haces de corrido. Por partes también funciona: cada parada deja una capa andando y puedes parar ahí una semana sin perder nada.
- el orden importa
- La memoria primero, el latido hasta el final. Automatizar algo que todavía no funciona a mano solo repite el error más rápido y en tu ausencia.
- con qué corre
- Con tu suscripción de Claude Pro o Max, y con Claude Code instalado en tu computadora. Sin clave de API y sin una segunda tarjeta.
- cuánto código escribes
- Ninguno. En los pocos lugares donde el sistema pide un archivo de configuración, lo que copias es un prompt en español y Claude Code escribe el archivo por ti.
Ese es el destino. Lo que cambia entre una persona y otra es por dónde se entra, y eso es la decisión que sigue.
Los tres caminos, en una línea cada uno
El cerebro de este sistema son archivos de texto en tu disco. Lo que cambia entre un camino y otro es qué le pones encima, y esa decisión se toma una vez.
Una carpeta de markdown y nada más
Archivos .md en tu disco, sin aplicación encima. Es lo más rápido de montar y es todo lo que hace falta para que las cinco capas funcionen.
Obsidian encima de esa misma carpeta
La misma carpeta, con una ventana que te deja ver los enlaces entre notas, buscar rápido y capturar desde el teléfono. Aquí Obsidian es la vista, no el cerebro.
claude-mem · memoria de sesión
Dejas que la captura la haga Claude solo con lo que pasó en cada sesión. No sustituye a los otros dos: guarda lo que Claude hizo, no lo que tú piensas.
Cada uno cuesta algo distinto, y hay uno que casi nadie debería elegir de entrada. La comparación completa, con lo que ganas y lo que te cuesta en cada caso, está en la parada de los tres caminos. Si ya sabes cuál es el tuyo, puedes saltártela.
Qué se queda en otras guías
La bóveda ya tiene guías completas de casi todas las piezas que aquí se usan. Esta página no las repite: las usa. La tabla dice de entrada qué tema vive en qué guía y con qué se queda ésta, para que no leas cuarenta minutos buscando algo que está en otro lado.
| Si buscas | Vive en | Aquí solo |
|---|---|---|
| Operar una tarea programada de punta a punta | 10 automatizaciones con Claude | La parte que esa página no cubre: qué le pasa a un vault cuando la tarea corre en la nube y no ve tus archivos. |
| El comando /schedule y los agentes de nube por dentro | Schedule · agentes en la nube | Los tres relojes comparados en una tabla, para decidir cuál despierta a tu agente. |
| Prender un conector paso a paso | Conectores de Claude | Cuáles valen la pena para un agente personal, y qué sale de tu máquina cuando los prendes. |
| claude-mem y MemPalace por dentro, con su instalación y sus diferencias | Memoria infinita para Claude Code | Un párrafo. Es el Camino C y nada más. |
| El método general para ordenar carpetas y la convención de nombres | Estructura de folders y archivos para Claude | Las nueve carpetas de este caso concreto, ya nombradas, en la parada del esqueleto. |
| Qué pieza construir: skill, subagente, hook o servidor MCP | Claude Anatomy | Cómo se arma una sola cosa con las cinco capas puestas al mismo tiempo. Aquella decide la pieza; ésta las junta. |
| El oficio de redactar una skill desde cero, y si va global o por proyecto | Skill Creator · y Skills global o por proyecto | Dejar andando las cuatro habilidades de esta guía, y convertir en skill algo que ya repites o que ya está en tus notas. |
| Ejércitos de subagentes trabajando en paralelo | Workflows dinámicos | Lo contrario: tres subagentes fijos, pocos, con memoria propia que se queda entre sesiones. |
| El cuaderno compartido de un equipo de agentes | Memory Palace · agentes | La memoria de un agente personal, no la de un equipo que se pisa entre sí. |
| Una flota corriendo 24/7 en una máquina dedicada | Ecosistema de agentes | Un solo agente, tu suscripción y la computadora que ya tienes. |
Dos de esas guías son las que más conviene tener a la mano mientras lees ésta. Si lo que quieres hoy es que algo corra solo y todavía no tienes el vault armado, empieza por las 10 automatizaciones con Claude: ahí se opera una tarea programada de punta a punta, y aquí se da por sabido.
Y si quieres el método general de carpetas y la convención de nombres, la estructura de folders y archivos para Claude lo cubre entero. Esta página se apoya en esa y arma las nueve carpetas de este caso en la parada del esqueleto.
La tercera es de otro tipo: si todavía no sabes si lo que necesitas es una skill, un subagente, un hook o un servidor MCP, Claude Anatomy te ayuda a decidir la pieza antes de escribir el primer archivo.
Y la cuarta llega hasta la parada de los sentidos: prender un conector paso a paso vive en la guía de conectores de Claude; aquí solo se decide cuáles valen la pena y qué sale de tu máquina cuando los prendes.
a quién le sirve
Suscripción Pro o Max, programes o no
Todo lo que hay en esta página se hace con una suscripción de Claude Pro o Claude Max. No hay claves de API, no hay identificadores de modelo, no hay precios por millón de tokens y no hay una sola llamada HTTP que escribir.
Tampoco hace falta que programes. En los pocos lugares donde el sistema pide un archivo de configuración, lo que vas a encontrar es un prompt en español para copiar y pegarle a Claude Code, y él escribe el archivo. Tu trabajo es leerlo y confirmar que dice lo que querías.
Lo que sí hace falta son dos cosas: Claude Code instalado y veinte minutos al día durante un mes. La primera se resuelve en diez minutos. La segunda es la que decide si esto te sirve o se te queda a medias en la semana dos.
Con eso ya sabes qué vas a construir y qué no vas a leer aquí. Lo que sigue es el arranque: abrir la terminal, dejar Claude Code instalado y con tu sesión iniciada, y crear la carpeta donde va a vivir todo. Si ya lo tienes andando, sáltatelo y entra directo al esqueleto de las cinco capas.
el esqueleto
Las cinco capas de un agente personal
Una herramienta la abres tú. Le pides algo, te contesta, cierras la ventana y lo que aprendió se va con ella. Un agente no funciona así: abre sabiendo quién eres y hace cosas los días que tú no lo abriste. La diferencia entre los dos no está en el modelo ni en el prompt: está en cuántas capas tiene montadas debajo.
Son cinco, y son las mismas para cualquier agente. Aquí no hay nada de contenido: si el tuyo cotiza, cobra o estudia, el esqueleto no cambia, cambia lo que le metes adentro. Por eso esta sección va antes que cualquier carpeta.
La cuenta que incomoda, antes de seguir: un chatbot con un prompt largo y bien escrito tiene una de las cinco. La memoria, y a medias. Es muchísimo mejor que nada, y también es la razón exacta por la que el lunes se siente amnésico.
una herramienta
Lo que casi todos tenemos hoy
- Arranca vacía. Lo que le explicaste ayer, hoy no existe.
- Repite lo que le pegues: el resultado depende de cuánto contexto tengas ganas de teclear ese día.
- Todo pasa en una sola ventana, la tuya, hasta que se llena y hay que empezar de nuevo.
- Solo sabe lo que le pusiste enfrente.
- Existe mientras la tengas abierta.
un agente
Lo que estás armando en esta página
- Abre sabiendo quién eres, cómo escribes y qué nunca se hace.
- Tiene procedimientos con nombre que salen igual las veinte veces.
- Le pasa lo pesado a alguien que trabaja aparte y le regresa solo el resultado.
- Alcanza tu calendario, tu correo o la web cuando la tarea lo pide, y nada más cuando no.
- Hace cosas los días que tú no lo abriste.
Las cinco, una por una
Memoria · lo que sabe de ti
Lo que no le quieres volver a explicar nunca: quién eres, para quién trabajas, cómo se llaman tus carpetas y qué reglas no se rompen. Se carga completo al arrancar cada sesión, así que cada línea de más la pagas todos los días. La regla es tenerlo en menos de 200 líneas; de dónde sale esa cifra y cómo se poda, en la parada de la memoria.
CLAUDE.md · .claude/rules/Contexto: alto. Entra entero al abrir y se paga en cada sesión, lo uses o no.
Habilidades · lo que sabe hacer
Un procedimiento con nombre: cómo se procesa el inbox, cómo se arma un brief, cómo se revisa lo que ya escribiste. Es la diferencia entre volver a pegar el mismo prompt largo cada vez y llamar a algo que ya funciona. Al arrancar la sesión solo se cargan su nombre y su descripción; el cuerpo entra cuando de verdad se usa.
.claude/skills/<nombre>/SKILL.mdContexto: bajo. Al inicio solo cargan nombre y descripción, así que puedes tener muchas.
Equipo · quién carga lo pesado
Subagentes a los que les delegas el trabajo que ensucia la conversación: leer cuarenta notas, revisar tres meses de publicaciones, buscar algo entre archivos que no vas a volver a mirar. Cada uno tiene su propia ventana de contexto y a ti solo te vuelve su mensaje final.
.claude/agents/<nombre>.mdContexto: bajo. Cada uno trae su propia ventana; a la tuya solo regresa el resultado.
Sentidos · qué alcanza fuera
Lo que el agente puede tocar más allá de sus archivos: tu calendario, tu correo, una página web, la herramienta donde de verdad vive tu trabajo. Es la capa más fácil de exagerar, porque aquí también está la frontera de privacidad: cada sentido que le prendes es algo que sale de tu máquina.
conectores de claude.aiContexto: medio. Cada herramienta conectada ocupa lugar antes de que escribas la primera palabra.
Latido · cuándo actúa sin ti
El reloj que lo despierta cuando tú no estás: una tarea agendada que corre el lunes a las siete y deja el trabajo hecho antes de que abras nada. Es la capa que separa una herramienta que abres de un agente que sigue, y la única que existe aunque hayas cerrado la terminal.
routines · tareas del DesktopContexto: ninguno del tuyo. Corre en su propia sesión, fuera de la que tienes abierta.
cómo se lee cada ficha
La línea de abajo es la que decide
En cada tarjeta, lo que va debajo de la línea es el costo de contexto: cuánto de la ventana se lleva esa capa antes de que tú escribas la primera palabra. Es el dato que decide si una capa te conviene o te estorba.
La memoria se paga entera en cada sesión, así que se cuida línea por línea. Las habilidades y el equipo casi no cuestan hasta que se usan, así que ahí sí puedes tener varias sin culpa. Los sentidos cuestan por estar prendidos. Y el latido no toca tu ventana: corre en una sesión aparte.
Qué cambia cuando la capa existe
| Capa | Sin ella | Con ella |
|---|---|---|
| Memoria | Cada sesión arranca de cero. Le vuelves a explicar quién eres, para quién es esto y qué no soportas leer; el resultado depende de cuánto contexto tuviste ganas de teclear ese día. | Abre sabiendo tu voz, tus carpetas y tus reglas. Tú empiezas por el encargo, no por la presentación. |
| Habilidades | El mismo prompt largo, pegado otra vez y un poco distinto cada vez. Lo que salió bien el martes no se puede repetir el jueves porque nadie sabe qué le pusiste. | Un procedimiento con nombre. Lo invocas tú, o lo reconoce él por la descripción, y sale igual las veinte veces. |
| Equipo | Una sola ventana hace todo. Leer cuarenta notas te deja la conversación llena de material que ya no sirve, justo cuando ibas a escribir. | El que lee las cuarenta notas trabaja aparte y te devuelve dos párrafos. Tu conversación se queda limpia para lo que sí importa. |
| Sentidos | Solo sabe lo que le pegaste. Tu calendario, tu correo y lo que pasó hoy afuera están fuera de su alcance, aunque sean la mitad del trabajo. | Alcanza lo de afuera cuando la tarea lo pide. Y como tú decides qué prendes, también decides qué sale de tu máquina. |
| Latido | Todo empieza cuando tú abres la terminal. El sistema no falla nunca: simplemente se apaga los días que no te sientas. | El lunes a las siete hay algo hecho que nadie pidió esa mañana. Es la capa que convierte la herramienta en agente. |
Se montan de abajo hacia arriba, y no se saltan
Las cinco capas no son un menú donde eliges tus favoritas. Son una escalera: cada una supone que la de abajo ya está puesta, y montarlas en desorden es la forma más común de terminar con un sistema aparatoso que no sirve.
- Memoria primero, siempre. Sin ella, todo lo que le montes encima vuelve a empezar de cero cada sesión: la habilidad no sabe para quién escribe y el subagente no sabe qué reglas respetar.
- Habilidades después, y solo cuando ya hiciste la tarea a mano varias veces. Una skill es un procedimiento que ya funciona, escrito para no volver a explicarlo; no es un lugar donde adivinar cómo debería funcionar.
- Equipo cuando la conversación se te empiece a llenar. Si todavía no se te llena, un subagente es una carpeta más que mantener y una indirección más que depurar.
- Sentidos cuando el trabajo de verdad viva afuera. Conectar el correo porque se puede es abrirle una puerta que quizá no necesita, y cada puerta abierta es algo que sale de tu máquina.
- Latido hasta el final. Lo que va a correr solo tiene que ser algo que ya te sale bien a mano, sin que nadie lo esté mirando.
el orden no es un consejo
Automatizar algo que todavía no funciona a mano solo automatiza el error
Una tarea agendada no arregla un procedimiento flojo: lo repite con puntualidad. Si tu skill de briefs saca briefs mediocres, programarla los lunes a las siete te da un brief mediocre cada lunes a las siete, y ahora además con la tranquilidad de que ya está hecho.
El mismo argumento sirve al revés. Si te saltas la memoria y empiezas por el latido, lo que va a estar corriendo solo, sin nadie enfrente, es un agente que no sabe quién eres.
Dónde estás parado ahora mismo
Si ya usas Claude Code para algo, lo más probable es que tengas una capa y media sin habértelo propuesto. Vale la pena saber cuál antes de construir encima. Este prompt no crea ni cambia nada: solo mira y te dice qué hay.
Diagnóstico: qué capas ya tienes
Pégalo en Claude Code, dentro de la carpeta donde trabajas. Te devuelve un SÍ o un NO por capa, con la ruta exacta de lo que encontró, y cuál es la siguiente que te toca.
Quiero saber en cuál de las cinco capas de un agente personal está parada esta carpeta. Revísala y dime qué hay y qué falta, capa por capa: 1. MEMORIA — ¿existe un CLAUDE.md en la raíz o en .claude/? ¿Cuántas líneas tiene? ¿Hay algo en .claude/rules/? Si hay rules, dime cuáles tienen frontmatter de rutas y cuáles cargan siempre. 2. HABILIDADES — ¿hay carpetas en .claude/skills/ con su SKILL.md adentro? Enlístalas con la descripción de cada una tal como está escrita. 3. EQUIPO — ¿hay archivos en .claude/agents/? Dime el nombre de cada uno y para qué dice que sirve. 4. SENTIDOS — ¿hay un .mcp.json en el proyecto? Enlista lo que declare. 5. LATIDO — revisa si existe ~/.claude/scheduled-tasks/ y, si existe, dime el nombre y la descripción de cada tarea que haya ahí. Reglas de esta revisión: - No crees, edites ni borres ningún archivo. Esto es solo un diagnóstico. - Si algo no existe, dilo con esas palabras en vez de proponer qué escribirías. - Cita la ruta exacta de todo lo que encuentres. Al final, dime cuál es la primera capa que me falta contando desde la memoria hacia arriba, y por qué ésa y no otra.
Una aclaración de territorio antes de seguir. Si lo que traes es la duda de qué pieza construir para un problema suelto —si eso se resuelve con una skill, con un subagente, con un hook o con un servidor MCP—, esa decisión se toma en la guía de anatomía de Claude Code, que compara las piezas una contra otra y te deja elegir una. Aquí no elegimos entre ellas: aquí se arma una sola cosa que las usa todas, y el orden en que se montan es la mitad del trabajo.
Ése es el esqueleto entero: cinco capas, un orden y una regla de costo. Lo que sigue es dónde vive. Y ahí aparece la pregunta que casi nadie hace antes de instalar nada: si el cerebro son archivos y las capas son carpetas, ¿de verdad necesitas Obsidian encima?
la decisión de entrada
¿De verdad necesitas Obsidian?
La respuesta honesta es no. Claude Code lee archivos markdown de una carpeta de tu disco: leer, escribir, mover y buscar archivos son herramientas que ya trae puestas, sin instalar nada de por medio. Una carpeta, archivos con extensión .md adentro y una sesión abierta ahí es todo lo que el agente necesita para funcionar.
Obsidian no le agrega ni una capacidad a Claude. Te agrega una ventana a ti: el grafo que enseña qué nota se conectó con cuál, la búsqueda instantánea sobre el vault entero, la app de teléfono para capturar en la calle y un atajo de teclado que abre una nota nueva sin que sueltes las manos.
La distinción importa porque decide qué instalas. Si lo que te frena es no ver tus notas, Obsidian resuelve. Si lo que te frena es no capturarlas, Obsidian resuelve. Si esperas que Obsidian haga que Claude entienda mejor tu vault, no va a pasar: el que entiende es Claude, y él abre los mismos archivos con Obsidian corriendo o desinstalado.
del lado de Claude
Lo que Obsidian no cambia
- Cómo llega a tus notas: abre los archivos del disco, con Obsidian instalado o sin él.
- Qué entiende de ellas: el frontmatter, los encabezados y el texto son exactamente los mismos bytes.
- Qué puede hacer con ellas: leer, escribir, mover y buscar ya son capacidades nativas de Claude Code.
- Los enlaces entre notas: un enlace de doble corchete es texto dentro del archivo, y como texto lo lee.
- Lo único que Obsidian escribe en tu carpeta es una subcarpeta oculta con sus propios ajustes. Tus notas siguen siendo markdown plano.
del lado tuyo
Lo que Obsidian sí te agrega
- El grafo: ves de un vistazo qué nota quedó suelta y qué grupo se está convirtiendo en un tema.
- Búsqueda instantánea sobre todo el vault, sin gastar un turno de conversación en preguntarle a Claude.
- La app de teléfono: capturas en la calle y aparece en la misma carpeta cuando llegas a la computadora.
- Captura por atajo de teclado: una nota nueva en el inbox sin abrir menús ni elegir carpeta.
- Ver lo que Claude escribió mientras lo escribe, en la nota, en vez de leerlo en la terminal.
cómo leer el resto de la página
Donde diga «vault», léelo como «carpeta»
De aquí en adelante esta guía dice «vault» porque es la palabra que todo el mundo usa, pero ninguna de las cinco capas pregunta si Obsidian está instalado. Las carpetas, el CLAUDE.md, las skills, los subagentes y los hooks funcionan igual sobre una carpeta pelada.
Si ya tienes un vault de Obsidian andando, no tienes que mudar nada: esa carpeta ya sirve tal como está.
Los tres caminos
Carpeta pelada
Una carpeta en tu disco, archivos markdown adentro y Claude Code corriendo ahí. Cero plugins, cero cuotas, cero mantenimiento: nada que actualizar y nada que se rompa el día que un plugin de la comunidad se quede sin dueño.
Es el camino con menos piezas móviles y alcanza de sobra. Las cinco capas de la parada anterior se montan igual encima.
El método general —cómo se decide qué carpeta existe, qué convención de nombres usar y cómo se poda cuando crece— ya tiene dueño en la bóveda y no se repite aquí: está en la guía del segundo cerebro sin base de datos. Las nueve carpetas concretas de este caso las arma la parada que sigue, y encima de ellas se monta el resto de la página, sea cual sea el camino que elijas.
Obsidian encima
La misma carpeta. Abres Obsidian, eliges abrir una carpeta como vault y apuntas a la que ya tienes. No se copia nada, no se convierte nada y no se importa nada: Obsidian es un lector de archivos markdown, igual que Claude.
Del lado de Claude no cambia una sola cosa. Del tuyo cambian cuatro, y las cuatro son plugins de la tienda de la comunidad.
| Plugin | Para qué sirve | Cómo se instala |
|---|---|---|
| Templater | Plantillas con lógica de verdad: le das un atajo y la nota sale con fecha, hora, etiquetas y los huecos ya puestos. Es lo que hace que todas tus capturas salgan con el mismo formato sin que lo pienses. | Ajustes → Community plugins → apaga el modo restringido → Browse → busca Templater → Install y Enable. |
| Dataview | Tu vault visto como base de datos: le pides «las notas con la etiqueta de patrón de los últimos siete días» y te lo arma en una tabla dentro de la nota. Es lo que deja que la carpeta crezca sin volverse un basurero. | Browse → Dataview → Install y Enable. Se puede empezar sin escribir consultas: las de la comunidad se copian y se pegan tal cual. |
| QuickAdd | El que mata la fricción de capturar. Le asignas una combinación de teclas y te abre una nota nueva en el inbox al instante. Cero clics, cero menús, cero excusa para no anotar. | Browse → QuickAdd → Install y Enable. Después, Ajustes → Hotkeys, busca la acción de captura de QuickAdd y asígnale tu combinación. |
el cuarto plugin
Obsidian Git empuja tu carpeta a un repositorio de GitHub sin que tú corras nada. Se instala igual que los otros tres: Browse → Obsidian Git → Install y Enable; después conectas el repositorio en sus ajustes y dejas prendido el commit automático.
Por qué ese repositorio decide si tu agente sigue trabajando sin ti va completo en la parada del latido. Aquí basta con dejarlo instalado y andando.
Y si lo quieres en el teléfono
Obsidian corre en iOS y Android, pero no sincroniza solo: hay que decidir por dónde viajan los archivos. Son cuatro caminos, del más simple al más manual.
| Opción | Qué cuesta | Cómo se siente |
|---|---|---|
| Obsidian Sync | De paga; el precio lo publica Obsidian en su sitio | El más simple. Un interruptor en los ajustes, cifrado de extremo a extremo, y jala en escritorio y teléfono sin configurar nada más. Si valoras tu tiempo por encima del costo, éste. |
| iCloud | Gratis si ya pagas iCloud | Pones la carpeta dentro de iCloud Drive y se sincroniza sola entre Mac y iPhone. Cero configuración, pero solo dentro del mundo Apple. |
| Syncthing | Gratis, código abierto | Sin servidor en medio: tu computadora y tu teléfono se hablan directo. La instalación pide más paciencia y a cambio los archivos no pasan por nadie. |
| GitHub más Working Copy | El repositorio es gratis; la app de iOS se compra una vez | Si ya tienes Obsidian Git empujando, abres ese mismo repositorio desde el iPhone: bajas, editas, subes. Es el más manual, y el único que además te deja el vault listo para la nube. |
claude-mem · memoria de sesión
claude-mem no compite con los dos de arriba porque guarda otra cosa: se cuelga de tus sesiones de Claude Code, comprime lo que pasó en cada una y se lo reinyecta a las siguientes. La distinción que decide si lo quieres es ésta: guarda lo que Claude hizo, no lo que tú piensas. Complementa el vault, no lo reemplaza, y se monta encima del camino A o del B sin cambiarles nada.
No lo confundas con la memoria automática de Claude Code, que es otra cosa: ésa ya viene prendida, la escribe él solo y no se instala nada. Cuál es cuál y qué guarda cada una se separa en la parada de las tres memorias. claude-mem es aparte y sí se instala.
Cómo funciona por dentro, dónde deja lo que guarda y cuándo estorba es tema de la guía de memoria infinita para Claude Code. Aquí termina en el comando de abajo.
Instalar claude-mem
npx claude-mem installEl camino que te toca
| Si… | Tu camino es |
|---|---|
| No quiero mantener plugins ni actualizar nada | A, carpeta pelada. Markdown y nada más. Todo lo que sigue en esta página funciona igual, sin quitar una línea. |
| Quiero verlo y capturarlo desde el teléfono | B, más una de las cuatro opciones de sincronización. Sin elegir una, la app del teléfono no ve tus archivos. |
| Ya vivo en Obsidian y no lo pienso soltar | B, y ya casi terminaste: abre Claude Code en la carpeta del vault que ya tienes y sigue en la parada del esqueleto. |
| Quiero que siga trabajando con la laptop cerrada | El que quieras, pero la carpeta termina siendo un repositorio privado de GitHub. Con Obsidian Git es automático; sin él, lo empujas tú. |
| Quiero que Claude recuerde sus propias sesiones | C, claude-mem, encima de A o de B. No sustituye tus notas: guarda lo que él hizo, no lo que tú pensaste. |
Ya elegiste la ventana. Falta el mueble: cómo se llaman las carpetas que van adentro y por qué el orden que casi todo el mundo usa, el de por tema, es justo el que le impide a tu agente encontrar nada. Eso es lo que sigue.
el arranque
De abrir la terminal a Claude Code respondiendo en tu carpeta
Si ya usas Claude Code todos los días, esta parada no te dice nada nuevo: salta a la parada del esqueleto y sigue desde ahí. Lo único que vale la pena que confirmes antes de irte es que abres la sesión parado dentro de la carpeta del vault, y no un nivel más arriba.
Para el resto: ya sabes qué vas a construir y con cuál de los tres caminos. Falta encender la herramienta que lo construye. Aquí no se crea todavía ninguna carpeta del vault; se deja Claude Code instalado, conectado a tu cuenta y parado donde tiene que estar.
Es el único tramo de la página con comandos de terminal. Son cuatro piezas, ninguna cuesta dinero aparte de la suscripción que ya pagas, y en una computadora limpia se hace en quince minutos. La mitad de ese rato es esperar descargas.
antes de la primera carpeta
Lo que queda instalado al terminar esta parada
- la terminal
- La ventana donde escribes comandos. Ya viene en tu computadora: no se instala, se abre.
- Claude Code
- Una sola línea y queda. Con el instalador oficial no necesitas Node.js ni saber qué es npm.
- Node.js
- Solo si prefieres instalarlo con npm. Es el único paso que puedes saltarte entero.
- tu cuenta
- Entras con tu suscripción de Claude Pro o Max desde el navegador. Aquí no se pega ninguna API key.
- Obsidian
- Opcional, y nada más si elegiste el Camino B. El agente no pierde una sola capacidad sin él.
Abre la terminal
En Mac: Cmd + Espacio, escribes Terminal y le das Enter. En Windows: buscas PowerShell en el menú de inicio y lo abres.
Es una ventana donde escribes una línea, la mandas con Enter y lees lo que contesta. Los comandos de esta parada instalan cosas y preguntan versiones: ninguno borra archivos tuyos. Si la ventana se ve rara, la cierras y abres otra.
Instala Claude Code
Hay dos formas y las dos dejan exactamente el mismo programa. La oficial es una línea que descarga el binario y lo deja listo, sin Node.js de por medio. Copia la de tu sistema, pégala en la terminal y dale Enter.
Cuando termine, cierra la terminal y abre una ventana nueva. Ese detalle aburrido es lo que hace que el comando claude ya se encuentre.
Instalar Claude Code en Mac o Linux
curl -fsSL https://claude.ai/install.sh | bashInstalar Claude Code en Windows, desde PowerShell
irm https://claude.ai/install.ps1 | iexComprobar que quedó instalado
claude --versionSi responde un número de versión seguido de «(Claude Code)», ya está. Si responde que no encuentra el comando, no te adelantes: abajo están los dos tropiezos que lo explican casi siempre.
El otro camino: npm, si ya tienes Node
Si ya vives en Node o prefieres instalarlo así, el paquete de npm baja el mismo binario. Pide Node 22 o más nuevo, y Node se descarga de nodejs.org: la versión LTS, que es la que recomiendan para todo el mundo. Doble clic al instalador, siguiente, siguiente, listo.
Primero pregunta qué Node tienes. Si contesta un número menor a 22, actualízalo antes de seguir; si contesta que no conoce el comando, es que Node no quedó instalado.
Ver qué versión de Node tienes
node --versionInstalar Claude Code con npm
npm install -g @anthropic-ai/claude-codeNunca le pongas sudo delante a ese comando, por más que un foro te lo sugiera. Ahí es donde nacen los problemas de permisos que después no sabes de dónde salieron. Si te falla por permisos, la página oficial de instalación tiene el arreglo por sistema.
Si ya instalaste por el camino de arriba, este paso no existe para ti. Sigue al login.
Entra con tu suscripción, parado en la carpeta correcta
Antes de arrancar, muévete a la carpeta donde va a vivir el vault. Claude Code trabaja sobre la carpeta desde la que lo abriste, así que esto no es un detalle de estilo: es lo que decide qué archivos ve.
La ruta del ejemplo es la carpeta de documentos de tu usuario. Si quieres el vault en otro lado, cambia esa ruta por la tuya.
Párate donde va a vivir el vault (ajusta la ruta si la tuya es otra)
cd ~/DocumentsArranca Claude Code ahí
claudeLa primera vez te pregunta cómo quieres entrar. Eliges entrar con tu cuenta de Claude, se abre el navegador, te conectas con la cuenta de siempre y regresas a la terminal. El login queda guardado: no lo repites cada mañana.
Si algún día quieres cambiar de cuenta, escribes /login dentro de la sesión y el navegador se abre otra vez.
cómo se paga esto
Con tu suscripción, no con una API key
Todo lo que hace esta página corre con una suscripción de Claude Pro o Max. No se pega una llave de API en ningún lado, no hay costo por token que vigilar y ninguna de las cinco capas lo pide.
Hay un caso que confunde a mucha gente: si tu computadora ya tiene puesta la variable ANTHROPIC_API_KEY de otro proyecto, Claude Code se salta la pregunta del login y te pide aprobar esa llave. Si te pasa, no la apruebes. Quita esa variable de tu terminal y vuelve a arrancar: quieres entrar con tu cuenta, no con crédito prepagado.
opcional · solo Camino B
Obsidian, si elegiste mirar el vault por ventana
Si te quedaste con la carpeta pelada o con claude-mem, sáltate esto entero y no vuelvas. Obsidian es la ventana, no el cerebro: el agente funciona igual sin él.
Si elegiste el Camino B: descarga Obsidian para tu sistema, ábrelo y elige abrir una carpeta como vault, apuntando a la carpeta donde vas a montar el tuyo. No importa que todavía esté vacía. No conviertas ni importes nada, porque no hay nada que convertir: Obsidian solo lee los archivos markdown que ya están ahí.
La descarga es gratis para uso personal y está en el sitio de Obsidian. Los plugins que valen la pena ya los viste en la parada anterior; instálalos cuando el vault tenga notas adentro, no hoy.
La prueba de que quedó
Con la sesión abierta, pega esto y mándalo. No cambia nada de tu computadora: solo obliga a Claude a decir en voz alta dónde está parado, que es justo el dato que se rompe sin que te des cuenta.
Comprobar que responde y que está en la carpeta correcta
Pégalo dentro de la sesión que acabas de abrir. Es la forma más rápida de confirmar que el login quedó y que no estás trabajando desde otra carpeta.
Quiero comprobar tres cosas antes de empezar, sin que modifiques nada de mi computadora. 1) Dime la ruta completa de la carpeta desde la que estás corriendo ahora mismo. 2) Enséñame qué archivos y qué carpetas hay ahí, sin entrar a las subcarpetas. 3) Dime si en esta carpeta existe un archivo CLAUDE.md y si estás leyendo alguno. Contéstame en español, en cinco líneas como máximo, y no crees, muevas ni borres ningún archivo.
Si contestó las tres, ya tienes con qué trabajar. La respuesta que importa es la primera: esa ruta es donde va a nacer el vault en la parada que sigue.
Si la ruta no es la que querías, sal de la sesión, muévete con cd a la carpeta correcta y vuelve a abrir Claude Code ahí. Es un minuto ahora y es media hora de confusión después.
Y si te dijo que no ve ningún CLAUDE.md, está bien: todavía no existe. Ese archivo se escribe más adelante, y va en la raíz del vault. En una subcarpeta no se autocarga: solo entra cuando Claude lee un archivo de esa carpeta.
cuando no arranca
Los dos tropiezos que se repiten
«command not found: claude» casi siempre significa que la terminal se quedó con la lista de programas que tenía antes de instalar. Ciérrala y abre una ventana nueva. Si sigue igual, el programa quedó en una carpeta que tu terminal no mira, y eso se arregla por sistema en la página oficial.
En Windows, si al pegar la línea te contesta que irm no se reconoce, estás en CMD y no en PowerShell. La ventana de PowerShell empieza con PS y la de CMD no; abre la correcta y vuelve a pegar.
Si Claude Code sí arranca pero se comporta raro, corre claude doctor: revisa la instalación y te lista los arreglos disponibles.
Los pasos por sistema operativo —Mac, Windows y Linux— los mantiene al día Anthropic en la página oficial de instalación. Si tu caso se sale de lo de arriba, esa es la que manda. Aquí no se copia su tabla completa a propósito: cambia cada mes y una copia vieja hace más daño que un enlace.
Ya tienes la herramienta encendida, conectada a tu cuenta y parada en la carpeta donde va a nacer el vault. De aquí en adelante todo pasa dentro de esa sesión: la parada que sigue la usa para construir las carpetas, y no vuelves a instalar nada.
las carpetas
Organizar por tipo, no por tema
Antes de crear una sola carpeta hay que tomar una decisión, y es la única de esta guía que no se deshace barato: cómo se agrupan tus notas. Si la tomas mal, el sistema funciona igual durante tres semanas y después se pudre solo.
Casi todo el mundo agrupa por tema. Es lo que hace un archivero, es lo que hace tu escritorio y es lo que va a proponerte cualquier plantilla que te bajes. Y es exactamente lo que no hay que hacer aquí.
Dos formas de guardar la misma nota
por tema
Tú decides a qué tema pertenece cada nota
- Carpetas como IA, marketing, productividad, salud. El primer día se ve impecable.
- Cada captura te obliga a un juicio: esto que acabo de anotar, ¿es marketing o es psicología? Dos días distintos lo contestas distinto, y las dos veces con razón.
- La nota que sirve para dos temas termina en uno solo. En el otro, para efectos prácticos, no existe.
- A los tres meses tienes carpetas huérfanas de tres notas y una carpeta llamada varios que ya nadie abre.
- Lo peor: las conexiones quedan encerradas. Lo que aprendiste de psicología nunca se topa con lo que anotaste de ventas, porque los guardaste en cuartos separados.
por tipo
La decisión ya viene tomada por la forma de la nota
- Carpetas como observación, reacción, patrón, pregunta, número. No dicen de qué trata la nota, sino qué clase de cosa es.
- La decisión es mecánica: ¿es algo que viste, algo que sentiste, algo que se repite, algo que no sabes, o algo con cifra? Se contesta en un segundo y se contesta igual siempre.
- El mismo criterio hoy y en seis meses. No hay estilo personal que se desvíe con el humor del día.
- Nada queda huérfano. Cualquier cosa que se te ocurra cae en uno de los cinco tipos, sin inventar carpetas nuevas.
- Las conexiones entre temas emergen después, cuando tu agente lee la carpeta completa y se encuentra dos notas de mundos opuestos diciendo lo mismo.
Fíjate en lo que se movió: no cambió qué anotas, cambió quién toma la decisión. Por tema decide tu criterio, que es inconsistente por definición. Por tipo decide la forma de la nota, que es la misma siempre.
la decisión que carga toda la guía
Las mejores ideas viven en el cruce de dos dominios
Una nota sobre un sesgo cognitivo y una nota sobre una objeción de venta no se parecen en nada por tema. Por tipo las dos son patrones, y caen en la misma carpeta.
Ahí es donde tu agente encuentra el cruce: no porque sea listo, sino porque la estructura las puso juntas y las leyó en el mismo movimiento. Organizar por tema hace lo contrario, las separa en el momento exacto en que las guardas.
Esa decisión es la que sostiene todo lo demás, y no se toca en el resto de la página. Lo que sí conviene mirar con cuidado es dónde vive el cerebro.
El cerebro estaba en el lugar equivocado
primero, cómo se ve el error
Contesta genérico y no parece conocer tu vault
Abres Claude Code dentro del vault, le pides que procese el inbox, y te contesta como si fuera la primera vez que ve la carpeta: te pregunta cosas que ya están escritas, ignora tus reglas de tono, pone etiquetas que tú no usas.
Entonces le pegas el CLAUDE.md a mano en el chat y de pronto todo sale bien. Ese es el síntoma completo. El archivo estaba bien escrito: lo que pasaba es que no estaba cargado.
La causa es de dónde cuelga el archivo. Claude Code sube por el árbol de directorios desde la carpeta donde lanzaste la sesión, y carga los CLAUDE.md que va encontrando de ahí hacia arriba. Los CLAUDE.md que están en subcarpetas no se cargan al inicio: entran solo cuando Claude lee algún archivo de esa subcarpeta.
La estructura vieja ponía el CLAUDE.md en 05-CLAUDE/. Si tú lanzas la sesión en la raíz del vault, que es lo normal porque ahí está todo, ese archivo queda una carpeta hacia abajo. Resultado: el cerebro del sistema no estaba cargado en la mayoría de las sesiones, y solo aparecía de rebote cuando Claude abría por su cuenta algo de esa carpeta.
El arreglo cabe en una línea: el CLAUDE.md se mueve a la raíz del vault. Desde ahí se carga al inicio de cada sesión, y si la conversación se compacta se vuelve a leer del disco. Está en la documentación oficial de memoria, y es el tipo de detalle que nunca te da un error: solo hace que todo funcione peor sin decirte por qué.
La estructura corregida, completa
el árbol del vault · solo para mirar
JARVIS/ ├── CLAUDE.md <- en la raíz. Aquí sí se autocarga ├── .gitignore <- lo que nunca sube al repositorio ├── .claude/ <- la carpeta que Claude Code ya busca sola │ ├── skills/ <- las habilidades (parada de las habilidades) │ ├── agents/ <- el equipo (parada del equipo) │ ├── rules/ <- reglas por carpeta (parada de la memoria) │ └── settings.json <- los reflejos (parada de los reflejos) ├── 00-INBOX/ <- todo cae aquí primero, sin pensar ├── 01-CAPTURES/ <- lo del inbox, ya clasificado por tipo │ ├── observations/ <- lo que viste │ ├── reactions/ <- lo que sentiste │ ├── patterns/ <- lo que se repite en dos lugares │ ├── questions/ <- lo que no sabes │ └── numbers/ <- lo que trae cifra ├── 02-CONNECTIONS/ <- ideas que salieron de cruzar dos notas ├── 03-BRIEFS/ <- la cola de producción └── 04-PUBLISHED/ <- lo publicado, con sus números pegados
Dos detalles del árbol que valen la pena. El primero ya lo viste: el CLAUDE.md va en la raíz.
El segundo es que 05-CLAUDE/ se retira entera. No porque estuviera mal pensada, sino porque Claude Code ya tiene su carpeta y se llama .claude/. Es la que busca sola para las habilidades, los subagentes, las reglas y la configuración. Tener una carpeta paralela inventada por nosotros significaba que nada de lo que metías ahí se cargaba solo.
Y 05-CLAUDE/context/, que aparecía en el árbol viejo y nunca se explicaba en ninguna parte, simplemente no hace falta. Todo lo que ibas a guardar ahí ya tiene su lugar: lo que siempre aplica va en el CLAUDE.md, lo que aplica solo en una carpeta va en .claude/rules/, y lo que Claude descubre solo se guarda en su propia memoria. Las tres se separan en la parada que sigue.
Qué cae en cada carpeta
| carpeta | qué cae aquí | por qué existe |
|---|---|---|
| 00-INBOX/ | Capturas crudas, sin clasificar. | Aquí cae todo en el segundo en que se te ocurre: la nota de voz transcrita, lo que viste en la calle, el número que te sacudió. Cero estructura, a propósito. Cualquier fricción en este paso mata el hábito completo. |
| 01-CAPTURES/observations/ | Lo que viste, oíste o leíste. | Crudo y todavía sin opinión. Si ya viene con juicio no es una observación, es una reacción, y va en la carpeta de al lado. |
| 01-CAPTURES/reactions/ | Tu respuesta honesta, sin filtro. | Lo que te dio coraje, envidia, alivio o vergüenza. Es la veta más rica para escribir con voz propia, y la que más rápido se te borra si no la anotas el mismo día. |
| 01-CAPTURES/patterns/ | El mismo principio en dos lugares distintos. | Cuando notas que algo de psicología y algo de ventas comparten la misma mecánica. Aquí está el oro del cruce entre dominios, y por eso esta carpeta existe aunque parezca vaga. |
| 01-CAPTURES/questions/ | Lo que no sabes. | Curiosidad real, escrita como pregunta y no como conclusión. Las mejores piezas empiezan en una pregunta honesta que todavía no tenía respuesta. |
| 01-CAPTURES/numbers/ | Datos con cifra. | Métricas, porcentajes, resultados concretos. Una nota que dice 33 por ciento pesa mucho más que una que dice mejoró bastante, y esta carpeta te obliga a guardar la primera. |
| 02-CONNECTIONS/ | Ideas nuevas que salieron de cruzar dos o más notas. | Aquí no van capturas crudas. Va lo que emergió de la relación entre ellas. Es la carpeta de la que sale el mejor material, y la que no existe en ningún sistema de carpetas por tema. |
| 03-BRIEFS/ | La cola de producción. | Cada archivo es una pieza lista para escribir: entrada, prueba, cierre y las notas fuente enlazadas. Escribir es el último paso, no el primero. |
| 04-PUBLISHED/ | Lo que ya publicaste, con sus números pegados. | Impresiones, guardados, respuestas. Es donde tu agente aprende qué funciona de verdad con tu audiencia en vez de suponerlo, y de donde sale la cosecha de la parada de la cosecha. |
si vas a abrir esto en Obsidian
Las carpetas que empiezan con punto no se ven, y está bien
Obsidian esconde por defecto todo lo que empieza con punto, así que .claude/ no va a aparecer en tu barra lateral. No está roto y no hay nada que configurar.
Esa carpeta es del agente, no tuya: habilidades, subagentes, reglas y configuración. No la vas a editar a mano casi nunca, y cuando toque, se lo pides a Claude Code. Lo que sí ves en Obsidian son las cinco carpetas numeradas, que son las que guardan tus notas.
El CLAUDE.md sí se ve, porque es un archivo markdown normal en la raíz. Lo puedes abrir y editar desde Obsidian como cualquier otra nota.
El prompt que construye el esqueleto
No hay nada que crear a mano. Abre la terminal en la carpeta donde quieres que viva el vault, lanza Claude Code y pega esto. Crea las carpetas, deja un README corto en cada una explicando qué va ahí y qué no, y escribe el .gitignore.
Los README no son adorno: son lo que va a leer tu agente, y tú a los tres meses, cuando dude si una nota va en observations o en reactions. El .gitignore importa porque este vault va a terminar siendo un repositorio privado de GitHub, que es la condición para que el sistema siga trabajando con la laptop cerrada.
Construye el esqueleto completo del vault
Pégalo en Claude Code, parado en la carpeta donde quieres que viva el vault. A propósito no crea todavía el CLAUDE.md ni las habilidades: esos necesitan información tuya que aún no le has dado.
Eres mi asistente de configuración. Vamos a crear el esqueleto de un vault personal llamado JARVIS dentro de la carpeta donde estamos parados. No me pidas que escriba archivos a mano: hazlo tú y al final enséñame el resultado. 1) Crea esta estructura exacta de carpetas: JARVIS/ ├── .claude/skills/ ├── .claude/agents/ ├── .claude/rules/ ├── 00-INBOX/ ├── 01-CAPTURES/observations/ ├── 01-CAPTURES/reactions/ ├── 01-CAPTURES/patterns/ ├── 01-CAPTURES/questions/ ├── 01-CAPTURES/numbers/ ├── 02-CONNECTIONS/ ├── 03-BRIEFS/ └── 04-PUBLISHED/ 2) En cada carpeta numerada y en cada subcarpeta de 01-CAPTURES, crea un README.md de diez líneas como máximo, escrito en español y hablándome de tú, que diga: - qué tipo de nota va en esa carpeta, - qué NO va, con el ejemplo del error más fácil de cometer (confundir una observación con una reacción, o meter una captura cruda en 02-CONNECTIONS), - un ejemplo de una sola línea de una nota que sí pertenece ahí. El criterio de todo el sistema es que las carpetas clasifican por TIPO de nota, no por tema. Que cada README lo deje claro en su primera frase. 3) Crea un .gitignore en la raíz que ignore la carpeta de configuración local de Obsidian (.obsidian/), los archivos basura del sistema operativo (.DS_Store, Thumbs.db), CLAUDE.local.md y .claude/settings.local.json. Explícame en dos líneas por qué se ignora cada uno. 4) NO crees todavía el CLAUDE.md, ni habilidades, ni subagentes, ni settings.json. Esos vienen después y necesitan información mía que aún no te he dado. 5) Cuando termines, muéstrame el árbol resultante, dime cuántos archivos creaste, y avísame si algo de lo que pedí ya existía y no lo tocaste. 6) Al final, dime el comando exacto para entrar a la carpeta JARVIS desde donde estoy parado ahora, y recuérdame con esas palabras que de aquí en adelante todas las sesiones de Claude Code se abren desde DENTRO del vault, nunca desde la carpeta de arriba.
Ese último paso no es cortesía. El prompt crea JARVIS como una carpeta dentro de donde estabas parado, así que la sesión que acaba de construirlo sigue viviendo un nivel más arriba del vault.
De aquí en adelante todas las sesiones se abren desde dentro de JARVIS. Eso es lo que hace que el CLAUDE.md de la raíz se cargue solo al arrancar. Si abres la terminal una carpeta más arriba, vuelves a tener el síntoma del principio: contesta genérico y no parece conocer tu vault.
El esqueleto ya está de pie y vacío, que es exactamente como debe estar. Lo que sigue es meterle lo primero que lo convierte en un agente en vez de una carpeta ordenada: la memoria. Son tres, se confunden todo el tiempo, y una de ellas no viaja entre tus máquinas.
capa 1 · memoria
Las tres memorias que se confunden
Cuando alguien dice que su Claude «ya tiene memoria», puede estar hablando de tres cosas distintas. Se escriben con manos diferentes, se cargan en momentos diferentes y no llegan a los mismos lugares. Confundirlas es el motivo número uno de que un agente personal se sienta amnésico justo cuando más lo necesitas.
Las tres existen en tu carpeta ahora mismo, aunque tú solo hayas escrito una.
Las tres, lado a lado
| CLAUDE.md | Memoria automática | Tus notas | |
|---|---|---|---|
| Quién la escribe | Tú, a mano | Claude solo, mientras trabajas | Tú, cuando capturas |
| Dónde vive | CLAUDE.md en la raíz de la carpeta, o en ~/.claude/CLAUDE.md si quieres que aplique a todos tus proyectos | En ~/.claude/projects/<proyecto>/memory/, con un índice MEMORY.md y un archivo por tema | En los .md de tu vault: las capturas, las conexiones, los briefs, lo publicado |
| Cuándo se carga | Al inicio de cada sesión, completo. Sobrevive al /compact: se vuelve a leer del disco | El índice al inicio; los archivos por tema se abren bajo demanda, cuando el tema sale | Solo cuando Claude abre esa nota o la encuentra buscando |
| ¿Viaja a otra máquina? | Sí, si la carpeta es un repositorio | No. La documentación lo dice textual: no se comparte entre máquinas ni con entornos de nube | Sí, si la carpeta es un repositorio |
| ¿Entra a los subagentes? | Sí | No. La única excepción es un fork, que hereda la conversación del padre | Sí, si el subagente puede leer archivos |
| Para qué sirve | Las reglas: quién eres, cómo suenas, qué no se toca nunca | Las correcciones: lo que te aprendió sin que se lo dictaras | El material: lo que piensas, y que no se deduce de ningún otro lado |
Las tres de la tabla son nativas: vienen con Claude Code y no se instalan. Si viniste del Camino C de la parada de los tres caminos, claude-mem no es ninguna de las tres ni las reemplaza — es una herramienta aparte que guarda lo que Claude hizo en cada sesión, y se monta encima de esto. La memoria automática de la fila de en medio ya está prendida en tu máquina aunque nunca hayas instalado nada.
tres datos que cambian el plan
Lo que casi nadie sabe de la memoria automática
Viene prendida por defecto. No la instalaste ni la configuraste, y lleva escribiendo desde tu primera sesión. Se apaga con el interruptor de /memory, pero antes de apagarla vale la pena leerla: es tuya y ya sabe cosas.
Es de esa computadora y de ninguna otra. Si mañana trabajas desde otra máquina, o si tu agente despierta dentro de una tarea de nube, esa memoria no existe ahí. Todo lo que quieras que viaje tiene que estar en el CLAUDE.md o en tus notas, porque eso sí va en el repositorio.
No entra a los subagentes. El equipo que armes en la capa 3 no sabe nada de lo que Claude aprendió de ti en la conversación principal, y por eso cada subagente lleva su propia carpeta de memoria.
Cómo se instala y se opera cada una por dentro, con claude-mem y los archivos por tema, es territorio de la guía de memoria en Claude Code. Aquí importa la pregunta que esa guía no contesta: qué escribir, qué borrar y quién gana cuando dos memorias dicen lo contrario.
Y cuando son varios agentes escribiendo en un mismo cuaderno, la mecánica cambia por completo: eso está en el palacio de memoria para agentes. Lo de esta página es más simple, y por eso funciona: el cuaderno es de uno solo.
Qué recordar y qué no
El error de casi todos los CLAUDE.md es que están llenos de cosas verdaderas que no hacía falta escribir. Verdadero no es lo mismo que útil: cada línea que agregas compite con las demás por atención, y las que se pueden deducir leyendo los archivos se llevan atención sin devolver nada.
no va en el CLAUDE.md
Lo que le quita fuerza al archivo
- Todo lo que Claude puede deducir leyendo tus archivos. Si la carpeta se llama briefs y adentro hay briefs, escribirlo otra vez no le enseña nada.
- La lista completa de carpetas. Basta con nombrar las tres o cuatro que se comportan distinto a lo que su nombre sugiere; las demás se explican solas.
- Lo que cambia cada semana: en qué proyecto andas, qué pieza estás escribiendo, cuándo entregas. Eso es una nota, no una regla.
- Los buenos deseos: «sé profesional», «escribe bien», «piensa antes de responder». No cambian nada porque no se pueden desobedecer ni cumplir.
- El archivo de alguien más. Un CLAUDE.md copiado de internet describe con mucha precisión el trabajo de otra persona.
sí va
Lo que solo tú puedes decirle
- Cómo suenas cuando escribes, en términos que se puedan verificar: largo de frase, qué signos no usas, cómo abres y cómo cierras.
- Las palabras que odias, escritas una por una. La lista literal, no la categoría: «desbloquea», «aprovecha», «potencia».
- Lo que NUNCA debe tocar: la carpeta de lo ya publicado, los archivos .env, cualquier cosa que no se pueda deshacer.
- Las decisiones que ya tomaste y no quieres volver a discutir cada sesión: en qué idioma escribe, si pregunta antes de crear archivos, si te avisa cuando algo no le cuadra.
- Las correcciones que ya le diste dos veces. Ésas dejaron de ser un comentario.
La regla práctica es una sola y no falla: si tuviste que corregirle lo mismo dos veces, va al archivo. La primera vez es un caso suelto. La segunda ya es un patrón, y un patrón que no escribes lo vas a corregir una tercera.
no cambia nada
Escribe corto y directo, con un tono profesional pero cercano. Cuida la calidad y evita el lenguaje que suene a inteligencia artificial.
sí cambia el resultado
Frases de menos de doce palabras. Nunca uses guion largo. Nunca uses estas palabras: desbloquea, aprovecha, potencia, en el mundo de hoy. Si una cifra no tiene fuente, no la escribas: pregúntame de dónde salió.
La de la izquierda no se puede desobedecer: cualquier texto la cumple. La de la derecha sí, y por eso sirve, porque se nota cuando no se cumplió. Ésa es la prueba para cada línea de tu archivo: si no puedes darte cuenta de que la rompió, no era una regla.
Los dos techos de carga
Escribir mucho no es lo mismo que que se cargue mucho. Hay dos números que deciden cuánto de lo que escribiste llega de verdad a la sesión, y son distintos para cada archivo.
cuánto llega de verdad
Los límites reales de cada archivo
- CLAUDE.md
- Apunta a menos de 200 líneas. Claude Code carga archivos de hasta 4 MiB y se salta uno más grande, pero el tope duro no es el problema: los archivos más cortos se obedecen mejor. Ése es el motivo verdadero.
- MEMORY.md
- Del índice de la memoria automática se cargan las primeras 200 líneas o los primeros 25 KB, lo que pase primero. Lo que queda abajo no se carga, y en la siguiente carga se pierde.
- Archivos por tema
- No cuentan contra ese techo: se abren bajo demanda cuando el tema sale. El que tiene que estar corto es el índice.
- Importar con arroba
- Un CLAUDE.md puede jalar otros archivos con una arroba y la ruta, hasta cuatro saltos. Los importados también cargan al inicio: partir el archivo organiza, no ahorra contexto.
- Subcarpetas
- Un CLAUDE.md que vive dentro de una subcarpeta no se carga al inicio. Entra solo cuando Claude lee archivos de esa carpeta.
Nada de esto hay que adivinarlo. Dos comandos te dicen qué tienes escrito y qué se cargó de verdad en la sesión que estás corriendo ahora.
Lista tus CLAUDE.md y el interruptor de la memoria automática
/memoryVer cuáles se cargaron de verdad en esta sesión
/contextSi /context enseña un archivo que tú creías cargado y no aparece, ya encontraste por qué te ignora.
Y si el índice de la memoria automática se pasa del techo, la escritura funciona pero Claude Code devuelve un error pidiéndole a Claude que reescriba el índice, precisamente porque lo que sobra se pierde en la siguiente carga.
La poda: quince minutos, una vez al mes
Nadie te va a avisar. El CLAUDE.md no se rompe cuando envejece: se pone flojo. Le agregaste una regla en marzo por un proyecto que ya cerró, una excepción en mayo por un cliente que ya no está, y una aclaración en junio que contradice la de marzo. Nada de eso da error.
Un CLAUDE.md que creció sin podarse obedece peor que uno de la mitad de largo. La razón es aritmética: cada instrucción que agregas le quita peso a las demás. Veinte reglas que siguen siendo ciertas pesan más, una por una, que sesenta donde la mitad ya no aplica.
Y si dos reglas se contradicen, Claude puede elegir cualquiera de las dos. El conflicto no se resuelve solo, no avisa, y no falla igual siempre: un día hace una cosa y otro día la contraria. Eso es exactamente lo que se siente como «se le olvidó».
la poda mensual
Abre el archivo a borrar, no a agregar
- Lee el CLAUDE.md de arriba a abajo. Es la única vez del mes que lo lees completo, y por eso funciona.
- Borra toda línea que ya no sea cierta: proyectos cerrados, clientes que se fueron, decisiones sobre las que ya cambiaste de opinión.
- Busca los pares que se pelean. Si dos líneas piden cosas distintas, deja una sola: la que quieres hoy.
- Junta las que dicen lo mismo con otras palabras. Tres versiones de la misma regla no la hacen más fuerte, la diluyen.
- Si quedó más largo que el mes pasado, quitaste menos de lo que agregaste. Vuelve a bajar.
La memoria automática se poda igual, pero por otro lado: ábrela con /memory, lee el índice y borra lo que ya no describe cómo trabajas. Como la escribe Claude solo, se acumula rápido; y como se corta a las primeras 200 líneas, lo viejo que dejaste arriba está desplazando lo nuevo sin que nadie te lo diga.
quién gana
Ninguna de las dos es obligatoria
El desempate entre el CLAUDE.md y la memoria automática no tiene un ganador fijo, y ésa es la respuesta incómoda: las dos son contexto, no configuración. Claude las lee y decide. Puede desobedecer cualquiera de las dos.
En la práctica pesa más la que es específica y la que es reciente, pero «en la práctica» no es una garantía. Si te alcanza con que una regla se cumpla casi siempre, el archivo basta. Si necesitas que se cumpla siempre, no.
Para lo que tiene que pasar pase lo que pase —que no borre lo ya publicado, que no abra un .env, que no mande nada sin que tú lo veas— hay otra capa que no pide por favor: un hook corre antes de la herramienta y la bloquea, entienda Claude o no. Eso se arma en la parada de los reflejos, los reflejos. Por ahora basta con saber que existe, para que no intentes resolver con una línea de texto algo que necesita un candado.
Reglas que solo aparecen cuando hacen falta
Hay además una forma de escribir memoria que casi nadie usa y que no compite con las tres de arriba, porque no es otra memoria: es una manera de partir la primera. Es la carpeta .claude/rules/, y es lo que salva al CLAUDE.md de crecer sin control. Son archivos .md sueltos y Claude Code los descubre solo, sin que los declares en ningún lado.
Sin frontmatter de rutas cargan siempre, con la misma prioridad que el .claude/CLAUDE.md; o sea, es lo mismo que tener un archivo más largo, solo que ordenado. El ahorro está en la otra versión: con un frontmatter paths, una regla carga únicamente cuando Claude toca un archivo que coincide con esos patrones.
Para un vault eso es justo lo que quieres. Las reglas de cómo se afila una captura no tienen por qué estar cargadas mientras escribes un brief, y las reglas de lo ya publicado, que es lo más delicado que hay, aparecen solo cuando Claude toca esa carpeta. Los tuyos personales van en ~/.claude/rules/ y cargan antes que los del proyecto.
así se ve · .claude/rules/publicado.md
--- paths: - "04-PUBLISHED/**/*.md" --- # Reglas de lo ya publicado - El texto de una nota publicada no se edita nunca. - Lo único que se actualiza aquí son las métricas del frontmatter. - Si te pido un cambio de texto, dime el archivo y espera mi confirmación por escrito antes de tocarlo.
Crea una regla que solo despierta en una carpeta
Pégalo en Claude Code con tu carpeta abierta. Escribe el archivo y su frontmatter por ti; tú solo cambias el nombre de la carpeta si la tuya se llama distinto.
Crea el archivo .claude/rules/publicado.md en la raíz de esta carpeta. Ponle un frontmatter con paths apuntando solo a 04-PUBLISHED/**/*.md, para que estas reglas se carguen únicamente cuando toques archivos de esa carpeta, y no en todas las sesiones. En el cuerpo escribe estas reglas en una lista, con mis palabras y sin adornos: - El texto de una nota publicada no se edita nunca. - Lo único que se actualiza son las métricas del frontmatter. - Si te pido un cambio de texto, me dices el archivo y esperas mi confirmación por escrito. Cuando lo tengas, enséñame el archivo completo y dime en una línea cómo compruebo que la regla se está cargando cuando toca, y no antes.
El prompt que te entrevista y escribe el archivo
Lo habitual es partir de una plantilla larga con corchetes para llenar a mano. Sirve, y tiene el problema de todas las plantillas: se llena rápido y en genérico, porque describir «mi voz» en abstracto es difícil, y contestar preguntas concretas no lo es.
Este prompt hace lo contrario. Te entrevista, una pregunta a la vez, y hasta el final escribe el archivo. Las cinco cosas que tiene que sacarte son las mismas de siempre: quién eres, qué es este lugar, cómo suenas, qué no se toca y qué trabajos te hace.
Entrevístame y escribe mi CLAUDE.md
Pégalo en Claude Code con tu carpeta abierta. Te pregunta de una en una, te empuja cuando contestes vago, y al final escribe el archivo en la raíz.
Vas a escribir el CLAUDE.md de esta carpeta, pero antes me vas a entrevistar.
Reglas de la entrevista:
- Una pregunta a la vez. Espera mi respuesta antes de seguir.
- Si contesto algo que no se puede verificar ("tono cercano", "que escriba bien"), no lo aceptes: pídeme un ejemplo concreto, o dos palabras que sí y dos que no.
- No inventes nada que yo no haya dicho. Lo que te falte, apúntalo y pregúntamelo al final en una lista aparte.
Cúbreme estas cinco cosas, en este orden:
1. Identidad. Quién soy, qué hago, para quién, y los dos o tres temas de los que hablo siempre.
2. El lugar. Qué es esta carpeta para mí y qué hacen las tres o cuatro subcarpetas que se comportan distinto a lo que su nombre sugiere. No me preguntes por las que se explican solas.
3. Voz. Cómo sueno cuando escribo. Pregúntame por largo de frase, signos que no uso, cómo abro, cómo cierro, y la lista literal de palabras que odio. Si te puedo pasar tres textos míos, léelos y saca los patrones tú en vez de preguntarme.
4. Reglas duras. Qué NUNCA debes tocar ni hacer sin que yo lo pida.
5. Trabajos. Qué te voy a pedir de forma repetida, con el nombre que yo uso para cada cosa.
Cuando termine la entrevista, escribe el archivo CLAUDE.md en la raíz de esta carpeta con esas cinco secciones, y respeta esto:
- Menos de 200 líneas. Si te pasas, corta primero lo que se puede deducir leyendo mis archivos.
- Cada regla escrita de forma que se note si la rompiste. Nada de buenos deseos.
- Nada de listar carpetas que se entienden por su nombre.
- Ninguna regla que contradiga a otra. Si dos de mis respuestas se pelean, dímelo antes de escribir.
Al final enséñame el archivo y dime en cuántas líneas quedó.Ya escrito, no confíes en que quedó. Cierra la sesión, abre una nueva y pégale esto antes que cualquier otra cosa.
El test de conexión
El primer mensaje de la sesión siguiente. Si la respuesta es específica, el archivo quedó. Si es vaga, el vago es el archivo.
Lee mi CLAUDE.md completo y dime en un párrafo: 1. Qué entiendes de mí y de este lugar: a quién le hablo, de qué escribo y cómo sueno. 2. Cuál es tu rol exacto aquí adentro, según el archivo. 3. Cuál es la regla que no vas a romper pase lo que pase. Sé específico. No me digas "es un sistema para tomar notas": dime quién soy, qué construyo y qué me importa. Y si algo del archivo te quedó ambiguo, o se contradice con otra línea, márcalo aparte en una lista para que yo lo arregle.
La respuesta te dice más del archivo que de Claude. Si te devuelve generalidades, no es que no entienda: es que no le diste nada específico que entender. Cuando pase, vuelve al archivo, no al prompt.
La memoria ya sabe quién eres, cómo suenas y qué no se toca. Lo que todavía no sabe es cómo haces las cosas: procesar lo que capturaste, cruzarlo, armar un encargo, escribirlo en tu voz. Eso no cabe en el CLAUDE.md, porque se cargaría entero en cada sesión aunque no lo uses. Va en la capa 2, que solo se enciende cuando hace falta.
capa 2 · habilidades
Las cuatro skills, en el formato que sí carga
La memoria le dice a tu agente quién eres. Las habilidades le dicen qué sabe hacer. Una skill es un procedimiento que tú ya repites a mano —procesar el inbox, cruzar las capturas de la semana, armar un brief— escrito una sola vez en un archivo, para no volver a dictarlo nunca.
Lo que las hace baratas es cuándo se cargan. Al arrancar la sesión, Claude Code solo lee el nombre y la descripción de cada skill. El cuerpo, con su procedimiento completo y su barra de calidad, no entra al contexto hasta que la skill se usa. Puedes tener veinte y pagar por veinte renglones.
Esta sección no te enseña a escribir skills desde cero. Hace otra cosa: migra las cuatro que ya trae este sistema al formato oficial y te enseña las tres trampas que dejan una skill escrita, guardada y muerta.
Si lo que quieres es escribir skills nuevas —cómo se estructura una desde cero, cómo se prueba que dispare y cómo se empaqueta—, eso tiene página propia: el creador de habilidades.
Y si dudas entre guardarlas en tu carpeta personal o en la del proyecto, esa decisión se toma en global o de proyecto. Aquí ya viene tomada: en este sistema van adentro del vault.
Una skill es una carpeta, no un archivo suelto
Lo más común es guardar las habilidades como archivos markdown sueltos en una carpeta, cada uno con un encabezado tipo «Skill: Process Inbox» y una lista de frases disparadoras debajo. Se lee bien y no sirve: eso es un documento. Claude Code no lo carga solo, no aparece en el menú de la barra, y las frases disparadoras de adentro no disparan nada.
Una skill de verdad es una carpeta con un archivo SKILL.md adentro. La carpeta se llama como la skill, el archivo se llama siempre SKILL.md, y arriba del todo va un bloque de frontmatter entre tres guiones. Ese bloque es lo que convierte un documento en algo que Claude Code carga.
documento
Un documento con pinta de habilidad
- Un archivo suelto: 05-CLAUDE/skills/process-inbox.md.
- Encabezados inventados: un título de skill arriba y una lista de frases disparadoras adentro del cuerpo.
- Sin frontmatter.
- Claude Code lo lee solo si tú le dices que lo lea. No existe ningún /process-inbox.
skill
Lo que Claude Code sí carga
- Una carpeta con su archivo: .claude/skills/process-inbox/SKILL.md.
- Frontmatter arriba, entre tres guiones, con el nombre y la descripción.
- El procedimiento como cuerpo, en español normal.
- Aparece como /process-inbox, y Claude la puede elegir solo cuando la descripción calza con lo que pediste.
cómo se ve en el disco · solo para mirar
tu-vault/ ├── CLAUDE.md ← en la raíz, no en una subcarpeta ├── .claude/ │ └── skills/ │ ├── process-inbox/ │ │ └── SKILL.md │ ├── weekly-connections/ │ │ └── SKILL.md │ ├── generate-brief/ │ │ └── SKILL.md │ └── write-content/ │ └── SKILL.md ├── 00-INBOX/ ├── 01-CAPTURES/ ├── 02-CONNECTIONS/ ├── 03-BRIEFS/ └── 04-PUBLISHED/
SKILL.md por dentro · la forma mínima
--- name: process-inbox description: Procesa las capturas crudas de 00-INBOX: las afila a una frase, les pone tres tags y las archiva en 01-CAPTURES. Úsala cuando el usuario diga «procesa mi inbox» o «afila las capturas de hoy». --- # Procesar el inbox 1. Lee cada nota en 00-INBOX/. 2. Decide a qué subcarpeta de 01-CAPTURES pertenece. 3. ... el resto del procedimiento, en español normal.
el formato oficial
Lo que hay que respetar para que cargue
- la carpeta
- Una carpeta por skill dentro de .claude/skills/ del vault. El nombre de la carpeta es el nombre de la skill.
- el archivo
- SKILL.md, con ese nombre exacto y en mayúsculas. Un archivo con otro nombre adentro de esa carpeta no se carga.
- el frontmatter
- Un bloque entre tres guiones, hasta arriba del archivo. Todos los campos son opcionales; el único que de verdad importa es description.
- qué se carga al arrancar
- Solo el nombre y la descripción de cada skill. El cuerpo entra al contexto hasta que la skill se usa.
- cómo se invoca
- Tú la escribes como /nombre, o Claude la elige solo cuando lo que le pediste calza con su descripción.
- y los comandos
- Los comandos personalizados se fundieron con las skills: .claude/commands/deploy.md y .claude/skills/deploy/SKILL.md crean el mismo /deploy. Si existen los dos, gana la skill.
La descripción es el disparador, no el cuerpo
Ésta es la parte que nadie cree hasta que la ve fallar. Al arrancar la sesión, lo único que Claude lee de tu skill es el nombre y la descripción. Con eso, y con nada más, decide si le sirve para lo que le acabas de pedir.
Por eso las frases disparadoras escritas adentro del cuerpo no disparan nada: el cuerpo no se lee hasta que la skill ya fue elegida. Meter ahí las palabras clave es ponerlas del otro lado de la puerta que quieres abrir. Van en la descripción.
La descripción y el campo when_to_use, si lo usas, se cortan juntos a 1.536 caracteres en el listado que Claude ve al arrancar. Es bastante espacio, pero no es infinito: pon el caso de uso principal primero.
no dispara
description: Procesa el inbox.
sí dispara
description: Procesa las capturas crudas de 00-INBOX del vault: las afila a una frase, les pone tres tags y las archiva en la subcarpeta correcta de 01-CAPTURES. Úsala cuando el usuario diga «procesa mi inbox», «afila las capturas de hoy» o «limpia el inbox», y también al empezar la sesión de la mañana si 00-INBOX tiene notas sin procesar.
- Qué hace la skill, en concreto y con los nombres reales de tus carpetas.
- Cuándo hay que usarla: en qué momento del día, ante qué situación, después de qué otra cosa.
- Con qué palabras se la vas a pedir: las frases exactas que tú dices, tal como las dices.
- Y si hace falta, cuándo NO usarla, para que no se meta donde no la llamaron.
Escríbela pensando en alguien que no ha leído el cuerpo. Literalmente es lo que está pasando.
Las cuatro skills del sistema
Éstas son las cuatro que mueven el flujo completo: capturar, conectar, hacer el brief y escribir. Cada tarjeta de aquí abajo es el archivo SKILL.md entero, con su frontmatter arriba: se copia tal cual y ya queda montada.
Para instalarlas no hace falta que abras el Finder ni que crees carpetas a mano. Copia el bloque, pégaselo a Claude Code adentro del vault y dile: «guarda esto tal cual en .claude/skills/process-inbox/SKILL.md, creando las carpetas que falten». Cuatro veces, una por skill.
1 · process-inbox
La de cada mañana. Lee las capturas crudas, las afila a una frase, les pone tres tags y las archiva en la subcarpeta que les toca.
--- name: process-inbox description: Procesa las capturas crudas de 00-INBOX del vault: las afila a una frase, les pone tres tags y las archiva en la subcarpeta correcta de 01-CAPTURES. Úsala cuando el usuario diga «procesa mi inbox», «afila las capturas de hoy» o «limpia el inbox», y también al empezar la sesión de la mañana si 00-INBOX tiene notas sin procesar. --- # Procesar el inbox ## Proceso 1. Lee cada nota que haya en 00-INBOX/. 2. Para cada nota: a. Decide a qué subcarpeta de 01-CAPTURES pertenece: observations, reactions, patterns, questions o numbers. b. Afila la nota cruda en una sola frase específica y punzante. c. Agrégale exactamente tres tags. Ni más, ni menos. d. Mueve la nota afilada a la subcarpeta que le toca. 3. Al terminar, devuelve un reporte con: - Total de notas procesadas y a dónde fue cada una. - Cualquier patrón que hayas notado entre las capturas de hoy. - Una conexión que valga la pena explorar más. 4. Guarda ese mismo reporte, con la fecha arriba, en .claude/ultima-corrida.md, sobrescribiendo el anterior. Cuando esta skill corre desde una tarea programada no hay nadie leyendo la pantalla, así que si el reporte no queda en un archivo se pierde. ## Barra de calidad Una nota afilada tiene que ser tan específica que alguien de fuera la entienda sin contexto adicional. Si todavía necesita explicación, no está afilada. Reescríbela. ## Reglas - No borres el original hasta que la nota afilada esté escrita en su carpeta. - Si una nota no cabe en ninguna de las cinco subcarpetas, déjala en 00-INBOX y dilo en el reporte. - Si una categoría se quedó con menos de cinco notas en total, márcalo: significa que estoy capturando de un solo lado.
2 · weekly-connections
La del domingo. Lee la semana completa de una sentada y busca lo que el ritual diario no alcanza a ver: los cuatro tipos de conexión.
--- name: weekly-connections description: Cruza las capturas de los últimos siete días de 01-CAPTURES y escribe las conexiones no obvias como notas nuevas en 02-CONNECTIONS. Úsala cuando el usuario diga «sesión de conexiones», «encuentra las conexiones de esta semana» o «qué se conectó esta semana», y en el ritual del domingo. --- # Conexiones de la semana ## Proceso 1. Lee todas las notas agregadas a 01-CAPTURES/ en los últimos 7 días. 2. Busca conexiones cruzando TODAS las subcarpetas al mismo tiempo, no dentro de cada una. 3. Una conexión fuerte cumple uno de estos cuatro tipos: TIPO A. El mismo principio de fondo apareciendo en dos dominios distintos. TIPO B. Contradicción entre dos notas que crea una tensión interesante. TIPO C. Patrón que conecta tres o más notas en una idea que todavía no tiene nombre. TIPO D. Una pregunta de una nota que otra nota responde por accidente. 4. Para cada conexión fuerte: a. Nombra de qué tipo es. b. Escribe el puente entre las ideas en una sola frase. c. Escribe una entrada posible que use la conexión. d. Crea una nota nueva en 02-CONNECTIONS/ que enlace las notas fuente. ## Barra de calidad Si la conexión es obvia, no califica. Solo suben las que sorprenderían de verdad a la persona que escribió las notas. Mínimo tres. Máximo cinco. Calidad sobre cantidad. ## Cierre Termina diciendo cuál de las conexiones vale más la pena trabajar como brief, y por qué.
3 · generate-brief
Convierte una conexión en algo escribible: cinco campos, ni uno más. El cierre se escribe antes que el medio, siempre.
--- name: generate-brief description: Convierte una conexión de 02-CONNECTIONS en un brief listo para escribir, con los cinco campos del sistema: ONE THING, PROOF, READER TRANSFORMATION, tres entradas y tres cierres. Úsala cuando el usuario diga «haz un brief de esto», «genera el brief de [tema]» o «esta conexión ya está para escribirse». --- # Generar un brief ## Proceso Escribe un brief con exactamente estos cinco campos. ONE THING La única idea sobre la que se construye toda la pieza. Tiene que caber en una frase. Si no cabe, la idea no está lista. Si la one thing se siente vaga, dilo y pide que se afile antes de seguir. PROOF El ejemplo, el número o el resultado más específico que prueba la one thing. Una prueba vaga invalida el brief. Números reales, no aproximaciones. READER TRANSFORMATION Qué sabe o qué siente el lector al final que no sabía antes. Si no se puede decir claro, la pieza no tiene razón de existir. TRES ENTRADAS, ordenadas Tres, distintas en enfoque y en tono. Ordénalas por qué tanto frenan el scroll. Entrada 1 agresiva. Entrada 2 curiosa. Entrada 3 personal. TRES CIERRES, ordenados Tres, ordenados por urgencia y por qué tanto se quedan en la cabeza. El cierre se escribe ANTES que el medio. Siempre. ## Salida Guarda una nota nueva en 03-BRIEFS/ con el nombre [fecha]-[tema-en-kebab].md Tag: #listo-para-escribir Enlaza en el brief las notas fuente de 01-CAPTURES y 02-CONNECTIONS que lo sostienen.
4 · write-content
El último paso. Toma un brief aprobado, relee tu voz y las notas fuente, y entrega la pieza terminada.
--- name: write-content description: Toma un brief aprobado de 03-BRIEFS y escribe la pieza completa en la voz del usuario, releyendo antes el CLAUDE.md de la raíz, las muestras de voz y las notas fuente enlazadas. Úsala cuando el usuario diga «escribe este brief», «produce el contenido de [tema]» o «ya escribe la pieza». --- # Escribir la pieza ## Proceso 1. Lee el brief indicado en 03-BRIEFS/. 2. Lee todas las notas fuente enlazadas en el brief. 3. Vuelve a leer las secciones «Mi voz» y «Muestras de mi voz» del CLAUDE.md de la raíz. 4. Escribe la pieza completa en esa voz. 5. Estructura: entrada, prueba, cuerpo, cierre. 6. Cada sección agrega algo específico. Cero relleno. 7. Donde aplique, incluye al menos dos bloques copiables: prompts, comandos o ejemplos. 8. Cierra con la invitación a guardar el post y a seguir la cuenta. ## Voz Aplica cada regla de voz del CLAUDE.md con precisión, incluidas las palabras prohibidas. Cuando dudes, más corto y más directo. Lo que salga tiene que ser indistinguible de algo que yo hubiera escrito. ## Salida Guarda el borrador en 03-BRIEFS/, junto al brief original, con el sufijo -borrador.md Tag: #escrito No toques nada de 04-PUBLISHED.
las tres trampas
Escrita, guardada y muerta
- Guarda las cuatro en el .claude/skills/ del vault, no en tu carpeta personal ~/.claude/skills/. Ni Cowork ni las sesiones de nube leen esa carpeta: cargan las skills que hayas prendido en tu cuenta de claude.ai, y las de nube además cargan las committeadas en el .claude/skills/ del repositorio que clonan. Por qué eso decide si tu agente sigue trabajando sin ti está en la parada del latido.
- El campo disable-model-invocation: true hace más de lo que promete. Impide que Claude elija la skill solo, sí, pero también impide que la skill corra cuando una tarea programada la dispara como su prompt. Si lo pusiste para que no se metiera sola en tus sesiones, acabas de apagar el latido.
- Si subes una skill personal a tu cuenta de claude.ai para usarla en la nube, solo se aceptan seis campos de frontmatter: name, description, license, compatibility, metadata y allowed-tools. Cualquier otro campo no se ignora: hace fallar la subida con un error duro. Por eso las cuatro de aquí arriba traen únicamente name y description.
El mecanismo completo de la primera trampa —qué viaja cuando tu agente corre sin ti y qué se queda en tu máquina— vive en el latido. Aquí basta con guardar las skills en el lugar correcto.
Convierte lo que ya repites en una skill
La regla para saber cuál sigue es simple: si ya le pegaste la misma instrucción tres veces, es una skill. Este prompt toma esa instrucción tuya, la que tienes en las notas del celular o en un archivo de texto, y la deja en el formato que sí carga, con la descripción escrita para disparar.
De instrucción repetida a SKILL.md
Pégaselo a Claude Code adentro de tu vault, con tu instrucción hasta abajo. Te devuelve el archivo ya guardado en la ruta correcta.
Voy a pegarte abajo una instrucción que le repito a mano cada semana. Conviértela en una skill de Claude Code bien formada y guárdala en este vault. Reglas: 1. Créala como carpeta con archivo: .claude/skills/<nombre>/SKILL.md, adentro de este proyecto y no en mi carpeta personal. 2. El frontmatter lleva solo dos campos: name y description. Ningún otro. 3. La descripción es lo único que vas a leer al arrancar para decidir si esta skill sirve, así que escríbela para eso: qué hace, con los nombres reales de mis carpetas; en qué momento se usa; y las frases exactas con las que yo la voy a pedir. Menos de 1.536 caracteres. 4. El cuerpo es el procedimiento, numerado, en español, con una barra de calidad al final que diga cuándo el resultado todavía no está listo. 5. No metas las frases disparadoras en el cuerpo: ahí no sirven. 6. Si algún paso de mi instrucción es ambiguo, pregúntame antes de escribir el archivo en vez de inventar el criterio. Cuando termines, dime la ruta exacta del archivo y enséñame solo la descripción que escribiste, para revisarla. Mi instrucción: [PEGA AQUÍ LO QUE YA REPITES]
Con esto tu agente ya sabe hacer cosas, pero las sigue haciendo todas él, en la misma ventana y con la misma cabeza. Cruzar noventa notas para encontrar tres conexiones se come la sesión entera antes de que llegues a escribir. Lo que sigue es repartir el trabajo: tres subagentes con contexto propio, herramientas recortadas y una memoria que no se les borra al terminar.
capa 3 · equipo
Tres subagentes con memoria propia
Hasta aquí tu agente tiene memoria y tiene habilidades, y todo lo hace en un solo lugar: tu conversación. Eso aguanta bien hasta el día en que le pides algo que se lee doscientas notas. La conversación se llena de notas, se compacta, y para cuando llegas a la parte interesante ya no se acuerda de qué ibas a hacer con eso.
La capa tres reparte el trabajo. Un subagente es un archivo de texto que describe a alguien con un oficio: cómo se llama, cuándo hay que llamarlo, qué herramientas puede tocar y qué se le queda grabado. Para un vault de contenido bastan tres: uno que ordena, uno que conecta y uno que escribe.
Una aclaración antes de seguir, porque la palabra subagente se usa para dos cosas muy distintas. Lanzar diez a la vez para barrer un problema grande es otra técnica y tiene su propia guía en workflows dinámicos. Aquí es exactamente lo contrario: pocos, fijos, con nombre. No los creas para una tarea y los tiras. Son los mismos tres el mes que viene, y para entonces son mejores que hoy, porque lo que aprenden se les queda.
la relación
Una skill es el procedimiento; un subagente es quien lo corre
Es la pieza que evita que las dos capas se estorben. Una skill guarda el procedimiento: los pasos, la barra de calidad, el criterio. Un subagente no vuelve a escribir nada de eso — invoca la skill y la corre en su propia ventana.
Lo que pone el subagente es lo otro: contexto aparte, para que lo que lea no te toque el hilo; herramientas recortadas, para que solo pueda hacer lo suyo; y memoria propia, para que la corrección que le hiciste hoy siga ahí el mes que viene.
Por eso cada ficha de aquí abajo dice qué skill corre y ninguna repite los pasos: ésos ya están completos en la parada de las habilidades. Si mañana cambias el procedimiento, lo cambias una sola vez en la skill y el agente que la corre ya lo hace corregido.
Por qué no basta con pedírselo a Claude directo
La razón es mecánica, no de estilo. Cada subagente arranca con su propia ventana de contexto, y al padre solo le vuelve su mensaje final. Todo lo que leyó para llegar ahí se queda del otro lado.
Traducido a un vault: si le pides a tu conversación principal que lea doscientas notas para encontrar tres conexiones, terminas con doscientas notas dentro de tu conversación y tres conexiones al final. Si se lo pides al tejedor, las doscientas notas se leen en la ventana de él, y a ti te llega un mensaje con las tres.
una sola conversación
Se lo pides a tu hilo: las doscientas notas entran a tu contexto, la compactación se lleva la mitad de lo que estabas armando, y las tres conexiones aterrizan en una conversación que ya no se acuerda del brief que ibas a escribir con ellas.
con un subagente
Se lo pides al tejedor: las doscientas notas entran a su ventana, no a la tuya. Te vuelve un mensaje con las tres conexiones y los enlaces a las notas fuente. Tu hilo sigue tan despejado como hace un minuto.
Ése es el trato de toda la capa: pagas una ida y vuelta más lenta a cambio de que lo pesado no te toque el contexto. Cuando el encargo es corto, delegar estorba. Cuando el encargo es leer mucho para devolver poco, delegar es lo único que funciona.
El archivista, el tejedor y el escriba
Cada uno cubre una etapa del flujo que ya conoces: entra una captura, se ordena, se cruza con las demás y sale una pieza. La primera fila dice qué skill corre. Fíjate en las de herramientas y memoria, que son las que casi nadie llena: son exactamente lo que el agente le agrega a la skill.
subagente 01
archivista — vacía el INBOX y etiqueta
- qué corre
- La skill process-inbox, sobre 00-INBOX. Los pasos y la barra de calidad son de ella; el archivista los corre en su ventana y te devuelve el reporte.
- herramientas
- Leer, escribir, editar y buscar archivos. Nada más: no navega, no manda correos, no toca tu calendario. Lo único que necesita para su oficio es el disco.
- modelo
- haiku. Clasificar y mover es trabajo mecánico; no le hace falta el modelo grande, y así no se te va la cuota en la tarea más aburrida del día.
- memoria
- project. Lo que se le queda: cómo clasificas tú. Que las capturas con cifra casi siempre van a numbers aunque suenen a observación, que la etiqueta genérica no la toleras, que cuando duda prefieres questions.
- cuándo lo llamas
- Todas las mañanas, en el primer minuto del ritual, o desde la tarea programada que lo despierta antes que tú.
subagente 02
tejedor — lee la semana entera y cruza
- qué corre
- La skill weekly-connections, sobre los últimos siete días de 01-CAPTURES. Ella trae los tipos de conexión que valen y el mínimo de calidad; él pone la ventana aparte donde caben los siete días sin tocarte el contexto.
- herramientas
- Leer y buscar. Escribir, solo para dejar la nota nueva en 02-CONNECTIONS. No mueve, no reescribe y no borra tus capturas.
- modelo
- opus. De los tres es el único que es puro juicio: la conexión obvia no sirve para nada, y la que sorprende hay que verla.
- memoria
- project. Lo que se le queda: qué conexiones te parecieron buenas y cuáles descartaste. Un tejedor de tres meses ya no te propone las evidentes, porque las tiraste todas y él lo anotó.
- cuándo lo llamas
- El domingo, sobre los últimos siete días. Es el único de los tres que trabaja con la semana completa enfrente.
subagente 03
escriba — convierte el brief en la pieza
- qué corre
- La skill write-content, sobre un brief aprobado de 03-BRIEFS. Ella dice cómo se escribe y dónde queda el borrador; él relee las notas fuente en su ventana, no en la tuya.
- herramientas
- Leer, buscar y escribir el borrador. No publica en ningún lado ni manda nada a nadie: el último ojo antes de publicar sigue siendo el tuyo.
- modelo
- inherit, que es el que traiga tu sesión. Al borrador lo vas a corregir en vivo, y ahí conviene que sea el mismo modelo con el que ya estás hablando.
- memoria
- project. Lo que se le queda: las correcciones que le haces. Cada adjetivo que le borras y cada frase larga que le partes se anotan ahí, y eso es lo que hace que el mes tres suene a ti y el mes uno no.
- cuándo lo llamas
- Cuando ya hay un brief aprobado y lo único que falta es el borrador. Nunca antes: sin brief escribe bonito y no dice nada.
Una honestidad sobre las herramientas: el campo que las recorta recorta herramientas, no carpetas. Decir «escribe solo en 02-CONNECTIONS» es una instrucción del cuerpo del archivo, y una instrucción se puede desobedecer. Si quieres que sea una pared y no una petición, eso ya es un hook, y son la parada de los reflejos. Para el uso diario la instrucción alcanza; para lo que no puedes permitirte que salga mal, no.
Para llamar a uno de los tres no hay menú que abrir ni comando que memorizar. Hay tres formas y sirven las tres.
cómo se llama
Tres formas de invocarlo, y una para retomarlo
- nombrarlo
- Lo mencionas en el prompt y ya: «que el archivista vacíe el inbox». Claude lee la descripción de cada agente y decide a cuál le toca.
- sin margen de duda
- Escribes @"archivista (agent)" y le hablas a ése, sin que nadie interprete nada. Es lo que usas cuando dos descripciones se parecen.
- toda la sesión
- Arrancas con claude --agent archivista y la sesión entera queda en sus manos, con sus herramientas y su memoria puestas desde el primer turno.
- retomarlo
- No empiezas de cero cada vez. Le puedes pedir que continúe y sigue con el contexto de lo que ya hizo, sin que se lo vuelvas a contar.
Cómo se ve por dentro uno de los tres
Un subagente no es una configuración escondida en un menú: es un archivo de texto que puedes abrir, leer y corregir. Vive en la carpeta .claude/agents/ del repositorio, así que se versiona y viaja con el vault. Arriba va el frontmatter, que son los datos de la ficha. Abajo, en español, va lo que le pides.
Fíjate en lo corto que es el cuerpo. No trae el procedimiento: trae la línea que manda a correr la skill, las dos de la memoria y el formato del reporte. Todo lo demás ya está escrito una vez, del otro lado.
.claude/agents/archivista.md · solo para mirar
--- name: archivista description: Procesa las capturas nuevas de 00-INBOX. Úsalo cuando el usuario pida vaciar el inbox, afilar capturas o etiquetar notas sueltas. tools: Read, Write, Edit, Glob, Grep model: haiku memory: project --- Eres el archivista del vault. Tu único trabajo es dejar 00-INBOX vacío y cada nota en su carpeta. El procedimiento no lo inventas tú: corre la skill process-inbox y sigue sus pasos y su barra de calidad tal cual están escritos. Antes de empezar, lee tu memoria: ahí está cómo clasificó este usuario las capturas anteriores y qué correcciones te hizo. Eso manda por encima de tu propio criterio. Al terminar, anota en tu memoria las reglas nuevas que aprendiste hoy sobre cómo clasifica este usuario. Devuelve un reporte de media pantalla: cuántas notas moviste, a dónde fue cada una, y la duda que te quedó. Nada más: al padre solo le llega tu mensaje final. Guarda ese reporte también en .claude/ultima-corrida.md. Cuando te despierta la tarea programada no hay nadie leyendo, y el reflejo de arranque lee ese archivo para contarte qué pasó.
Y éstos son todos los campos que acepta ese encabezado. Solo dos son obligatorios; el resto los pones cuando quieres apretar algo.
| Campo | Obligatorio | Para qué |
|---|---|---|
| name | sí | El identificador, en minúsculas. Se permiten guiones. |
| description | sí | Cuándo Claude debe delegarle. Es lo que se lee para decidir si lo llama. |
| tools | no | Las herramientas permitidas. Si no la pones, hereda todas. |
| disallowedTools | no | La lista negra, para cuando es más corto decir qué no. |
| model | no | sonnet, opus, haiku o inherit, que es el valor por defecto. |
| memory | no | user, project o local. Su cajón propio. |
| permissionMode | no | default, acceptEdits, auto, plan o bypassPermissions. |
| maxTurns | no | El tope de turnos antes de que se detenga solo. |
| isolation | no | worktree, para que sus cambios de archivos queden aislados. |
| background | no | true para que siempre corra en segundo plano. |
De los opcionales, el que más se nota es el de las herramientas. Un agente sin esa línea puede usar todo lo que puedes usar tú. Recortarla no es paranoia: es lo que evita que el archivista, buscando dónde va una nota, decida de paso reescribirte el CLAUDE.md.
La memoria de cada agente es suya
El campo de memoria le da al subagente una carpeta propia donde escribir lo que aprende. No es la tuya, no es la de la conversación principal y no es la de los otros dos: es un cajón por agente, y tiene tres alcances posibles.
| Alcance | Carpeta | Quién la ve |
|---|---|---|
| user | ~/.claude/agent-memory/<nombre>/ | Tú, en todos tus proyectos de esa máquina. No se versiona y no sale de ahí. |
| project | .claude/agent-memory/<nombre>/ | Se versiona con el repositorio. Es el único que viaja: a tu otra computadora, a un colaborador y a una sesión de nube. |
| local | .claude/agent-memory-local/<nombre>/ | Solo esa copia del repositorio en esa máquina. Queda fuera del control de versiones a propósito. |
Para un vault, project. Es el único de los tres que se versiona, y por eso es el único que llega a la sesión que va a despertar a tu agente con la laptop cerrada, que es la parada del latido. Un archivista con memoria local es un archivista que amanece amnésico del otro lado, repitiendo los errores que ya le corregiste en tu computadora.
la trampa
Lo que le enseñaste en tu conversación, el archivista no lo sabe
La memoria automática de tu conversación principal, la que Claude escribe solo mientras trabajan juntos, no entra a los subagentes. La única excepción es un fork, que sí hereda la conversación del padre.
Se siente injusto la primera vez. Llevas un mes corrigiéndole a Claude cómo etiquetas y el archivista sigue etiquetando como el primer día. No es que no aprenda: ese aprendizaje quedó guardado en otro cajón, el de tu hilo, y ese cajón no cruza.
Por eso cada agente necesita el suyo, y por eso el cuerpo del archivo le pide dos cosas de forma explícita: leer su memoria antes de empezar y anotar ahí lo que aprendió al terminar. Si esas dos líneas no están escritas, el cajón existe y se queda vacío para siempre.
Los tres archivos, de una sola vez
No escribas el frontmatter a mano. Abre Claude Code en la carpeta del vault, pega esto y revisa lo que te devuelva: los tres archivos quedan creados con las herramientas ya recortadas, la memoria ya apuntada y el cuerpo mandando a correr la skill que le toca a cada uno.
Crea el archivista, el tejedor y el escriba
Pégalo en Claude Code, dentro de la carpeta del vault. Escribe él los tres archivos de .claude/agents/; tú solo revisas y corriges lo que no suene a ti.
Crea los tres subagentes de este vault. Son tres archivos markdown en .claude/agents/ de este repositorio: archivista.md, tejedor.md y escriba.md. Escribe tú el frontmatter con los campos oficiales de Claude Code; yo no voy a tocar YAML a mano. Las cuatro skills del vault ya están en .claude/skills/. Ningún agente vuelve a escribir el procedimiento: el cuerpo de cada uno dice qué skill corre y le ordena seguir sus pasos y su barra de calidad tal cual están escritos. Reglas para los tres: - memory: project, para que lo que aprendan se versione con el repositorio y viaje a las sesiones de nube. - La descripción tiene que decir CUÁNDO delegarle, no qué es. Es lo que se lee para decidir si lo llamas. - En el cuerpo, en español, incluye siempre estas dos líneas: que lea su memoria antes de empezar y la aplique por encima de su criterio, y que anote ahí lo que aprendió al terminar. - Que el mensaje final sea corto y concreto: al padre solo le llega eso. 1. archivista - model: haiku Corre la skill process-inbox sobre 00-INBOX. Herramientas: leer, escribir, editar y buscar archivos, y nada más. Su memoria guarda cómo suelo clasificar y las correcciones que le hago. 2. tejedor - model: opus Corre la skill weekly-connections sobre los últimos 7 días de 01-CAPTURES. Herramientas: leer y buscar, más escribir solo para la nota nueva de 02-CONNECTIONS; déjalo dicho en el cuerpo, y que no mueva ni reescriba mis capturas. Su memoria guarda qué conexiones aprobé y cuáles descarté. 3. escriba - model: inherit Corre la skill write-content sobre el brief de 03-BRIEFS que yo le indique. No publica nada. Su memoria guarda las correcciones que le hago a sus borradores. Cuando termines: enséñame los tres archivos y avísame si usaste algún campo de frontmatter que no exista en la documentación oficial de subagentes, o si algún cuerpo se puso a repetir el procedimiento de una skill en vez de invocarla.
Tres son suficientes. La tentación de la segunda semana es agregar un cuarto, un editor o un investigador o un publicador, y casi siempre sale peor que arreglar el que ya tienes: un agente más es una descripción más compitiendo por la delegación, un cajón más de memoria que llenar y una decisión más cada mañana. Antes de crear el cuarto, reescribe el tercero. Con el equipo montado tu agente ya reparte trabajo dentro del vault, y lo que sigue es lo de afuera: qué alcanza cuando lo que necesita no es una nota tuya, sino tu calendario, tu correo o una página que todavía no has leído.
capa 4 · sentidos
Qué alcanza fuera del vault
Las tres capas anteriores viven adentro de la carpeta. La memoria sabe lo que escribiste, las habilidades hacen lo que le enseñaste y el equipo trabaja sobre lo que ya está guardado. Un agente así es bueno, pero solo sabe lo que tú alcanzaste a contarle.
Los sentidos son lo que alcanza sin que se lo pegues: tu calendario, tu correo, los archivos que viven en la nube, la web. Es la capa más fácil de exagerar y la más fácil de equivocar, porque casi toda guía del tema le llama MCP a cosas que no lo son.
Casi nada de lo que te venden como MCP lo es
Vas a ver listas de «MCPs que vale la pena prender» donde la mitad de las entradas no son MCP. Leer y escribir archivos, buscar en el disco, correr comandos, abrir una URL y buscar en la web son herramientas nativas de Claude Code: vienen adentro, no se instalan, no se configuran y ya están prendidas la primera vez que abres la terminal.
Y SuperWhisper no es un MCP de nada. Es una app de dictado: hablas, transcribe y te deja el texto en el portapapeles. Sirve muchísimo para capturar sin teclado, pero no es un sentido del agente. Es un teclado más rápido.
La distinción no es purismo. Buena parte de las tardes que la gente pierde armando su segundo cerebro se van en instalar algo que ya tenía prendido. Antes de conectar nada, la pregunta es si Claude Code no lo hace ya solo.
ya lo tiene
Nativo · cero instalación
- Leer, escribir y editar los archivos de tu vault, directo del disco.
- Buscar por nombre y por contenido en toda la carpeta, sin índice y sin base de datos.
- Correr comandos en la terminal: mover archivos, contar notas, ver con git qué cambió esta semana.
- Abrir una URL que tú le pasas y leerla.
- Buscar en la web cuando le falta un dato.
- Un dictado tipo SuperWhisper entra por aquí: escribe en el portapapeles, tú pegas. No hay nada que conectar.
hay que conectarlo
Lo que sí vive afuera
- Tu calendario, tu correo y tus archivos en la nube: son conectores de tu cuenta de Claude y se prenden una vez.
- Un servidor MCP es otra cosa: un programa aparte que le enseña herramientas nuevas a Claude, y hay que darlo de alta.
- El plugin que abre Obsidian por MCP, si es que lo necesitas. Casi nunca lo necesitas, y abajo está el porqué.
- Ojo con dónde vive cada uno: un MCP que agregaste en la terminal se queda en tu máquina, no en tu cuenta.
el criterio en tres líneas
Nativo, conector, MCP
Nativo: viene con Claude Code. No lo prendes porque ya está. Si algo tiene que ver con archivos, con la terminal o con leer una página, empieza asumiendo que es nativo.
Conector: una integración de tu cuenta de claude.ai, como el correo o el calendario. Se prende una vez desde el directorio de conectores y vive en tu cuenta, no en tu máquina. Como vive en la cuenta y no en el disco, sirve en tus sesiones y es además lo único de esta lista que una tarea programada en la nube puede usar cuando corre sin ti.
MCP: un programa que le agrega herramientas a Claude. Si lo diste de alta en tu terminal se queda en tu máquina, y ahí no aparece en la lista de conectores de una rutina. Esa diferencia es la que decide si una corrida de nube lo alcanza o no.
Los tres que le cambian el trabajo al agente
Con el calendario adentro, el agente deja de preguntarte cuándo. Sabe que el martes tienes tres horas libres y el jueves ninguna, así que el brief que te deja el lunes cabe en el martes y no en un día imaginario. Sabe con quién te reuniste ayer y puede abrir la nota de esa persona antes de que se la pidas. Y cuando lo despiertes temprano, puede decidir qué te sirve hoy en lugar de vaciarte encima todo lo que encontró.
El correo es donde llega el material que nunca capturas: la respuesta larga de un cliente, la objeción con las palabras exactas del que la tiene, el hilo donde alguien te explicó algo mejor de lo que tú lo explicas. Con el correo conectado, el agente puede sacar de ahí las frases que valen y dejarlas como notas en tu vault, en tu formato, sin que tú copies y pegues nada. Es la fuente de captura más rica que tienes y la que menos usas.
Los archivos en la nube son el puente entre tu carpeta y lo que hace el resto del mundo: el PDF que te mandaron, el documento que un colaborador editó, la hoja donde llevas los números. El agente los lee y los vuelve una nota tuya, resumida y conectada con lo que ya tenías, en vez de dejarlos ahí como un archivo más que vas a abrir cuando te acuerdes.
Los tres viven en tu cuenta de claude.ai, no en tu carpeta, y por eso son lo que una tarea programada en la nube alcanza el día que corra sin ti. Préndelos de a uno. Un conector, una semana de uso, y hasta entonces el siguiente. Un agente con seis conectores el primer día no es seis veces más útil: es seis veces más difícil de auditar el día que haga algo que no querías.
El paso a paso de prenderlos —cuáles se agregan de un clic desde el directorio, cuáles se agregan pegando una URL y qué permisos pide cada uno— está en la guía de conectores. Aquí solo importa la decisión, y la decisión tiene dos caras al mismo tiempo: cada conector que prendes es un sentido nuevo y también una puerta nueva.
Obsidian por MCP: cuándo sirve y cuándo sobra
Obsidian tiene su propio MCP. El plugin de la tienda se llama hoy Local REST API with MCP, y cuando lo prendes sirve un MCP nativo en una dirección de tu propia máquina, con un token que viaja en el encabezado de autorización. Obsidian tiene que estar abierto para que del otro lado haya alguien, y la primera vez hay que confiar a mano en su certificado, porque es un certificado que se firmó a sí mismo y tu sistema no lo conoce de antes.
Instala la última versión desde la tienda de plugins de Obsidian, no una que ya tuvieras guardada. Hubo una vulnerabilidad de path traversal —una falla que permite alcanzar archivos fuera de la carpeta que le tocaba— parchada en la línea 4.1.x. Por eso esta guía no fija un número de versión y sí dice lo otro: no conectes nada desde una versión vieja.
el plugin
Local REST API with MCP, en una tarjeta
- cómo se instala
- Desde la tienda de plugins de Obsidian, siempre la última. Cualquier número de versión que leas en una guía envejece antes que tú.
- dónde escucha
- En https://127.0.0.1:27124/mcp/ — una dirección de tu propia computadora, que no sale a internet.
- cómo se autentica
- Con un token que el propio plugin te genera, mandado en el encabezado Authorization: Bearer.
- qué necesita
- Obsidian abierto. Con la app cerrada no hay servidor, y el agente se queda hablando solo.
- la trampa
- Usa un certificado autofirmado: hay que confiar en él la primera vez. Y hubo una vulnerabilidad de path traversal parchada en la línea 4.1.x, así que no lo conectes desde una versión anterior.
Que Claude Code lo conecte por ti
Prende el plugin en Obsidian y copia el token que te genera. Después abre Claude Code en la carpeta de tu vault y pega esto. No escribas la configuración a mano.
Quiero conectar Obsidian a Claude Code por MCP. Ya instalé la última versión del plugin «Local REST API with MCP» desde la tienda de plugins de Obsidian, tengo el token que me generó y Obsidian está abierto. Haz esto: 1. Da de alta el servidor MCP de Obsidian para esta carpeta, apuntando a la dirección local que sirve el plugin y mandando mi token en el encabezado de autorización. Pídeme el token cuando lo necesites y no lo dejes escrito en ningún archivo que pueda terminar en un repositorio. 2. Dime en una línea dónde quedó guardada esa configuración y si viaja con el repositorio o se queda solo en mi máquina. 3. Prueba la conexión: lee el título de una nota cualquiera del vault y dime qué te devolvió. 4. Si el certificado autofirmado del plugin da problema, dime exactamente qué tengo que aceptar y dónde. No desactives la verificación por tu cuenta. Antes de tocar nada, dime en dos líneas qué vas a hacer y espera mi visto bueno.
la línea honesta
Para la mayoría, este MCP sobra
Claude Code ya lee la carpeta del vault directo del disco. Todo lo que el MCP de Obsidian te deja hacer con tus notas —abrirlas, buscarlas, escribirlas— ya lo hace sin instalar nada, y con menos piezas que se pueden romper. Si tu vault vive en tu máquina y trabajas desde la terminal, no lo necesitas.
Sirve en dos casos, y conviene saber si estás en uno antes de perder la tarde. El primero: cuando quieres que Obsidian esté vivo del otro lado, o sea que lo que se escriba pase por la app, respete sus plugins y refresque la vista que tienes abierta. El segundo: cuando el que se conecta no es Claude Code sino Claude Desktop, que no está parado en tu carpeta y necesita que alguien le abra la puerta.
Qué sale de tu máquina, y cuándo
Este tema no es de ninguna otra guía de la bóveda, así que va aquí y va completo. No es una advertencia de abogado: son tres situaciones distintas que casi todo el mundo mete en el mismo cajón.
El vault son archivos en tu disco. Cuando le preguntas algo a Claude, lo único que sale de tu máquina es el pedazo que necesita leer para contestarte: las notas que abrió, no la carpeta entera. Es exactamente lo mismo que pasa cuando pegas un texto en una conversación normal con tu suscripción. Ni más ni menos.
Un conector es otra cosa. Ahí no le estás mandando un mensaje: le estás dando acceso permanente a un servicio entero. Prender el correo no es enseñarle un correo, es dejarle la bandeja. Puede ser exactamente lo que quieres, porque es justo lo que lo vuelve útil, pero es una decisión distinta y se toma sabiendo que es distinta.
La tercera es la que sorprende: a una tarea programada en la nube se le incluyen por defecto todos los conectores que tengas prendidos, así que hay que quitarle uno por uno los que esa tarea no necesita antes de dejarla corriendo. Cómo se comporta esa corrida, y por qué no te va a preguntar nada, está en la parada del latido. Aquí basta con tenerlo presente antes de prender el sexto conector: el costo de un conector de más no se paga mientras tú estás sentado enfrente, se paga el día que el agente corra sin ti.
Lo que nunca va en el CLAUDE.md ni en una nota del vault
- Contraseñas, llaves de API y tokens de acceso. Ni completos, ni «solo el principio», ni comentados para acordarte.
- El token del plugin de Obsidian y cualquier otro secreto de configuración: van donde el programa los pida, no en una nota.
- Datos de terceros que no son tuyos para compartir: el contrato de un cliente, la conversación privada de alguien, el expediente de un paciente. Que tú los tengas no los vuelve tuyos.
- Nada que te dolería ver pegado en la salida de un agente que corrió solo a las tres de la mañana.
Escribir en el CLAUDE.md una regla dura del tipo «nunca leas archivos .env» ayuda, y vale la pena escribirla. Pero es contexto, no candado: es una instrucción que el modelo lee y casi siempre obedece, y «casi siempre» no es una garantía. El candado de verdad es un hook, que corre antes de la herramienta y la bloquea aunque el modelo opine otra cosa. Eso es la parada de los reflejos.
Con esto tu agente ya sabe, ya puede, ya delega y ya alcanza. Y las cuatro capas tienen el mismo defecto: todas esperan a que tú abras la terminal. Falta la que lo despierta solo.
capa 5 · latido
Que siga trabajando con la laptop cerrada
Las cuatro capas anteriores hacen un asistente buenísimo. Ninguna lo hace JARVIS. Todo lo que llevas construido empieza igual: tú abres la terminal. El latido es la capa que quita ese paso.
Hay tres relojes que pueden despertarlo y no son intercambiables. Elegir mal es la razón número uno por la que alguien programa una tarea, se va de viaje, vuelve y no encuentra absolutamente nada esperándolo.
qué no se explica aquí
Operar una tarea programada ya está contado en otras dos guías
Cómo se crea una tarea paso a paso, la regla de la carpeta, los modos de aprobación, los topes por plan y qué puede tocar cada conector están en 10 automatizaciones con Claude.
El comando de agendado, los disparadores y el tablero de corridas están en Schedule: agentes en la nube.
Y si lo que quieres no es un agente que despierte, sino varios corriendo todo el día en una máquina tuya, eso es otra arquitectura y está en Ecosistema de agentes.
Aquí va solo lo que esas dos no cubren, porque no es su tema: qué le pasa a un vault cuando la tarea corre. Es una pregunta distinta y tiene una respuesta incómoda.
Los tres relojes
Uno corre en la infraestructura de Anthropic, otro en tu computadora con la app de escritorio abierta, y el tercero dentro de una sesión que tú dejaste corriendo. Suenan parecidos y no lo son.
| Nube | Desktop local | Sesión abierta | |
|---|---|---|---|
| Corre en | La infraestructura de Anthropic | Tu máquina, con la app de escritorio abierta | Tu máquina, dentro de la sesión |
| ¿Necesita la compu prendida? | No | Sí, y despierta | Sí, y despierta |
| ¿Necesita una sesión abierta? | No | No | Sí |
| ¿Ve tus archivos locales? | No. Clona un repositorio de GitHub al empezar cada corrida. | Sí, la carpeta que le diste | Sí, la de la sesión |
| Permisos | Corre sin preguntar: no hay selector de modo ni confirmaciones durante la corrida. | Configurable por tarea | Los que ya tiene la sesión |
| Intervalo mínimo | 1 hora | 1 minuto | 1 minuto |
dónde se da de alta cada uno
Los tres botones, sin salir de aquí
- en la nube
- En claude.ai/code/routines, o escribiendo /schedule en cualquier sesión de la terminal y contestando lo que te pregunte. Las dos superficies escriben en la misma cuenta, así que lo que crees en una aparece en la otra.
- en tu máquina
- En la app de escritorio, pestaña Code, Routines, New routine, y ahí eliges Local en vez de Cloud. Es la misma pantalla para las dos, y esa elección es la que decide todo lo demás.
- solo mientras trabajas
- Con /loop en la sesión que ya tienes abierta. No sobrevive a cerrar la terminal, y para eso está.
Léela una vez de arriba abajo y quédate con la cuarta fila. Todo lo demás de esta sección sale de ahí.
La regla del repositorio
Una rutina de nube no corre en tu computadora. Corre en un contenedor limpio que se enciende para esa corrida y se apaga al terminar. Ese contenedor no tiene tu carpeta de documentos, no tiene tu vault y no tiene forma de llegar a ellos.
Lo que sí tiene es lo que tú le diste. Al crear la rutina seleccionas uno o más repositorios de GitHub, y cada uno se clona al empezar la corrida, desde su rama por defecto. Ése es el único puente. El trabajo que Claude haga ahí lo empuja a ramas con prefijo claude/, para que puedas revisarlo antes de que toque tu rama principal.
De ahí sale la frase que decide si tu JARVIS es real o es una demo: para que tu segundo cerebro siga trabajando con la laptop cerrada, tiene que ser un repositorio privado de GitHub. No «tener respaldo en GitHub». Ser un repositorio.
Lo que la gente cree que pasó
«Programé la rutina para que procesara mi INBOX cada mañana a las 7. Me fui una semana de viaje y cuando volví el INBOX estaba idéntico, con las mismas capturas crudas. Y la tarea aparece en verde los siete días.»
Lo que de verdad pasó
La rutina corrió los siete días, en un contenedor que nunca vio tu carpeta. Clonó el repositorio que le seleccionaste —o ninguno, si no le seleccionaste ninguno— y ahí buscó un INBOX que no existía. Salió sin error de infraestructura, y por eso está en verde.
El plugin de sincronización con Git que apareció en la parada de los tres caminos cambia de papel en este punto. Cuando lo instalaste parecía una comodidad: respaldo automático, por si se pierde la laptop. No era respaldo. Era el transporte.
Es la pieza que sube tu vault al único lugar donde una rutina de nube puede alcanzarlo. Lo que la rutina escribe mientras duermes no vuelve solo: queda en una rama con prefijo claude/, y tú la revisas y la mezclas cuando quieras. Sin el transporte, el latido de nube no tiene dónde latir.
el hallazgo
El respaldo y el transporte son el mismo archivo
Sin repositorio, tu vault existe en un solo lugar y solo tú puedes trabajarlo. Con un repositorio privado existe en dos: tu disco y una copia que la nube sabe clonar.
Conviene que el auto-commit corra seguido y que la rama por defecto sea la que usas todos los días, porque la rutina clona la rama por defecto, no la que tengas abierta en local.
Y va privado, sin discusión. Ahí adentro están tus capturas crudas, tus reacciones sin filtrar y tus números reales.
La otra mitad de la regla: tus skills tampoco viajan
El repositorio resuelve los archivos. Falta la mitad que rompe más sistemas: una sesión de nube no lee la carpeta personal de skills de tu máquina. No la ve, igual que no ve tu vault.
Sí lee dos cosas. Las skills que hayas prendido para tu cuenta, que se sincronizan al arrancar la sesión. Y las skills committeadas en el .claude/skills/ del repositorio que acaba de clonar. Esa segunda es la que importa para un vault.
Por eso la parada de las habilidades insistió en que la carpeta .claude/ viva dentro del vault y no en tu carpeta de usuario. No era orden por gusto. Todo el esqueleto de la parada del esqueleto estaba puesto para este momento: si tus cuatro skills están adentro del repositorio, la rutina las tiene; si están en tu carpeta personal, la rutina corre sin ellas y no te avisa.
- Las skills del vault van en .claude/skills/<nombre>/SKILL.md, dentro del repositorio, y se commitean como cualquier otro archivo.
- Tu CLAUDE.md de la raíz viaja también, porque también es un archivo del repositorio. La memoria automática no: vive en tu carpeta de usuario y la documentación dice textual que no se comparte con entornos de nube.
- Los subagentes de .claude/agents/ y los hooks declarados en .claude/settings.json viajan por la misma razón: son archivos versionados.
- Los servidores MCP que agregaste desde tu terminal no aparecen en la lista de conectores de una rutina, porque viven en tu máquina y no en tu cuenta. Para que una rutina los alcance hay que darlos de alta como conector de la cuenta o declararlos en un archivo de configuración committeado en el repositorio.
Qué agendar de verdad
La tentación es agendar todo. No funciona: una tarea que corre sola y que nadie lee es ruido con horario. Éstas son las cuatro del sistema de contenido, y cada una tiene un reloj que le queda.
| La tarea | Su reloj | Por qué ése |
|---|---|---|
| Procesar el INBOX cada mañana | Desktop local | Toca archivos de tu disco y tiene que dejarlos afilados antes de que te sientes. En la nube trabajaría sobre la copia clonada y tú tendrías que bajar el resultado antes de verlo. Con una condición: esa corrida solo pasa con la app de escritorio abierta y la máquina despierta, y si se durmió a esa hora la corrida se salta. Está completo en los avisos, aquí abajo. |
| La sesión de conexiones del domingo | Nube | Es la que tiene que pasar aunque estés de viaje. Lee la semana entera del repositorio y deja las conexiones nuevas en una rama claude/ para que las revises el lunes. |
| La revisión mensual de lo publicado | Nube | Corre una vez al mes, no urge la hora exacta, y depende más de conectores que de tu disco. Es el caso donde la nube gana sin discusión. |
| Recoger los dictados sueltos cada pocos minutos | Desktop local | En la nube no existe: el intervalo mínimo es de una hora. Cualquier cosa que tenga que pasar más seguido es tarea local, y punto. |
es del Desktop
Cuando toca tu disco o corre seguido
- Necesita leer o escribir archivos que solo existen en tu computadora.
- Tiene que correr cada pocos minutos: en la nube el mínimo es una hora.
- Quieres verla mientras pasa y aprobar algo antes de que siga.
- El resultado lo vas a usar tú, sentado, en los próximos minutos.
es de nube
Cuando tiene que pasar aunque no estés
- Tiene que ocurrir aunque estés de viaje y la laptop esté cerrada.
- Puede trabajar sobre la copia del repositorio sin perder nada.
- Usa conectores de tu cuenta más que archivos locales.
- Te sirve encontrarte el trabajo hecho, en una rama, para revisarlo al abrir.
Si una tarea cae en las dos listas, pártela en dos: la mitad de nube deja el material en una rama, y la mitad local lo integra a tu vault cuando abres la computadora.
Los avisos que cuestan caro
- Las rutinas de nube están en vista previa de investigación. La documentación avisa que el comportamiento, los límites y la superficie pueden cambiar, así que lo de aquí puede haberse movido cuando lo pruebes.
- Corren sin pedir permiso: no hay selector de modo de aprobación ni confirmaciones durante la corrida. Y por defecto se incluyen todos tus conectores conectados, con sus herramientas de escritura. Quítale los que no necesite antes de la primera corrida, no después.
- Un estado verde solo dice que la sesión arrancó y terminó sin error de infraestructura. No dice que la tarea haya salido bien. Hay que abrir la corrida y leerla, sobre todo las primeras semanas.
- En la nube el intervalo mínimo es de una hora y una expresión de cron más frecuente se rechaza. Las corridas también pueden empezar unos minutos tarde, por un desfase deliberado que es consistente para cada rutina.
- Hay un tope diario de corridas por cuenta, aparte del límite normal de tu suscripción. Las corridas de una sola vez no cuentan contra él.
- Las tareas locales solo corren con la app de escritorio abierta y la computadora despierta. Si se durmió a la hora agendada, la corrida se salta, y cerrar la tapa la duerme de todos modos.
- Al despertar, el Desktop arranca exactamente una corrida de recuperación: la del horario perdido más reciente de los últimos siete días, y descarta las anteriores. Una tarea diaria que perdió seis días corre una sola vez.
El tope cambia y no vale la pena memorizarlo: míralo en tu propio tablero de rutinas, que es el mismo lugar donde se abre cada corrida para leerla.
cómo se escribe un prompt que aguanta esto
Dale a la tarea permiso de no hacer nada
Como la recuperación es una sola y puede llegar a deshora, el prompt de una tarea local tiene que mirar la hora y decidir. No supongas que corre a las 7.
Con una línea al principio basta: «Antes de empezar, mira la hora. Si ya pasaron las cinco de la tarde, no proceses nada: dime qué corridas se perdieron y déjalo para mañana.»
Lo mismo del otro lado: si la tarea escribe en el vault, pídele que revise si el trabajo de hoy ya está hecho antes de rehacerlo. Una corrida de recuperación que duplica notas cuesta más que una corrida perdida.
Una tarea programada es una skill
Éste es el detalle que amarra la sección con la parada de las habilidades. Cada tarea local que creas desde el Desktop se guarda en tu disco como un SKILL.md, con frontmatter de nombre y descripción y el prompt como cuerpo. No es una metáfora ni un parecido: es el mismo archivo que una skill.
en tu disco · solo para mirarlo
~/.claude/scheduled-tasks/
└── procesar-inbox/
└── SKILL.md
---
name: procesar-inbox
description: Afila las capturas crudas del INBOX y las archiva
---
Antes de empezar, mira la hora. Si ya pasaron las
cinco de la tarde, no proceses nada: dime qué se
perdió y déjalo para mañana.
Si estamos a tiempo, lee cada nota de 00-INBOX/ ...Lo que no está en ese archivo es el horario, la carpeta, el modelo y si la tarea está prendida: eso lo guarda la app aparte. Puedes leer y editar el prompt de tu tarea como cualquier otro archivo de texto, pero el reloj se cambia desde la app.
Y hay un último giro. Una tarea que está corriendo puede cambiar su propio horario o su propio prompt con una herramienta que trae para eso, update_scheduled_task. Es la primera vez en toda la guía que el agente edita su propio latido: úsalo cuando se lo pidas explícitamente, no como costumbre.
Convierte tu vault en el repositorio privado que la nube puede clonar
Pégalo en Claude Code con la sesión abierta en la carpeta de tu vault. Él hace el git init, escribe el .gitignore, verifica que la carpeta .claude/ sí entre, y te lleva hasta el primer push. Lo único que haces tú es crear el repositorio vacío en GitHub cuando te lo pida.
Quiero que esta carpeta —mi vault— se vuelva un repositorio privado de GitHub, porque necesito que una rutina de Claude en la nube pueda clonarla y trabajar sobre ella cuando mi computadora esté apagada. Hazlo en este orden y explícame cada paso en español, sin jerga: 1. Revisa si esta carpeta ya es un repositorio. Si no lo es, inicialízalo. 2. Escribe un .gitignore pensado para un vault de notas. Deja FUERA el estado local de la app de notas (workspace, caché, plugins con datos propios), los archivos temporales del sistema, y cualquier archivo con credenciales o tokens. Antes de escribirlo, enséñame la lista de lo que vas a excluir y espera mi visto bueno. 3. Confirma que la carpeta .claude/ de este vault SÍ entra al repositorio: skills, agentes, reglas y settings. Ésa es la parte que tiene que viajar a la nube. Si algo de .claude/ quedó excluido por el .gitignore, arréglalo y dímelo. 4. Recórreme la lista de archivos que están por subir y avísame si ves algo sensible o personal que quizá no quiero ni en un repositorio privado. 5. Explícame en dos líneas cómo crear el repositorio vacío y PRIVADO en GitHub, dime qué nombre ponerle, y espera a que te confirme que ya existe. 6. Conecta el remoto, haz el primer commit con un mensaje claro y empuja a la rama por defecto. Dime cómo se llama esa rama, porque es la que va a clonar la rutina. 7. Cierra con un resumen de tres líneas: qué subió, qué quedó fuera, y qué tengo que hacer de aquí en adelante para que el repositorio no se atrase. No borres nada ni reescribas mis notas. Si algo no te queda claro, pregúntame antes de ejecutar.
Con el latido puesto, las cinco capas están completas: memoria, habilidades, equipo, sentidos y latido. Falta una cosa más, y no es una capa: que reaccione sin que nadie lo decida.
los reflejos
Lo que dispara aunque Claude opine otra cosa
Todo lo que llevas montado hasta aquí es contexto. El CLAUDE.md, las skills, los subagentes, los conectores: se lo pones enfrente, se lo pides, y casi siempre te hace caso. Casi siempre es una palabra incómoda cuando de eso depende tu respaldo.
Un hook no pide nada. Es un comando que Claude Code corre en un momento fijo del ciclo de vida —al abrir la sesión, al cerrarla, justo antes o justo después de usar una herramienta— pase lo que pase y decida lo que decida el modelo. No hay una versión de la conversación en la que se le olvide, porque no es una instrucción: es un disparador.
por qué es la capa más confiable de las cinco
Los hooks se saltan la compactación por completo
Cuando una sesión se hace larga, la conversación se compacta: lo viejo se resume para que quepa lo nuevo. El CLAUDE.md de la raíz sobrevive porque se vuelve a leer del disco y se reinyecta, pero todo lo demás pasa por el resumen y se degrada un poco cada vez.
Los hooks no participan de eso. No viven en la ventana de contexto, viven en la configuración. La documentación es explícita: se saltan la compactación entera. A la hora tres de una sesión funcionan exactamente igual que en el minuto uno.
Ése es el criterio para decidir qué merece ser un hook y qué no: si algo tiene que pasar aunque la sesión lleve horas y el contexto esté lleno, no lo escribas como instrucción.
Los tres que le sirven a un vault
No necesitas doce. Con estos tres el vault deja de depender de que tú te acuerdes de tres cosas.
SessionStart · el reflejo de arranque
Al abrir la sesión, el hook cuenta cuántas notas hay en 00-INBOX y te lo dice en una línea, antes de que escribas nada.
En la segunda línea te dice si la última corrida programada pasó y qué dejó. Lee el reporte que la corrida deja en .claude/ultima-corrida.md y, si no lo encuentra, se apoya en la fecha de lo último que entró a 01-CAPTURES. Importa porque esa corrida es local y solo ocurre con la máquina despierta, como se explica en la parada del latido: cuando se salta, quieres enterarte al abrir y no tres días después.
Suena chiquito y no lo es. Es la diferencia entre una línea del CLAUDE.md que dice «acuérdate de procesar el inbox» —que compite contra todo lo demás que hay en contexto— y un número en pantalla. Catorce notas sin procesar se ven. «Acuérdate» no se ve. Y si el parte dice que la corrida no pasó, ya sabes que ese número te toca a ti.
Stop · el reflejo de cierre
Cuando terminas de trabajar, el hook hace commit del vault y lo empuja al remoto. No cuando te acuerdes: al cerrar, que es cuando el vault está en un estado con sentido. El empujón importa tanto como el commit, porque una rutina de nube clona lo que está en GitHub: un commit que se quedó en tu disco es trabajo que la rutina del domingo no va a ver.
Si venías usando el plugin de Obsidian Git, esto no lo contradice, lo destapa: el respaldo pasa a correr aunque Obsidian esté cerrado, porque no depende de Obsidian. En esta guía Obsidian es la ventana, y una ventana cerrada no debería costarte el trabajo del día.
PostToolUse con matcher de escritura · el reflejo de índice
Cada vez que se escribe o se edita una nota, el hook actualiza el índice del vault.
Un vault sin índice se busca a mano. Un vault con índice desactualizado es peor, porque miente. Mantenerlo tú es el tipo de tarea que nadie sostiene dos semanas seguidas.
El matcher es la mitad del truco: escribir «Write|Edit» significa que corre después de escribir y de editar, y no después de cada lectura ni de cada búsqueda. Un PostToolUse sin matcher corre después de todo, y ésa es la forma más fácil de volver lenta una sesión.
Dónde se declaran
Un hook es un renglón en un archivo de configuración: qué evento lo dispara, con qué filtro, y qué comando corre. Puede vivir en los ajustes de tu usuario, en los del proyecto, en los del proyecto que no se versionan, en el paquete de un plugin, o en el frontmatter de una skill o de un subagente. El lugar que elijas decide quién los hereda.
los lugares donde vive un hook
El archivo que eliges decide quién lo hereda
- .claude/settings.json
- Del proyecto y se commitea. Es donde van los tres hooks del vault si quieres que viajen con el repo. Y si tu vault es un repositorio privado que una tarea de nube clona, este archivo es el único lugar donde existen para ella.
- .claude/settings.local.json
- Del proyecto pero no se versiona. Para lo que es tuyo y de esta máquina: una ruta local, un script que solo tú tienes, algo que no quieres empujar al repo.
- ~/.claude/settings.json
- Tuyo y para todos tus proyectos. Ojo con esto: un hook aquí corre también en repos donde no tiene nada que hacer. Los tres de esta sección hablan de carpetas que solo existen en el vault.
- frontmatter de una skill
- Se registran cuando invocas la skill y siguen puestos el resto de la sesión, salvo que lleven la marca de correr una sola vez, que la doc llama once.
- frontmatter de un subagente
- Viven solo mientras ese subagente corre. Se apagan cuando devuelve su mensaje final, y no afectan a la conversación del padre.
- hooks/hooks.json de un plugin
- Los que trae un plugin instalado. Vale saber que existen para no volverte loco buscando de dónde salió un hook que tú no escribiste.
.claude/settings.json · la forma por dentro
{
"hooks": {
"SessionStart": [
{
"hooks": [
{ "type": "command", "command": ".claude/hooks/inbox.sh" }
]
}
],
"PostToolUse": [
{
"matcher": "Write|Edit",
"hooks": [
{ "type": "command", "command": ".claude/hooks/indice.sh" }
]
}
],
"Stop": [
{
"hooks": [
{ "type": "command", "command": ".claude/hooks/respaldo.sh" }
]
}
]
}
}Míralo, no lo copies. Lo único que hace falta que se te quede es la jerarquía: el nombre del evento arriba, el matcher opcional que filtra por herramienta, y abajo la lista de comandos que corren. Los eventos que no son de herramienta no llevan matcher.
Y ahora la parte que importa si no programas: no tienes que escribir nada de esto. Los scripts y el JSON los escribe Claude Code, en el mismo vault, si se lo pides bien.
Los tres hooks, escritos y funcionando
Pégalo en Claude Code con la sesión abierta en la carpeta del vault. Él crea los scripts, escribe la configuración y te dice cómo probarlos.
Quiero tres hooks en este vault. No escribo JSON, así que hazlo tú: crea los scripts, déjalos registrados en .claude/settings.json y compruébalos antes de decirme que están. 1) SessionStart: al abrir la sesión dame un parte de dos líneas, sin que yo pregunte nada. - Primera línea: cuántas notas hay en 00-INBOX/. Si está en cero, dilo también. - Segunda línea: si la última corrida programada pasó y qué dejó. Busca primero el archivo .claude/ultima-corrida.md, que es donde la corrida deja su reporte; si todavía no existe, usa la fecha del archivo más reciente de 01-CAPTURES/ para saber cuándo se archivó algo por última vez. Si no hay rastro de una corrida reciente, dilo en claro: que se saltó y que el inbox está sin procesar. 2) Stop: cuando termine de trabajar, haz commit de todo el vault con un mensaje que incluya la fecha y empújalo al remoto. Si no hay cambios, que no haga commit vacío ni falle; y si no hay remoto configurado, que se salte el empujón en silencio en vez de tronar. 3) PostToolUse con matcher "Write|Edit": cada vez que se escriba o se edite una nota, actualiza el índice del vault con el título, la ruta y la fecha del archivo que se tocó. Reglas: - Los scripts van en .claude/hooks/ y tienen que quedar ejecutables. - El parte de arranque cabe en dos líneas: si no hay nada que decir, que se calle en vez de llenarme la pantalla. - Ninguno de los tres debe bloquear nada: solo informan y respaldan. - Si a alguno le falta algo (por ejemplo, que el vault todavía no sea un repositorio de git), que falle en silencio en vez de tumbarme la sesión. - Explícame en dos líneas qué hace cada script, en español y sin jerga. - Al final dime con qué comando pruebo cada uno sin tener que abrir y cerrar sesiones.
Salida 2: la única forma de cerrar una puerta
Un hook puede hacer más que avisar. Si el script termina con código de salida 2, eso es un bloqueo, y qué bloquea depende del evento en el que esté colgado.
En la parada de memoria quedó abierto un desempate: qué haces cuando una regla no puede quedar a criterio del modelo. Ésta es la respuesta, y es corta. Una línea en el CLAUDE.md pide por favor. Un hook PreToolUse cierra la puerta.
- PreToolUse: la herramienta no llega a correr. Es el único punto donde puedes impedir de verdad que algo pase.
- Stop: la conversación no termina. Sirve para obligar un paso final, y también para dejarte encerrado si el script está mal escrito.
- UserPromptSubmit: el prompt se borra antes de llegar al modelo.
- PostToolUse: la herramienta ya corrió, así que salir con 2 no deshace nada. Ahí solo le enseña el error a Claude para que lo tome en cuenta.
pide por favor
En el CLAUDE.md: «Nunca modifiques archivos de 04-PUBLISHED sin que yo te lo pida.» Es una instrucción y compite con todo lo que hay en contexto. La va a respetar casi siempre. Basta con que una vez no, en una sesión larga, para que te reescriba una pieza publicada.
cierra la puerta
Un hook PreToolUse con matcher de escritura que mira la ruta y, si cae dentro de 04-PUBLISHED, sale con 2. La herramienta no corre. No existe la sesión larga, el contexto lleno ni el malentendido que haga que ese archivo se toque de todos modos.
El candado sobre lo que ya publicaste
El mismo formato: se lo pides en español y él escribe el script y la configuración. Cámbiale la carpeta si en tu vault se llama de otra forma.
Agrega un hook PreToolUse a este vault que impida escribir o editar cualquier archivo dentro de 04-PUBLISHED/. Es material ya publicado y no quiero que se toque por accidente. Cómo lo quiero: - Matcher de escritura: "Write|Edit". - El script mira la ruta del archivo que se va a tocar. Si cae dentro de 04-PUBLISHED/, sale con código 2 y escribe una línea que explique por qué: que es material publicado y que si de verdad hay que cambiarlo, se cambia a mano. - Si la ruta está fuera de esa carpeta, sale con 0 y no estorba. - Déjalo registrado en .claude/settings.json. - Cuando termines, pruébalo intentando editar un archivo de esa carpeta y enséñame que se bloqueó. - Y dime cómo lo desactivo un rato el día que sí necesite editar ahí.
Estos tres son los que le sirven a un vault, pero la lista de eventos es más larga: hay uno para cuando arranca un subagente, otro para cuando cambia un archivo, y un par para antes y después de una compactación. Viven en la documentación oficial de hooks. Si se te ocurre un momento del ciclo de vida en el que algo debería pasar solo, revisa ahí si ya tiene evento antes de inventarte un rodeo.
Con los reflejos puestos ya no falta ninguna pieza: las cinco capas, más la que dispara aunque nadie la invoque. Lo que falta no es construir otra capa. Es usarlo, y eso pide un ritmo.
el ritmo
Veinte minutos al día, treinta el domingo
Las cinco capas ya están puestas. Lo que sigue decide si el sistema sobrevive al mes dos: cuándo te sientas, cuánto rato, y qué haces exactamente en ese rato.
Veinte minutos al día, treinta el domingo y una hora al mes. Lo que importa no es el tamaño, es quién hace qué: sin las capas puestas, la mitad del bloque diario se te iría mudando archivos de una carpeta a otra. Con ellas puestas esa parte ya pasó sin ti, y los veinte minutos se van completos en lo único que no se delega: decidir.
Por eso cada bloque de aquí abajo dice dos cosas que antes no decía. Qué capa hace el trabajo, y qué parte del ritual viejo te quitaron de encima.
Un aviso de alcance antes de entrar: en esta parada se usa el resultado de una tarea programada, no se explica cómo se da de alta. Eso está en 10 automatizaciones con Claude, y qué le pasa a un vault cuando la corrida es en la nube quedó en la parada del latido.
Los tres bloques, con su desglose
Un supuesto del bloque diario, y conviene decirlo antes: la corrida que procesa el inbox es de mañana temprano y pasa en tu máquina, así que necesita la computadora despierta y la app de escritorio abierta. Hay un ajuste «Keep computer awake» que evita que se duerma sola por inactividad, pero cerrar la tapa la duerme de todos modos: para que esa corrida no se salte, la máquina se queda abierta. Si no corrió, el reflejo de arranque te dice cuántas capturas quedaron sin procesar y la corres tú ahí mismo, antes del minuto 3. Qué reloj le toca a cada tarea está en la parada del latido.
Diario · veinte minutos, antes de abrir cualquier red
De lunes a viernes, temprano. Es el bloque que sostiene todo lo demás: si se cae éste, los otros dos no alcanzan a salvarlo.
- Del minuto 0 al 3, lees. Al abrir la sesión, el reflejo de arranque ya dejó en pantalla cuántas capturas hay en el inbox y si la última corrida programada pasó y qué dejó. No preguntas nada todavía: solo miras.
- Del 3 al 8, capturas en crudo lo de las últimas horas. Lo que notaste, la reacción sin filtro, el número real, la pregunta que no supiste contestar. Sin editar. Editar aquí es la forma más común de no capturar.
- Del 8 al 14, le pides las conexiones del día. Cruza lo que entró hoy contra los últimos catorce días y te devuelve tres como máximo.
- Del 14 al 20, eliges una y pides el brief. Una, no las tres. Antes de las nueve de la mañana tienes una pieza lista para escribir.
La capa que trabaja: el latido procesa el inbox temprano, antes de que te sientes; el reflejo de arranque te pone el conteo enfrente y el tejedor es quien cruza las capturas. Tú apareces en el minuto 3 y en el minuto 14.
Lo que ya no haces tú: abrir el vault para procesar el inbox. Sin el latido puesto, este bloque empezaría con «abre el vault y corre la skill del inbox» y diez de los veinte minutos serían mudanza de archivos. Con él puesto eso ya ocurrió, y ocurrió sin ti.
Las conexiones del día
El momento en que el sistema te sorprende. Lo pegas en el minuto 8, cuando el inbox ya quedó archivado.
Las capturas de hoy ya están archivadas en 01-CAPTURES. Busca conexiones fuertes entre lo que entró HOY y cualquier nota agregada al vault en los últimos 14 días. Reglas: - Solo cuentan cuatro tipos: el mismo principio en dos dominios distintos, dos notas que se contradicen, un patrón que aparece en tres notas o más, o una pregunta que otra nota responde por accidente. - Si la conexión es obvia, no me la cuentes. - Para cada una: nómbrala, dame el puente en una frase y una entrada posible. - Máximo tres. Quiero la mejor, no todas. Cierra diciéndome cuál de las tres vale más la pena trabajar como brief hoy, y por qué. Si hoy no hay ninguna que llegue, dilo en la primera línea: prefiero cero conexiones a tres forzadas.
Semanal · treinta minutos, domingo por la tarde
Es el bloque que más gente se salta y el que produce las mejores piezas de la semana, porque es el único donde alguien lee los siete días completos de una sentada.
- Del minuto 0 al 5, abres lo que la corrida del domingo ya dejó escrito. Si tu latido corre en la nube, el trabajo te llega en una rama aparte: se revisa, no se acepta de entrada.
- Del 5 al 15, descartas. De las conexiones que propuso, la mitad no sirve. Decir cuáles y por qué es lo que hace que la semana que entra proponga mejor.
- Del 15 al 25, de las dos que quedaron en pie pides los briefs completos.
- Del 25 al 30, anotas lo que cambió: un tema que ya se repitió tres semanas seguidas, una palabra que empezaste a usar, un ángulo que dejó de interesarte. Eso va a donde el agente lo va a volver a leer, no a un pendiente.
La capa que trabaja: el equipo. El tejedor lee los siete días de una sola vez, que es justo lo que el bloque diario no puede hacer, y las conexiones que salen de siete días de material son más fuertes que las de un día. Su memoria es propia, así que se acuerda de lo que ya te propuso y no te lo vuelve a servir.
Lo que ya no haces tú: releerte la semana. Antes, el domingo empezaba abriendo siete días de notas para pasarlas por los ojos. Eso pasa ahora en la ventana de contexto del tejedor, no en la tuya: a ti te vuelve la lista corta.
La sesión del domingo
Media hora que te deja el lunes con dos piezas listas. Lo pegas después de leer lo que dejó la corrida.
Corre la sesión de conexiones semanal sobre todas las capturas de los últimos 7 días. Cuando termines de generarlas: 1. Quédate con las dos más fuertes, medidas por una sola cosa: cuál me sorprendería más a mí, que fui quien escribió las notas. 2. De cada una, genera el brief completo y guárdalo en 03-BRIEFS. 3. Devuélveme la ruta de los dos briefs, cuál crees que pega más con mi audiencia y por qué. 4. Si algo se está repitiendo en las capturas de las últimas semanas y todavía no tiene nombre, ponle uno y dime si merece entrar al CLAUDE.md como pilar nuevo. No inventes un patrón que no está. Prefiero que me digas que la semana salió floja.
Mensual · una hora, el primer fin de semana del mes
Es el bloque que convierte el sistema en algo que aprende de tu audiencia y no nada más de ti. También es el que casi nadie hace.
- Los primeros 15, pegas los números reales en las notas de 04-PUBLISHED: impresiones, guardados, el comentario que más se repitió. Esta parte sigue siendo a mano salvo que tengas un conector que llegue hasta esa plataforma, y el análisis va a valer exactamente lo que valgan estos números.
- Del 15 al 45, pides el análisis del mes contra ese material y nada más contra ese material.
- Los últimos 15, decides qué se repite el mes que entra y qué se deja de hacer. Dos decisiones, escritas donde el agente las vuelva a leer.
La capa que trabaja: la memoria. Lo que sale de esta hora no sirve de nada si se queda dentro de la respuesta de una sesión: se escribe en el CLAUDE.md o en la memoria del subagente que escribe. Una conclusión que no se guardó, no pasó.
Lo que ya no haces tú: cruzar de memoria lo que publicaste contra lo que funcionó, ni llevar la cuenta en la cabeza. El archivo de publicados la lleva por ti; tú solo tienes que alimentarlo con los números y leer lo que sale.
La revisión mensual
La hora que hace que el sistema aprenda. Va después de pegar los números, nunca antes.
Lee todo lo que hay en 04-PUBLISHED. Cada nota trae sus números en el frontmatter. Basándote SOLO en ese material, dime: 1. Qué temas dieron más guardados por impresión. Por proporción, no por totales. 2. Qué entradas superaron el promedio de su propio tema. Cítalas textuales; no me digas "las agresivas". 3. Tres ángulos que mis mejores piezas sugieren y que todavía no he probado. 4. Qué combinación de tema y formato debería repetir este mes. Reglas: nada de consejo genérico. Si una conclusión necesita más material para ser confiable, márcala así en vez de redondearla. Y si este mes tiene muy pocas piezas para concluir algo, dímelo en la primera línea y ahí párate.
Lo que se te quitó de encima
| Del ritual viejo | Quién lo hace ahora |
|---|---|
| Procesar el inbox | La tarea programada, temprano por la mañana. El archivista afila cada captura, le pone sus etiquetas y la archiva donde va; tú lees el reporte que dejó en .claude/ultima-corrida.md. |
| Acordarte de procesarlo | El latido. La corrida pasa a su hora aunque se te haya olvidado, y el reflejo de arranque te enseña el conteo apenas abres la sesión. |
| Respaldar el vault | El reflejo de cierre: al terminar la sesión hace commit y empuja al remoto, que es lo que deja el vault donde una rutina de nube puede clonarlo. Y si el latido corre en la nube, esa corrida deja su propio commit en una rama. En los dos casos, nadie tiene que acordarse. |
| Buscar las conexiones | El tejedor, en su propia ventana de contexto y con su propia memoria. Lee siete días de una sentada, que es algo que tú un domingo a las nueve de la noche no vas a hacer. |
| Decidir qué se escribe | Tú. Es la única fila de la tabla que sigue siendo tuya, y es la única que no conviene delegar. |
el punto de la tabla
Los veinte minutos no se acortaron: cambiaron de dueño
Un sistema que te ahorra tiempo y un sistema que te sube el nivel del tiempo no son la misma cosa. Éste es el segundo.
Si el ritual bajara a ocho minutos, lo que se estaría delegando ya sería el criterio, y ahí es donde el vault se vuelve un archivero bonito lleno de notas que nadie eligió. Las capas se comieron el trabajo de mudanza para que los veinte minutos completos se te vayan en mirar, descartar y elegir.
El día que te encuentres aprobando lo que sea que te proponga, sin descartar nada, el sistema dejó de funcionar aunque siga corriendo.
Si hoy es tu día uno
arranque mínimo
El día uno no son catorce paradas, son tres cosas
Todo lo de arriba supone las cinco capas puestas, y eso no hace falta para empezar. El primer día solo necesitas tres piezas:
- Una carpeta con la estructura por tipo, aunque esté vacía.
- Un CLAUDE.md en la raíz de esa carpeta, escrito con tus nombres reales y no con ejemplos. En la raíz: ése es justo el detalle que la versión vieja de esta guía tenía mal.
- Una skill que procese el inbox, aunque por ahora la dispares tú a mano.
Capturas cinco notas en crudo, corres la skill, le pides una conexión. Eso ya es el ritual y ya es JARVIS funcionando. El latido, el equipo y los sentidos se montan encima cuando el ritual se sostiene solo: agregarlos antes es automatizar un hábito que todavía no existe.
JARVIS no es la app. Es la práctica que compone con el tiempo, y compone de una forma bastante aburrida: al principio no se nota nada.
El cambio no llega el día que terminas de instalar las capas. Llega el día que abres el vault buscando una cosa y te topas con dos notas tuyas de hace tres meses que se contestan entre ellas. Ahí no hubo creatividad: hubo memoria bien ordenada. Buena parte de lo que llamamos creatividad es memoria con buen orden de búsqueda, y eso es exactamente lo que construye este ritual.
Sostén el ritmo un trimestre y aparece un problema nuevo, que además es de los buenos: el vault empieza a saber cosas que tú nunca le dijiste a Claude. Cómo decides, qué descartas siempre, con qué palabras abres. Eso está en tus notas y en ninguna configuración. La parada que sigue es la de cobrarlo.
el paso que nadie documenta
Tus notas se vuelven tus skills
A los noventa días pasa algo raro: el vault funciona y el agente sigue igual de listo que el primer día. Hace lo mismo, con las mismas cuatro skills y con el CLAUDE.md que escribiste antes de saber cómo ibas a trabajar de verdad.
Tus notas, mientras tanto, sí aprendieron. No en sentido figurado: ahí está escrito cómo decides. Qué capturaste y qué dejaste pasar. Qué conexión te pareció buena y cuál descartaste sin dar explicaciones. Qué entrada aguantó y cuál murió. Qué palabras usas cuando escribes sin pensar. Nada de eso está en ninguna de las cinco capas.
Cosechar es cobrarlo. Le pides al agente que lea tu propio archivo, encuentre lo que repites y lo escriba como instrucción. Es la única parte de este sistema donde el material no lo pones tú en el momento: ya lo pusiste, hace tres meses, sin darte cuenta de que lo estabas escribiendo.
está en tus notas
Lo que el vault ya sabe de ti
- Qué merece anotarse. Noventa días de INBOX son noventa días de decisiones sobre qué capturaste y qué dejaste ir.
- Qué conexión te pareció buena. Las que llegaron a 02-CONNECTIONS y, sobre todo, las que se quedaron ahí sin volverse brief.
- Qué entrada funcionó. Está en 04-PUBLISHED, pegado a las métricas, pieza por pieza, sin depender de lo que te acuerdes.
- Qué palabras usas de verdad. No las que crees usar: las que aparecen en lo que ya publicaste, con su frecuencia.
- Qué le corriges al escriba. Cada borrador que editaste antes de publicar dejó el antes y el después uno al lado del otro.
está en el agente
Lo que las cinco capas saben hoy
- Lo que le dijiste en el CLAUDE.md el día que lo escribiste, que fue el día en que menos sabías de tu propio sistema.
- Lo que la memoria automática dedujo de las sesiones, que es lo que Claude hizo, no lo que tú pensaste.
- Las cuatro skills, con el procedimiento que imaginaste antes de correrlo cien veces.
- Las notas que alcanzó a leer en esa sesión, si es que se las pediste explícitamente.
Cosechar es mover una fila de la columna de la izquierda a la de la derecha. No es escribir mejores instrucciones de la nada: es leer las que ya escribiste sin querer.
Tres cosechas, en el orden en que conviene hacerlas
De 04-PUBLISHED a tu voz
La primera y la que más se nota. Tu carpeta de publicados es un corpus de tu escritura real, con métricas al lado para saber cuál sirvió. Nadie describe bien su propia voz de memoria: describes la que te gustaría tener. Los archivos no tienen ese problema.
La salida es una sección de ocho a doce patrones concretos que se pega en el CLAUDE.md de la raíz. Si te sale larga y ese archivo ya está apretado, guárdala como un archivo de .claude/rules/ con un frontmatter paths: que apunte a tus borradores: así carga solo cuando el escriba está escribiendo, y no en cada sesión.
Destila mi huella de voz desde lo que ya publiqué
Córrelo dentro del vault. Pídele que te lo enseñe en pantalla antes de escribir nada: la mitad del valor está en discutir los patrones que sacó.
Lee todo lo que hay en 04-PUBLISHED/ y quédate con las diez piezas que mejor funcionaron según las métricas del frontmatter. Tu trabajo es destilar cómo escribo YO, no cómo se escribe bien. 1. Léelas una por una y anota patrones reales: cómo abro, cómo cierro, largo promedio de oración, signos que evito, palabras que repito, cómo meto un número, cómo hago una transición. 2. Nada de juicios tipo "tu tono es directo". Quiero patrones que se puedan seguir sin adivinar: "abres con una afirmación contraintuitiva de seis a nueve palabras y la contradices en la línea siguiente". 3. Escribe una sección llamada "Huella de voz" con ocho a doce patrones concretos, redactados como instrucciones para ti, no como descripción para mí. 4. Lista cinco muletillas mías: palabras o construcciones que aparezcan en más de tres piezas. 5. Lista cinco cosas que nunca hago, deducidas de lo que está ausente en las diez. 6. Aparte, marca los patrones que solo viste en una o dos piezas. Ésos todavía no son mi voz: son casualidad, y no quiero que se vuelvan regla. Al final escribe dos párrafos de prueba sobre [UN TEMA CUALQUIERA] aplicando la huella. Si suenan a mí, quedó. Si suenan genéricos, dime qué patrón te faltó. Enséñame todo en pantalla antes de escribir en ningún archivo.
De 02-CONNECTIONS a una skill nueva
Si llevas tres meses conectando notas, no estás haciendo cualquier cosa: estás repitiendo dos o tres movimientos mentales sin haberles puesto nombre. Un movimiento que repites y que sale parecido cada vez ya es un procedimiento, y un procedimiento escrito es una skill.
El prompt hace las dos mitades del trabajo: encuentra el patrón leyendo tus conexiones y redacta el archivo. Guárdalo en .claude/skills/ dentro del repositorio del vault, no en tu carpeta personal: es lo que hace que la skill exista también cuando el agente corre en la nube con tu computadora cerrada.
Encuentra el análisis que repito y escríbelo como skill
La descripción que redacte es lo único que Claude lee al arrancar para decidir si usa la skill, así que revísala tú: tiene que decir el momento en que quieres que se dispare.
Lee todas las notas de 02-CONNECTIONS/ y también las conexiones que quedaron ahí sin volverse brief. 1. Agrúpalas por el TIPO de movimiento que hice, no por tema. Un tipo se ve así: "tomé un número de un dominio y lo comparé con su equivalente en otro" o "encontré la contradicción entre lo que alguien dice y lo que hace". 2. Dime cuáles tres movimientos repetí más veces, con la cuenta y con dos ejemplos de cada uno. 3. Del que más repetí, reconstruye el procedimiento paso por paso: con qué empiezo, qué comparo, qué descarto, y cómo se nota que la conexión sirve. 4. Después dime qué conexiones se quedaron a medias y qué tenían en común. Ese es mi filtro de calidad, y va dentro del procedimiento: sin él la skill produce ruido. 5. Con eso escribe una skill nueva en .claude/skills/ del repositorio de este vault. La descripción tiene que decir en qué momento quiero que se use, con las palabras que yo usaría al pedirlo. El cuerpo lleva el procedimiento y el filtro. 6. Enséñame el nombre, la descripción y los pasos antes de crear el archivo.
De tus correcciones a las reglas duras
Cada vez que editaste un borrador antes de publicarlo dejaste una preferencia tuya escrita, con su antes y su después. Nadie las lee nunca. Están repartidas entre el archivo -borrador.md que dejó el escriba y la versión que quedó en 04-PUBLISHED, y la diferencia entre los dos es literalmente tu criterio.
Las que aparecen en tres o más piezas son reglas y van al CLAUDE.md. Las que dependen del formato van a un archivo de reglas con paths:, para que carguen solo ahí. Y si alguna tiene que cumplirse pase lo que pase, esa ya no es una regla: es un reflejo, y se resuelve con un hook en la parada de los reflejos.
Convierte mis correcciones en reglas que el escriba pueda seguir
Es la cosecha más incómoda de leer y la que más cambia el borrador siguiente. Necesita que hayas publicado al menos seis o siete piezas con su borrador guardado al lado.
Compara cada borrador de 03-BRIEFS/ que termina en -borrador.md con la versión que quedó publicada en 04-PUBLISHED/. 1. Para cada par, lista los cambios que hice yo. Cambios de contenido y de redacción; ignora los de formato. 2. Agrupa los cambios que se repiten en tres o más piezas. Ésas son mis correcciones de verdad, no accidentes. 3. Traduce cada grupo a una regla en imperativo, escrita para ti: qué hacer o qué no hacer, con un ejemplo del antes y el después sacado de mis propias piezas. 4. Separa las reglas en dos listas: las que aplican siempre, y las que solo aplican para un formato o una plataforma en particular. 5. Dime también qué corregí una sola vez. Eso todavía no es regla: márcalo como pendiente de confirmar y no lo mezcles con lo demás. 6. Enséñame las dos listas antes de escribir nada. Yo te digo cuál va al CLAUDE.md y cuál a un archivo de reglas.
Los tres prompts entregan el archivo escrito, pero no te enseñan el oficio: cómo se redacta una descripción que dispare en el momento correcto, qué va en el cuerpo, qué sobra y cuándo conviene que la skill sea personal o del proyecto está en el creador de habilidades. Lo único que agrega la cosecha es de dónde sale el contenido: de tu archivo, no de tu memoria.
La diferencia se ve a simple vista
escrita el día uno
Escribe en mi voz: directa, sin relleno, con ejemplos reales. No uses lenguaje que suene a inteligencia artificial.
cosechada a los noventa días
Nunca abras con pregunta retórica: apareció en seis borradores y en los seis la borré y dejé la afirmación de abajo. Toda afirmación de resultado va con su número; si el número no existe, la afirmación se cae. Las oraciones de más de veinticinco palabras las partí en dos en todas las piezas publicadas.
Las dos quieren decir lo mismo. Solo una se puede seguir sin adivinar, y esa no la escribiste tú: salió de comparar tus borradores con lo que de verdad publicaste.
la regla de la cosecha
Se cosecha tarde, y es a propósito
La tentación es hacer todo esto el día uno: sentarte a escribir tu huella de voz y tus reglas duras antes de haber publicado nada. Falla, y falla caro. Sale una skill que describe un procedimiento que todavía no funciona, y como está escrita en un archivo se ve igual de seria que una que sí.
Una skill que sirve sale de trabajo que ya hiciste a mano suficientes veces como para saber dónde se atora. Si no lo hiciste a mano, no estás cosechando: estás inventando un método y poniéndolo en un archivo que el agente va a obedecer. Tres señales de que ya está listo:
- Lo hiciste a mano varias veces y todas salieron parecido. Cosechar del archivo pide más material que convertir en skill un prompt que ya repites: aquí el patrón tiene que aguantar entre piezas distintas, no solo repetirse igual.
- Puedes decir en qué paso te equivocas casi siempre. Si no sabes dónde falla, todavía no lo entiendes lo suficiente para escribirlo.
- Ya tienes ejemplos de las dos caras: los que salieron bien y los que descartaste. El filtro es la mitad del procedimiento y solo se aprende descartando.
Y al revés: si llevas tres meses haciendo algo idéntico a mano y no lo has cosechado, ése es exactamente el trabajo que le toca al agente. En la práctica, una vez por trimestre alcanza. Cosechar cada mes es reescribir reglas sobre diez piezas nuevas, que es demasiado poco material para cambiar de opinión.
Por qué esto mejora en vez de degradarse
el ciclo · una vuelta por trimestre
┌──► 1. trabajas a mano en el vault │ capturas · conexiones · borradores · correcciones │ │ │ ▼ │ 2. cosechas lo que ya se repite │ huella de voz · skill nueva · reglas duras │ │ │ ▼ │ 3. eso entra a la capa 1 y a la capa 2 │ CLAUDE.md · .claude/rules/ · .claude/skills/ │ │ │ ▼ │ 4. el agente hace mejor la parte repetida │ y tú trabajas encima de eso, no debajo │ │ └──────────────┘
Fíjate en la dirección de la flecha. Nada de esto empieza en la capa 1. Empieza en el trabajo: el agente no se vuelve más útil porque te sientes a escribirle mejores instrucciones, sino porque produjiste material del cual se pueden sacar mejores instrucciones.
Por eso un vault de un año con cosecha no se parece a uno de un año sin ella, aunque tengan las mismas notas adentro. Uno acumuló archivos. El otro acumuló procedimiento, y el procedimiento es lo único que se ejecuta solo.
Con esto el sistema queda completo: cinco capas, un ritual que las mueve y una cosecha que las vuelve a escribir con lo que aprendiste haciéndolo. Lo que sigue es la lista de lo que lo tira. Diez errores: cinco de conducta, que se ven venir y de todos modos se cometen, y cinco mecánicos, que no avisan y dejan al agente viéndose funcional mientras no hace nada.
los que lo matan
Diez errores: cinco de conducta, cinco mecánicos
Estos diez son los que matan el sistema, y se parten en dos mitades que no se arreglan igual. Los primeros cinco son de conducta: la máquina hace lo suyo y el que falla eres tú. Los otros cinco son mecánicos: tú haces todo bien y la máquina no ejecuta. Confundirlos cuesta semanas, porque a un problema mecánico le puedes echar disciplina encima todo el mes y no se mueve un milímetro.
Cada ficha abre por el síntoma. Búscate en el índice de abajo, salta a tu ficha, arregla eso. El resto lo lees otro día.
Búscate por el síntoma
cinco de conducta
Está bien montado y aun así no sirve
- «Suena a cualquiera, no a mí» → tu CLAUDE.md está escrito con deseos.
- «Le pido una cosa y corre otra» → dos skills se disparan con las mismas palabras.
- «Tengo doscientas notas y ninguna conexión» → capturas y nunca afilas.
- «Lo monté y no lo he abierto en tres semanas» → te saltaste el ritual.
- «Seis meses después escribe igual que el primer día» → nunca cerraste el ciclo con datos.
cinco mecánicos
Está bien pensado y la máquina no lo ejecuta
- «La rutina corrió y el resultado salió genérico» → tu skill personal no viajó.
- «La tarea arranca a su hora y no pasa nada» → disable-model-invocation.
- «Contesta como si no conociera mi vault» → el CLAUDE.md quedó en una subcarpeta.
- «En mi otra computadora no se acuerda de nada» → la memoria automática es de una sola máquina.
- «Salió verde y el trabajo no está hecho» → verde solo significa que arrancó.
Los cinco de conducta
Ninguno de estos cinco se arregla con una configuración. Todos se arreglan decidiendo una cosa y sosteniéndola.
error 01 · conducta
El CLAUDE.md vago devuelve respuestas vagas
Lo que ves. Lo que escribe está bien y no es tuyo. Correcto, plano, intercambiable con el de cualquier otro.
Por qué. «Escribe corto y directo» no es una instrucción, es un deseo. Y el CLAUDE.md es contexto, no configuración: pide por favor, no obliga. Si tu línea admite dos lecturas, Claude puede tomar cualquiera de las dos.
El arreglo. Cambia cada adjetivo por una regla que se pueda verificar leyendo el resultado: frases de ocho palabras o menos, nada de preguntas retóricas, prohibida la palabra desbloquea. Y mantenlo por debajo de las 200 líneas, la regla de la parada de la memoria. Lo que se pase, sácalo a .claude/rules/ con frontmatter paths para que cargue solo cuando toque esa carpeta.
error 02 · conducta
Dos skills que se disparan con las mismas palabras
Lo que ves. Le pides una cosa y corre otra. O no corre ninguna y te contesta de memoria, como si la skill no existiera.
Por qué. La descripción es el disparador: es lo único que Claude lee para decidir si carga la skill. Si «procesa mi bandeja» y «procesa mis notas» se parecen, el que elige es él. Y hay un tope: la descripción y el when_to_use juntos se cortan a 1.536 caracteres en el listado, así que lo que pusiste al final quizá ni se ve.
El arreglo. Una skill, un caso, sin ambigüedad. El caso de uso principal va en la primera línea de la descripción, con las palabras exactas que tú usas al pedirlo. Si dos se siguen pisando después de reescribirlas, no eran dos skills: fusiónalas.
error 03 · conducta
Capturar sin afilar
Lo que ves. La bandeja tiene doscientas notas crudas y cero conexiones. Buscas algo que sabes que guardaste y no aparece por ningún lado.
Por qué. Capturar es gratis y procesar cuesta. Cuando solo haces la parte gratis, la carpeta deja de ser memoria y se vuelve un cementerio: no la lee nadie, ni tú ni el agente.
El arreglo. Si capturas hoy, procesas hoy. Y si sabes que no vas a procesar, no captures: pon el latido a dejarte el lote agrupado y a recordártelo. Cinco notas conectadas valen más que doscientas en bruto.
error 04 · conducta
Saltarse el ritual
Lo que ves. Montaste las cinco capas, se ve impecable, y llevas tres semanas sin abrirlo.
Por qué. JARVIS no es la app, es la práctica. Las conexiones no salen solas del vault: salen de que alguien pregunte. Sin esa pregunta, lo que tienes es una carpeta muy bien organizada.
El arreglo. Veinte minutos al día, cinco días a la semana, y el mes que viene el sistema empieza a devolverte cosas que tú ya no recordabas. La parada del ritual trae el ritmo completo; lo único que hay que defender es que sea siempre a la misma hora.
error 05 · conducta
No cerrar el ciclo con datos reales
Lo que ves. Medio año después escribe igual de bien que el primer día. Ni mejor ni peor: igual.
Por qué. Sin los números de lo que publicaste, el agente no tiene forma de saber qué funcionó. Le enseñaste a escribir. No le enseñaste a acertar.
El arreglo. Cada pieza publicada vuelve al vault con su resultado al lado, aunque sea una línea. La revisión mensual es lo que convierte tu archivo en criterio, y es el paso que casi nadie hace: es la diferencia entre un sistema que dura seis meses y uno que dura dos años.
Los cinco mecánicos
Estos cinco no dan error. Ésa es la parte cara: el sistema no se queja, simplemente hace algo genérico o no hace nada, y tú lo lees como «no funcionó» y lo apagas.
error 06 · mecánico
Tus skills personales no viajan
Lo que ves. La tarea corrió, el estado salió verde, y lo que dejó es genérico. Como si no conociera tu método.
El arreglo. Toda skill que tu agente necesite cuando tú no estás va adentro del repositorio del vault, en su .claude/skills/, y con el commit hecho: guardada solo en ~/.claude/skills/ no existe para nada que no corra en tu máquina. Si además la quieres en Cowork, súbela a tu cuenta de claude.ai, y revisa antes su frontmatter: la parada de las habilidades tiene los únicos campos que esa subida acepta.
Por qué una sesión que no corre en tu computadora no ve esa carpeta, y qué carga en su lugar, va completo en la parada del latido. Para salir del paso basta con mover las skills al lugar correcto y commitearlas.
error 07 · mecánico
disable-model-invocation también apaga al reloj
Lo que ves. La tarea programada arranca puntual, termina, y no pasó nada. Ningún archivo nuevo, ningún reporte.
Por qué. disable-model-invocation: true significa «esta skill solo se llama a mano, con su barra». Eso también impide que la skill corra cuando una tarea programada la dispara como su prompt: el que la invoca ahí es el modelo, no tú.
El arreglo. Quítale el campo a las skills que el latido tenga que disparar. Déjalo puesto solo en las que de verdad quieres bajo llave, las que nunca deberían activarse sin que tú lo pidas.
error 08 · mecánico
El CLAUDE.md guardado en una subcarpeta
Lo que ves. Contesta como si no conociera tu vault. Le vuelves a explicar las carpetas, otra vez, cada sesión.
El arreglo. El CLAUDE.md del sistema va en la raíz del vault, o en .claude/CLAUDE.md. Nunca dentro de una carpeta numerada. Lo que quieras tener partido por tema va en .claude/rules/ con frontmatter paths, que carga solo cuando Claude toca los archivos que coinciden.
Por qué un archivo guardado en una subcarpeta no entra al inicio de la sesión está en la parada del esqueleto. Aquí lo único que importa es dónde vive el tuyo.
error 09 · mecánico
La memoria automática no cruza máquinas ni entra a los subagentes
Lo que ves. En tu otra computadora contesta como si te acabara de conocer. Y el archivista, cuando le delegas, tampoco se acuerda de nada de lo que trabajaron ayer.
Por qué. Son dos fallas con la misma raíz. La memoria automática vive en una carpeta de tu máquina, y la doc dice textual que esos archivos no se comparten entre máquinas ni con entornos de nube. Y la memoria automática de la conversación principal no entra a los subagentes: la única excepción es un fork, que hereda la conversación del padre.
El arreglo. Lo que tiene que existir en todas partes va en un archivo del repo —el CLAUDE.md, .claude/rules/ o una nota del vault—, nunca en la memoria automática. Y a cada subagente dale su propia carpeta con memory: project, que es la única de las tres que se versiona y viaja con el repositorio.
error 10 · mecánico
Una rutina de nube corre sin pedirte permiso
Lo que ves. Ramas con prefijo claude/ que no pediste, un correo que salió, un evento creado en tu calendario. O lo contrario: diez corridas en verde y cero trabajo hecho.
El arreglo. Quítale a la rutina todos los conectores que no vaya a necesitar, antes de la primera corrida y no después. Arranca con una tarea chica que solo lea y deje un reporte, y abre las primeras corridas a leerlas una por una en vez de fiarte del color. Lo que haga con tu identidad de GitHub y tus conectores aparece como tuyo.
Por qué una rutina de nube se comporta así, y qué significa de verdad el verde, está en la parada del latido, junto con la tabla que decide si esa tarea debía correr en la nube o en tu propia máquina.
Para el 08: comprueba qué se cargó de verdad en esta sesión
/contextSi tu CLAUDE.md no aparece ahí, no está cargado, por muy bien escrito que esté. El comando hermano, /memory, te lista los archivos de instrucciones y el interruptor de la memoria automática.
El manual de operación de las tareas programadas vive en 10 automatizaciones con Claude. Aquí solo va la parte que esa página no cubre: lo que le pasa a un vault cuando el que trabaja es el reloj.
Los cinco de conducta los sabes tú. Los mecánicos se ven en los archivos, y hay un prompt al pie de esta página que descarta los tres que dejan una tarea programada en blanco —las skills que no viajaron, la skill que no se puede disparar y el CLAUDE.md que no se cargó— mirando tu instalación de verdad. Los otros dos, el de la memoria que no cruza máquinas y el de la rutina que corre sin permisos, no se diagnostican con un prompt: se revisan abriendo la corrida y leyendo qué hizo.
Falta el error once, que no es una ficha porque es de orden: montar el latido antes de que el flujo te salga bien a mano. La regla es que una tarea se programa cuando ya la hiciste tú varias veces y el resultado te gustó; el argumento completo está en el orden de montaje de las cinco capas.
Con esto ya sabes qué se rompe, cómo se ve cuando se rompe y por dónde se entra a arreglarlo. Falta la prueba de que el esqueleto no era de contenido: la última parada cambia el dominio entero —ventas, finanzas, estudio— sobre las mismas cinco capas, y cierra con el prompt maestro que te entrevista y lo escribe completo.
hazlo tuyo
El mismo esqueleto, otro dominio
Trece paradas atrás esto arrancó pareciendo un vault de contenido. No lo es. Lo que quedó armado es un agente al que le tocó vivir dentro de una carpeta de notas, con sus cinco capas puestas: memoria, habilidades, equipo, sentidos y latido.
Ninguna de esas cinco capas sabe de qué trata tu trabajo. Cambia lo que hay adentro de cada archivo y tienes otro agente, con la misma estructura y las mismas decisiones de diseño. Esta última parada es esa prueba, y termina con el prompt que lo construye para tu caso.
Esto ya está construido, y no es de contenido
Antes de proponerte nada, mira un agente que ya está publicado en la bóveda y que no tiene una sola nota adentro. Su trabajo es vender: sale a buscar negocios que encajan con lo que ofreces, verifica cuáles siguen vivos, descarta los que no y redacta el primer correo con un dato real de cada uno.
El agente de prospección de Apify · Clientes ilimitados no sabe qué es un brief y nunca abrió Obsidian. Pero si abres su carpeta, adentro están exactamente las mismas cinco piezas, en los mismos lugares.
el mismo esqueleto · dominio de ventas
Cómo se ven las cinco capas cuando el agente vende
- Memoria: un CLAUDE.md en la raíz con qué vendes, a quién buscas, cuánto puede gastar y qué no debe hacer nunca. Lo lee completo antes de cada trabajo.
- Habilidades: un instructivo por oficio —sacar leads, enriquecerlos, escribir correos— que se abre solo cuando toca ese trabajo, en vez de cargar el manual entero cada vez.
- Equipo: tres subagentes. El prospector busca, el verificador descarta y el redactor escribe. Cada uno en su propio contexto, para que el ruido de uno no se le pegue al otro.
- Sentidos: un servidor MCP que alcanza Google Maps y LinkedIn, más una carpeta de memoria con a quién ya le escribiste y quién pidió que no lo molesten.
- Latido: una tarea programada de tu computadora que corre la ronda el día y la hora que le pusiste, y te deja el reporte hecho.
Y con el mismo límite que ya conoces de la parada del latido: esa tarea vive en tu máquina, así que necesita la computadora despierta. Cambia el dominio y cambia el contenido de cada archivo. La estructura de carpetas no, y las decisiones de diseño tampoco: qué carga siempre, qué carga bajo demanda, qué corre aparte y qué corre solo.
Tres agentes que se parecen más de lo que crees
Estos tres no existen todavía: son plantillas para que veas la mecánica. Léelos en vertical y son tres agentes que no tienen nada que ver entre sí. Léelos en horizontal y ninguna fila cambió de trabajo.
| capa | finanzas personales | estudio | operación de una agencia |
|---|---|---|---|
| memoria | Tus categorías de gasto y tus reglas: qué cuenta como fijo, qué es del negocio, de qué no quieres que te pregunte nunca. | Qué estás estudiando, para cuándo, y cómo aprendes: si te sirve más explicarlo con tus palabras o que te interroguen. | Tus clientes uno por uno y las reglas de cada uno: quién quiere el reporte en viñetas, a quién no se le escribe en viernes. |
| habilidades | Clasificar movimientos y cerrar el mes. Dos instructivos, dos momentos distintos, ninguno de los dos cargado cuando no toca. | Resumir un tema, generar preguntas sobre él y calificar tus respuestas contra el material. | Armar el reporte semanal y arrancar un proyecto nuevo con el mismo checklist siempre. |
| equipo | Un revisor que solo lee: busca lo raro y no puede tocar nada, porque le recortaste las herramientas de escritura. | Un examinador que te pregunta sin ver las respuestas que ya diste, para que no te las califique de memoria. | Uno por área: contenido, pauta y reportes. Cada uno con su contexto y con lo que aprendió de ese cliente. |
| sentidos | Los archivos que descargas del banco y dejas caer en una carpeta. Nada se conecta a tu cuenta. | Tus PDFs, tus apuntes y lo que subrayaste, en el disco. | Correo y calendario, por conector, con la frontera de privacidad que revisaste en la parada de los sentidos. |
| latido | Mensual, un par de días después de tu fecha de corte. | Diario, a la hora en la que de verdad te sientas. | Lunes temprano, antes de tu primera junta. |
La memoria siempre es lo que no quieres volver a explicar. Las habilidades siempre son lo que se repite con la misma forma. El equipo siempre es lo que ya no cabe en un solo contexto. Los sentidos siempre son lo que está fuera de la carpeta. Y el latido siempre es lo último. Si tu caso no entra en esas cinco frases, probablemente todavía no está bien acotado.
Lo que no cambia, cambies lo que cambies
El contenido de cada capa es tuyo. Estas cinco reglas no, y son las que se rompen primero cuando alguien adapta el esqueleto a su dominio sin releer las mecánicas.
- El CLAUDE.md va en la raíz del proyecto, nunca en una subcarpeta, y se queda corto.
- Cada habilidad es una carpeta con su SKILL.md adentro, dentro del proyecto. Su descripción tiene que decir cuándo usarla, no qué es, porque es lo único que Claude lee para decidir si la abre. Y si algún día quieres que corra en la nube, tiene que estar committeada en el repositorio: una skill personal de tu máquina no existe allá.
- El equipo se agrega cuando una sola tarea ya te llena el contexto, no antes. Un subagente sin un trabajo con principio y fin es un rodeo caro: le pagas la ventana entera para que te devuelva un párrafo.
- El latido va al final, siempre. Primero corres el trabajo a mano hasta que salga bien varias veces seguidas, y hasta entonces lo programas.
- La cosecha llega a los noventa días, no a las dos semanas. Antes de eso el sistema todavía no sabe nada que tú no le hayas dicho, y no hay skill que sacar de ahí.
Dos de esas reglas se explican en otra parada de esta misma página. Cuánto es «corto» para un CLAUDE.md, de dónde sale esa cifra y qué se hace con lo que no cabe está en la parada de la memoria. Aquí basta con dejarlo en la raíz.
Y por qué programar algo que todavía no sale bien a mano te sale caro está en la parada de la anatomía. Aquí basta con respetar el orden: el latido se prende al último.
El prompt maestro
Este es el entregable de la página. No te da una plantilla: te entrevista, te enseña el diseño de tus cinco capas y espera tu aprobación antes de escribir un solo archivo. Va en una carpeta nueva y vacía, con Claude Code abierto adentro, de preferencia en modo plan.
La parte que da flojera es la que sirve. Si te saltas la entrevista y le pides que construya de una vez, vas a terminar con la estructura de otra persona con tus nombres encima.
Entrevístame y constrúyeme el agente
Pégalo en una carpeta nueva, con Claude Code adentro. Tres fases: entrevista, diseño y construcción. No escribe nada en disco hasta que tú apruebes el diseño.
Vamos a construir un agente personal para mi trabajo. No crees ningún archivo todavía. Primero entrevístame, después enséñame el diseño completo, y solo cuando yo escriba "aprobado" empiezas a escribir en disco. CONTEXTO: un agente personal tiene cinco capas. 1. Memoria — lo que sabe de mí sin que se lo repita. Vive en un CLAUDE.md en la raíz del proyecto. 2. Habilidades — un instructivo por trabajo, que se carga solo cuando toca. Cada uno en su carpeta, en .claude/skills/. 3. Equipo — subagentes con su propio contexto y sus propias herramientas, en .claude/agents/. 4. Sentidos — de dónde saca lo que no está en la carpeta: archivos que yo dejo ahí, conectores, servidores MCP. 5. Latido — lo que lo despierta sin que yo abra nada. ESTA CAPA NO SE MONTA HOY. FASE 1 · ENTREVISTA Hazme estas preguntas de una en una y espera mi respuesta antes de la siguiente. Si te contesto algo vago, repregunta una vez pidiéndome un ejemplo concreto antes de seguir. 1. ¿Qué trabajo repito cada semana y me gustaría dejar de hacer a mano? Descríbemelo como si me estuvieras viendo hacerlo. 2. ¿Qué decisiones tomo dentro de ese trabajo y con qué criterio? Dame dos casos reales: uno donde dije que sí y uno donde dije que no. 3. ¿Qué información consulto para decidir y dónde vive? Archivos, correo, calendario, una hoja de cálculo, o nada más mi cabeza. 4. ¿Cómo se ve un buen resultado y cómo se ve uno malo? Un ejemplo de cada uno. 5. ¿Qué no debe hacer nunca, ni aunque parezca buena idea? Mandar algo sin que yo lo lea, borrar cosas, gastar dinero, tocar ciertos archivos. 6. ¿Cada cuánto pasa esto: diario, semanal, mensual, o cuando llega algo de fuera? 7. ¿Cuánto de todo esto ya está escrito en algún lado que yo te pueda dar hoy mismo? FASE 2 · DISEÑO (todavía sin crear archivos) Devuélveme en una sola respuesta, en español: - Las cinco capas rellenadas para MI caso, una por una, diciendo qué va en cada una y por qué. - Los nombres exactos de las habilidades que propones, entre dos y cuatro, no más, y en qué momento se dispara cada una. - Los subagentes que propones para empezar, cero, uno o dos, qué trabajo cerrado hace cada uno y qué herramientas le recortas. - El árbol de carpetas completo, con el CLAUDE.md en la raíz. - Lo que decidiste dejar fuera y por qué. Esta parte no te la saltes. Después pregúntame si lo apruebo. Si te pido cambios, rehaz el diseño completo, no le pongas un parche. FASE 3 · CONSTRUCCIÓN (solo con mi aprobación explícita) Construye en este orden y enséñame cada archivo antes de pasar al siguiente: 1. El CLAUDE.md en la raíz. Menos de 200 líneas. Quién soy, qué es este proyecto, qué se guarda en cada carpeta, cómo se ve un buen resultado, y las reglas duras que no se rompen. 2. Las carpetas del árbol, cada una con un archivo de una línea que diga qué va ahí adentro. 3. Las habilidades, una por una, cada una en su carpeta con su SKILL.md. La descripción de cada una tiene que decir CUÁNDO usarla, con las palabras que yo usaría, no qué es. 4. Los subagentes, uno por archivo, con la lista de herramientas recortada a lo mínimo que necesitan para su trabajo. 5. Un archivo PRIMERA-SEMANA.md con las cinco cosas que tengo que hacer a mano esta semana para comprobar que el diseño sirve. REGLAS - No montes tareas programadas, no escribas hooks y no configures nada que corra solo. El latido va después, cuando el sistema ya haya funcionado a mano varias veces. Si te lo pido hoy, recuérdame esta línea. - No inventes datos míos. Si te falta uno, deja el hueco marcado y dime cuál es. - Nada de código. Todo lo que escribas es markdown y prosa en español. - Si el diseño te pide más de cuatro habilidades, es señal de que el trabajo no está bien acotado. Dímelo en vez de crecer.
Lo que te devuelve la fase 2 vale por sí solo, aunque nunca construyas nada. Es tu trabajo descrito por capas, con la lista de lo que quedó fuera. La mayoría de la gente nunca ha visto eso escrito.
Esto compone porque cada capa le baja el costo a la siguiente, y en ese orden: memoria, habilidades, equipo, sentidos, latido. Por eso el orden importa, y por eso el latido es lo último que se prende.
Guía de la comunidad
Esta guía es parte de la bóveda abierta de tododeia.
para cerrar · los dos prompts que trabajan sobre todo lo demás
Los prompts de las catorce paradas construyen: cada uno levanta una capa, escribe un archivo o deja una rutina puesta. Estos dos no construyen nada — revisan, y trabajan sobre el sistema entero en vez de sobre una capa. El primero es la auditoría de salida: apuntas Claude Code a la carpeta que ya montaste y te dice qué quedó a medias, con las preguntas que solo tienen sentido cuando la cosa ya existe. El segundo es para el día que la tarea programada corra, salga en verde y no haya hecho nada: recorre las cinco causas mecánicas en orden y te dice cuál es la tuya.
Quedó bien montado, o quedó a medias
La auditoría de salida. La parada de la anatomía tiene un diagnóstico para antes de construir; éste es el de después, y pregunta lo que solo tiene sentido cuando la cosa ya existe: si las skills están committeadas o nada más guardadas, si los hooks de verdad disparan, si la memoria creció sin podarse. Ábrelo en Claude Code parado en tu vault.
Esta carpeta ya es un agente montado. No lo rediseñes: audítalo. Revisa exactamente estas siete cosas y dime cuáles pasan y cuáles no. 1. ¿El CLAUDE.md está en la raíz de esta carpeta, o en una subcarpeta? Si está en una subcarpeta, no se carga al inicio de la sesión. 2. ¿Cuántas líneas tiene el CLAUDE.md? Si pasa de 200, dime qué tres bloques quitarías primero: empieza por lo que puedas deducir leyendo los archivos. 3. ¿Las skills están committeadas o solo guardadas en disco? Corre git status y dímelo. Una skill sin commitear no existe para nada que corra en la nube. 4. ¿Cada skill tiene frontmatter con una description que alcance para elegirla sin abrir el cuerpo? Nómbrame las que no. 5. ¿Los subagentes tienen el campo memory? ¿Existe ya la carpeta de memoria de cada uno, o está vacía porque nunca corrieron? 6. ¿Los hooks disparan? Míralos en .claude/settings.json y dime cuál de ellos no podría funcionar con los archivos que hay hoy: un script que no existe, una ruta que cambió, un matcher que no coincide con nada. 7. ¿Esta carpeta es un repositorio de git con un remoto configurado? Sin eso, nada de esto puede correr con la computadora apagada. Después dame tres líneas y ya: - Lo que está roto y el lector no lo sabe todavía, porque falla en silencio. - Lo que está bien y no hay que tocar. - La única cosa que arreglaría hoy si solo tuviera diez minutos. No propongas rehacer nada desde cero y no inventes archivos que no existen.
Programé la tarea y no pasó nada
El fallo más caro del sistema, porque no da error: la tarea arranca, sale en verde y no hizo nada. Casi siempre es una de cinco causas mecánicas, y ninguna es obvia. Este prompt las recorre en orden de más común a menos, mirando tus archivos de verdad en vez de adivinar.
Programé una tarea con Claude Code y corrió, pero no hizo lo que le pedí, o no hizo nada. Antes de proponerme nada, descarta estas cinco causas EN ESTE ORDEN, mirando mis archivos de verdad. Dime en cuál se rompe. 1. ¿Dónde corrió la tarea? Si corrió en la nube, no vio los archivos de mi computadora: clonó un repositorio. Revisa si esta carpeta es un repo de git con un remoto. Si no lo es, esa es la causa y para aquí. 2. ¿Mis skills viajaron? Una sesión de nube no lee ~/.claude/skills/ de mi máquina. Solo lee las que están committeadas en el .claude/skills/ del repo clonado. Revisa dónde viven las mías y si están committeadas (no solo guardadas en disco). 3. ¿La skill se puede disparar? Si la tarea usa una skill como su prompt y esa skill tiene disable-model-invocation: true en el frontmatter, no corre. Revisa el frontmatter de las skills involucradas. 4. ¿El CLAUDE.md se cargó? Si está en una subcarpeta en vez de en la raíz desde donde arranca la sesión, no se carga al inicio: solo entra si el agente lee archivos de esa subcarpeta. Dime dónde está el mío. 5. ¿Le faltó una herramienta? Si la tarea necesitaba un conector, revisa si el prompt de la tarea da por hecho algo que no le di. Los servidores MCP que agregué con claude mcp add en mi terminal no existen en una tarea de nube. Termina con una sola línea: cuál de las cinco es, y el cambio exacto que tengo que hacer. Si ninguna aplica, dilo claro y dime qué revisarías después en vez de inventar una sexta.
Las fuentes · dónde se verificó cada dato mecánico
Aquí no hay rutas de archivo escritas de memoria ni límites contados por alguien que los oyó. Cada campo de frontmatter, cada carpeta, cada tope de carga y cada comportamiento de las tareas programadas que afirma esta página salió de estas páginas oficiales, leídas completas el 21 de agosto de 2026. Dos datos se dejaron a propósito sin número —la versión del plugin de Obsidian y el tope diario de corridas de rutinas por plan— porque las dos cosas cambian seguido y una cifra vieja aquí valdría menos que un vistazo a tu propia pantalla. Si algo de lo que lees no coincide con lo que ves en tu máquina, créele a la documentación oficial antes que a esta página.
Claude Code · Memoria
La fuente de toda la parada de la memoria y de la corrección de la parada del esqueleto. De aquí salen las rutas de cada CLAUDE.md, el objetivo de menos de 200 líneas, el hecho de que los CLAUDE.md de subcarpetas no se cargan al inicio sino solo cuando Claude lee archivos de ahí, la carpeta de la memoria automática y su límite de 200 líneas o 25 KB, que viene prendida por defecto, que es de una sola máquina, que no entra a los subagentes, y el frontmatter paths: de las reglas.
Claude Code · Skills
La fuente de la parada de las habilidades. De aquí salen las tres rutas donde puede vivir una skill, la tabla completa de frontmatter, el tope de 1.536 caracteres de la descripción en el listado, y las dos trampas que sostienen media página: que ni las sesiones de Cowork ni las de nube leen las skills de tu máquina, y que solo las de nube clonan el repositorio y además cargan las que estén committeadas en su .claude/skills/; más el detalle de que disable-model-invocation también impide que la skill corra cuando una tarea programada la dispara.
Claude Code · Subagentes
La fuente de la parada del equipo. De aquí salen la carpeta .claude/agents/, la tabla de campos del frontmatter con cuáles son obligatorios, los tres alcances del campo memory con sus rutas exactas, y el dato de que cada subagente trae su propia ventana de contexto y solo le devuelve al padre el mensaje final.
Claude Code · Hooks
La fuente de la parada de los reflejos. De aquí salen los nombres de los eventos, la forma del JSON, los seis lugares donde se puede configurar un hook incluido el frontmatter de una skill y el de un subagente, que la salida 2 bloquea la herramienta en PreToolUse, y el detalle que vuelve a los hooks la capa más confiable de las cinco: se saltan la compactación por completo.
Claude Code · Rutinas
La fuente de la mitad más importante de la parada del latido, y la razón por la que esta guía se rehizo entera. De aquí sale que una rutina selecciona repositorios de GitHub y los clona al empezar cada corrida, que corre sin pedir permiso y sin selector de modo de permisos, que se le incluyen todos tus conectores por defecto, que el intervalo mínimo es de una hora, que hay un tope diario de corridas por cuenta, y el aviso de que un estado verde solo significa que la sesión arrancó sin error de infraestructura. La documentación marca la función como vista previa de investigación.
Claude Code · Tareas programadas del escritorio
La otra mitad de la parada del latido. De aquí sale la tabla que compara los tres relojes fila por fila, que una tarea local solo corre con la app abierta y la computadora despierta, que al despertar se recupera exactamente una corrida perdida de los últimos siete días, y el detalle bonito de que cada tarea vive en disco como un SKILL.md con frontmatter, más la herramienta que le permite cambiar su propio horario mientras corre.
Obsidian · Local REST API with MCP
El plugin del que habla la parada de los sentidos. De su documentación sale la dirección del servidor MCP que levanta dentro de Obsidian y que la autenticación va con el token en el encabezado Authorization. Aquí no se fija número de versión a propósito: hubo una vulnerabilidad de path traversal parchada en la línea 4.1.x, así que lo correcto es instalar la última desde la tienda de plugins en vez de copiar una versión de una página que envejece.
thedotmack · claude-mem
El Camino C de la parada de los tres caminos, en un párrafo. De aquí sale el comando de instalación y qué guarda: sesiones, observaciones y resúmenes en SQLite, más vectores para buscar por significado. Esta página no lo explica por dentro a propósito — esa guía ya existe en la bóveda y se enlaza en su lugar.
Sigue por aquí
Tu segundo cerebro sin base de datos · el Camino A, completo
Aquí te dijimos que Obsidian es opcional y que una carpeta de markdown alcanza. Ese camino tiene su propia guía y es de ella: el CLAUDE.md de la raíz como mapa, las carpetas anidadas con sus propias reglas, y el argumento de por qué la mayoría no necesita ni plugins ni vectores. Si el Camino A fue el que elegiste, sigue allá.
10 automatizaciones con Claude · cómo se opera una tarea programada
La parada del latido explica qué le pasa a un vault cuando la tarea corre, y a propósito no explica cómo se crea ni cómo se opera una. Eso vive allá completo: la regla de la carpeta, los tres modos de aprobación, los topes por plan, qué puede de verdad cada conector, y diez tareas concretas ya escritas. Es la guía que hace falta el día que quieras agendar algo que no sea tu vault.
Claude Anatomy · qué pieza construir antes del primer archivo
Esta página arma una cosa sola con las cinco capas puestas. Allá está la decisión anterior: frente a un problema cualquiera, si lo que necesitas es una skill, un subagente, un comando, un hook, un MCP o una rutina. Si al llegar a la parada de hazlo tuyo quieres construir un agente distinto y no sabes por dónde empezar, empieza por ahí.
Verificado el 21 de agosto de 2026, y estas piezas se mueven rápido
Estas piezas se mueven rápido. Lo que leíste aquí se verificó contra la documentación oficial de Claude Code el 21 de agosto de 2026, y las rutinas siguen marcadas como vista previa de investigación, así que sus límites y su superficie pueden cambiar. Dos datos se dejaron a propósito sin número —la versión del plugin de Obsidian y el tope diario de corridas por plan— porque una cifra vieja aquí vale menos que un vistazo a tu propia pantalla. Si algo ya no coincide con lo que ves en la tuya, créele a tu pantalla y avísanos. Guía de la comunidad, sin afiliación con Anthropic ni con Obsidian.