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
Cómo deshabilitar la ventana de contexto de 1M de Claude Code para reducir el uso de tokens
Los usuarios de Anthropic pueden deshabilitar la ventana de contexto de 1M en Claude Code agregando variables de entorno a settings.json, lo que puede reducir el consumo inesperado de tokens. La fuente proporciona dos opciones de configuración: deshabilitar completamente el contexto de 1M o limitar la ventana de compactación automática.
Deja de usar Claude como un autocompletado costoso: construye un sistema SDR con definiciones de roles, archivos de memoria y rituales de refinamiento
Un post de Reddit argumenta que la mayoría de los equipos de ventas usan Claude como un 'chatbot' en lugar de un sistema. La solución: definir un rol, mantener un archivo de memoria con ICP/tono/aprendizajes, y realizar un ritual de refinamiento semanal para mejorar la calidad de los resultados.
Uso de Herramientas de Dictado para Instrucciones Más Efectivas en Agentes de IA
Un desarrollador descubrió que cambiar de instrucciones escritas a habladas para OpenClaw mejoró la calidad de los resultados al proporcionar un contexto más natural y detallado, utilizando SaySo.ai como herramienta de dictado.
Añade listas de verificación decoradas con emojis en Claude agregando una línea a CLAUDE.md
Agrega una línea de marcadores a tu CLAUDE.md a nivel de usuario para que Claude decore las listas de verificación con emojis de estado — 14 iconos fijos para completado, en ejecución, fallido, bloqueado, etc.