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
Escribir archivos SOUL.md efectivos para agentes de programación de IA
Una publicación de Reddit en r/openclaw demuestra la diferencia entre instrucciones vagas y específicas en SOUL.md, mostrando que las indicaciones específicas producen un comportamiento más útil del agente de IA.
Cómo dejar de alcanzar los límites de Claude: Trata cada sesión como un presupuesto de tokens
Un usuario comparte cómo solucionó los límites diarios de Claude al detener la hinchazón de mensajes: delimitar la tarea, cargar solo contexto relevante y limpiar después de cada sesión. Incluye flujo de trabajo práctico e infografía.
Los Patrones de Código Superan las Guías de IA: Portando una Extensión de Firefox a Chrome
Un desarrollador fracasó dos veces al portar una extensión de Firefox a Chrome usando indicaciones de IA, y luego tuvo éxito al extraer la lógica central independiente del navegador con una interfaz BrowserShell, reduciendo el código específico de Chrome a 5 líneas significativas.
Construyendo una capa de procesos sobre Claude Code para manejar el contexto y la coordinación
Un equipo comparte cómo construyeron una capa de proceso sobre Claude Code que declara entradas/salidas por paso de ingeniería, reduciendo la pérdida de contexto en las transferencias y permitiendo ganancias de productividad compuestas sin depender de la disciplina individual.