Tu JARVIS en Obsidian

Obsidian es el editor markdown más serio que existe — vault local, archivos en disco, plugins potentes. Claude Code es el agente de coding más serio que existe — corre local, mantiene contexto largo, ejecuta tools. La combinación de los dos arma un segundo cerebro que piensa contigo: vos escribís ideas crudas, Claude las procesa, conecta, te recuerda y te ayuda a publicar.

Esta nota documenta el setup completo: 5 prerequisitos, arquitectura del vault, los 4 plugins indispensables, las 4 skills que conectan todo, y el ritual diario que mantiene el sistema vivo.

Por qué Obsidian y no Notion

Tres razones técnicas, no estéticas:

1. Archivos markdown reales en tu disco. Cada nota es un .md que abre cualquier editor. Si Obsidian desaparece mañana, tus notas siguen funcionando.
2. Claude Code los lee nativo. No hay traducción, no hay API. Claude abre el archivo, lo edita, lo guarda. Mismo flujo que cualquier archivo de código.
3. Plugins open source. El ecosistema de Obsidian tiene los plugins que necesitás (Templater, Dataview) sin lock-in.

Notion tiene UI más linda. Para segundo cerebro que se integre con Claude Code, Obsidian gana por mucho.

5 prerequisitos

Antes de arrancar, asegurate de tener:

1. Obsidian instalado (gratis, obsidian.md).
2. Claude Code instalado y logueado con tu suscripción Pro/Max.
3. Un vault dedicado para esto (no mezclar con notas viejas hasta migrar a la estructura).
4. Git instalado y configurado (para versionar el vault).
5. Una repo privada en GitHub/GitLab para backupear el vault.

El 4 y 5 son negociables si no querés backup remoto, pero te lo voy a recomendar igual.

Arquitectura del vault

La estructura no es opinión — es ingeniería. Cada carpeta tiene un propósito y un ciclo de vida.

/00-INBOX          ← captura cruda, sin procesar
/01-CAPTURES       ← capturas web/voz/imagen procesadas
/02-CONNECTIONS    ← notas conectadas con links bidireccionales
/03-BRIEFS         ← outputs estructurados (artículos, propuestas)
/04-PUBLISHED      ← archivos publicados en algún lado
/05-CLAUDE         ← memoria persistente y reglas para Claude

00-INBOX: la entrada

Acá cae todo lo crudo. Una idea suelta a las 3am. Una imagen del whiteboard. Un voice note transcrito. Sin orden, sin tags, sin pensar.

Regla: se vacía cada 7 días. Lo que sigue acá después de una semana, se borra. Esto fuerza a procesar.

01-CAPTURES: capturas procesadas

Lo de INBOX pero ya pasado por un primer filtro: tiene título descriptivo, 2-3 tags, una línea de contexto. Sigue siendo borrador, pero ya recuperable.

02-CONNECTIONS: el grafo real

Acá vive el conocimiento. Cada nota acá tiene:

• Links bidireccionales a otras notas ([[nombre-nota]]).
• Tags consistentes (#concepto, #proyecto, #persona).
• Contenido estructurado (encabezados, listas, no párrafos sueltos).

Esta es la capa que Claude usa más. Cuando le preguntás "qué sé de X", lee esta carpeta primero.

03-BRIEFS: outputs estructurados

Cuando vas a escribir un artículo, una propuesta, un script: arrancás un brief acá. El brief combina notas de CONNECTIONS y se cocina hasta volverse el output final.

04-PUBLISHED: archivo

Lo que ya publicaste (post en blog, video, charla, propuesta enviada). No se edita. Es histórico.

05-CLAUDE: el cerebro de Claude

Acá viven:

• CLAUDE.md con las reglas del vault.
• voice.md con tu tono de marca (entrenado en tus textos publicados).
• templates/ con plantillas que Claude usa.
• memory/ con memorias persistentes (decisiones, contexto del usuario).

4 plugins indispensables

Templater

Plantillas dinámicas. Cuando creás una nota nueva, Templater corre código JS que la rellena con metadata (fecha, autor, plantilla según folder, etc).

Configurá una plantilla por carpeta:

• INBOX: fecha + título vacío.
• CAPTURES: fecha + tags placeholder + fuente.
• CONNECTIONS: fecha + tags + 3 secciones (qué, por qué, links).
• BRIEFS: estructura completa de artículo.

Dataview

Queries sobre tu vault. Tratás el vault como base de datos.

Ejemplos:

LIST FROM "02-CONNECTIONS" 
WHERE contains(tags, "#decision") 
SORT file.mtime DESC
LIMIT 10

Eso te lista las últimas 10 decisiones registradas. Dataview es lo que convierte Obsidian de "carpeta de archivos" a "knowledge base navegable".

QuickAdd

Captura ultra rápida. Hotkey global del sistema (configurable) que abre un input para tirar texto al INBOX sin abrir Obsidian. La fricción más baja posible para capturar.

Obsidian Git

Backup automático. Cada N minutos, hace git add . && git commit && git push. Tu vault está versionado en remoto sin que pienses.

Setup:

• Repo privada en GitHub.
• Token de acceso con permisos solo a esa repo.
• Auto-commit cada 15 minutos, auto-push cada 60 minutos.

4 skills que conectan Claude al vault

Skill 1: vault-inbox-processor

Procesa el INBOX. Toma cada archivo crudo, le agrega título, tags, contexto, y lo mueve a CAPTURES. Si la captura amerita conexión con notas existentes, sugiere links a CONNECTIONS.

npx skills@latest add agora/vault-inbox-processor

Uso:

> /procesar-inbox

Claude lee los archivos en 00-INBOX, te muestra plan para cada uno, ejecuta lo que aprobás.

Skill 2: vault-connector

Cuando agregás una nota a CONNECTIONS, Claude busca en el resto del vault qué otras notas se relacionan y propone los links bidireccionales.

npx skills@latest add agora/vault-connector

Skill 3: vault-brief-builder

Convierte notas dispersas en BRIEFS estructurados. Le decís "armame un brief sobre X usando lo que tengo en CONNECTIONS sobre X" y arma el outline + secciones + links a fuentes.

npx skills@latest add agora/vault-brief-builder

Skill 4: voice-training

Lee 04-PUBLISHED y destila tu voice (tono, estructuras de frase, vocabulario). Lo guarda en 05-CLAUDE/voice.md. Cuando le pedís a Claude que escriba, este archivo se carga automático y emula tu voz.

npx skills@latest add agora/voice-training

Ritual diario

El sistema solo funciona si vivís dentro de él. El ritual mínimo:

A la mañana (5 min):

• Abrís Obsidian.
• /procesar-inbox — limpia las capturas de ayer.
• Revisás 02-CONNECTIONS con una búsqueda por tag relevante al día.

Durante el día:

• Cada idea/insight/captura → QuickAdd al INBOX. Sin pensar dónde va.
• Cada artículo/podcast/video que consumís → CAPTURES con highlights.

A la noche (5-10 min):

• /procesar-inbox otra vez si quedó algo.
• Si trabajaste en un BRIEF, commit manual con mensaje descriptivo.

Semanal (1 hora, los domingos):

• Pasada por CONNECTIONS — qué tengo, qué falta, qué se contradice.
• Voice training si publicaste algo nuevo en la semana.
• Backup manual chequeado en GitHub.

Por qué funciona local + suscripción

Una de las ventajas no obvias: como Claude Code corre con tu suscripción Pro/Max ($20-200/mes), no hay costos por uso del vault. Procesás INBOX 10 veces al día, le pedís 5 briefs, hacés voice training semanal — todo entra en la suscripción.

Comparado con APIs por token, este uso te costaría $300-600/mes solo. La suscripción es 5-10x más barata para este patrón.

Errores típicos al adoptar

1. Querer migrar todo de una. Mala idea. Arrancá con vault vacío y dejá que crezca. Las notas viejas de Evernote/Notion las migrás cuando las necesitás, no antes.

2. Sobre-taggear. No pongas 8 tags por nota. 2-3 max. Si tenés 200 tags distintos, el sistema de tags se vuelve inservible.

3. No vaciar INBOX. Si INBOX tiene más de 30 archivos, el ritual se rompe. Es señal de que no estás procesando seguido. Volvé al ritual de 5 minutos.

4. Skill global vs proyecto. Las 4 skills del vault tienen que estar en <vault>/.claude/skills/, no en global. Si las ponés global se cargan en proyectos que no son el vault y dan errores.

Lo que no resuelve

Obsidian + Claude no reemplaza:

• Tu base de datos transaccional. Si manejás clientes activos, usá CRM.
• Tu sistema de tareas con notificaciones. Obsidian no te pingea mañana a las 10am.
• Búsqueda full-text masiva sobre miles de archivos. A partir de ~5.000 notas, las queries de Dataview se ponen lentas.

Para los tres anteriores, integrá con otras herramientas (Linear/Notion para tareas, Pinecone si pasás los 5k de notas).

Conclusión

El segundo cerebro no es producto que comprás — es sistema que construís. Obsidian aporta los archivos, Claude Code aporta el procesamiento, los 4 plugins aportan la mecánica, las 4 skills aportan la inteligencia, el ritual diario lo mantiene vivo.

El primer mes va a ser lento — vas a tener pocas notas en CONNECTIONS y los briefs van a ser pobres. A partir del segundo mes el sistema empieza a "saber cosas". A los 6 meses tenés un segundo cerebro real que te ayuda a pensar mejor.

Tags: jarvis-obsidian, obsidian, claude-code, second-brain, vault, skills, claude-md, voice-training