Contenido detallado
🧠 Los tres niveles de memoria
La idea es simple: cuanto más contexto adecuado tenga Claude sobre ti y tu proyecto, mejores serán las respuestas y el código. Pero no todos los datos son iguales: algunos cambian todo el tiempo y otros casi nunca. Por eso dividimos la memoria en tres niveles, cada uno con una "tasa de cambio" diferente.
El modelo mental de memoria a corto, mediano y largo plazo, y cómo encajan las tres en un solo sistema.
Sin este mapa, las personas ponen todo en la conversación y sufren con respuestas que empeoran. Con él, sabes dónde cada información tiene su lugar.
Corta = sesión · Mediana = CLAUDE.md · Larga = base de conocimiento en disco · cada nivel tiene su propia tasa de cambio.
Corta — el ahora
Lo que dijiste en esta conversación. Vive dentro de la sesión; desaparece al abrir un chat nuevo. Cambia todo el tiempo.
Media: el manual del proyecto
Un CLAUDE.md en la raíz de la carpeta dice qué es el proyecto, el objetivo, el stack y las decisiones. Cambia a veces, pero mantiene cierta estabilidad.
Larga — el archivo muerto vivo
Notas, decisiones y aprendizajes guardados en disco para consultarlos meses después. Casi nunca cambia; solo crece.
🏢 Analogía de la oficina
A memoria a corto plazo es lo que está disperso sobre tu escritorio ahora. El CLAUDE.md es el tablero fijo en la pared con las reglas del proyecto: quien entra a la sala las lee primero. La base de conocimiento es el archivo de cajones que tienes detrás: no lo consultas todo el tiempo, pero sabes dónde encontrar las cosas.
⭐ La regla de oro
El mejor sistema de memoria es aquel que no exige que estés en un chat específico para funcionar. Si abres una conversación nueva desde cero, Claude debería rendir casi igual, porque lo que importa está escrito en un archivo, no atrapado en la conversación anterior.
⏱️ Memoria corta y context rot
La memoria a corto plazo es el estado de la conversación actual más lo básico sobre ti. Es el nivel más frágil: desaparece con cada chat nuevo. Y tiene un efecto engañoso: cuando la conversación se alarga demasiado, la calidad baja. Es el deterioro del contexto. Por eso, empezar de nuevo es saludable, no un desperdicio.
El estado de la conversación actual más instrucciones generales sobre ti.
Es el nivel más frágil: saberlo evita frustraciones y te enseña cuándo empezar de nuevo.
Contexto de sesión · instrucciones generales · deterioro del contexto (la calidad baja cuando la conversación se alarga demasiado).
✓ Conversación concisa
- ✓Enfócate en un tema a la vez: respuestas precisas.
- ✓Vuelve a empezar sin miedo cuando cambies de tema.
- ✓El contexto duradero ya está en un archivo, no en la conversación.
✗ Sesión eterna
- ✗Meter todo en un solo chat; la calidad va bajando.
- ✗Creer que una conversación larga = más memoria (es lo contrario).
- ✗Lo pierdes todo cuando se cierra el chat, sin nada guardado.
💡 Consejo práctico
Cuando sientas la conversación «pesada» o notes respuestas peores, abre un chat nuevo. Si tu CLAUDE.md y la base de conocimiento están en orden, no pierdes nada: empezar de nuevo es parte del método.
🪣 Organiza tu vida en "cubos"
Antes de escribir un CLAUDE.md, necesitas dónde colocarlo. La base de la memoria mediana es dividir todo lo que haces en 5–8 grandes áreas: las cubetas (buckets) — y convertir cada uno en una carpeta.
Dividir tus frentes de trabajo en 5–8 grupos, cada uno convertido en una carpeta en la computadora.
Es la base de la memoria media. Sin cajones, no hay dónde guardar un CLAUDE.md.
Bucket = clúster de proyectos relacionados · una carpeta por bucket · empieza de forma sencilla (pessoal, cliente-x, estudos).
Pídele a Claude que organice
Usa el prompt de categorías (sección Prompts) para agrupar tus actividades en 5–8 áreas.
Crea una carpeta por cada cubo
En tu computadora, una carpeta con un nombre claro para cada categoría.
Reserva un depósito pessoal
Siempre ten un contenedor para tus propios datos y documentos.
💡 Consejo práctico
No busques la taxonomía perfecta. Empieza con pocas categorías amplias y ajústalas después: es más fácil dividir una categoría grande que juntar diez pequeñas.
📋 CLAUDE.md — el manual del proyecto
O CLAUDE.md es un archivo en la raíz de cada carpeta que le explica el proyecto a Claude. Solo uno por carpeta, breve (~200 palabras). Claude lee este archivo automáticamente al abrir la carpeta: se convierte en tu "estrella guía". Es el corazón de la memoria media.
Un archivo CLAUDE.md en la raíz de la carpeta, breve, que describe el proyecto a Claude.
Es el corazón de la memoria media. Al leerse automáticamente, se convierte en la referencia fija de todo el trabajo en la carpeta.
Qué es la carpeta · objetivo (north star) · stack · decisiones fijas · mapa de memoria · referencias. Las decisiones se convierten en reglas (p. ej., «nada de publicaciones generadas por IA»).
Plantilla de CLAUDE.md (listo para copiar)
# CLAUDE.md — <nome do projeto> ## O que é esta pasta <Uma frase: o que vive aqui e para quê.> ## Objetivo (north star) <O resultado que este projeto persegue. Toda decisão é medida contra isto.> ## Stack <Ferramentas, linguagens, serviços usados. Ex.: Next.js, Stripe, Supabase.> ## Decisões fixas - <Decisão 1 — ex.: tudo em português.> - <Decisão 2 — ex.: sem dependências pesadas.> - <Decisão 3 — ex.: nada de conteúdo gerado por IA sem revisão.> ## Mapa de memória - Base de conhecimento: ./conhecimento/ - Subpastas por tema: <ex.: decisoes, notas, referencias> ## Memória (memory save) Quando eu pedir para salvar/lembrar uma conversa, grave o essencial em ./conhecimento/ na subpasta mais relacionada ao tema. ## Referências - <link ou caminho de algo importante.>
Copia la plantilla
Usa el bloque de arriba como punto de partida.
Completa el objetivo, el stack y las decisiones
Específico de cada categoría. Guárdalo como CLAUDE.md en la raíz de la carpeta.
Pídele a Claude que te entreviste
Hace 3–5 preguntas y completa lo que falta, manteniendo el archivo corto.
✂️ Mantenlo conciso
Apunta a ~200 palabras — algo que quepa en una pantalla. Si crece demasiado, mueve los detalles a la base de conocimientos. El CLAUDE.md guarda «el proyecto hoy», no el historial.
🗄️ Memoria a largo plazo: la base que crece
La memoria a largo plazo son notas y decisiones guardadas en archivos de texto (markdown) que consultas en el futuro. El CLAUDE.md se ocupa de «cómo es el proyecto hoy»; la base de conocimiento guarda el el historial y los aprendizajes.
Notas y decisiones en archivos markdown interconectados, organizados en subcarpetas por tema.
Es la memoria institucional del proyecto: lo que decidiste y aprendiste, disponible meses después.
Markdown interconectado · subcarpetas por tema · editable a mano · herramientas como Obsidian solo visualizan los archivos (son opcionales).
✓ Va a la memoria a largo plazo
- ✓Decisiones importantes (con fecha y motivo).
- ✓Frameworks y aprendizajes que sirven durante meses.
- ✓Referencias y notas que querrás volver a leer.
✗ NO va ahí
- ✗Toda la conversación copiada y pegada.
- ✗Detalles del día que cambian a cada rato.
- ✗Cosas que pertenecen a
CLAUDE.md(el "hoy").
🔭 Obsidian es opcional
La base de conocimiento son solo archivos .md en carpetas: no necesitas ninguna app. Herramientas como Obsidian solo visualizan y conectan estos archivos; el contenido sigue siendo tuyo, en texto, en el disco.
💾 «memory save»: registra lo que importa
O memory save es una rutina: cuando pides «guarda esto», Claude registra lo esencial de la conversación en la carpeta correcta de la base. Convierte buenas conversaciones en conocimiento permanente: sin copiar y pegar manualmente. Es lo que cierra el ciclo entre los tres niveles.
Una rutina en la que, cuando pides «guárdalo», Claude guarda lo esencial en la carpeta correcta de la base.
Convierte buenas conversaciones en conocimiento duradero, sin trabajo manual.
Sección de memoria en CLAUDE.md · elegir la subcarpeta correcta · guardar solo lo que tiene valor duradero (decisiones, frameworks).
Agrega la sección al CLAUDE.md
Di dónde guarda cuando lo pidas (usa la sección "Memoria" de la plantilla).
Indica la ruta de la base
Ej.: ./conhecimento/ con subcarpetas por tema.
Pídele a Claude que elija la subcarpeta
Según el tema de la conversación, y guarda solo decisiones y aprendizajes duraderos.
Profundiza (opcional): por qué empezar de nuevo no implica perder nada
Con CLAUDE.md + base de conocimiento bien organizada, abrir un chat nuevo es seguro: lo importante está en archivos, no en la sesión. Evitas el deterioro del contexto y mantienes un rendimiento estable. La memoria no puede depender de la conversación anterior: esa es la prueba final del sistema.
Autoevaluación (opcional): ¿dónde vive la «estrella guía» que Claude lee automáticamente al abrir una carpeta?
✏️ Ejercicios
1. Mapea tus cubetas (fácil)
Enumera de 5 a 8 áreas de tu vida/trabajo. Criterio: cada cubeta es un área distinta, sin grandes superposiciones.
2. Crea uno CLAUDE.md de verdad (medio)
Elige un proyecto real y escribe un CLAUDE.md de un máximo de ~200 palabras. Criterio: tiene objetivo, stack y al menos 2 decisiones; cabe en una pantalla.
3. Prueba del chat nuevo (medio)
Abre una conversación desde cero y pídele a Claude que resuma el proyecto solo con el CLAUDE.md. Criterio: el resumen coincide con lo que escribiste, sin agregar contexto.
4. Guarda en la base de conocimientos (medio)
Crea una subcarpeta conhecimento/ y registra 1 decisión en markdown. Criterio: el archivo existe, tiene fecha y está en la carpeta correcta.
5. Simplifica (medio)
Vuelve a leer tu CLAUDE.md y elimina todo lo que no sea duradero. Criterio: nada de detalles de la conversación del día; solo lo que sigue siendo válido por semanas/meses.
⌨️ Prompts listos
Estos prompts ponen en práctica tu memoria a mediano y largo plazo. Cópialos, ajústalos a tu contexto y ejecútalos en Claude Code. La base de datos completa está en la Biblioteca → Prompts.
Organizar en baldes (canónico)
Con base en todo lo que sabes sobre mí y en lo que trabajo, organiza mi vida en 5 a 8 «categorías». Cada proyecto debe quedar en una categoría. No inventes datos: si falta información, pregúntame. Sin rodeos.
Original (EN):
Based on everything you know about me and everything I work on, organize my life into 5 to 8 buckets. Put any project into one of those buckets. Don't invent facts — ask me if something is missing. No fluff.
Aplicar el CLAUDE.md en cada carpeta
Agrega un archivo CLAUDE.md en la raíz de cada una de las carpetas de los baldes, usando la plantilla que te voy a pasar. Después, hazme preguntas sobre cada proyecto para completar el briefing. Un solo CLAUDE.md por carpeta.
Guardar en la memoria a largo plazo ("memory save")
Cuando te pida guardar, conservar, cerrar o recordar una conversación, registra lo esencial en markdown en mi base de conocimientos, en la subcarpeta más relacionada con el tema. Guarda solo decisiones y aprendizajes duraderos, no toda la conversación.
Plantilla de CLAUDE.md (lista para copiar)
# CLAUDE.md — <nome do projeto> ## O que é esta pasta <Uma frase: o que vive aqui e para quê.> ## Objetivo (north star) <O resultado que este projeto persegue. Toda decisão é medida contra isto.> ## Stack <Ferramentas, linguagens, serviços usados. Ex.: Next.js, Stripe, Supabase.> ## Decisões fixas - <Decisão 1 — ex.: tudo em português.> - <Decisão 2 — ex.: sem dependências pesadas.> - <Decisão 3 — ex.: nada de conteúdo gerado por IA sem revisão.> ## Mapa de memória - Base de conhecimento: ./conhecimento/ - Subpastas por tema: <ex.: decisoes, notas, referencias> ## Memória (memory save) Quando eu pedir para salvar/lembrar uma conversa, grave o essencial em ./conhecimento/ na subpasta mais relacionada ao tema. ## Referências - <link ou caminho de algo importante.>
Consejo: mantén el CLAUDE.md alrededor de ~200 palabras. Si crece, mueve los detalles a la base de conocimiento.
⚠️ Errores comunes
- ✗Dejar todo en la conversación. Confiar en la memoria a corto plazo y perder el contexto al abrir un chat nuevo. Corrige: escribe lo que importa en el
CLAUDE.md. - ✗
CLAUDE.mdgigante. Llenar de detalles que cambian todo el tiempo. Corrige: mantén ~200 palabras; el resto va a la base. - ✗Más de uno
CLAUDE.mdpor carpeta. Genera confusión sobre cuál lee Claude. Corrige: solo uno por carpeta, en la raíz. - ✗Guardar basura en la memoria a largo plazo. Volcar toda la conversación en la base de datos. Corrige: guarda solo decisiones y aprendizajes duraderos.
- ✗Mantener una sesión interminable. Creer que una conversación larga = más memoria. Corrige: empieza de nuevo sin miedo; el sistema en archivos conserva el contexto.
✅ Resumen del módulo
CLAUDE.md) y extensa (base de conocimiento); cada una con su propia tasa de cambio.CLAUDE.md conciso por carpeta.Lista de verificación de finalización
- ☐ Definí de 5 a 8 baldes para mi vida/trabajo.
- ☐ Creé una carpeta por cada balde.
- ☐ Cada carpeta tiene uno
CLAUDE.mden la raíz, con ~200 palabras. - ☐ Cada
CLAUDE.mdincluye objetivo, stack y al menos 2 decisiones. - ☐ Probé un chat nuevo y Claude resumió el proyecto solo con
CLAUDE.md. - ☐ Creé la subcarpeta
conhecimento/y guardé al menos 1 decisión. - ☐ Añadí la sección de "memory save" a
CLAUDE.md.
Siguiente módulo:
1.4 — Funciones avanzadas: recursos para aprovechar mejor Claude Code