Código Listo para Agentes: Reglas Negativas, Nombres Precisos, READMEs de Directorios
Un desarrollador en r/ClaudeAI detalló cómo adaptó su base de código de Android después de que Claude Code metiera repetidamente nuevas funciones en una clase monolítica UserManager (autenticación, sesiones, perfil, analítica). La clave: el agente aparece frío cada vez, como un empleado nuevo en su primer día, sin memoria de las decisiones arquitectónicas. La solución fueron reglas explícitas en un CLAUDE.md en la raíz del repositorio.
Tres patrones que marcaron la mayor diferencia
1. Las reglas negativas superan a las positivas
En lugar de "sigue un buen diseño", el desarrollador escribe instrucciones como:
NO toques BaseActivity – está compartida entre 12 funciones y falla silenciosamente.
El agente es optimista por defecto y toma el camino de menor resistencia. Cerrar caminos peligrosos explícitamente detiene malas decisiones de manera más efectiva que una guía vaga.
2. Los nombres importan más de lo que crees
Una clase llamada UserSessionExpiryHandler es un contrato. Llamarla simplemente Handler es ruido. El agente empareja patrones fuertemente con los nombres; los buenos nombres reducen la cantidad de lectura de archivos que necesita. El desarrollador recomienda evitar sufijos genéricos y hacer explícito el propósito en el nombre.
3. Cada directorio tiene un README que enumera lo que NO pertenece allí
En lugar de "esta carpeta es para la UI", el README dice:
Sin lógica de negocio en presentation/
Este enfoque negativo "parece impactar más" al agente, previniendo más malas ubicaciones que la guía positiva.
Reglas prácticas para CLAUDE.md
- Mantén los archivos pequeños. Una clase, un trabajo.
- Crea un archivo nuevo en lugar de extender uno antiguo.
- No produzcas monolitos – divide las preocupaciones temprano.
El desarrollador informa que después de aplicar estas reglas, el patrón de que el agente relea un archivo de 600 líneas tres veces en una sola sesión prácticamente desapareció. Sospechan que el costo de tokens disminuyó significativamente, pero no lo han medido adecuadamente.
Para quién es
Desarrolladores que utilizan agentes de codificación de IA (Claude Code, Copilot, etc.) que quieran reducir el desperdicio de tokens y evitar que los agentes tomen malas decisiones arquitectónicas.
📖 Lee la fuente completa: r/ClaudeAI
👀 Ver también
Cuatro archivos locales para mantener el contexto de Claude en proyectos largos.
Un usuario de Reddit recomienda mantener cuatro archivos Markdown—claude.md, memory.md, restart.md y backlog.md—como memoria externa para Claude, para contrarrestar la compresión de la ventana de contexto en conversaciones prolongadas.
Desperdicio de tokens en Claude Code: Una autoauditoría muestra que las correcciones conductuales superan al cambio de modelo
Un usuario midió el uso de tokens en Claude Code y descubrió que usar /clear entre tareas, planificar antes de editar y prohibir la relectura de archivos ya editados ahorraba más tokens que cambiar de modelo. La disciplina práctica supera a los envoltorios.
Agentes de OpenClaw se vuelven inactivos después de la Semana 1: ¿Problemas de integración con Telegram?
Usuario informa que los agentes de OpenClaw se vuelven silenciosos después de la primera semana, sospechando problemas de integración con Telegram o de ejecución a largo plazo. Los reinicios ayudan temporalmente.
Cargar silenciosamente cada servidor MCP en cada mensaje destruye el presupuesto de tokens.
Un usuario con 5–6 servidores MCP descubrió que cada prompt cargaba todos los servidores, causando un enorme desperdicio de tokens. Implementar una capa de enrutamiento para cargar solo los servidores relevantes por prompt redujo drásticamente el uso de tokens y mejoró los tiempos de respuesta.