PlainSkillsZero0

Lista de comprobación de CLAUDE.md: 10 puntos antes de fiarte

CLAUDE.md es el archivo que Claude Code lee al empezar cada sesión para saber cómo funciona tu proyecto. Uno flojo es fácil de escribir y difícil de notar. Usa estos diez puntos.

Basada en nuestro uso diario y en la página oficial de Anthropic sobre la memoria (en inglés), code.claude.com/docs/en/memory. Mírala para los detalles actuales.

  1. ¿Es corto?

    La guía de Anthropic es no pasar de unas 200 líneas por archivo. Los largos gastan más contexto y hacen menos probable que se cumpla cada regla. Si una regla vale solo para una carpeta, ponla en una regla por rutas en vez de en el archivo principal.

  2. ¿Se puede comprobar cada regla?

    «Ejecuta npm test antes de hacer commit» se puede verificar. «Prueba tus cambios» no. Reescribe cada línea vaga hasta que, viendo el resultado, sepas si se cumplió.

  3. ¿Son reales los comandos?

    Copia los comandos de compilar, probar y revisar del README o de la integración continua y ejecuta cada uno una vez. Un comando erróneo en CLAUDE.md se sigue al pie de la letra.

  4. ¿Se contradice alguna regla?

    Si dos instrucciones chocan, Claude puede escoger una al azar. Busca «siempre» y «nunca» y lee esas líneas juntas.

  5. ¿Hay un mapa de dónde está cada cosa?

    Una línea por carpeta importante («los manejadores de la API viven en src/api/handlers/») evita que el asistente adivine y te ahorra tokens.

  6. ¿Dice qué no tocar, y se hace cumplir en otro sitio?

    CLAUDE.md es contexto, no configuración que se imponga: pide, no bloquea. Para lo que nunca debe pasar, usa permisos o un hook, no solo una frase en este archivo.

  7. ¿Está libre de secretos?

    Es texto plano y a menudo se sube al repositorio. Ninguna clave, token, contraseña ni dato personal, nunca. Indica dónde se guarda el secreto en vez de copiarlo.

  8. ¿Está ordenado?

    Agrupa reglas relacionadas bajo títulos cortos y viñetas. Las secciones ordenadas se siguen mejor que los párrafos densos.

  9. ¿Sabes qué se cargó de verdad?

    Ejecuta /context en una sesión y mira la lista en «Memory files». Si falta un archivo que esperabas, esa es la primera pista.

  10. ¿Cuándo lo revisaste por última vez?

    Una regla caducada es peor que ninguna. Pon un recordatorio mensual y borra una línea cada vez que añadas otra.

¿Quieres ir más rápido? /init genera un primer CLAUDE.md a partir de tu código; refínalo con lo que Claude no puede descubrir solo.

Gratis y de código abierto: Loop-Stop, una skill que da a una tarea larga un encargo, un límite y una regla de parada. Para este mismo trabajo ya hecho, el Tune-Up Kit revisa tu CLAUDE.md y tus permisos y el Project Starter Kit trae 10 plantillas de CLAUDE.md (las fichas están en inglés; la tienda tiene versión en español de los packs principales). Son archivos de texto plano que lees y adaptas; los probamos a mano pero no hemos medido resultados en otros proyectos y no prometemos ninguno.