Un Sistema para que Claude Code Aprenda Tu Proyecto con el Tiempo
Un desarrollador en r/ClaudeAI compartió un sistema para abordar la falta de contexto persistente de Claude Code entre sesiones. En lugar de comenzar desde cero cada vez, esta configuración ayuda a Claude a aprender las convenciones, arquitectura y errores pasados de tu proyecto.
El Problema y la Solución
Al usar Claude Code, cada nueva sesión pierde todo el contexto anterior. Claude vuelve a leer archivos que ya entendió, repite errores corregidos e ignora patrones establecidos, lo que requiere una reexplicación constante.
La solución implica agregar algunos archivos a cualquier repositorio:
CLAUDE.md- Un breve conjunto de reglas que le indican a Claude cómo comportarse. Los ejemplos incluyen "preguntar antes de proceder si algo no está claro" y "no ejecutes las pruebas tú mismo, dime qué ejecutar en su lugar" (lo que ahorra dinero al evitar el desperdicio de tokens en la búsqueda de errores).- Carpeta
docs/- Contiene archivos cortos (5-10 líneas cada uno) que capturan convenciones, patrones y arquitectura del proyecto, organizados en subcarpetas. Un archivo de índice (docs/README.md) ayuda a Claude a encontrar rápidamente el documento correcto en lugar de adivinar.
Tres Prompts Clave
- bootstrap - Se pega una vez al adoptar una base de código existente. Claude lee tu código y escribe la documentación inicial.
- refine - Se pega al final de una sesión. Claude reflexiona sobre lo que sucedió y actualiza la documentación con nuevos aprendizajes.
- factory - Se pega cuando Claude hace algo que quieres repetir. Captura el patrón como un prompt reutilizable.
El Ciclo de Trabajo
El proceso crea un ciclo de aprendizaje continuo: programas con Claude → la sesión termina → pegas el prompt refine → Claude actualiza la documentación → haces commit → la siguiente sesión comienza más inteligente. Dado que la documentación vive en git, todos en tu equipo se benefician de ella, y funciona con cualquier stack tecnológico.
Consejos Prácticos de la Implementación
- Indícale explícitamente a Claude que no ejecute comandos de compilación/prueba para evitar quemar tokens persiguiendo errores. En su lugar, haz que te diga qué comandos ejecutar.
- Usa números específicos en las reglas (por ejemplo, "pausa si cambias 3+ archivos") en lugar de términos vagos como "pausa para tareas complejas", ya que Claude pierde tiempo interpretando la ambigüedad.
- Un archivo de índice para tu carpeta docs se paga de inmediato al evitar que Claude abra archivos al azar con la esperanza de encontrar información relevante.
El sistema es gratuito y de código abierto, disponible en saas-vibe.
📖 Read the full source: r/ClaudeAI
👀 Ver también
Un patrón para ejecutar Claude Code en sesiones nocturnas desatendidas sin desviación
Un marco de tres piezas — ejecutor en cadena, supervisor y un único contrato de traspaso — resuelve el problema de deriva del bucle de retroalimentación en sesiones autónomas de Claude Code de varias horas.
Cerebro: Un Sistema de Memoria de Errores Persistente para Claude Code mediante MCP
Brain es un servidor MCP de código abierto que le proporciona a Claude Code memoria persistente y entre proyectos para errores y soluciones. Captura el contexto de los errores, sugiere correcciones probadas con puntuaciones de confianza y construye una red de sinapsis ponderada que conecta errores, soluciones y módulos de código en todos los proyectos.
alogin: Una Puerta de Enlace de Seguridad Basada en Go para Agentes de IA con Participación Humana
alogin es una puerta de enlace de seguridad de código abierto basada en Go que proporciona un conducto seguro entre agentes de IA e infraestructura, con soporte integrado de servidor MCP para Claude Desktop, barreras de seguridad con intervención humana y almacenamiento cifrado de credenciales.
Mike: IA legal de código abierto con autoalojamiento y soporte multimodelo
Mike es una alternativa de código abierto a Harvey y Legora, que ofrece chat de documentos, extracción tabular y plantillas de flujo de trabajo, todo autogestionable con tus propias claves API de Claude o Gemini.