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.
Entrega de la lección
Qué vas a construir
Una evidencia práctica para "Enseña el repositorio con AGENTS.md" aplicada a un repositorio real o de entrenamiento.
Por qué es importante
El objetivo es convertir la idea de la lección en una acción verificable, no solo en una lectura.
Repositorio o archivos iniciales
Un repositorio pequeño con Git, README y un comando de validación conocido.
Pasos
- 1. Revisa el estado de Git antes de empezar.
- 2. Pide a Codex que trabaje con alcance limitado.
- 3. Ejecuta el comando de verificación.
- 4. Revisa el diff o la evidencia producida.
- 5. Anota qué queda comprobado y qué queda pendiente.
Encargo listo para Codex
Aplica la lección "Enseña el repositorio con AGENTS.md" en este repositorio. Trabaja con cambios pequeños, cita archivos concretos, ejecuta una verificación y termina con resumen de evidencias y riesgos.
Resultado esperado
Una salida revisable: mapa, plan, diff, prueba o informe según el tipo de lección.
Comando de verificación
git status --short && git diff --stat
Comprobación manual
Comprueba que el resultado coincide con el alcance pedido y que Codex no ha tocado archivos ajenos.
Mini ejercicio
Repite la práctica en otra carpeta del mismo repositorio cambiando solo una restricción.
Ver solución
Mantén el mismo objetivo, añade una restricción explícita y compara si la evidencia final mejora.
Evidencia que debes guardar
Guarda el prompt usado, comandos ejecutados, salida relevante y git diff --stat.
Fuentes oficiales y versión probada
Si has guardado la evidencia de esta lección, continúa con «Implementa, prueba y revisa la interfaz». Si no, repite la comprobación antes de avanzar.