01 Qué cambió y por qué importa
En julio de 2026, Anthropic publicó en el blog de Claude Code el artículo «The new rules of context engineering for Claude 5 generation models». Su conclusión principal: quitaron más del 80% del system prompt de Claude Code para modelos como Opus 5 y Fable 5 sin pérdida medible en sus evaluaciones de código.
El motivo es que muchas de esas instrucciones eran parches para modelos anteriores, que fallaban en casos límite. Los modelos actuales tienen mejor criterio, y las normas rígidas se vuelven un estorbo: se contradicen entre sí y obligan al modelo a gastar razonamiento en decidir a cuál hacer caso. Si tu CLAUDE.md se escribió hace meses a base de «NUNCA» y «SIEMPRE», probablemente arrastra el mismo problema.
02 Seis cambios de enfoque
| Antes | Ahora |
|---|---|
| Dar reglas a Claude | Dejar que use su criterio a partir del contexto |
| Darle ejemplos | Diseñar bien las herramientas, parámetros y archivos para que se entiendan solos |
| Ponerlo todo al principio | Carga progresiva: skills y reglas que entran solo cuando hacen falta |
| Repetir instrucciones | Explicar cada herramienta en su propia descripción, una sola vez |
| Memoria escrita a mano en CLAUDE.md | Memoria automática que Claude guarda mientras trabaja |
| Especificaciones simples | Referencias ricas: tests, maquetas HTML, código de otro proyecto o rúbricas |
Un ejemplo del propio artículo: en lugar de prohibir comentarios en el código, el nuevo prompt pide escribir código que se lea como el que lo rodea, igualando su densidad de comentarios, nombres y estilo. Pasa de una prohibición que a veces era errónea a un criterio que se adapta a cada repositorio.
03 Cómo convertir una regla en criterio
-
1
Encuentra el motivo
Pregúntate qué problema intentaba evitar la regla. «NUNCA uses any» suele significar «queremos tipos que detecten errores».
-
2
Escribe el objetivo
Sustituye la prohibición por el resultado que buscas y por qué.
-
3
Da contexto local
Añade lo que Claude no puede deducir mirando el repositorio: excepciones, historia, gustos del equipo.
-
4
Elimina lo obvio
Si se deduce de los archivos (estructura de carpetas, dependencias), sobra.
-
5
Decide si es innegociable
Si incumplirla causa un daño grave, no es criterio: es un permiso o un hook.
| Regla rígida | Criterio |
|---|---|
| NUNCA escribas textos de más de 150 palabras | Los textos de producto se leen en móvil: prioriza que se entiendan en un vistazo |
| SIEMPRE usa la librería X para fechas | Usamos X porque gestiona bien las zonas horarias de nuestros clientes en Canarias y Península |
| NO crees archivos nuevos | Antes de crear un archivo, comprueba si encaja en uno existente; preferimos pocos módulos grandes |
| NO toques la carpeta legacy/ | Regla de permisos deny para escribir en legacy/: no es negociable |
Esta es una regla de mi CLAUDE.md: «[pega la regla]». Explícame qué problema crees que intentaba evitar. Después propón una versión en forma de objetivo y criterio, con el contexto que solo nosotros sabemos. Si consideras que incumplirla causaría un daño grave o irreversible, dímelo y propón en su lugar una regla de permisos o un hook.04 Audita lo que tienes escrito
Claude Code incluye una auditoría para esto. Con /doctor prompt-audit revisa tus CLAUDE.md, CLAUDE.local.md, AGENTS.md y lo que hay en .claude/ (reglas, skills, comandos, subagentes y estilos de salida) buscando instrucciones pensadas para modelos antiguos, referencias a archivos que ya no existen y contradicciones. Te devuelve propuestas, pero no cambia nada hasta que se lo pidas. También puedes auditar una sola ruta.
/doctor prompt-audit
/doctor prompt-audit .claude/skills/despliegueLee mi CLAUDE.md y clasifica cada instrucción en una tabla: A) obvia, se deduce del repositorio y se puede borrar; B) trampa real del proyecto que Claude no podría deducir, se queda; C) procedimiento de varios pasos que debería ser una skill; D) solo aplica a ciertas carpetas y debería ser una regla con paths; E) innegociable, debería ser un permiso o un hook; F) contradice otra instrucción (indica cuál). No modifiques nada todavía.05 No todas las instrucciones tienen la misma fuerza
| Mecanismo | Cuándo se aplica | Para qué |
|---|---|---|
| Reglas de permisos y hooks | Siempre, las lea o no el modelo | Lo innegociable |
| CLAUDE.md | Se carga entero en cada sesión | Qué es el proyecto y sus trampas |
| Reglas en .claude/rules/ con paths | Solo al trabajar con archivos que coinciden | Convenciones de una parte del código |
| Skills | Solo la descripción hasta que se usan | Procedimientos y conocimiento especializado |
La documentación recomienda mantener cada CLAUDE.md por debajo de unas 200 líneas: los archivos largos consumen contexto y reducen el seguimiento de las instrucciones. Lo que solo afecta a una parte del código va a una regla con paths.
---
paths:
- "src/api/**/*.ts"
---
# API
- Cada endpoint valida la entrada con el esquema de src/api/schemas.
- Los errores usan el formato común de src/api/errors.ts: los consume la app móvil.06 Skills: la descripción es la instrucción
Mientras una skill no se usa, Claude solo ve su descripción. Si la descripción dice qué es («Guía de despliegue») en lugar de cuándo usarla («Úsala al publicar en producción o preparar una release»), no se activará cuando toca. Escribe la descripción con las palabras que usarías al pedir esa tarea, divide las skills largas en varios archivos que se lean solo si hacen falta y reserva las restricciones duras para lo verdaderamente importante.
La sección «[título]» de mi CLAUDE.md es un procedimiento que solo se usa de vez en cuando. Conviértela en una skill en .claude/skills/[nombre]/SKILL.md: escribe una description que diga cuándo usarla con frases que yo escribiría, deja en el cuerpo solo los pasos y el criterio que no se deducen del repositorio y mueve los detalles largos a archivos de referencia. Después, propón la línea que debería quedar en CLAUDE.md, si es que hace falta alguna.Preguntas frecuentes
El recorte se hizo pensando en la generación Claude 5. Con modelos más antiguos, algunas reglas explícitas pueden seguir siendo útiles; si los usas, prueba los cambios antes de generalizarlos.
No. Mantenlo corto: para qué sirve el repositorio y las trampas que no se ven a simple vista. Lo demás, a reglas por rutas, skills o permisos.
Claude puede elegir una al azar. Por eso conviene auditar periódicamente CLAUDE.md, los CLAUDE.md anidados y .claude/rules/ para eliminar conflictos.
Claude Code ya guarda automáticamente lo relevante sobre tu trabajo. Reserva CLAUDE.md para lo que quieres que vea todo el equipo.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.