MemoryLake
Volver a todos los artículos
Pain Point22 de mayo de 20267 min de lectura

¿Por qué Claude olvida mis convenciones de la casa?

Tu equipo acordó las convenciones hace meses. Los repos utilizan carpetas en kebab-case. Las pruebas viven junto al archivo que se está probando. Los mensajes de commit siguen los Conventional Commits. Las migraciones van en `db/changes`. Le enseñaste todo esto a Claude. Hoy sugirió `src/Tests/`, un mensaje de commit en Title Case y una migración en `prisma/migrations`. Lo corregiste. Dos chats después hizo lo mismo.

Esto no es Claude siendo terco. Es lo que sucede cuando las reglas del equipo viven dentro de un solo chat en lugar de en una capa compartida.

La respuesta corta

Claude olvida tus convenciones de la casa porque las convenciones viven en instrucciones por Proyecto (un Proyecto a la vez), archivos CLAUDE.md por repos (solo Claude Code, local a la máquina) y correcciones por chat (desaparecen al final de la sesión). No hay un objeto "casa" compartido que cada Claude de los compañeros de equipo lea, por lo que cada contribuyente vuelve a enseñar las mismas reglas. Una capa de memoria fijada por encima de Claude lo soluciona.

Por qué Claude olvida las convenciones de la casa

Tres cosas rompen la memoria de convenciones.

1. Las convenciones están limitadas a un Proyecto o un repositorio. Los Proyectos de Claude.ai mantienen sus instrucciones para sí mismos. Los archivos CLAUDE.md viven dentro de un repositorio. Si te mueves a un repositorio hermano o a un Proyecto hermano, las convenciones desaparecen. Tu equipo tiene docenas de repositorios y un puñado de Proyectos, por lo que las reglas se fragmentan rápidamente.

2. La memoria automática no sale del terminal. La memoria automática de Claude Code escribe notas sobre tus preferencias mientras trabaja, pero esas notas viven en la carpeta de memoria local en la máquina que ejecutó Claude Code. No se sincronizan entre contribuyentes, máquinas o a claude.ai en un navegador.

3. La deriva de convenciones se acumula en chats largos. Incluso con convenciones pegadas en un Proyecto, los chats largos resumen las reglas. El modelo mantiene el espíritu ("usar kebab case") y pierde los detalles ("kebab case para carpetas, snake_case para migraciones"). Las excepciones sutiles son las primeras en desaparecer.

El efecto neto: cada compañero de equipo enseña a Claude las mismas convenciones, y las reglas aún se desvían en medio de la sesión.

Lo que pierdes cuando Claude olvida las convenciones de la casa

Las convenciones perdidas parecen pequeñas de forma aislada y dolorosas a gran escala:

  • La revisión de PR se vuelve de limpieza. Los revisores pasan la mitad de su tiempo corrigiendo nombres de carpetas y formatos de mensajes de commit en lugar de detectar errores reales.
  • CI falla en diferencias solo de estilo. Las migraciones caen en la carpeta equivocada, los lints detectan importaciones prohibidas y los pipelines se rompen por razones que nunca debieron haber ocurrido.
  • La incorporación de nuevos compañeros de equipo toma más tiempo. Los nuevos empleados heredan chats que aún están enseñando a Claude las mismas convenciones que escribiste hace un año.

Soluciones integradas de Claude

Anthropic ofrece dos respuestas reales pero parciales.

Instrucciones del Proyecto y conocimiento del proyecto en claude.ai te permiten fijar convenciones a un Proyecto. También puedes subir tu manual del equipo o documento de reglas al conocimiento del proyecto, y Claude lo lee a través de Generación Aumentada por Recuperación cuando el contenido supera la ventana de contexto. La propia guía de Anthropic sobre Proyectos y conocimiento del proyecto vale la pena leer. El límite es el mismo de siempre: un Proyecto, una cuenta, sin compartir a nivel de equipo sin copiar y pegar.

Archivos CLAUDE.md en Claude Code llevan reglas específicas del repositorio y se leen al inicio de cada sesión. Son excelentes para el terminal. Son invisibles para claude.ai, para compañeros de equipo que no usan Claude Code y para otras herramientas de IA que usa tu equipo.

Estas son buenas localmente y débiles a gran escala.

Dónde falla la memoria integrada de Claude

Las convenciones de la casa son un artefacto del equipo, no una preferencia por Proyecto. Se aplican a cada repositorio, cada chat, cada compañero de equipo, cada herramienta de IA que toca el equipo. El modelo de memoria de Claude está construido en torno a un alcance por Proyecto y por cuenta, lo que garantiza la fragmentación en el momento en que más de una persona o herramienta entra en la imagen.

La solución más limpia es elevar las convenciones un nivel por encima de Claude, a una capa de memoria compartida que cada sesión de Claude (y cada sesión de Cursor, ChatGPT o Gemini) pueda leer.

Cómo MemoryLake soluciona que Claude olvide las convenciones de la casa

MemoryLake mantiene tus convenciones de la casa como una fuente de verdad compartida y versionada.

  • Un Proyecto de reglas compartido para todo el equipo. Cada Claude de los compañeros de equipo lee del mismo Proyecto de MemoryLake. Actualiza una regla una vez y el siguiente chat en cualquier lugar la utiliza.
  • Las convenciones sobreviven a chats largos. MemoryLake recupera solo las reglas relevantes para el archivo o tarea actual y las reinserta a medida que la conversación crece, por lo que la resumación deja de eliminar detalles.
  • Aplicación de convenciones entre herramientas. Cursor, Windsurf, Claude Code y ChatGPT leen todas las mismas reglas. No más vigilancia de estilo contribuyente por contribuyente en los PRs.

MemoryLake obtuvo un 94.03% en el benchmark de contexto largo LoCoMo, el mejor resultado publicado hasta 2026, con recuperación en milisegundos y cifrado de extremo a extremo AES-256.

Conectar MemoryLake a Claude en 3 pasos

  1. Crea un Proyecto y carga las reglas de la casa. Inicia sesión en MemoryLake, abre Gestión de Proyectos, haz clic en Crear Proyecto y nómbralo "Convenciones de la casa". Sube tu guía de contribución, configuración de lint, ADRs y ejemplos de PR a través del Document Drive, luego agrega las reglas de mayor fricción (estructura de carpetas, formato de commit, ubicación de migraciones) como entradas nombradas en la pestaña de Memorias.
  2. Genera un endpoint del servidor MCP. Abre la pestaña de Servidores MCP dentro del proyecto, haz clic en Agregar Servidor MCP, nómbralo "Integración del equipo Claude" y haz clic en Generar. Copia el ID de clave API, secreto y URL del endpoint: el secreto aparece solo una vez.
  3. Conecta a Claude. En Claude Desktop o Claude Code, agrega la entrada del servidor MCP a la configuración local con el endpoint y el token Bearer, luego reinicia. Para claude.ai en el navegador, pega una sola línea en las instrucciones de cada Proyecto que apunte a tu ID de proyecto de MemoryLake, y la API REST hidrata las reglas por turno para cada compañero de equipo.

Preguntas frecuentes

¿Claude recuerda las convenciones del equipo entre proyectos?

No. Las instrucciones del Proyecto y CLAUDE.md están limitadas a un Proyecto o un repositorio. No hay un concepto nativo de un almacén de convenciones a nivel de cuenta o de equipo.

¿Cómo hago que Claude siga las reglas de la casa de nuestro equipo cada vez?

O bien pega las reglas en cada Proyecto y repositorio, o conecta a Claude a una capa de memoria compartida como MemoryLake para que un Proyecto de reglas fluya a los chats de cada compañero de equipo, en claude.ai, Claude Code, Cursor y más.

¿Por qué Claude sigue ignorando mi CLAUDE.md?

Generalmente por una de tres razones: el archivo es demasiado grande y la regla relevante fue resumida, el archivo vive en un directorio padre que Claude Code no escaneó, o estás trabajando en claude.ai que no lee CLAUDE.md en absoluto.

¿Puede todo un equipo de ingeniería compartir las mismas convenciones de Claude?

No de forma nativa. Las instrucciones del Proyecto de cada compañero de equipo y la memoria de Claude Code son locales a su cuenta o máquina. MemoryLake convierte las reglas en un Proyecto compartido del que cada sesión de Claude lee.

¿Cuál es la diferencia entre las instrucciones del Proyecto y el conocimiento del proyecto en Claude?

Las instrucciones son directrices cortas que acompañan cada chat. El conocimiento del proyecto son archivos subidos que Claude puede buscar a través de RAG cuando el contenido excede la ventana de contexto. Ambos son por Proyecto y por cuenta.