tjboudreaux/ready-agent-1

Corrección de Preparación para Agentes

Mejora la preparación de un repositorio aplicando solo cambios seguros. El motor planifica y escribe andamios de configuración; tú manejas git y redactas cualquier prosa. Tres categorías, tres niveles de seguridad distintos.

Pasos

1. Asegúrate de que exista un informe. Si falta .agents/readiness/latest.json, ejecuta primero la habilidad ra1-report.

2. Ejecuta un dry-run del plan para ver qué cambiaría:

   python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <ruta-del-repo>
   

   Esto imprime tres categorías: Auto-aplicar (andamios de configuración seguros), Proponer (borradores para revisión), Ajustes de GitHub (manuales).

3. Crea primero una rama local (nunca trabajes en la rama por defecto):

   git -C <ruta-del-repo> checkout -b readiness/fixes
   

4. Aplica los andamios seguros (idempotente; se niega si el área de trabajo está sucia; nunca sobrescribe archivos no vacíos):

   python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <ruta-del-repo> --apply
   

5. Redacta tú mismo los elementos de "Proponer" — secciones del README, un AGENTS.md personalizado, manuales, una primera prueba. Escríbelos como borradores para que el usuario los revise; no inventes hechos sobre el código base. templates/AGENTS.md es un esqueleto inicial — complétalo con lo que realmente hace el repositorio.

6. Muestra el diff y haz commit localmente. Resume los cambios, luego:

   git -C <ruta-del-repo> add -A && git -C <ruta-del-repo> commit -m "chore: mejorar preparación para agentes"
   

   Termina el mensaje del commit con el trailer obligatorio Co-Authored-By.

7. Vuelve a ejecutar ra1-report para mostrar el delta de nivel.

Contrato (no violar)

• Nunca hagas push ni abras un PR sin confirmación explícita del usuario. Construye y haz commit localmente primero.
• Auto-aplica solo andamios de configuración. README/AGENTS.md/pruebas/manuales son borradores propuestos que el usuario revisa — escribir prosa automáticamente corre el riesgo de "documentar ficción".
• Nunca combines cambios de ajustes de GitHub (protección de ramas, escaneo de secretos, etiquetas) con commits de código. Preséntalos como una lista de verificación de comandos gh para que el usuario los ejecute y confirme.
• Respeta un área de trabajo sucia: no uses --force sobre trabajo sin commit sin preguntar.