¿Cómo crear un segundo cerebro con Claude Code? Guía completa de carpetas Markdown y CLAUDE.md

El término “segundo cerebro” puede sonar pretencioso, pero en la práctica es algo mucho más sencillo: un conjunto de archivos de texto organizados en carpetas y gestionados por un único archivo índice que indica a la IA dónde mirar.

No necesitas Obsidian, bases de datos complejas ni aplicaciones infladas. Solo necesitas Markdown plano en tu disco y una estructura clara.

En esta guía, basada en el flujo de trabajo compartido junto al video del experto en Claude, vamos a construir esta arquitectura desde cero: organización de directorios, redacción del mapa CLAUDE.md, convenciones de nombres y la forma exacta en que el agente interpreta todo.

Al terminar, tendrás un sistema replicable que podrás empezar a poblar de inmediato.

La respuesta corta: ¿Qué es un segundo cerebro con Claude?

Un segundo cerebro no es más que una colección de archivos .md planos organizados en carpetas simples, con un archivo CLAUDE.md en la raíz que actúa como índice.

Ese archivo funciona como una brújula: le dice al agente dónde vive la información, cómo están estructurados los archivos y qué protocolos debe seguir para leerlos.

La regla de oro: un tema por archivo. El CLAUDE.md es el mapa que el agente sigue para navegar por tu conocimiento. No necesitas una app dedicada de notas.

¿Qué necesitas para empezar?

• Un agente de IA capaz de leer directorios de proyecto, como Claude Code o similar.
• Cualquier editor de texto. Son archivos .md estándar; funcionan con todo.
• Cinco minutos. Es tiempo suficiente para crear las carpetas. Puedes ir llenándolas sobre la marcha; no hace falta cargar todos tus datos de golpe.

Nota importante: no hay scripts de instalación ni configuraciones complejas. Esto es una estructura de archivos y un índice, no un producto de software.

El principio: archivos planos antes que aplicaciones

El instinto de descargar Obsidian o montar una base de datos en Notion suele ser una trampa. Las aplicaciones imponen sus propios formatos propietarios, lógicas de almacenamiento e interfaces que, a menudo, crean fricción para una IA.

Un agente trabaja mejor cuando puede leer directamente un archivo de texto en tu disco, sin capas intermedias.

Por eso la base aquí son archivos Markdown planos. “Plano” significa texto simple con formato estándar —encabezados, viñetas—, sin bases de datos anidadas ni enlaces propietarios. Es accesible en cualquier lugar y lo pueden leer tanto humanos como IA.

No es un sacrificio por simplicidad: es una ventaja estratégica. Cuanto más limpio sea el formato, menos muros habrá entre tu conocimiento y el agente.

El esqueleto: carpetas semánticas

La organización se basa en carpetas semánticas, agrupadas por tipo de contenido. Esta es la estructura básica:

/
├── CLAUDE.md
├── MEMORY.md
├── LEARNINGS.md
├── decisions.md
├── notes/
├── people/
└── projects/

Estas tres carpetas principales cubren casi cualquier caso de uso:

• notes/ : hechos y entradas sobre temas concretos. Si aprendes algo, destílalo aquí. Un archivo por tema.
• people/ : fichas de contactos o empresas: quiénes son, resúmenes de reuniones, detalles clave. Un archivo por persona.
• projects/ : estado de proyectos: en qué estás trabajando, dónde lo pausaste y cuáles son los siguientes pasos.

Además, usa los archivos de la raíz para metadatos de tu flujo de trabajo:

• MEMORY.md : información central de largo plazo.
• LEARNINGS.md : lecciones aprendidas.
• decisions.md : registro de auditoría de tus decisiones.

CLAUDE.md: el mapa del sistema

Este archivo es el sistema nervioso del cerebro. Las carpetas son solo almacenamiento; para que sean accionables, necesitas un mapa. El CLAUDE.md en la raíz le dice al agente cómo interpretar tu estructura.

¿Por qué CLAUDE.md? Si usas Claude Code, este archivo se carga automáticamente en el prompt del sistema al iniciar. No tienes que pedirle al agente que “lea el mapa”: ya conoce las reglas antes de tu primera pregunta.

Ejemplo de archivo mapa:

Mapa del segundo cerebro

**Estructura**

- `notes/`: un archivo por tema. Hechos, conceptos y aprendizajes.
- `people/`: un archivo por persona o empresa. Contexto y reuniones.
- `projects/`: un archivo por proyecto. Estado y próximos pasos.
- `MEMORY.md`: contexto central permanente.
- `LEARNINGS.md`: lecciones acumuladas.
- `decisions.md`: registro de decisiones importantes.

**Protocolo**

1. Antes de responder, localiza el archivo relevante usando este mapa.
2. Lee solo los archivos necesarios.
3. Cita siempre el archivo fuente.
4. Si la información no existe, indícalo; no inventes.

Pro-tip: conexiones con @

Para una configuración más avanzada, puedes preparar al agente para que tu CLAUDE.md referencie archivos centrales usando rutas @.

Por ejemplo, al añadir @MEMORY.md o @decisions.md al mapa, el agente mantiene ese contexto de alto nivel en su memoria activa en todo momento. Úsalo con moderación: solo para lo que realmente necesite estar siempre en foco.

Reglas de nombres: la disciplina lo es todo

La regla “un archivo = un tema” es donde la mayoría de los sistemas triunfan o fracasan.

• Un archivo, un tema. Evita volcar varios puntos no relacionados en notes.md. Si se trata de “política fiscal”, crea politica-fiscal.md.
• El tema como nombre. Nombra el archivo por lo que contiene. Usa ivan-petrov.md en lugar de nota-12.md.
• Estilo unificado. Mantén minúsculas y guiones para evitar ambigüedades.

¿Cómo lee el agente la información?

Cuando inicias una sesión, el agente ingiere CLAUDE.md. Cuando haces una pregunta, usa el mapa para localizar el archivo correcto, lo analiza y sintetiza una respuesta con su cita correspondiente.

Si la información no está allí, reporta un fallo en lugar de alucinar. Tu única responsabilidad es mantener una estructura limpia; el agente se encarga de la recuperación.

Errores comunes y preguntas frecuentes

¿El mapa tiene que llamarse obligatoriamente CLAUDE.md?

Si usas Claude Code, sí: es automático. Para otros agentes, usa README.md o un índice equivalente en la raíz.

¿Cuántas carpetas debería crear al principio?

Manténlo simple. Empieza con tres carpetas principales y tus archivos de raíz. Amplía solo cuando un tema sea lo suficientemente grande como para merecer su propio directorio.

¿Tengo que mover todas mis notas antiguas?

No. Construye el esqueleto ahora y migra o crea contenido nuevo sobre la marcha.

¿Necesito una aplicación de notas?

No. La clave es Markdown plano, carpetas semánticas y un CLAUDE.md bien escrito.

Conclusión

Tu segundo cerebro es simplemente una mezcla de archivos .md planos, una disciplina estricta de “un tema = un archivo” y un mapa CLAUDE.md que guía al agente. Olvídate del software complejo: mantén tus archivos de texto organizados en el disco. Invierte tu tiempo en el mapa. Un CLAUDE.md claro marca la diferencia entre un desastre desorganizado y un asistente de IA realmente funcional.