Cómo prevenir la degradación de CLAUDE.md: trata las reglas como código
Después de ejecutar Claude Code en proyectos de producción durante 18 meses, u/mm_cm_m_km identificó el punto de fallo más común: el archivo CLAUDE.md se pudre. No porque Claude lo ignore, sino porque los desarrolladores siguen añadiendo reglas sin limpiarlas nunca. El resultado es un archivo inflado de 500 líneas que cuesta tokens en cada turno y se desincroniza con el código base real.
1. CLAUDE.md como índice, no como manual
Mantén CLAUDE.md entre 30 y 50 líneas. Debe funcionar como una tabla de contenido que apunte a archivos específicos para temas concretos, no como un muro con todas las preferencias que hayas establecido. Claude relee el archivo en cada turno; los archivos cortos son baratos, los largos desperdician tokens y atención.
2. Cada sección responde a una de dos preguntas
- ¿Qué comportamiento deseas? (la regla) — va en
CLAUDE.md. - ¿Dónde encuentras la verdad actual? (la fuente) — va como una URL o ruta de archivo que Claude pueda releer en el momento de la tarea.
Mezclar reglas y fuentes es como los archivos crecen sin límite. Mantén la regla breve, la fuente externa.
3. Auditar antes de fusionar, no después
Las reglas se desvían silenciosamente al renombrar cosas, refactorizar hooks o eliminar funcionalidades. La solución no es "tener más cuidado" — es un paso en CI. El autor creó una aplicación de GitHub llamada agentlint (agentlint.net) que audita la superficie de reglas en cada PR: contradicciones entre archivos, referencias a rutas eliminadas, reglas que describen características de un entorno que tu versión no soporta.
4. Elimina más de lo que agregas
Casi todos los CLAUDE.md ganan una regla nueva por semana y eliminan cero. Después de seis meses tienes un Frankenstein. La disciplina: por cada regla nueva, encuentra una para eliminar. Esto ha mantenido el archivo del autor por debajo de 100 líneas.
El patrón central: trata tu superficie de reglas como código. El código tiene pruebas, revisión y detección de desviaciones. Las reglas necesitan lo mismo.
📖 Read the full source: r/ClaudeAI
👀 Ver también
Las Indicaciones Vagas Son el Verdadero Problema, No el Modelo — Prueba de 50 Ejecuciones Muestra que la Calidad de la Indicación Supera a la Elección del Modelo
Un usuario de Reddit ejecutó las mismas diez indicaciones a través de ChatGPT 4, Claude Sonnet y Gemini 1.5 Pro cinco veces cada uno (150 salidas en total) y descubrió que los tres modelos producían resultados igualmente utilizables o igualmente genéricos; el factor decisivo era la especificidad de la indicación, no el modelo.
Pruebas y QA automatizadas con IA: una nueva era para las pruebas de software
Antirez describe el uso de agentes LLM para QA automatizado escribiendo un archivo markdown que instruye al agente a realizar pruebas manuales en nuevas versiones. Aplicado a DwarfStar y Redis Arrays, este enfoque mejora la calidad del software sin sacrificar la exhaustividad.
Problemas de Cuantización de la Caché KV en Agentes de Codificación Local con Contextos de Alta Longitud
Un análisis de Reddit identifica la cuantificación agresiva de la caché KV como la causa de bucles de corrección infinitos y salidas JSON malformadas en agentes de codificación locales como Qwen3-Coder y GLM 4.7 con longitudes de contexto superiores a 30k, recomendando precisión mixta o contexto reducido como soluciones alternativas.
El Método de la Suegra: Armando la Amabilidad de Claude para Revisiones de Código Brutales
Un usuario de Reddit logra que Claude haga revisiones de código severas al presentar el código como escrito por una odiada suegra, resultando en 27 problemas encontrados a través de 4 agentes revisores hostiles después de 31 minutos de análisis profundo.