IA:Memoria Persistente claude.md

Descripción

El claude.md es un archivo de configuración que se coloca en un repositorio para indicarle a Claude (el modelo de IA de Anthropic) cómo debe comportarse cuando interactúa con ese proyecto. Funciona como una “guía persistente”: define el tono, las reglas, el estilo de respuesta, el contexto del proyecto y cualquier instrucción que quieras que Claude tenga siempre presente al analizar o generar contenido relacionado con ese repositorio. Es, en esencia, una forma de personalizar la IA para que entienda tu entorno de trabajo sin que tengas que repetir instrucciones cada vez.

También sirve para mejorar la coherencia y la calidad del trabajo con IA en equipos: puedes usarlo para establecer convenciones de código, estándares de documentación, políticas de seguridad, formatos de commit, estilos de escritura o incluso restricciones sobre qué puede o no puede hacer la IA dentro del proyecto. Así, Claude se convierte en una herramienta más integrada en tu flujo de desarrollo. Si quieres, puedo mostrarte ejemplos de estructura típica de claude.md o ayudarte a crear uno para tu proyecto.

Escribir instrucciones efectivas en CLAUDE.md

Todo lo que escribas en CLAUDE.md consume tokens de la ventana de contexto de Claude. Cada línea compite por atención con tu conversación real y con el código que Claude está leyendo.

Un CLAUDE.md inflado no solo desperdicia tokens: reduce la calidad de las respuestas porque Claude tiene más instrucciones que seguir y las sigue de forma menos consistente.

La regla es simple: incluye solo lo que causaría errores si faltara. Todo lo demás es ruido.

Tamaño recomendado

Apunta a un máximo de 200 líneas por archivo CLAUDE.md. Si tus instrucciones crecen más allá de eso, es señal de que necesitas dividirlas usando importaciones @ o archivos en .claude/rules/ (lo veremos en la siguiente clase).

Qué incluir

Incluye instrucciones que Claude no podría descubrir solo leyendo tu código, o que si las descubriera por su cuenta, llevaría demasiado tiempo:

• Comandos exactos de build, test y lint — Claude los ejecutará literalmente
• Decisiones de arquitectura que afectan cómo se escribe el código
• Convenciones de código específicas de tu proyecto
• Variables de entorno necesarias y servicios requeridos
• Trampas comunes o patrones que Claude debe evitar
• Estructura de monorepo y qué paquete es responsable de qué

Qué NO incluir

• Cosas que Claude ya sabe (sintaxis estándar de TypeScript, APIs comunes)
• Recordatorios obvios ("escribe código limpio", "añade comentarios")
• Guías de estilo extensas que un linter puede enforcar automáticamente
• Documentación completa de APIs externas (mejor referenciar con @)

Consejo avanzado: "Nunca envíes a un LLM a hacer el trabajo de un linter." Los LLMs son comparativamente caros y lentos frente a herramientas deterministas como ESLint o Prettier. Si tu código sigue ciertas guías de estilo, Claude tenderá a seguir los patrones existentes gracias al aprendizaje en contexto, sin que se lo digas explícitamente. Considera usar un Hook de Claude Code que ejecute tu formatter/linter automáticamente (lo veremos más adelante en el curso)

Cómo escribir las instrucciones

Usa imperativos, no sugerencias:

Sé específico y verificable:

Usa IMPORTANT o YOU MUST con moderación para reglas críticas:

• IMPORTANT: Nunca modificar el directorio src/db/migrations/ directamente. Siempre crear una nueva migración.
• YOU MUST ejecutar `npm run typecheck` antes de considerar un cambio completo

Si todo está marcado como IMPORTANT, nada lo es. Reserva el énfasis para 2-3 reglas que, si se ignoran, causan problemas graves.

Estructura con Markdown

Usa headers y bullets para organizar. Claude escanea la estructura igual que un lector humano: secciones organizadas son más fáciles de seguir que párrafos densos.

IA : Prompts : Claude : Copilot Memoria