Claude Code · Fable 5.2 · solo lectura

Audita tu Claude para Fable 5.2

El prompt que funcionaba con el modelo anterior puede ser un obstáculo ahora. Encuentra las líneas antiguas en 5 segundos, con informe y gráficos.

Banner: Audita tu Claude, listo para Fable 5.2
En resumen

audite-seu-claude es un pequeño programa en Python que lee la configuración de tu Claude Code (el archivo CLAUDE.md, las skills, las memorias, los plugins y los scripts) y señala las instrucciones escritas para modelos anteriores que ahora dificultan el uso de Claude Fable 5.2. Es para quienes usan Claude Code a diario y van a cambiar de modelo. Entrega un informe con gráficos y una lista de sugerencias; tú marcas las que apruebas y tu propio Claude aplica solo esas correcciones. Solo necesitas Python 3: no usa internet ni modifica tu configuración (solo guarda el informe donde le indiques).

Vídeo

Los 10 puntos en poco más de 2 minutos

Nei explica qué publicó Anthropic sobre Fable 5.2, por qué el prompt anterior puede ser un obstáculo ahora y cómo el kit encuentra esas líneas.

▶ Mira también la versión vertical (9:16)

Qué es

La herencia invisible, encontrada línea por línea

Anthropic publicó 10 puntos de atención para Fable 5.2. Sigue las instrucciones al pie de la letra, por lo que las reglas antiguas producen efectos distintos. El kit convierte esos 10 puntos en comprobaciones automáticas.

Puntos auditados: rechazos, esfuerzo, subagentes, cautela acumulada, informe con gráficos, correcciones aprobadas

🔍 Encuentra lo que bloquea

Peticiones de razonamiento en el texto (pueden provocar un rechazo), «piensa menos», presupuesto de tokens, orden de delegar siempre, «nunca» sin motivo, estilo rígido, esfuerzo antiguo.

📊 Muestra el peso

Gráficos por punto, por archivo y el peso del texto que entra en cada sesión: CLAUDE.md, índice de memoria y descripciones de skills. También señala skills repetidas y memorias antiguas.

✅ Tú apruebas, Claude corrige

Marca las sugerencias y genera correcoes.md. Se convierte en la solicitud de corrección: un elemento cada vez, con una copia del original. Las reglas de seguridad nunca se borran.

Cómo funciona

Tres pasos, tú decides

El programa solo lee. Tú decides qué cambia; tu Claude edita únicamente lo que aprobaste.

varrer.py lo lee todo→ relatorio.html con gráficos→ marcas lo que apruebas→ correcoes.md→ «aplica el correcoes.md»→ vuelve a ejecutarlo y compara
Los 10 puntos de Anthropic

Qué dice la página oficial y qué comprueba el kit

Fuente: Prompting Claude Fable 5.2 (consultada el 11/11/2026). Las cifras proceden de las pruebas de la propia Anthropic.

1 Esfuerzo

El valor predeterminado de la API es high. Medium para el día a día; xhigh y max solo cuando hayas medido una mejora. «Responde sin pensar» no reduce el razonamiento: baja el esfuerzo. Comprueba: max fijo, xhigh predeterminado, ajuste copiado de un modelo antiguo, Fable 5.2 en low/medium.

2 Finalización anticipada

En tareas largas a veces se detiene antes de terminar, más a menudo en low y medium. El texto oficial redujo a la mitad las sesiones abandonadas a medias, con +~30% de tokens. Comprueba: si tu CLAUDE.md contiene este texto (está en blocos/terminar-tarefa.md). En Claude Code con Fable 5.2, este texto ya viene activado de fábrica.

3 Aprobaciones

Indica la acción («sí, ejecuta la migración en la base de datos de prueba») en vez de «continúa». La regla de aprobación debe nombrar las acciones. Comprueba: aprobación para «cualquier acción» y claude -p "continue" en un script.

4 Responsable del código

«Este código es tuyo» hace que reorganice el código: ~1,5x más tokens y cambios que nadie pidió. Úsalo solo cuando quieras eso y revisa el diff. Comprueba: la frase, como aviso.

5 Silencio

Trabaja en silencio durante secuencias largas. El texto oficial le pide hablar antes de usar la primera herramienta, con +~20% de tokens. Comprueba: si tienes este texto (blocos/avisar-progresso.md). En Claude Code con Fable 5.2, el recordatorio de silencio ya viene activado de fábrica.

6 Subagentes

Si el prompt le ordena delegar, delega mucho. Revisa primero esas líneas. Comprueba: «usa siempre subagentes», «agent army», «delega todo».

7 Cautela acumulada

Las notas y las memorias acumulan «nunca» y obedece todas las órdenes. Borra las que ya no tengan motivo; añade alcance y motivo a las demás; enumera lo que NO necesita aprobación. Comprueba: «nunca» sin motivo, «nunca vuelvas a intentarlo», órdenes absolutas en mayúsculas, memorias antiguas.

8 Instrucciones antiguas

Elimina: el presupuesto de tokens en el prompt, «piensa menos», «trata la respuesta anterior como definitiva» (deja de señalar sus propios errores) y las reglas de estilo rígidas. Comprueba: las cuatro.

9 Informe final

Pídele que escriba para alguien que no haya visto el trabajo: primero lo principal, sin términos inventados. Comprueba: si tienes este texto (blocos/relatorio-claro.md).

10 Rechazos

Pedir que escriba su razonamiento en la respuesta puede activar el filtro reasoning_extraction y detener la skill. Comprueba: «muestra tu razonamiento paso a paso», «chain of thought» — gravedad alta.

Qué cambia en los prompts

Hace lo que está escrito, al pie de la letra

Sin contar las skills y el volumen, estos son los cambios de prompt que más alteran el resultado, de mayor a menor. Un prompt escrito para el modelo que «interpretaba» empieza a dar un resultado diferente.

Para empresas (sistemas, automatizaciones, API)

1 «Muéstrame tu razonamiento» puede convertirse en una negativa

Un prompt antiguo con «explica paso a paso cómo pensaste» puede devolver una negativa (refusal) en vez de una respuesta. Es el único punto que puede romper la producción. Cambio: quita la frase; para ver el razonamiento, usa el resumen del pensamiento de la API.

2 El esfuerzo importa más que el prompt

El valor predeterminado es high, que cuesta más. «Responde directamente, sin pensar mucho» no reduce el esfuerzo. Cambio: elige el nivel según la tarea (low para lo simple, medium para el día a día, high para una tarea larga) y mide. No copies el ajuste del modelo anterior.

3 Se detiene a mitad de camino

Ocurre más con low y medium. En una automatización, deja la tarea a medias sin mostrar ningún error. Cambio: pega el texto de «termina el trabajo»: resolver por su cuenta los obstáculos comunes, detenerse solo ante un bloqueo real y decir qué falta.

4 Las reglas antiguas se convierten en un freno

Años de «nunca hagas X» y «pide siempre aprobación»: obedece todo y se vuelve tímido. Cambio: indica el motivo y el alcance de cada regla y escribe qué no necesita aprobación.

5 «Usa siempre subagentes» multiplica el costo

Reparte el trabajo entre varios agentes. Cambio: «cuando la tarea sea independiente y pueda ejecutarse en paralelo».

Para quienes conversan con él

1 Di la acción, no «continúa»

«Sí, ejecuta la migración en la base de prueba» funciona mejor que «puedes seguir».

2 «Ese código es tuyo» tiene un costo

Combina código repetido y modifica lo que no pediste, con ~50% más tokens. Úsalo cuando quieras reestructurar y revisa el diff.

3 Trabaja en silencio

Para seguir el proceso, pide: «antes de empezar, di en una línea qué vas a hacer».

4 Pide el formato del resumen

«Escribe para quien no siguió el proceso; empieza por lo principal».

¿Y Opus 5.5? ¿Cambiar las reglas lo empeora?

No. Los cambios anteriores siguen las buenas prácticas de Anthropic para los modelos Claude en general: indicar el motivo de cada regla, expresar claramente la acción y pedir que termine el trabajo también ayudan a Opus. Adivina mejor la intención, así que la mejora es menor. El esfuerzo se ajusta por modelo en settings.json (modelSettings), así que subir el Fable 5.2 no afecta a Opus. El único efecto es que el texto de «termina el trabajo» puede hacer que Opus trabaje y gaste un poco más en una tarea larga. Las reglas de seguridad (API, crédito, borrar, publicar) se mantienen igual en ambos.

Requisitos previos

Solo Python 3 y git

Sin instalar paquetes, sin internet, sin clave de API. Funciona en Linux, macOS y WSL.

Python 3.8 o posterior

Solo la biblioteca estándar.

python3 --version

Claude Code (para aplicar)

El auditor funciona sin él; para aplicar las correcciones, usas tu Claude.

claude --version
Guía de uso · paso a paso

Desde clonar hasta corregir Claude

Es el orden que recomienda Anthropic: primero el esfuerzo, después limpiar las instrucciones y luego medir.

1

Descarga el kit

Una carpeta, un archivo principal.

git clone https://github.com/inematds/audite-seu-claude.git ~/audite-seu-claude
2

Pon Fable 5.2 en high para las tareas largas

El comando /effort de Claude Code cambia el nivel de esfuerzo (cuánto piensa el modelo). Úsalo antes de una tarea grande. En los bots con claude -p, pasa --effort high.

/effort high
3

Ejecuta la auditoría

Desde la carpeta del proyecto. --home también lee tu ~/.claude (CLAUDE.md global, skills, memorias, plugins).

cd ~/meu-projeto
python3 ~/audite-seu-claude/varrer.py . --home --html relatorio.html --saida-json relatorio.json
# en el terminal: total de hallazgos, por punto y por gravedad
4

Abre el informe y marca lo que apruebas

Cada sugerencia tiene un ID (A001, A002…). Filtra por capa — Fable 5.2 (las líneas que cambian el comportamiento del modelo) o volumen (peso del contexto, skills repetidas o sin uso, memorias antiguas) — o por gravedad. Haz clic en generar correcoes.md: el navegador descarga el archivo y muestra el texto en pantalla. Mueve el archivo a la carpeta del proyecto. También puedes generarlo directamente ahí desde el terminal, con los ID:

python3 ~/audite-seu-claude/varrer.py --correcoes A001,A004,A007 --de relatorio.json --saida correcoes.md
5

Pídele a tu Claude que aplique las correcciones

Con correcoes.md en la carpeta del proyecto (también sirve la ruta: «aplica el ~/Downloads/correcoes.md»). El encabezado del archivo ya indica cómo hacerlo: un elemento cada vez, copia del original en .audite-backup/, las reglas protegidas nunca se borran y los archivos de plugins no se editan. La aprobación solo cubre esas ediciones.

# en Claude Code, dentro de la carpeta del proyecto
aplica el correcoes.md
6

Vuelve a ejecutarla y compara

Los hallazgos aplicados desaparecen. Luego ejecuta tu tarea más larga y observa dónde se detiene, se queda en silencio o delega demasiado. Para cada síntoma, pega el bloque adecuado de blocos/, uno cada vez.

python3 ~/audite-seu-claude/varrer.py . --home
cat ~/audite-seu-claude/blocos/terminar-tarefa.md # si se detiene a mitad

Ejecuta también el auditor oficial de Claude Code (versión 2.1.283 o posterior). Detecta lo que este kit no busca: archivos o comandos mencionados que ya no existen y reglas que se contradicen entre archivos. Este kit cubre lo que el auditor no lee: memorias, textos de plugins, prompts dentro de scripts y bots, el nivel de esfuerzo en settings.json y el peso de las skills. Usa ambos.

# en Claude Code
/doctor prompt-audit
7

Opcional: la skill y el CI

La skill realiza los pasos 3 a 6 mediante Claude Code. --uso 30 lee los registros de tus sesiones (~/.claude/projects/*.jsonl, locales) y marca las skills que no hayas usado en 30 días. --estrito hace fallar el CI si hay algún hallazgo de gravedad alta.

cp -r ~/audite-seu-claude/skill/audite-seu-claude ~/.claude/skills/
python3 ~/audite-seu-claude/varrer.py . --home --uso 30
python3 ~/audite-seu-claude/varrer.py . --estrito  # sale con 1 si hay algo de gravedad "alta"
Ejemplos

El informe de un proyecto de prueba

Generado a partir de tests/fixtures/sujo, un proyecto creado deliberadamente con una línea de cada tipo (24 hallazgos). Abre el informe interactivo (en portugués) y prueba el botón para generar correcoes.md.

Parte superior del informe: totales, gráfico por punto de Anthropic, por gravedad y por archivo
Totales y gráficos: por punto de Anthropic, por gravedad, por archivo y peso del contexto fijo.
Lista de sugerencias con casillas de aprobación, fragmento, motivo y qué hacer
Cada sugerencia: dónde está, el fragmento, el motivo (con el número de Anthropic) y qué hacer. Márcala y genera correcoes.md.

En una máquina de producción con 148 skills cargadas, la primera auditoría tardó 4 segundos y encontró: un hook de plugin que ordena escribir «telegráfico, en fragmentos» (punto 8), una skill de plugin con «si hay un 1% de probabilidad, estás obligado» (punto 7), nueve órdenes de delegar siempre (punto 6) y Fable 5.2 configurado en medium (punto 1).

Cuidados y próximos pasos

El auditor señala; tú decides

La propia Anthropic dice que no es necesario eliminar todas las instrucciones antiguas. Prueba cada cambio en una tarea real.

Protegida
La regla de seguridad se conservaLos «nunca» relacionados con API, crédito, borrar, publicar o contraseñas aparecen como protegidos: la sugerencia es darles alcance y motivo, nunca borrarlos.
Plugin
No edites archivos de pluginsLa actualización deshace el cambio. Escribe en el CLAUDE.md global que esa regla no se aplica o desactiva el plugin.
Consejo
Biblioteca de skills: guárdalas, no las borresLas skills que usas poco van a una carpeta fuera de ~/.claude/skills, con un INDICE.md (nombre, para qué sirve, palabras de búsqueda). Una línea en el CLAUDE.md global le indica a Claude que busque allí cuando pidas una skill que no está cargada. Antes, comprueba si otra skill, script o timer la invoca. En la máquina del autor: 148 → 107 skills cargadas y de 13,7 mil → 9,6 mil tokens de descripción por sesión. Paso a paso: blocos/biblioteca-skills.md.
Oficial
Dos bloques ya vienen en Claude CodeLas pruebas publicadas en la versión 2.1.322 muestran que, con Fable 5.2, Claude Code ya activa automáticamente el texto para terminar la tarea y el recordatorio cuando se queda callado. En ese caso, no pegues terminar-tarefa.md ni avisar-progresso.md: sirven para quienes llaman al modelo mediante la API o con un programa propio.
Costo
Los bloques cuestan tokensTerminar la tarea: +~30% de salida. Avisar del progreso: +~20%. Pégalos solo si observas el síntoma.
v1.0
Hoy19 reglas en la capa Fable 5.2, 8 en la capa de volumen, informe HTML, correcoes.md, 4 bloques, skill, 19 pruebas.
Después
Medir los síntomas en los registrosContar en las sesiones grabadas cuántas veces el modelo se detuvo a mitad, se quedó en silencio o abrió subagentes, antes y después de las correcciones.