Los desarrolladores de LLVM iniciaron una discusión sobre si el proyecto debería alojar un archivo AGENTS.md, y también un CLAUDE.md, dentro de su repositorio Git para orientar el trabajo de los agentes de inteligencia artificial.
¿Qué es un archivo AGENTS.md?
Se trata de un archivo de texto plano que se deja en el repositorio con instrucciones dirigidas a las herramientas de programación asistida por inteligencia artificial: cómo compilar el proyecto, qué convenciones de estilo respetar, qué políticas seguir al enviar una contribución. La idea es que el agente lea esas indicaciones antes de proponer un cambio, en lugar de deducirlas del código.
Muchos proyectos de código abierto ya adoptaron este tipo de archivos para guiar a los agentes que preparan parches o colaboran de otras formas. Pero no todos coinciden en su efectividad, ni en qué tan receptivo conviene ser frente a estas herramientas.
¿Por qué el caso de LLVM es más complicado?
En LLVM aparece además una preocupación específica: la cantidad de subproyectos que conviven bajo el mismo paraguas, cada uno con alcances distintos. Un solo archivo en la raíz del repositorio tendría que cubrir realidades de desarrollo que no se parecen entre sí, y esa es precisamente una de las objeciones que surgieron en el hilo.
Nick Desaulniers, desarrollador de larga trayectoria en el proyecto, abrió la conversación en el foro Discourse de LLVM. Las respuestas hasta ahora son mixtas.
Algunos participantes están a favor. Otros sostienen que estos archivos pueden generar más ruido que beneficio y que no necesariamente resultan efectivos. Un tercer grupo argumenta que la propuesta va en contra de un principio vigente en LLVM: el proyecto no define los flujos de trabajo privados de cada desarrollador. Varios, de hecho, ya usan su propio material en un AGENTS.md dentro de sus repositorios personales.
¿Qué diría el archivo si se aprueba?
Desaulniers no se quedó en la propuesta. Abrió un pull request en borrador para agregar un AGENTS.md mínimo al proyecto. Esa versión reducida se limita a indicarle a los agentes que revisen la documentación de LLVM sobre la política de contribución con herramientas de inteligencia artificial y sobre los estándares de codificación del proyecto.
Es una apuesta deliberadamente conservadora: en vez de escribir instrucciones nuevas, el archivo apunta a las reglas que el proyecto ya tiene escritas para colaboradores humanos. Eso reduce la superficie de discusión, porque nadie tiene que ponerse de acuerdo sobre contenido inédito, y también reduce el riesgo de que el archivo quede desactualizado respecto de la documentación oficial.
Queda por ver qué posición adopta finalmente LLVM sobre el asunto.
