Qué hay realmente en mi AGENTS.md
Mi archivo AGENTS.md empezó como un cajón de sastre. Pensé que necesitaba notas de estilo y detalles del stack tecnológico. Me equivoqué.
Un agente de IA ignorará tus reglas de formato. Seguirá las reglas que combatan sus peores instintos.
Esto es lo que aprendí al probar estos archivos con mi propio código.
El permiso para detenerse
La primera regla no trata sobre el código. Trata sobre el permiso.
Los agentes quieren parecer útiles. Resuelven la ambigüedad eligiendo una respuesta en silencio. Esto conduce a cientos de líneas de código erróneo.
Les digo a mis agentes que se detengan y pregunten cuando las cosas no estén claras. Les digo que declaren sus suposiciones. Les digo que decir "No estoy seguro" es un éxito, no un fracaso.
Las reglas de los hábitos prohibidos
Las reglas más útiles nombran un mal instinto y lo prohíben.
• No construyas en exceso. Escribe el código mínimo para resolver el problema. Sin frameworks especulativos. • No te extralimites. Toca solo lo que sea necesario. Un cambio de diez líneas no debería convertirse en un diff de doscientas líneas. • No promedies patrones. Si ves dos estilos de codificación diferentes, no los mezcles. Elige uno y explica por qué.
La diferencia entre guía y ejecución
Los modelos se desvían de las instrucciones. Una regla en un archivo markdown es una sugerencia, no un contrato.
Divido mi archivo en dos niveles:
- Guía: Estilo y filosofía. Esto vive en prosa.
- Ejecución: Requisitos estrictos. No los pongas en el archivo. Ponlos en una comprobación de CI o en un script.
Si una regla debe cumplirse siempre, haz que sea imposible realizar un merge si falla. Una instrucción es una cortesía. Un control es una garantía.
Confía en la comprobación, no en la afirmación
Los agentes suelen afirmar que las pruebas pasan de memoria. No siempre las vuelven a ejecutar.
Les digo a mis agentes que definan el éxito a través de pruebas. En lugar de "corrige este error", digo "escribe una prueba que reproduzca este error, luego haz que pase".
Nunca confíes en una afirmación sin una comprobación reciente.
El registro de cicatrices
Mantengo una sección para las lecciones aprendidas de los errores. A estas las llamo cicatrices.
Un agente no tiene memoria del dolor pasado. Pisará la misma mina en cada ocasión.
Escribe los errores específicos, los comportamientos extraños de la API y los fallos silenciosos. Mapear estas minas te ahorrará horas de tiempo perdido.
El objetivo de este archivo es codificar el juicio. Las reglas de formato se escriben solas. El juicio es lo que debes escribir.
Fuente: https://dev.to/miteshethos/whats-actually-in-my-agentsmd-434e
Comunidad de aprendizaje opcional: https://t.me/GyaanSetuAi