El Sistema Brain: convierte Claude Code + Obsidian en tu segundo cerebro

El problema que resuelve

Seguramente ya trabajas con Claude Code en una carpeta donde lo mezclas todo: distintos proyectos, clientes, pruebas, ideas sueltas. Funciona, pero tiene tres problemas graves:

1. Claude no "recuerda" entre sesiones. Cada vez que le preguntas algo, redescubre la respuesta desde cero. Todo lo que aprendéis en una conversación se pierde al cerrarla.
2. Los datos de tus proyectos están mezclados. La información de un cliente puede contaminar una respuesta sobre otro. Sin aislamiento.
3. No hay acumulación de conocimiento. Cada decisión, cada insight, cada pregunta bien respondida queda enterrada en un chat que nunca vas a releer.

La solución: el patrón "LLM Wiki" de Andrej Karpathy

Andrej Karpathy (ex-director de IA en Tesla, cofundador de OpenAI) publicó en abril de 2026 un sistema para resolver exactamente esto. La idea es simple pero poderosa:

Tú le das fuentes (CSVs, capturas, notas). Claude las compila en artículos de wiki enlazados entre sí. Después, cuando le preguntas algo, consulta esa wiki en vez de reinventar la respuesta. Y si la respuesta es valiosa, la archiva de vuelta en el wiki. Así cada pregunta enriquece el sistema. El resultado es un "segundo cerebro" que conoce tus proyectos a un nivel que tú, conscientemente, no recuerdas.

Esto es lo más importante para que todo lo demás encaje. Piensa en cada brain como una biblioteca especializada:

Reglas que no se rompen nunca

• Tú nunca entras a la sala pública a escribir fichas. Eso lo hace Claude. El wiki/ es su territorio.
• Claude nunca baja al sótano a tocar los originales. El raw/ es sagrado e inmutable.
• El manual dice cómo trabajar. Si una regla falla, se edita el manual (no se ignora).
• El diario del bibliotecario es append-only. Cada cosa importante queda registrada y nunca se borra.

No hay un único "cerebro general" gigante. Hay una biblioteca por cada dominio. Todas viven dentro de una carpeta madre, por ejemplo ~/brain/:

Hay dos tipos de brain, con reglas distintas:

📊 Brains de datos

Contienen información concreta y confidencial de un cliente o proyecto. Están aislados entre sí: los datos de un cliente jamás se mezclan con los de otro, aunque una pregunta lo sugiera.

📚 Brains de referencia

Contienen conocimiento generalizable, reutilizable entre proyectos (playbooks, frameworks, definiciones). Sin datos confidenciales. Se pueden leer desde cualquier brain de datos, pero solo se escriben desde su propia sesión. Ejemplo: marketing-brain. En el futuro podrías crear books-brain (resúmenes de libros) o tools-brain (documentación de herramientas).

¿Por qué separados y no uno solo?

1. Aislamiento de datos. La información de un cliente no contamina la de otro.
2. Cada brain tiene sus propias reglas. Cada proyecto es distinto; las instrucciones del bibliotecario cambian según el dominio.
3. Escalabilidad. Proyecto nuevo = carpeta nueva en 1 minuto con plantilla. Proyecto que se va = borras la carpeta y el resto sigue intacto.

Tienes dos formas de abrir Claude Code sobre el sistema, y cada una sirve para cosas distintas.

🎯 Modo foco (el 80% del tiempo)

Se carga el CLAUDE.md de ese cliente. Claude opera solo con los datos de ese brain. No ve los otros. Puede leer marketing-brain/ en modo lectura si se lo pides, pero no escribirlo.

Cuándo usarlo: ingestar datos nuevos, escribir wiki, archivar análisis, preguntas sobre ese proyecto. La inmensa mayoría de tus sesiones.

🌐 Modo global (para cruzar brains)

Se carga el CLAUDE.md raíz. Claude puede leer todos los brains y cruzar información respetando el aislamiento.

Cuándo usarlo: aplicar un framework de marketing-brain a un cliente concreto, comparar patrones entre clientes (manteniéndolos separados), o búsquedas cuando no sabes en qué brain está algo.

Antes de la mecánica interna, hay una decisión previa que tomarás muchas veces al día: ¿esta tarea merece la ceremonia del brain, o la hago suelta y rápida? Ten siempre una carpeta neutral (llámala "Cowork" o como quieras) para lo rápido.

El test de los 5 segundos

Zona gris: empecé rápido pero se volvió estratégico

Copias la conversación relevante a un .md en raw/notes/ del brain, abres una sesión allí y le dices: "Ingesta raw/notes/<archivo>.md y si hay algo archivable, propónmelo." Rescatas el valor sin empezar de cero.

📁 raw/ — el sótano

Aquí metes todo lo que venga de fuera o escribas tú. Una vez dentro, nunca se edita ni se mueve. Las subcarpetas son categorías por origen del dato (de qué plataforma vienen), no por contenido: meta-ads/, google-ads/, tiktok-ads/, web/ (capturas, copys, CRO), y notes/ (lo que escribes tú: objetivos, hipótesis, decisiones, conversaciones).

Convención de naming de cada ingesta

Dentro de la subcarpeta del canal, creas una sub-sub-carpeta:

Ejemplos: raw/meta-ads/2026-04-13-al-19-all-campaigns/. Así el nombre mismo te dice qué periodo cubre cuando buscas en el log. (Un slug ambiguo como 2026-04-all te hará dudar: ¿todo abril o solo unos días?)

# Contexto — <nombre ingesta>

## Objetivo
<Qué intentabas conseguir. Una o dos frases.>

## Fechas
<inicio — fin>

## Presupuesto / Alcance
<Lo relevante del scope de esta ingesta>

## Hipótesis inicial
<Qué esperabas que pasara ANTES de mirar los datos>

## Qué pasó realmente
<Tu lectura humana. NO métricas — interpretación.>

## Qué NO entiendo
<Las preguntas abiertas que te gustaría resolver>

📁 wiki/ — la biblioteca pública

Aquí vive el conocimiento destilado. Claude escribe, tú lees. Nunca editas a mano. Dos archivos base existen siempre:

• index.md — el catálogo. Una línea por página, organizada por categoría y canal. Es lo primero que Claude consulta.
• log.md — el diario append-only. Cada evento importante (ingesta, query archivada, lint) añade una entrada con fecha. Nunca se edita el pasado. Es tu trazabilidad.

Y las subcarpetas: sources/ (ficha por fuente), campaigns/ (una por campaña, por canal), entities/ (audiencias, creatividades, productos), concepts/ (transversales como CPA, ROAS) y concepts/platform-specific/ (ligados a un canal: Advantage+, Performance Max…), y syntheses/ (análisis y decisiones archivadas: el activo más valioso).

📄 CLAUDE.md — el manual del bibliotecario

Es el alma del brain. Se carga automáticamente al abrir Claude Code en esa carpeta. Le dice qué es cada carpeta, cómo ingestar, cómo responder y cuándo archivar, las reglas duras ("nunca inventes datos, nunca toques raw/, cita siempre la fuente"), qué brains de referencia puede leer, y el idioma. Es un "schema vivo": si una regla falla, la editas y queda registrada como refactor en el log.

📄 README.md — el cartel en la puerta

Es para humanos (tú, dentro de un año). Explica en pocas líneas qué es esto y cómo se usa. No lo lee Claude para operar: lo lees tú para recordar.

El wiki tiene dos tipos de páginas completamente distintos. Aquí es donde la gente se confunde al empezar.

📋 Páginas descriptivas

(sources, campaigns, entities, concepts) Te dicen "esto es lo que hay". Fichas objetivas que resumen lo que vive en raw/. Se crean durante un ingest, automáticamente. Son los ladrillos del wiki. Responden a "¿qué gasto tuvo la campaña X?".

🧠 Páginas analíticas (syntheses)

Te dicen "esto es lo que significa o qué decidir". Son el cerebro del wiki. Se crean durante una query, y solo cuando tú lo pides. Contienen supuestos, riesgos y criterios de reversión. Son el activo más valioso.

🔵 Ingest — cargar contexto y describir lo que hay

Claude lee una fuente nueva de raw/ y genera/actualiza las fichas descriptivas. Qué hace:

1. Lee el material completo de la carpeta.
2. Discute los hallazgos clave en el chat antes de escribir.
3. Propone un plan de páginas a crear o actualizar y espera tu aprobación.
4. Al aprobar, escribe: 1 ficha en sources/, una por campaña, una por audiencia/creativo, actualiza conceptos, añade backlinks entre páginas, actualiza index.md y añade una entrada ingest al log.md (con una sección "Datos que faltaron").

Toca entre 5 y 15 páginas según el tamaño de la fuente. NO crea syntheses, no modifica raw/ y no inventa datos (marca [FALTA DATO]).

🟢 Query — una pregunta que genera análisis

Claude responde consultando el wiki compilado, sin volver a leer raw/: lee index.md, cruza páginas, razona, cita las páginas que usó, marca supuestos y —si la respuesta es valiosa— propone archivarla como synthesis.

Tipos: consulta rápida (no se archiva), diagnóstico, decisión, comparativa (candidatas a synthesis) y exploratoria (normalmente no se archiva).

🟡 Lint — mantenimiento periódico

Claude limpia el wiki: busca contradicciones (una página dice CPA 12 €, otra 15 € para la misma campaña), detecta datos obsoletos, encuentra páginas huérfanas, revisa [FALTA DATO] sin resolver y propone fixes antes de aplicarlos. Córrelo cuando el wiki tenga ~30-50 páginas.

La sección que más te interesa para operar. Aquí tienes el ciclo completo con las tres perspectivas en paralelo: qué haces tú, qué hace Claude, cómo se ve en Obsidian. Escenario: es lunes y quieres analizar las campañas del fin de semana (13-19 abril).

Ingesta raw/<canal>/<NOMBRE-DE-TU-CARPETA>/ siguiendo estrictamente
el workflow de ingest definido en CLAUDE.md.

Antes de escribir nada en wiki/, dime:

1. Qué archivos has leído de esa carpeta y qué has entendido de cada uno
   (resumen de 1-2 líneas por archivo).
2. Qué hallazgos clave detectas cruzando los datos y notes.md.
3. Qué páginas concretas planeas crear o actualizar en wiki/
   (lista completa con nombres y ruta respetando la organización por canal).
4. Qué backlinks vas a establecer entre esas páginas.
5. Si detectas datos faltantes o confusos, márcalos como [FALTA DATO].

Espera mi confirmación explícita antes de escribir nada.
No toques raw/. No archives syntheses durante el ingest.

Usando solo la wiki, responde esta pregunta:

<tu pregunta concreta>

Requisitos:
- Cita las páginas concretas que uses (ruta completa)
- Si no hay datos suficientes en la wiki, dilo explícitamente
- Si la respuesta es valiosa y no existe como página, proponla
  como synthesis y pídeme confirmación antes de archivar
- No inventes. [FALTA DATO] si falta.

Resumen visual del ciclo

Sin disciplina de archivado, el brain deja de crecer y se vuelve un wiki estático. Con disciplina, se convierte en tu segundo cerebro. Las syntheses son el corazón del sistema porque capturan decisiones con su razonamiento, se pueden releer en el futuro, permiten el efecto compuesto y son tu output defendible ante un cliente.

Separación estricta entre ingest y archivado

• ✅ Si combinas ingest + pregunta analítica en el mismo prompt, SÍ se puede archivar (la pregunta fue explícita).
• ✅ Si durante el ingest Claude detecta algo analizable, lo anota como "hook pendiente de query" en el log.
• ❌ Claude NO crea syntheses por iniciativa propia durante un ingest.
• ❌ Claude NO archiva cada respuesta del chat: solo las que pasan el criterio.

Los 3 filtros: qué merece ser synthesis

Una respuesta se archiva si cumple al menos uno:

1. Decisión tomada — vas a ejecutar una acción basada en ella.
2. Relectura futura probable — la querrías releer en 2-3 meses.
3. Explicación consolidada — responde a una pregunta difícil que no tenía respuesta clara y une varios hallazgos.

No se archivan: consultas rápidas ("¿cuánto gasté ayer?"), exploraciones tentativas, resúmenes de páginas que ya existen, respuestas triviales.

Formato mínimo de una synthesis

• Título claro y fechado (2026-04-09-decision-pausar-campana.md)
• Pregunta original o contexto que la motivó
• Respuesta/diagnóstico con backlinks a las páginas consultadas
• Supuestos marcados ("SUPUESTO: la campaña mantiene el CPA al escalar 3x")
• Si es decisión: acción concreta + riesgo principal + señal de validación a X horas + criterio de reversión
• Entrada correspondiente en log.md tipo query

Cerrar hooks: el ciclo completo del aprendizaje

Cuando una synthesis dejó un experimento abierto ("pausar y verificar a 48h") y vuelves con datos nuevos: ingestas los datos, actualizas la synthesis anterior (sección ## Resultado del experimento [fecha]) — NO creas una nueva — y anotas en el log cerrar hook. Así mantienes toda la trazabilidad en una sola página:

En un chat normal, cada conversación es efímera: preguntas, recibes, cierras, la respuesta muere. Con el Sistema Brain, cada análisis se convierte en infraestructura persistente: se archiva como synthesis, vive para siempre, y la próxima pregunta relacionada parte de ahí. El wiki se vuelve más inteligente con cada pregunta.

El marketing-brain (o el nombre que le des) guarda conocimiento reutilizable entre proyectos. Su estructura es casi idéntica, con dos diferencias:

Diferencia 1: subcarpetas distintas en raw/

Diferencia 2: reglas estrictas de contenido

Solo va conocimiento reutilizable (playbooks, frameworks, definiciones). Jamás datos concretos de cliente. Si un aprendizaje nació con un cliente, se generaliza y anonimiza antes de subirlo:

• ✅ "En e-commerce de reacondicionados, el remarketing a 30d se satura con frecuencia >2 en 9 días."
• ❌ "En [cliente], la audiencia [nombre] tiene frecuencia 2,41…"

Desde un brain de cliente solo puedes leerlo: "Consulta también las páginas relevantes de ~/brain/marketing-brain/wiki/ como referencia teórica." Las escrituras se hacen en su propia sesión dedicada.

Brain

Una biblioteca especializada: una carpeta con raw/, wiki/, CLAUDE.md y README.md.

Brain de datos

Contiene información confidencial de un cliente o proyecto. Aislado.

Brain de referencia

Conocimiento transversal reutilizable. Sin datos de cliente. Lectura libre desde otros brains.

Modo foco

Sesión abierta dentro de un brain concreto (cd ~/brain/<brain> && claude).

Modo global

Sesión abierta en ~/brain/. Permite consultas cruzadas.

Arquitecto externo

La conversación con Claude fuera de cualquier brain, para dudas estructurales y diagnóstico del sistema.

Raw

El sótano con los documentos originales. Inmutable. Solo tú metes archivos.

Wiki

La sala pública con fichas escritas por Claude. Tú lees, Claude escribe.

Ingest

El proceso por el que Claude lee una fuente de raw/, la resume y actualiza 5-15 páginas descriptivas.

Query

Una pregunta contra el wiki. Si la respuesta es valiosa y lo pides, se archiva como synthesis.

Página descriptiva

Ficha objetiva que resume hechos (sources, campaigns, entities, concepts). Se crea en el ingest.

Synthesis

Página analítica que responde una pregunta compleja o archiva una decisión, con supuestos y criterio de reversión. Se crea en una query explícita.

Lint

Limpieza periódica del wiki: contradicciones, datos obsoletos, páginas huérfanas, [FALTA DATO].

Backlink

Enlace entre dos páginas del wiki, escrito con doble corchete: [[otra-pagina]]. Obsidian los resuelve por nombre único.

Schema

Las reglas del brain. Viven en CLAUDE.md. Son "vivas": se editan cuando hace falta y se registran como refactor.

Hook abierto

Una pregunta o experimento que la synthesis dejó pendiente de datos futuros.

Cerrar hook

Volver con los datos nuevos y actualizar la synthesis original con el resultado.

Ritual de cierre

La pregunta proactiva de Claude al final de cada sesión: "¿algo merece archivarse?".

Gist

El documento original de Karpathy donde describe el patrón.

Guarda estos prompts para reutilizar. Cámbiale solo las partes marcadas con <...>.

1 · Ingesta estándar (con confirmación previa)

Ingesta raw/<canal>/<NOMBRE-DE-TU-CARPETA>/ siguiendo estrictamente
el workflow de ingest definido en CLAUDE.md.

Antes de escribir nada en wiki/, dime:

1. Qué archivos has leído de esa carpeta y qué has entendido de cada uno
   (resumen de 1-2 líneas por archivo).
2. Qué hallazgos clave detectas cruzando los datos y notes.md.
3. Qué páginas concretas planeas crear o actualizar en wiki/
   (lista completa con nombres y ruta respetando la organización por canal).
4. Qué backlinks vas a establecer entre esas páginas.
5. Si detectas datos faltantes o confusos, márcalos como [FALTA DATO].

Espera mi confirmación explícita antes de escribir nada.
No toques raw/. No archives syntheses durante el ingest.

2 · Decisión única defendible

Usando solo la wiki, responde con criterio:

Si mañana tuviera que elegir UNA sola acción y justificarla ante
el cliente, ¿cuál sería y por qué? Asume que solo puedo hacer
una (no combinar). Dame:

1. La acción concreta (qué muevo, cuánto, dónde)
2. Las 2-3 razones principales citando las páginas del wiki
3. El resultado esperado vs el objetivo
4. El riesgo más grande de esta decisión
5. Qué señal miraría en 48h para saber si fue correcta
6. Criterio de reversión si la señal a 48h no es la esperada

Si crees que los datos no bastan para elegir con confianza, dilo
y dime qué dato adicional sería decisivo.

3 · Query exploratoria

Usando solo la wiki, dime:

¿Qué patrones interesantes ves en <tema/periodo/canal>?
¿Qué me estoy perdiendo? ¿Qué pregunta debería estar
haciéndome pero no estoy?

Cita las páginas concretas. Si algo es hipótesis no confirmada,
márcalo explícitamente. No archives nada todavía.

4 · Archivar una synthesis

Archiva esta respuesta como wiki/syntheses/<YYYY-MM-DD>-<slug>.md
respetando el formato de synthesis de CLAUDE.md:

- Título fechado
- Contexto / pregunta original
- Respuesta con backlinks a las páginas que usaste
- Supuestos marcados explícitamente
- [Si es decisión:] acción, riesgo, señal a X horas, criterio de reversión
- [Si hay preguntas abiertas:] sección de hooks pendientes

Añade entrada tipo `query` al log apuntando a esta página nueva.

5 · Ritual de cierre de sesión

Antes de cerrar la sesión: ¿hay alguna respuesta o análisis de
esta conversación que merezca archivarse como synthesis en
wiki/syntheses/?

Si sí, propón los candidatos con:
- Nombre sugerido del archivo
- Justificación breve (cuál de los 3 filtros cumple)
- Formato previsto

Si no ves nada archivable, dímelo explícitamente.

6 · Cerrar un hook abierto

He ingestado los datos nuevos de <periodo> (están en raw/<ruta>).
La synthesis que dejó este experimento abierto es
wiki/syntheses/<synthesis-anterior>.md.

Por favor:
1. Lee la synthesis anterior para recordar la hipótesis y el
   criterio de validación.
2. Cruza con los datos recién ingestados.
3. ACTUALIZA la synthesis anterior añadiendo una sección
   "## Resultado del experimento [fecha]" con:
   - Qué pasó realmente vs qué esperábamos
   - Si la hipótesis se confirmó o no
   - Qué aprendimos
   - Qué decisión tomamos a partir de aquí
4. NO crees una synthesis nueva. La actualización va en la original.
5. Añade entrada al log tipo `query` con título "cerrar hook: <nombre>".

7 · Verificar que CLAUDE.md cargó bien

Resume en 3 líneas las reglas de este brain según CLAUDE.md.

Opción A — Desde la Terminal (la más rápida)

1. Abre la app Terminal (en Mac: Cmd + Espacio → escribe "Terminal").
2. Escribe cd ~/brain/cliente1-brain (cambia por tu brain) y pulsa Enter.
3. Escribe claude y pulsa Enter.

A partir de ahí, Claude Code opera dentro del brain y ha cargado su CLAUDE.md.

Para cambiar de brain en la misma terminal

Para modo global

Opción B — Desde VS Code

Abre la carpeta del brain en VS Code (File → Open Folder → ~/brain/cliente1-brain/) y lanza Claude Code desde su terminal integrada o su extensión. Al estar en esa carpeta, cargará el CLAUDE.md igual.

¿Dónde van los skills de Claude Code?

Los skills globales van en ~/.claude/skills/ y se cargan en cualquier sesión, estés en la carpeta que estés. Los skills específicos de un brain van en ~/brain/<brain>/.claude/skills/ y solo se cargan en ese brain. Recomendación al empezar: no muevas nada.

Tengo un archivo importante y no sé dónde meterlo

¿Puedo pedirle que conecte APIs (Meta, Google Ads) directamente?

Técnicamente sí, pero no al principio. Durante las primeras 3-4 semanas opera manual: el notes.md humano es lo que da los mejores hallazgos (una API no lo escribe), y así descubres qué datos necesitas de verdad. Automatizar antes de saber qué automatizar = tiempo perdido.

¿Puedo consultar el brain desde Obsidian sin abrir Claude Code?

Sí: Obsidian te deja navegar y leer toda la wiki y el raw/. Pero para preguntas complejas, ingestas o escribir páginas nuevas, necesitas Claude Code.

Claude propone un plan raro durante un ingest

No te enfades, ajústalo en lenguaje natural: "El plan está bien, pero fusiona las páginas de CPA y ROAS en una por ahora." Si el mismo error se repite 2-3 veces, edita CLAUDE.md para añadir la regla que lo evita (y regístralo como refactor en el log).

Claude toca raw/ o inventa datos

1. Dile que pare inmediatamente.
2. "Revierte esa acción."
3. "Vuelve a leer las reglas duras de CLAUDE.md y confírmame que las entiendes."

La wiki generada me parece genérica o inútil

Casi siempre es porque el notes.md fue muy escueto o inexistente. Sin contexto humano, Claude compila fichas frías. Refuerza el notes.md de la próxima ingesta.

Olvidé archivar algo importante de una sesión pasada

No pasa nada. Si recuerdas el contenido, en una sesión nueva se lo dices y le pides archivarlo como synthesis con fecha de hoy (notando que es una reconstrucción). Si no, avanzas: el próximo análisis similar generará su propia synthesis.

Ya tienes el modelo mental completo. El resto es práctica. Para no abrumarte:

1. Crea UN solo brain (tu proyecto o cliente más activo). No montes cinco a la vez.
2. Crea la estructura de carpetas (raw/, wiki/) y un CLAUDE.md con las reglas de este documento.
3. Haz una primera ingesta con un buen notes.md. Revisa la wiki en Obsidian.
4. Haz una query y archiva tu primera synthesis.
5. Cuando ese brain tenga 3-4 ingestas sólidas, replica a otro proyecto.