Un programador comparte su experiencia personal afinando el archivo agent.md —el fichero que los entornos de desarrollo con IA inyectan en el prompt al iniciar una sesión— para elevar la calidad del código que producen los modelos de lenguaje. Tras varios intentos fallidos entre 2025 y principios de 2026, descubrió que las instrucciones explícitas iteradas a través del IDE agente (Antigravity o el plugin Claude Code de VS Code) son la vía más eficaz.
El artículo detalla qué reglas incluye su agent.md: redactar mensajes y comentarios con el menor número posible de palabras y sin elogios; extraer números mágicos a constantes; reducir el sangrado; funciones con nombres de menos de 30 caracteres; preferir enums en lugar de booleanos; programar por niveles de abstracción y respetar jerarquías por capas; aplicar TDD ante cualquier corrección de bug; y seguir siete normas formales para los mensajes de commit (asunto imperativo, 50 caracteres máximo, envoltura del cuerpo a 72).
El autor reconoce que la técnica no evita tener que revisar y corregir manualmente: los modelos siguen alucinando y aparece el fenómeno de "dilución de contexto" documentado en el paper Lost in the Middle. Aun así, su flujo de trabajo pasa de corregir estilo a centrarse en arquitectura y diseño. Una práctica útil es pedir al propio agente que actualice agent.md cuando surge una nueva pauta repetitiva.