tjboudreaux/ready-agent-1

Correction de la préparation aux agents

Améliorez la préparation d'un dépôt en appliquant uniquement des modifications sûres. Le moteur planifie et rédige les squelettes de configuration ; vous gérez git et rédigez toute prose. Trois catégories, trois niveaux de sécurité différents.

Étapes

1. Assurez-vous qu'un rapport existe. Si .agents/readiness/latest.json est manquant, exécutez d'abord la compétence ra1-report.

2. Simulez le plan pour voir ce qui changerait :

   python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <chemin-du-depot>
   

   Cela affiche trois catégories : Application automatique (squelettes de configuration sûrs), Proposition (brouillons à réviser), Paramètres GitHub (manuel).

3. Créez d'abord une branche locale (ne travaillez jamais sur la branche par défaut) :

   git -C <chemin-du-depot> checkout -b readiness/fixes
   

4. Appliquez les squelettes sûrs (idempotent ; refuse sur un espace de travail sale ; n'écrase jamais les fichiers non vides) :

   python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <chemin-du-depot> --apply
   

5. Rédigez vous-même les éléments « Proposition » — sections README, AGENTS.md personnalisé, runbooks, un premier test. Rédigez-les comme des brouillons à faire réviser par l'utilisateur ; n'inventez pas de faits sur le codebase. templates/AGENTS.md est un squelette de départ — remplissez-le en fonction de ce que le dépôt fait réellement.

6. Affichez le diff et commitez localement. Résumez les modifications, puis :

   git -C <chemin-du-depot> add -A && git -C <chemin-du-depot> commit -m "chore: améliorer la préparation aux agents"
   

   Terminez le message de commit par le pied de page Co-Authored-By requis.

7. Réexécutez ra1-report pour montrer le delta de niveau.

Contrat (ne pas enfreindre)

• Ne jamais pousser ni ouvrir de PR sans confirmation explicite de l'utilisateur. Construisez et commitez localement d'abord.
• Appliquer uniquement les squelettes de configuration. Les README/AGENTS.md/tests/runbooks sont des brouillons proposés que l'utilisateur révise — rédiger automatiquement de la prose risque de « documenter une fiction ».
• Ne jamais regrouper les modifications des paramètres GitHub (protection de branche, analyse des secrets, labels) avec les commits de code. Présentez-les comme une liste de commandes gh à exécuter et confirmer par l'utilisateur.
• Respectez un espace de travail sale : n'utilisez pas --force sans demander d'abord.