Plantilla de CLAUDE.md lista para copiar (y los 8 errores que se comen tu contexto)
Una plantilla que puedes pegar hoy en tu repositorio, sección a sección, y los ocho errores que hacen que un CLAUDE.md consuma contexto sin mejorar una sola respuesta.
Casi todos los CLAUDE.md que se ven por ahí tienen el mismo problema: son un README disfrazado. Cuentan qué hace el proyecto — cosa que el agente puede deducir leyendo el código — y no cuentan lo único que no puede deducir: qué decisiones ya están tomadas y qué cosas rompen si las toca.
El coste no es estético. Cada línea de ese archivo entra en el contexto de todas las peticiones. Un CLAUDE.md de 300 líneas que repite lo que ya está en el código es un impuesto que pagas en cada mensaje, para siempre, a cambio de nada.
Abajo tienes la plantilla completa, sección a sección, con el porqué de cada una y los ocho errores que más contexto consumen sin mejorar una sola respuesta.
