Votre kit agent : 3 fichiers à copier dans votre projet

Les 3 fichiers

Téléchargez-les, ou ouvrez-les ici pour les lire avant.

1. 1 AGENTS.md Les règles de votre agent Ce qu’il fait seul, ce qu’il vous demande d’abord, et comment il prouve que « c’est fait ». Télécharger AGENTS.md
   Lire le fichier

   # AGENTS.md : les règles de votre agent
   
   > Kit offert par Hugo, L'IA faite pour vous (iafaitepourvous.fr). Copiez ce fichier à la racine de votre
   > projet et remplacez les lignes entre < >. Codex le lit tout seul. Pour Claude Code, créez à côté un
   > fichier CLAUDE.md qui contient une seule ligne : @AGENTS.md
   
   ## Le projet
   
   <En 3 lignes : ce que fait le projet, et pour qui. Pas son histoire.>
   
   ## Ce que tu fais seul, ce que tu me demandes
   
   - **Seul :** tout ce qui se défait facilement. Modifier un fichier, lancer les tests, enregistrer ton
     travail sur une branche à part.
   - **Tu me demandes d'abord :** supprimer un fichier ou des données, mettre en ligne, payer, écrire à
     quelqu'un, toucher à un compte ou à un réglage en ligne.
   
   ## Avant de dire « c'est fait »
   
   - Lance ce que tu as changé et regarde le résultat. Une explication n'est pas une preuve.
   - Dis en une ligne ce que tu as vérifié et ce que tu n'as pas vérifié.
   - Un échec se dit avec sa ligne d'erreur, sans l'enrober.
   
   ## Avant de corriger un bug
   
   - Trouve la cause et montre-la avant de changer le code.
   - Écris d'abord un test qui échoue à cause du bug, puis corrige, puis montre le test qui passe.
   
   ## Mise en ligne
   
   - Jamais directement sur la branche principale : une branche, puis une demande de fusion.
   - Mise en ligne seulement si les contrôles passent, dans la même commande :
     `npm test && <commande de mise en ligne>`. Le `&&` arrête tout si un test échoue.
   - Chaque mise en ligne a sa commande de retour arrière, écrite dans HANDOFF.md avant de lancer.
   
   ## Secrets
   
   - Les clés et les mots de passe vivent dans un fichier `.env`, listé dans `.gitignore` : jamais dans le
     code, jamais dans git, jamais affichés dans la conversation.
   
   ## Les commandes du projet
   
   | Faire | Commande |
   |---|---|
   | Lancer en local | <…> |
   | Lancer les tests | <…> |
   | Mettre en ligne | <…> |
   
   ## Les pièges connus
   
   - <Ce qui a déjà cassé, et ce qui l'évite. Deux lignes après chaque incident.>
   
   ## Fin de séance
   
   - Mets à jour HANDOFF.md : la prochaine action, ce qui reste ouvert, ce qui bloque, le retour arrière.
   - La séance suivante commence par la lecture de HANDOFF.md, et toi aussi quand ta mémoire a été
     compressée.
   

2. 2 HANDOFF.md Le carnet de passation Où en est le projet, la prochaine action, le retour arrière : relu à chaque reprise. Télécharger HANDOFF.md
   Lire le fichier

   # HANDOFF.md : où en est le projet
   
   > Kit offert par Hugo, L'IA faite pour vous (iafaitepourvous.fr). L'agent réécrit ce fichier à chaque fin
   > de séance et le relit au début de la suivante, ou quand sa mémoire a été compressée.
   
   Mis à jour le : <AAAA-MM-JJ HH:MM>
   
   ## Prochaine action (la plus difficile d'abord)
   
   1. <Une action précise, avec le fichier ou la commande concernés.>
   2. <…>
   
   ## État vérifié
   
   | Branche | Dernier enregistrement | Tests | Vérifié comment |
   |---|---|---|---|
   | <nom> | <identifiant du commit> | <ex. 42 réussis, 0 échec> | <commande lancée, date> |
   
   ## Ce qui reste ouvert
   
   | Point | Priorité | Mis de côté parce que |
   |---|---|---|
   | <…> | <haute, moyenne, basse> | <…> |
   
   ## Ce qui bloque
   
   - <Ce qui attend une personne, un accès ou une réponse. Rien : « aucun ».>
   
   ## Ce qu'on a essayé et qui n'a pas marché
   
   | Essayé | Pourquoi ça n'a pas tenu |
   |---|---|
   | <…> | <…> |
   
   ## Retour arrière
   
   ```
   <la commande exacte qui annule le dernier changement mis en ligne>
   ```
   

3. 3 CHECKLIST-mise-en-ligne.md Les 8 vérifications avant de mettre en ligne Tests, retour arrière, secrets, aperçu : votre agent vérifie, vous décidez. Télécharger CHECKLIST-mise-en-ligne.md
   Lire le fichier

   # Avant de mettre en ligne : 8 vérifications
   
   > Kit offert par Hugo, L'IA faite pour vous (iafaitepourvous.fr). Demandez à votre agent de passer cette
   > liste avant chaque mise en ligne : il vérifie, il montre la preuve, et c'est vous qui décidez.
   
   1. **Les tests passent**, lancés maintenant et pas hier. Le nombre de réussites et d'échecs est écrit.
   2. **La mise en ligne dépend des tests** : une seule commande avec `&&`, jamais deux commandes séparées.
   3. **Le retour arrière est écrit** dans HANDOFF.md avant de lancer, et vous savez qui le lance.
   4. **Aucun secret ne part** : pas de clé dans le code, le fichier `.env` est ignoré par git.
   5. **Vous avez vu le résultat** dans un aperçu, sur ordinateur et sur téléphone.
   6. **Le changement tient en une phrase** dans le journal des changements, compréhensible par quelqu'un
      d'extérieur au projet.
   7. **Ce qui n'a pas été vérifié est dit**, pas passé sous silence.
   8. **Après la mise en ligne**, vous ouvrez la vraie adresse et vous voyez la modification de vos yeux.
   

Comment vous en servir

1. Copiez AGENTS.md et HANDOFF.md à la racine de votre projet.
2. Remplacez les lignes entre < > : ce que fait le projet, vos commandes, vos pièges connus.
3. Avec Codex, rien d’autre à faire : il lit AGENTS.md tout seul. Avec Claude Code, créez à côté un fichier CLAUDE.md qui contient une seule ligne : @AGENTS.md.
4. Avant chaque mise en ligne, demandez à votre agent de passer la liste des 8 vérifications et de vous montrer ses preuves.

Pour apprendre à construire et à faire travailler des agents, dans l’ordre : se former aux agents IA

Qui vous écrit : mon parcours