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
Directiva del Modo Sigiloso de Claude para la Ejecución Autónoma de IA
Un usuario de Reddit comparte una directiva de 'modo sigiloso' que obliga a Claude a operar en silencio y de forma autónoma, entregando resultados completos de una sola vez sin salida de conversación hasta que el trabajo esté terminado.
¿Cómo desactivar la función de verb spinner de Claude Code?
Claude Code incluye un girador de verbos predeterminado que muestra gerundios caprichosos como 'Sazonando' y 'Creando' durante el procesamiento. Puedes desactivarlo editando el archivo settings.json con un espacio en blanco en el array spinnerVerbs.
6 Tipos de Bucles Encontrados en Agentes de IA en Producción: Un Análisis de Registros de una Semana
Análisis de 670 eventos de 5 agentes de producción durante una semana revela 6 patrones de bucle de alta gravedad, incluyendo oscilación de decisiones, bucles de reintento, bucles de ping pong, bucles de lectura-escritura, bucles de reflexión y no determinismo de herramientas.
Claude + MCP Browser: Usuarios Reportan Acceso Web Mejorado
Un usuario de Claude explica cómo conectar Claude a un navegador externo a través de MCP le permitió navegar sitios previamente inaccesibles, y se pregunta si Claude puede usar los tokens del modelo del navegador.