Qué debe contener
AGENTS.md sirve para convenciones estables del repositorio: arquitectura, comandos, estilo, límites y verificación. No lo conviertas en una enciclopedia ni guardes secretos.
# AGENTS.md ## Arquitectura - app/ contiene rutas; lib/ contiene datos compartidos. ## Comandos - npm run lint - npm test - npm run build ## Convenciones - Sigue los componentes existentes. - No añadas dependencias sin justificarlo. ## Verificación - Prueba móvil y escritorio en cambios de UI.
Jerarquía por carpetas
Las instrucciones más cercanas al archivo tienen prioridad. Un AGENTS.md en la raíz define reglas generales y otro dentro de un módulo puede precisar comandos o convenciones de ese ámbito.
Créalo y audítalo
El comando /init puede crear un punto de partida. Después debes revisarlo como código: elimina vaguedades, confirma comandos y mantén el documento corto.
/init Lee todos los AGENTS.md aplicables y resume las reglas que gobernarán esta tarea antes de editar.
Señal de calidad
Una persona nueva debería poder ejecutar el proyecto y validar un cambio leyendo el archivo. Si una regla solo aplica a una tarea, déjala en el prompt y no la conviertas en norma permanente.