Claude Code: limpia tu CLAUDE.md con /doctor prompt-audit

/doctor prompt-audit es un comando que ya viene dentro de Claude Code. Revisa todo lo que tú le das a Claude como instrucciones —el archivo CLAUDE.md (el de la carpeta principal y los de dentro de cada subcarpeta), tus skills, tus subagentes y tus comandos propios— y te dice qué frases se escribieron para modelos de hace uno o dos años y ya no hacen falta.

No es invento de un youtuber: lo añadió el propio equipo de Claude Code en la versión 2.1.283 (finales de septiembre de 2026) y aparece en su documentación, dentro de /doctor.

El nombre viene de ahí: es como meter tu CLAUDE.md en una lavandería («CLAUDE.md WASH», lo llama el vídeo).

Porque esas instrucciones viejas no solo sobran: estorban. Se escribieron para modelos que no hacían mucho caso, así que están a gritos («CRITICAL», «SIEMPRE», «NUNCA») y con los pasos explicados uno a uno. Los modelos nuevos siguen las instrucciones al pie de la letra: esa misma letra les hace dar más vueltas, gastar más y responder peor en los casos dudosos.

Lo que te llevas al lanzarlo:

• Una lista de lo que sobra, con el fichero y la línea, por qué ya no hace falta y con cuánta seguridad lo dice.
• Una propuesta de cambios (el texto que quitaría o cambiaría). Nada se cambia hasta que tú lo apruebas.
• Si tu archivo está bien, no te propone nada — y eso también es un buen resultado, no un fallo.

• Actualiza Claude Code. El comando necesita la versión 2.1.283 o más nueva. En la terminal: claude update. Comprueba cuál tienes con claude --version.
• Abre Claude Code en la carpeta de tu proyecto, donde está tu CLAUDE.md.
• Escribe el comando /doctor prompt-audit y pulsa Intro. (También vale /checkup prompt-audit.) Si quieres que mire solo un archivo, díselo: /doctor prompt-audit ./CLAUDE.md.
• Espera y lee el informe. Primero te dice qué va a revisar y luego cada hallazgo: el fichero, el patrón que ha encontrado («mayúsculas de más», «revisa tu trabajo dos veces», «pasos uno a uno») y por qué es de otra época.
• Mira los cambios que propone y decide. Es una propuesta: aplica lo que te convenza y deja lo que no. Las reglas que solo conoces tú (tu entorno, tus datos, tus normas) se conservan.
• Si te da respeto el cambio, ve por partes: lánzalo sobre un solo archivo (/doctor prompt-audit ./skills/mi-skill) y así ves el resultado antes de tocar el resto.

El vídeo termina diciendo «comenta AUDIT y te mando el comando y la guía desde la bóveda». No hace falta comentar nada ni darle tus datos a nadie: el comando ya está dentro de Claude Code y es gratis. Pedir un comentario para mandarte algo que ya está instalado es una forma de llenarse de mensajes.

Lo comprobado el 5 de octubre de 2026:

• Necesita la versión 2.1.283 o más nueva (y la revisión del CLAUDE.md a secas pide la 2.1.206). Si no actualizas, el comando no aparece y parece que no existe.
• No «te lo arregla solo». Te enseña lo que sobra y te propone los cambios; el que decide eres tú. No es un detalle menor: borrar a lo loco es la única forma de que una limpieza así te deje el archivo peor.
• No va de hacer el archivo corto. Busca frases concretas que ya no sirven. Un archivo largo que explica cosas que solo sabe tu equipo está bien así.
• Lo que hay que conservar: tu entorno (carpetas, servidores, cuentas), tus reglas del negocio, los motivos que hay detrás de cada regla y las trampas de verdad, porque eso el modelo no lo adivina.
• El vídeo habla de Opus 5.5 (el modelo que salió el 22 de septiembre de 2026). Es cierto que los modelos nuevos siguen las instrucciones mucho más al pie de la letra que los de hace un año: por eso lo que antes ayudaba ahora molesta.

1. Dice que el comando no existe o no aparece en la lista. Es la versión. Escribe claude update en la terminal y luego claude --version; tienes que ver 2.1.283 o más. Con una versión vieja, /doctor solo hace el chequeo de instalación.

2. No encuentra mi CLAUDE.md. Ábrelo desde la carpeta del proyecto, o pásale tú la ruta:

/doctor prompt-audit ./CLAUDE.md

Y ojo: puede haber más de uno (uno por subcarpeta). Si el tuyo está dentro de una carpeta, pásale esa ruta.

3. Me propone borrar cosas que quiero conservar. No lo aceptes. Es una propuesta, no un arreglo automático: deja lo que solo sabe tu equipo (entorno, cuentas, normas del negocio) y lo que nació de un fallo de verdad.

4. No encuentra nada. Es un resultado bueno: no hay nada que quitar. No toques el archivo por tocar.