# Un segundo cerebro en Claude Code: cómo crear la estructura en una hora > Cómo usar notas Markdown locales de Obsidian como segundo cerebro de Claude Code: jerarquía de memoria, cinco carpetas y Git para conservar el contexto entre sesiones. Source: https://ailoot.ai/blog/es/claude-code-second-brain/ Canonical: https://ailoot.ai/blog/es/claude-code-second-brain/ Language: es Publisher: Ailoot (https://ailoot.ai/) Translation: guide-233 Revision: sha256-73da8cbfd7b1b095bc251272e5ec71403a30264601286a88f5e56a9c721dd543
Idea clave Un segundo cerebro para Claude Code no es un único archivo: es una estructura de cinco carpetas más Git. CLAUDE.md establece las reglas y las rutas; `business/` guarda conocimientos sobre el proyecto; `ai-clone/` almacena información sobre ti como responsable de las decisiones; `plans/` contiene planes técnicos y `retrospectives/`, lecciones de sesiones anteriores. El agente empieza por CLAUDE.md y sigue los enlaces hasta la carpeta adecuada para cada solicitud. Este artículo explica la jerarquía de memoria de la documentación oficial de Claude Code, una estructura de cinco partes y cómo montarla paso a paso en una hora.
Documentación de referencia de Ailoot: [ailoot.ai/docs/](https://ailoot.ai/docs/). ## ¿Por qué necesita Claude Code un segundo cerebro y qué es esencial?
Idea clave Un archivo CLAUDE.md cubre las reglas básicas, pero no puede gestionar la memoria empresarial. Al cabo de un mes, has olvidado por qué subiste el precio. Al cabo de tres meses, has olvidado por qué rechazaste los pagos a plazos. El conocimiento vive en cuatro lugares a la vez: tu cabeza, los chats de Telegram, los documentos de Google y las cabezas de los empleados. Un segundo cerebro lo reúne todo en una carpeta de archivos Markdown junto al proyecto, y Claude puede acceder a ella por su cuenta.
Abres Claude Code el martes. Explicas: este es el proyecto, este es el público, no hagas esto. Trabajáis juntos. El jueves hay un chat nuevo y tienes que volver a explicarlo todo. Si tienes un archivo CLAUDE.md, ya has resuelto la primera ronda de frustración. Las reglas básicas y la descripción del proyecto están en un archivo y se cargan en cada sesión. Expliqué cómo funciona este archivo en mi [guía de CLAUDE.md](https://ailoot.ai/blog/es/claude-md-template/); puedes leerla primero para establecer los fundamentos. Pero CLAUDE.md es un manual de instrucciones para un empleado nuevo. Cómo vestir, qué tono usar con los clientes, qué comandos utilizar para publicar. Eso no basta para tomar buenas decisiones sobre el proyecto. Las decisiones requieren conocimiento: qué es el producto, quién es el público, cómo funciona la economía, qué has probado y qué no ha funcionado. Según la experiencia del autor que se describe aquí, ese conocimiento vivía antes en cuatro lugares: su cabeza, los chats de Telegram, los documentos de Google y las cabezas de los empleados. Un mes después de tomar una decisión, nadie recordaba por qué se había tomado. Una persona nueva pasaba una hora haciendo preguntas al equipo para ponerse al día. Claude ni siquiera formaba parte de ese contexto. Antes de tener el segundo cerebro, según la experiencia descrita por el autor, cada sesión implicaba volver a explicar quién era el cliente, cómo estaba estructurada la oferta y qué proveedor gestionaba los pagos. Con `business/`, abro un chat y digo: «actualiza la oferta para el nuevo plan de precios»; Claude va por su cuenta a `business/company/legal.md`, lee los requisitos y después abre `business/products/pricing.md`, ve el nuevo plan de precios y propone una edición de una sola vez. Desaparece la puesta al día inicial; el contexto se carga automáticamente.
Nota No es un problema de la memoria de Claude. Es una cuestión de arquitectura. La ventana de contexto de un agente es su memoria de trabajo. Solo carga aquello a lo que le indicas explícitamente que acceda. Todo lo demás queda fuera de la ventana y se carga cuando hace falta. Un segundo cerebro almacena ese «todo lo demás» de forma estructurada para que Claude pueda orientarse.
Anthropic llama a este problema «context rot» en su blog de ingeniería:
Cuantos más tokens hay en la ventana de contexto, peor recuerda el modelo con precisión la información de ese contexto.
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents
En otras palabras, cuanto más metes en la ventana, peor trabaja el agente con los detalles concretos. La solución es mantener una estructura de archivos externos que Claude pueda consultar por su cuenta en respuesta a una solicitud específica. Eso es un segundo cerebro. ## ¿Qué es un segundo cerebro y cómo se aplica a Claude?
Idea clave La idea es sencilla: la mente sirve para tener pensamientos, no para almacenarlos. En Claude Code, un segundo cerebro pasa de ser un método de productividad a convertirse en una arquitectura de agente: una carpeta externa de notas a la que el agente puede acceder directamente a través del sistema de archivos.
Normalmente, un segundo cerebro se orienta a la productividad en general: las personas crean una bóveda en Obsidian y añaden fragmentos de libros, notas de llamadas e ideas para proyectos. Cuando el autor aplicó esta idea al trabajo con Claude Code, dejó de tratarse de productividad y pasó a ser arquitectura de agentes. En el enfoque clásico, el segundo cerebro es tuyo y accedes a él manualmente. Al trabajar con Claude Code, el segundo cerebro pasa a ser **bidireccional**: tanto tú como el agente accedéis a él. Eso cambia los requisitos de su formato. Como el agente accede a él por su cuenta, los archivos deben estar en un formato que entienda sin una integración aparte. Markdown es ideal: texto, jerarquía de encabezados y enlaces entre archivos. Notion y Google Docs no son adecuados. Puedes conectarlos mediante MCP, pero eso añade otra capa, otro token por solicitud y otro punto de fallo. Como los archivos están en el sistema de archivos junto al proyecto, quedan automáticamente al alcance de Claude Code. No hace falta configurar nada. Inicia el agente en la carpeta del proyecto y podrá ver todos los archivos que contiene. Es gratis y funciona desde el primer momento.
Consejo Puedes guardar tu segundo cerebro en Obsidian; yo también lo abro ahí para ver con más facilidad el grafo de conexiones. Pero los archivos están en una carpeta normal junto al código. Obsidian no es más que una interfaz cómoda para archivos Markdown. Claude puede verlos sin Obsidian. Puedes usar cualquier editor; lo importante es que los archivos estén en el disco y no en un servicio en la nube con formato propio.
## ¿Qué jerarquía de memoria tiene Claude Code de serie?
Idea clave Claude Code puede leer de serie cuatro niveles de CLAUDE.md (empresa, usuario, proyecto y local) y, desde la versión 2.1.59, mantiene su propia memoria automática en `~/.claude/projects//memory/`. Esto basta para una memoria básica, pero no para el contexto empresarial: ese se guarda en una carpeta separada junto al proyecto.
Antes de añadir nada propio, veamos qué puede recordar Claude sin tu ayuda. Anthropic describe dos mecanismos en su [documentación oficial](https://code.claude.com/docs/en/memory): CLAUDE.md (las reglas que escribes) y la memoria automática (las lecciones que Claude escribe por su cuenta). Ambos se cargan al inicio de cada sesión. CLAUDE.md se busca en cuatro ubicaciones a la vez: | Nivel | Ubicación | Propósito | |----|----|----| | **Empresa** | `/Library/Application Support/ClaudeCode/CLAUDE.md` (macOS), `/etc/claude-code/CLAUDE.md` (Linux), `C:\Program Files\ClaudeCode\CLAUDE.md` (Windows) | Reglas que un administrador distribuye a todo el equipo mediante MDM. Los particulares no necesitan este nivel. | | **Usuario** | `~/.claude/CLAUDE.md` | Reglas personales aplicables a todos los proyectos. «Responde en mi idioma preferido», «no uses rayas». | | **Proyecto** | `./CLAUDE.md` en la raíz del proyecto | Reglas para un proyecto específico: stack, estructura de carpetas y reglas empresariales. Se confirma en Git. | | **Local** | `./CLAUDE.local.md` | Tus notas personales para este proyecto, que no se confirman en Git. En `.gitignore`. | Los cuatro archivos se cargan en el contexto. Cuanto más específico es el nivel, mayor es su prioridad. El archivo local se lee al final, por lo que sus reglas prevalecen sobre las demás. También puede haber un archivo CLAUDE.md en cualquier carpeta del proyecto. Cuando Claude lee un archivo de una subcarpeta, carga el CLAUDE.md de esa subcarpeta cuando hace falta. Esto resulta útil en un monorepo: las reglas del frontend están en `frontend/CLAUDE.md`, las del backend en `backend/CLAUDE.md` y solo se cargan cuando el agente trabaja en la parte correspondiente. La memoria automática apareció en Claude Code 2.1.59. Consiste en archivos que Claude escribe sobre ti: ``` ~/.claude/projects//memory/ ├── MEMORY.md # Índice, cargado en cada sesión (200 líneas o 25KB) ├── debugging.md # Notas detalladas (se cargan cuando hace falta) ├── api-conventions.md └── ... ``` Anthropic lo describe así en la documentación oficial:
Claude no guarda algo en todas las sesiones. Decide qué merece la pena recordar según si la información podría ser útil en una conversación futura.
— Anthropic, code.claude.com/docs/en/memory
La memoria automática se activa con el indicador `autoMemoryEnabled` en `~/.claude/settings.json`. Claude decide qué escribir ahí. Puedes leer MEMORY.md y editarlo manualmente: es Markdown normal.
Advertencia La memoria automática es útil, pero no sustituye a un segundo cerebro. Claude guarda ahí conclusiones tácticas sobre herramientas y patrones de código. «Este script falla sin el indicador X», «esta tabla de la base de datos se llama así». No guarda estrategias empresariales. Si quieres que el agente recuerde quién es tu público y por qué elegiste un precio determinado, tienes que ponerlo tú en una carpeta de contexto aparte.
## ¿CLAUDE.md o un segundo cerebro? ¿Dónde está el límite?
Idea clave CLAUDE.md es un manual de instrucciones para un empleado nuevo: cómo comportarse, qué comandos utilizar y qué no hacer. Un segundo cerebro es una wiki de la empresa: qué haces, para quién, cómo funciona la economía y qué has probado. Un archivo de reglas de comportamiento y una estructura de conocimiento externo. CLAUDE.md es el índice; el segundo cerebro es el archivo. Sin el índice, el agente no sabe que existe el archivo. Sin el archivo, solo conoce las reglas, no el contexto empresarial.
Esta es la analogía que uso en mis charlas: imagina que has contratado a un empleado nuevo. ¿Qué le das el primer día? Un manual de instrucciones: cómo vestir, cuándo llegar, qué tono utilizar con los clientes y qué sistema usar para publicar. Es un documento breve. No explica qué hacéis ni por qué. Solo indica cómo comportarse. Y, por separado, acceso a la wiki de la empresa. Explica qué es el producto, para quién es, quién es el público, cuál es el precio y por qué, quiénes son los competidores y qué errores habéis cometido. Es un archivo extenso. Nadie lo lee entero: se consulta para resolver una pregunta concreta. CLAUDE.md = manual de instrucciones. Segundo cerebro = wiki. Necesitas ambos. La distinción es sencilla. Pon en CLAUDE.md todo lo que sea **relevante para cada tarea**: - Quién es el agente en este proyecto (ayudante, responsable, asistente) - En qué idioma debe responder - Stack de herramientas - Comandos de publicación - Prohibiciones (no usar rayas, no ejecutar `git push --force`) - Rutas: dónde buscar el contexto empresarial y dónde encontrar los principios Pon en el segundo cerebro todo lo que se **necesita cuando hace falta**: - El producto, el público, la economía y los objetivos - Competidores y mercado - Decisiones anteriores y sus motivos - Ejemplos y reseñas de clientes - Principios y metodología Anthropic establece la misma distinción en su documentación:
Mantén CLAUDE.md breve. Se carga en cada sesión, así que incluye solo lo que sea aplicable en términos generales. Para conocimientos del dominio o flujos de trabajo que solo se necesitan a veces, usa Skills. Claude los carga cuando hace falta, sin sobrecargar cada conversación.
— Anthropic, code.claude.com/docs/en/best-practices
Los Skills son una forma de almacenar conocimiento episódico. Una carpeta `business/` junto al proyecto es otra. Yo uso ambos y los explicaré con más detalle a continuación. ## ¿Qué compone el cerebro de un proyecto? 5 partes y una máquina del tiempo
Idea clave El cerebro de un proyecto consta de cinco carpetas con Git por encima. CLAUDE.md define las reglas y las rutas. `ai-clone/` guarda tu proyección digital: tus principios, tu tono y tus comentarios después de los errores. `business/` almacena conocimientos sobre el proyecto. `plans/` contiene planes técnicos por fases. `retrospectives/` contiene reflexiones después de las sesiones. Git convierte todo esto en una máquina del tiempo: un año después puedes abrir cualquier archivo y ver qué contenía cuando se tomó una decisión.
Un ejemplo de arquitectura basado en la experiencia descrita por el autor: | Carpeta | Contenido | Propósito | |----|----|----| | **`CLAUDE.md`** | Reglas del proyecto, stack, estructura de archivos, rutas de carpetas, idioma de comunicación | Es el manual de instrucciones del agente. Se carga en cada sesión. Menos de 200 líneas, idealmente 80-120. | | **`ai-clone/`** | Quién soy, mis principios, mi tono, mi estilo de toma de decisiones y comentarios después de errores | Una proyección digital de mí como responsable de las decisiones. Sabe qué rechazaré de inmediato, con qué estilo sugiero cosas y qué reglas he aprendido de mis errores. | | **`business/`** | Producto, público, objetivos, economía, marketing, decisiones anteriores y ejemplos | Archivos Markdown enlazados mediante vínculos wiki. Cada archivo conecta con los demás usando enlaces `[[...]]`. El agente acude ahí cuando tiene una pregunta concreta. | | **`plans/`** | Un plan por función. Archivo `YYYY-MM-DD-feature.md` con fases y casillas | El modo Plan existe en una conversación y se pierde tras `/clear`. La carpeta `plans/` está en el repositorio; cualquier agente puede retomar el plan en cualquier momento. | | **`retrospectives/`** | Reflexiones tras cada sesión: qué se hizo, qué hay que recordar y qué podría mejorarse | Autoaprendizaje del sistema. Los errores se convierten en reglas en `ai-clone/feedback/`. | | **`+ git`** | Historial de versiones de todos los archivos | Una máquina del tiempo. Abre cualquier archivo y ejecuta `git log` para ver cuándo cambió y por qué. | El punto metodológico clave es **separar `ai-clone/` de `business/`**. `business/` responde a la pregunta «¿qué hacemos?». Producto, público, precios y competidores. Trata del proyecto. Si mañana le entregas el proyecto a un socio, esta carpeta se va con él. `ai-clone/` responde a la pregunta «¿cómo tomo decisiones?». Mis principios, mi tono, mi oficio y mis palabras prohibidas. Trata de mí. Si mañana empiezo un proyecto nuevo, esta carpeta se viene conmigo. ¿Quieres no solo configurar una segunda carpeta, sino también crear un sistema que haga que Claude sea coherente? Eso no basta por sí solo. Sin `ai-clone/`, el agente responde para todo el mundo, no para ti. Sin context engineering, recorre toda la carpeta y consume tokens. Conviene conectar las tres cosas: **segundo cerebro + clon de IA + context engineering**. Son los **tres pilares** sin los cuales la IA alucina. ## ¿Qué debe ir en business/ y qué no?
Idea clave Pon en `business/` los hechos del proyecto que cambian como máximo una vez por semana: posicionamiento, público, productos y precios, objetivos trimestrales y decisiones clave. Deja fuera la correspondencia de chats, los materiales brutos sin procesar, la información duplicada en el código, las capturas de pantalla y los números dinámicos. Sustituye los números por el marcador LIVE y un enlace a una consulta SQL; lo explico en una sección aparte más abajo.
Estructura de primer nivel de `business/` en el proyecto descrito por el autor: ``` business/ ├── INDEX.md ← mapa de la carpeta; leer primero ├── company/ ← misión, entidad jurídica, valores, políticas legales ├── products/ ← productos, programas, precios ├── audience/ ← perfil del cliente, segmentos, objeciones ├── goals/ ← objetivos anuales, trimestrales y mensuales, métricas ├── economics/ ← economía unitaria, ingresos, gastos, previsiones ├── marketing/ ← canales, embudo, materiales, competidores ├── execution/ ← planificación semanal, backlog └── assets/ ← sistema de diseño, reseñas, banco de textos ``` Este es un ejemplo del proyecto descrito por el autor, no un dogma. Creo carpetas según las necesito. Empecé con tres (`products/`, `audience/`, `goals/`); añadí las demás al cabo de 2-3 meses, cuando dejó de estar claro dónde poner lo nuevo. El archivo principal de la carpeta es `INDEX.md`. Es un mapa. Contiene una tabla «pregunta → archivo» que Claude utiliza para saber dónde ir. Sin ella, el agente gasta tokens leyendo todos los archivos en orden. Un ejemplo de extracto de `INDEX.md`: ```markdown ### Dónde encontrar las cosas | Qué necesitas | Dónde buscar | |---|---| | Quién es nuestro cliente y cuáles son sus puntos de dolor | `business/audience/avatar.md` | | Productos, planes y precios | `business/products/` | | Objetivos y métricas | `business/goals/` | | Economía (ingresos, gastos, economía unitaria) | `business/economics/` | | Canales y materiales de promoción | `business/marketing/` | ``` Entonces basta con una línea en `CLAUDE.md`: «Para preguntas empresariales, lee `business/INDEX.md` y sigue el mapa». El agente no carga toda la carpeta en el contexto. Carga el mapa, elige el archivo adecuado y lee solo ese. **Lista de comprobación de lo que no debes poner en `business/`:** - Correspondencia de chats sin procesar. Si contiene una idea útil, sintetízala y anótala. Si no, déjala fuera. - Información duplicada en el código. «Los pagos pasan por CloudPayments» no hace falta; el agente puede verlo en el código. - Capturas de pantalla e imágenes. Aumentan el tamaño de la carpeta y un modelo de texto no las interpreta sin un paso adicional. - Números dinámicos. «Hoy hay 423 pagos del producto» quedará obsoleto en una semana. Usa el marcador LIVE y un enlace a una consulta de base de datos. - Información confidencial o cuestionable. Si mañana publicaran el repositorio en YouTube ante 100 mil desconocidos, conserva solo lo que estarías dispuesto a mostrar. Los empleados, los agentes y, a veces, los contratistas externos leen la carpeta.
Advertencia Si el repositorio es público, la carpeta `business/` también lo es. Trato el segundo cerebro como si el repositorio pudiera hacerse público mañana, aunque ahora sea privado. Nada de nombres de clientes sin consentimiento, cifras de ingresos mensuales ni contraseñas. Este hábito ahorra mucho estrés.
## ¿Por qué tener una carpeta ai-clone separada y por qué no mezclarla con business?
Idea clave `ai-clone/` guarda tu proyección digital: principios, tono, palabras prohibidas y comentarios después de los errores. Cada error del agente se convierte en una regla en `ai-clone/feedback/`, siguiendo la fórmula «regla → por qué → cómo aplicarla». La carpeta te acompaña de un proyecto a otro. `business/` se queda con el proyecto. Mantenlas separadas: en un proyecto nuevo, `business/` será nuevo, pero tus principios y tu estilo seguirán siendo los mismos.
La idea es sencilla: el negocio sabe qué hacemos. El clon sabe cómo tomo decisiones. Estructura de `ai-clone/` en el proyecto descrito por el autor: ``` ai-clone/ ├── INDEX.md ← mapa de la carpeta ├── role.md ← quién soy, antecedentes, qué me importa ├── identity/ ← valores, visión, misión ├── thinking/ ← modelos mentales de charlas ├── voice/ ← tono, vocabulario, estilo ├── principles/ ← convicciones sobre producto, código y negocio ├── feedback/ ← reglas aprendidas de los errores ← carpeta principal ├── style/ ← palabras prohibidas, formato de Telegram └── reference/ ← herramientas, entorno ``` La carpeta más útil es `feedback/`. Contiene reglas concretas que he aprendido a partir de los errores del agente. Cada regla va en un archivo separado con este formato: ```markdown --- name: short-name description: una línea - qué contiene el archivo y cuándo aplicar la regla type: feedback --- Una regla breve en una frase. **Por qué:** por qué existe esta regla. Contexto, incidente, observación. **Cómo aplicarla:** desencadenantes concretos que indican cuándo se aplica la regla. ``` Sin «Por qué», la regla está muerta: el agente no la aplicará a una situación parecida. Sin «Cómo aplicarla», no queda claro cuándo usarla. Un ejemplo de mi carpeta: la regla «guion corto, no raya». Surgió porque la raya `—` es un marcador visual importante de los textos generados. Se aplica a cualquier texto dirigido al público. El archivo está en `ai-clone/feedback/no-em-dashes.md`. Yo lo hago de otra manera: escribo las reglas en `ai-clone/feedback/`, no en `CLAUDE.md`. CLAUDE.md es un archivo del proyecto, pero las reglas sobre tono y estilo son personales. Me acompañan al siguiente proyecto. `CLAUDE.md` se queda con el proyecto.
Nota Una forma de medir la madurez de este enfoque: ¿cuántas veces a la semana le dices al agente «no, así no» sobre lo mismo? En un sistema maduro, la respuesta es cero. Cada error se convierte en una regla en `feedback/` y el agente no lo repite la próxima vez.
## ¿Qué son las Live Metrics y por qué no se deben fijar números en los archivos?
Idea clave Los números de los archivos del segundo cerebro quedan obsoletos en pocos días. «1,000 clientes» hoy se convierte en 1,050 mañana y en 2,000 dentro de un mes. Si lo escribes de forma fija, un mes después el agente hará sugerencias basadas en los datos de ayer. La solución es incluir un marcador LIVE en el archivo y crear un documento aparte, `live-metrics.md`, con consultas SQL listas para ejecutar. Cuando el agente ve LIVE, accede a la base de datos, obtiene el número actual y razona a partir de datos actualizados.
Uno de los principales escollos al crear un segundo cerebro es llenarlo de números obsoletos. Escribes «tenemos 320 clientes» y, dos semanas después, ya son 410. Escribes «los ingresos mensuales son 4.7 millones» y, un mes después, el número ha perdido el contexto: ¿es un objetivo, un dato real o una previsión? En el ejemplo del autor, funciona así. En el archivo `business/products/practicum.md`, se coloca un marcador en vez de un número: ```markdown ## Cohortes > **LIVE** - ejecuta las consultas de `live-metrics.md`, sección «Ventas», > para ver los pagos actuales por cohorte. | Cohorte | Fechas | Pagadores | |-------|------|------------| | 1 | 10-12 de marzo de 2026 | LIVE | | 2 | 24-26 de marzo de 2026 | LIVE | ``` Un archivo independiente `live-metrics.md` contiene consultas SQL listas para ejecutar y descripciones de lo que devuelven: ````markdown ## Ventas (pagos por cohorte) ```sql SELECT c.name, COUNT(p.id) AS paid, SUM(p.amount) AS revenue FROM purchases p JOIN cohorts c ON c.id = p.cohort_id WHERE p.status = 'paid' GROUP BY c.name ORDER BY c.starts_at DESC; ``` ```` Cuando pregunto al agente «¿cuántos pagos tenemos para la segunda cohorte?», hace lo siguiente: 1. Lee `business/products/practicum.md` 2. Ve el marcador LIVE junto al número 3. Abre `live-metrics.md` 4. Encuentra la sección «Ventas» 5. Ejecuta la consulta en la base de datos de producción 6. Responde con datos actualizados Así se resuelven dos problemas a la vez. Los números no quedan obsoletos. Y las decisiones se toman con la situación actual, no con la del año pasado.
Advertencia En el enfoque descrito por el autor, solo los agentes de confianza tienen acceso a la base de datos de producción. Acceden a ella únicamente mediante un wrapper que registra las consultas y no revela contraseñas. Incluir un comando `psql` directo con una contraseña en texto plano en `live-metrics.md` es mala idea. Crea un wrapper que obtenga la contraseña de una variable de entorno y no la muestre en la salida. Es una capa técnica aparte, pero sin ella LIVE se convierte en un agujero de seguridad.
## ¿Cómo navega la IA por el segundo cerebro para una sola solicitud?
Idea clave La ruta de la solicitud siempre es la misma: Claude lee CLAUDE.md, ve los mapas (`business/INDEX.md`, `ai-clone/INDEX.md`), abre el INDEX correspondiente, sigue sus indicaciones hasta un archivo concreto y, si hace falta, obtiene un número mediante LIVE. Son 5-6 operaciones de lectura, en vez de meter toda la carpeta en el contexto. La ventana queda libre para razonar y no se gastan tokens en archivos irrelevantes.
Una solicitud concreta, por ejemplo: «redacta un correo para los participantes sobre la nueva cohorte». 1. Claude empieza con una ventana vacía. Carga CLAUDE.md (reglas, stack y rutas). 2. En las rutas de CLAUDE.md ve: «`ai-clone/INDEX.md` - leer siempre al inicio de una sesión». Abre el archivo y averigua quién soy, cuál es mi tono y qué palabras prohibidas utilizo. 3. En las rutas ve: «plantillas de correo electrónico - `src/lib/email/layout.ts`». Abre el archivo y entiende el formato. 4. Ve: «contexto del producto - `business/products/practicum.md`». Abre el archivo y lee sobre el producto. 5. Ve el marcador LIVE en el archivo y una referencia a `live-metrics.md`. Abre ese archivo y encuentra el SQL listo para ejecutar. Si necesita un número actual, ejecuta la consulta. Si no, anota «obtener este número en el momento del envío». 6. Ve las reglas de tono en `ai-clone/style/telegram-format.md`, la prohibición de usar rayas en `ai-clone/feedback/no-em-dashes.md` y las tasas de conversión del embudo en `business/marketing/funnel.md`. Escribe el correo con mi tono, con cifras actualizadas y sin rayas ni marcadores de IA. Anthropic llama a este enfoque «contexto justo a tiempo» en su blog de ingeniería:
Los agentes creados mediante un enfoque «justo a tiempo» conservan identificadores ligeros (rutas de archivos, consultas guardadas, enlaces, etc.) y usan esos enlaces para incorporar datos al contexto dinámicamente durante la ejecución mediante herramientas.
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents
En otras palabras, Claude lleva consigo referencias a los datos, no los datos mismos. Esto es mucho más eficiente en tokens y mucho más preciso, porque el contexto solo recibe la información pertinente. La ventana queda despejada para razonar. ## 5 anti-patrones del segundo cerebro: ¿qué deberías evitar?
Idea clave Los principales errores que cometen los principiantes con un segundo cerebro: 1) un CLAUDE.md desmesurado, con 500+ líneas, en vez de un enrutador breve; 2) una carpeta comodín que acaba siendo un vertedero; 3) duplicar cosas que Claude ya sabe por el lenguaje o el código; 4) fijar números que quedan obsoletos si no se usa LIVE; 5) dejar el contexto inaccesible al agente o no indicar cómo encontrarlo, tanto en el mismo repositorio como en un almacén privado separado.
Anti-patrón 1. **Un CLAUDE.md desmesurado.** 500 líneas de instrucciones «en vez de ponerlo todo en un solo lugar». Anthropic es tajante:
Que sea breve. Para cada línea, pregúntate: «Si la elimino, ¿Claude empezará a cometer errores?». Si no, bórrala. ¡Los archivos CLAUDE.md demasiado largos hacen que Claude ignore tus instrucciones de verdad!
— Anthropic, code.claude.com/docs/en/best-practices
La longitud objetivo es de 80-120 líneas. Pon todo lo demás en archivos separados y crea rutas hacia ellos. Anti-patrón 2. **Una carpeta comodín.** Lo echas todo al segundo cerebro: conversaciones sin procesar, capturas de pantalla inútiles e informes que nadie leerá. Un mes después, la carpeta ha crecido, el agente desperdicia tokens leyendo material inútil y ya no recuerdas dónde está nada. La regla: cada archivo del segundo cerebro debe responder a una pregunta concreta. Si nadie lo ha abierto en seis meses, elimínalo o pásalo al archivo. Anti-patrón 3. **Duplicación.** «Los pagos pasan por CloudPayments, en `src/lib/payment/cloudpayments.ts`; el proveedor está configurado en `.env`». El agente puede ver todo esto en el código. No lo dupliques en `business/`. Las copias quedan obsoletas: cambia el código, `business/` no se actualiza y el agente trabaja con información desfasada. Anti-patrón 4. **Números fijados.** «Tenemos 1,247 clientes y una conversión del 6.3 %»; imagina que esos números pertenecen a una startup fintech abstracta. Todos quedarán obsoletos en una semana. Usa el marcador LIVE y `live-metrics.md`. La sección sobre este tema está más arriba. Anti-patrón 5. **Contexto sin una ruta accesible.** Si el segundo cerebro está en otro lugar y el agente no tiene permiso ni una referencia, iniciar en la carpeta de código no basta. Para notas compartidas no sensibles, mantener `business/` y `ai-clone/` dentro del repositorio resulta cómodo. Para contexto privado, utiliza una ubicación con control separado y configura expresamente el acceso permitido y cómo encontrarlo. La comodidad de carpetas no prevalece sobre la confidencialidad.
Consejo Una rama independiente (`context` o `business-context`) organiza el trabajo, pero no es un límite de acceso: sus archivos siguen siendo objetos Git del mismo repositorio y pueden publicarse con ramas o historial. Para contexto empresarial privado, usa otro repositorio privado o almacén externo con controles explícitos y navegación permitida al agente. Un submódulo puede apuntar a un repositorio privado, pero la privacidad procede de sus permisos, no del submódulo. Otra opción es una carpeta local ignorada deliberadamente y con respaldo propio; ignorarla no elimina archivos ya seguidos ni historial publicado. Conserva con el código solo el contexto compartible.
## Cómo crear un segundo cerebro en una hora: receta paso a paso
Idea clave Puedes configurar un segundo cerebro mínimo en una hora: crea las carpetas raíz `business/` y `ai-clone/`, prepara un mapa `INDEX.md` en cada una, añade una descripción breve del producto en `business/products/`, una descripción del cliente en `audience/` y una descripción de quién eres en `ai-clone/role.md`. Añade rutas a estas carpetas en `CLAUDE.md`. Después amplíalo mientras trabajas: tras cada error del agente, añade una regla a `ai-clone/feedback/`; después de cada decisión, añade una nota a `business/`.
1. ### Crea dos carpetas raíz En la raíz del proyecto, junto a `src/`: ```bash mkdir -p business/{products,audience,goals,economics,marketing} mkdir -p ai-clone/{identity,voice,principles,feedback,style} ``` 2. ### Crea un INDEX.md como mapa de la carpeta `business/INDEX.md` es una tabla de «pregunta → archivo». Empieza con al menos 5 filas y añade más sobre la marcha. Haz lo mismo en `ai-clone/INDEX.md`. 3. ### Añade descripciones breves del producto y del cliente `business/products/main.md`: qué es el producto, para quién es, cuánto cuesta y qué lo hace diferente. 30-50 líneas. `business/audience/avatar.md`: quién es el cliente, cuáles son sus puntos de dolor y qué compra. 30-50 líneas. No describas a un cliente ideal: describe a uno real. Si no sabes algo, márcalo como «por aclarar» y sigue adelante. 4. ### Descríbete en ai-clone/role.md Quién eres, a qué te dedicas y qué te importa. 20-30 líneas. Basta para empezar. Añade el tono, los principios y las palabras prohibidas cuando notes que el agente escribe con un estilo que no es el tuyo. 5. ### Añade rutas a CLAUDE.md Abre `CLAUDE.md` y añade una sección: ```markdown ## Mapa del proyecto - Contexto empresarial → `business/INDEX.md` - Contexto sobre mí → `ai-clone/INDEX.md` - Planes técnicos → `plans/YYYY-MM-DD-*.md` - Reflexiones sobre sesiones anteriores → `retrospectives/` Lee siempre `ai-clone/INDEX.md` y `business/INDEX.md` al inicio de cada sesión. ``` 6. ### Inicia Claude Code y comprueba Abre el agente. Pregúntale: «cuéntame sobre mi producto y mi público». Si responde usando el contexto de la carpeta, está funcionando. Si inventa cosas, comprueba que las carpetas estén junto al proyecto, que los archivos tengan los nombres correctos y que las rutas en `CLAUDE.md` estén expresadas con precisión. A partir de ahí, el segundo cerebro crece según dos principios. Primero: cada vez que el agente cometa un error, añade una regla. Al cabo de 3-4 semanas, `ai-clone/feedback/` contendrá 15-20 archivos de reglas y el agente dejará de cometer la mayoría de los errores habituales. Segundo: cada vez que tomes una decisión empresarial, regístrala en `business/`. Si subes el precio, añade una nota a `business/products/pricing.md` con la fecha y el motivo. Si cambias el posicionamiento, añade una nota a `business/company/about.md`. Seis meses después, tendrás un archivo que recuerda el «porqué».
Prompt: prompt listo para actualizar el segundo cerebro por la tarde ``` Esta semana hemos hecho bastante trabajo juntos. Analiza todos los cambios de código de esta semana, todos los commits que hemos hecho. ¿Qué información valiosa de esto debería guardarse en business/? Escríbela en los archivos adecuados con enlaces wiki a los archivos cercanos para que no se pierda el contexto. Si hay decisiones en el código que no he explicado, pregúntame por qué y registra el motivo en el archivo correspondiente, indicando la fecha. No dupliques lo que ya resulta evidente en el código. Incluye solo aquello que el agente no sabría en la próxima sesión sin business/. ```
## Qué sigue: Skills, Subagents y context engineering
Idea clave Un segundo cerebro junto con CLAUDE.md es la base. Encima se añaden Skills (conocimiento procedimental que se carga según la descripción de la tarea), Subagents (instancias aisladas de Claude con sus propias ventanas de contexto para tareas exigentes) y context engineering (gestión de lo que entra en la ventana). Son los tres pisos superiores. Sin los cimientos no funcionan: el agente no tiene nada que leer.
Una vez instalado el segundo cerebro, hay tres herramientas más que Anthropic describe como tres niveles distintos de optimización del contexto. **Los Skills** son conocimiento procedimental. Si tienes un flujo de trabajo que repites (escribir una guía de aprendizaje, preparar una publicación de Telegram, auditar un sitio web), puedes codificarlo en un archivo `SKILL.md` con una descripción de la tarea. Al inicio de una sesión, Claude examina los nombres y las descripciones de los Skills y carga solo los que se ajustan a la tarea actual. Esto ahorra tokens y mantiene el enfoque. **Los Subagents** son instancias aisladas de Claude con sus propias ventanas de contexto. Inicia un Subagent para una tarea exigente (leer 30 archivos y preparar un resumen); trabaja en su propia ventana y devuelve solo el resultado. Tu ventana principal se mantiene despejada. Anthropic escribe:
Los Subagents especializados pueden resolver tareas concretas en ventanas de contexto limpias. [...] Cada Subagent puede explorar ampliamente, utilizando decenas de miles de tokens o más, pero devuelve solo un resumen comprimido y destilado de su trabajo (a menudo 1,000-2,000 tokens).
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents
**El context engineering** consiste en gestionar qué entra en la ventana. Anthropic lo llamó una habilidad fundamental para trabajar con agentes en 2025, un nivel por encima del prompt engineering. El prompt engineering consiste en elegir las palabras. El context engineering consiste en elegir archivos, rutas, Skills y Subagents. Un segundo cerebro es el primer componente del context engineering. Sin él, los Skills leen un espacio vacío, los Subagents no tienen adónde ir y la ventana del agente se llena de información aleatoria. Con él, las tres herramientas empiezan a funcionar. **Siguiente paso.** Crea dos carpetas junto al proyecto: `business/` y `ai-clone/`. Añade un `INDEX.md` a cada una con 5 líneas que sirvan de mapa. Añade cuatro líneas de rutas a `CLAUDE.md`. En una hora tendrás un marco funcional para el segundo cerebro. Después, desarróllalo siguiendo la regla «después de cada error del agente, añade una línea a `ai-clone/feedback/`». Explico la plantilla completa de CLAUDE.md que utilizarás para dirigir al segundo cerebro en la guía [Cómo configurar correctamente CLAUDE.md](https://ailoot.ai/blog/es/claude-md-template/).
### Fuentes - [Documentación de Claude Code sobre Memory](https://code.claude.com/docs/en/memory) - jerarquía de memoria oficial de Claude Code, de Anthropic - [Buenas prácticas de Claude Code](https://code.claude.com/docs/en/best-practices) - recomendaciones oficiales para trabajar con CLAUDE.md - [Context engineering eficaz para agentes de IA](https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents) - Anthropic Engineering, explicación de context rot, el presupuesto de atención y el contexto justo a tiempo - [Explicación de Skills](https://claude.com/blog/skills-explained) - blog de Anthropic: diferencias entre Skills, Memory, Subagents y MCP
Sigue descubriendo Ailoot en [ailoot.ai](https://ailoot.ai/). ## Preguntas sobre Claude Code ### ¿Guardar contexto empresarial en otra rama Git lo mantiene privado? No. Una rama forma parte del mismo repositorio y sus archivos pueden compartirse con sus objetos e historial. Usa un almacén privado con control separado o una carpeta local ignorada deliberadamente con respaldo; ignorar una ruta no elimina el historial ya seguido. ### ¿Cómo debe encontrar el agente contexto privado fuera del repositorio de código? Dale una referencia explícita y solo los permisos necesarios para la tarea. Mantén un índice breve hacia el documento pertinente y comprueba que pueda leer el archivo permitido; una ubicación privada sin navegación no aporta contexto automáticamente. ## Ailoot · La empresa y su cartera de proyectos Ailoot se apoya en la experiencia operativa acumulada, una amplia base de clientes, un servicio estable y el seguimiento continuo de KPI. La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes. Ailoot aplica esa experiencia operativa al acceso por API a funciones de IA en productos de clientes, agentes, aplicaciones y automatizaciones.