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.