Claude Code: audita tu CLAUDE.md con /checkup
Con /checkup prompt-audit, Claude Code audita tu CLAUDE.md y tus skills: marca lo escrito para modelos anteriores, rutas caducadas y reglas que se contradicen.
Lo que escribiste en tu CLAUDE.md hace seis meses estaba pensado para el modelo de hace seis meses. Con cada modelo nuevo, alguna de esas instrucciones deja de ayudar y empieza a estorbar. Para encontrarlas, Claude Code tiene un comando: /checkup prompt-audit, que audita tu CLAUDE.md por ti.
Es el día 29 de #30DaysOfClaude; el resto de tips está en el índice de la serie.
Qué audita /checkup prompt-audit en tu CLAUDE.md
Según la documentación de Claude Code, el comando revisa tu CLAUDE.md y tus otros archivos de instrucciones (skills, agentes, comandos) y busca tres cosas:
- Instrucciones escritas para modelos anteriores. La del día 1, "think step by step", es el ejemplo clásico; las mayúsculas de presión, otro (las vimos en cuántos NUNCA hay en tu CLAUDE.md).
- Referencias a archivos o comandos que ya no existen.
- Archivos que se contradicen entre sí.
Te devuelve un informe con los hallazgos y los cambios propuestos. No toca nada hasta que le pides que los aplique.
Cómo usar /checkup prompt-audit en Claude Code
Escribe esto en Claude Code (versión 2.1.283 o posterior, de finales de septiembre):
/checkup prompt-audit
/checkup prompt-audit [ruta/del/archivo]
Lo probamos con un CLAUDE.md viejo de ejemplo. Marcó "piensa paso a paso" como sobrante, dos reglas de formato que chocaban ("nunca uses tablas" y "para comparar, usa una tabla"), un "revisa todo dos veces" que alarga cada respuesta y una carpeta de plantillas de 2024 que podía no existir. De cada hallazgo, dio el motivo y el cambio, para aprobarlos por separado.
Tu paso para hoy: pásalo por tu CLAUDE.md. Si es la primera vez, empieza por aprobar solo lo que marque como contradicción: es lo que más confunde a Claude.
Cuándo pasar /checkup prompt-audit (y cuándo no hace falta)
- Cada vez que cambies de modelo. Es cuando más instrucciones se quedan viejas de golpe.
- Si Claude empieza a ignorar una regla: puede que choque con otra. Y si lo que pasa es que el archivo ha crecido demasiado, el día 25 va de qué sacar a un skill y el día 26 de qué convertir en un hook.
- No hace falta si tu CLAUDE.md tiene diez líneas y lo escribiste la semana pasada.
¿Cuándo fue la última vez que releíste tu CLAUDE.md entero?
Preguntas frecuentes
¿Qué hace /checkup prompt-audit en Claude Code?
Revisa tus archivos de instrucciones (CLAUDE.md, skills, agentes, comandos) y marca lo escrito para modelos anteriores, las referencias a archivos o comandos que ya no existen y las reglas que se contradicen. Te da un informe con los cambios propuestos.
¿Cambia mis archivos?
No. Te enseña los hallazgos y los cambios que propone, y no toca nada hasta que le pides que los aplique.
¿Es lo mismo que /checkup a secas?
No. /checkup a secas revisa tu instalación y tu configuración (permisos, extensiones, tamaño del CLAUDE.md). Con prompt-audit revisa lo que dicen tus instrucciones.