Copilot Code Review lit AGENTS.md : prépare ton repo pour une review IA utile

[CrdaN]

Copilot Code Review lit AGENTS.md : prépare ton repo pour une review IA utile

GitHub a annoncé le 18 juin 2026 une amélioration discrète mais très pratique : Copilot Code Review peut maintenant lire le fichier AGENTS.md à la racine d’un dépôt. Dit autrement, la review IA peut tenir compte des règles du projet au lieu de commenter le code comme si tous les repos avaient les mêmes conventions.

Pour un bot Discord, un outil forum, un script d’automatisation, un projet web ou un petit dashboard serveur, c’est exactement le genre de détail qui change la qualité des retours. Un agent IA sans contexte peut repérer des bugs, mais il peut aussi proposer des corrections hors style, ignorer vos contraintes, ou demander des changements qui ne collent pas au projet.

Source : GitHub Changelog, 18 juin 2026.

Ce qui change concrètement​

D’après GitHub, Copilot Code Review sait maintenant :

• lire un fichier AGENTS.md placé à la racine du repo ;
• utiliser les instructions pertinentes de ce fichier pendant la review ;
• mieux adapter ses commentaires aux conventions et attentes du dépôt ;
• être demandé plus facilement sur les pull requests en brouillon ;
• afficher moins de bruit dans la timeline des PR grâce à des événements regroupés.

Le point important n’est pas “Copilot devient magique”. Le point important, c’est que la review IA devient plus pilotable. Au lieu d’espérer que l’outil devine votre manière de travailler, vous pouvez lui donner une fiche de route courte.

Pourquoi AGENTS.md est utile​

Un fichier AGENTS.md sert à expliquer à un agent IA comment contribuer proprement au projet. Ce n’est pas un README marketing. Ce n’est pas non plus une documentation complète. C’est plutôt une checklist de comportement : comment tester, comment nommer, quoi éviter, quelles zones sont sensibles, quelles commandes sont autorisées, et quel niveau de prudence attendre.

Exemples utiles pour Cheat-Gam3 :

• un bot Discord ne doit jamais logger les tokens ;
• un scraper ne doit pas spammer une source externe ;
• un script XenForo ne doit pas afficher la clé API ;
• une PR doit inclure un test ciblé si le projet en possède ;
• les changements de base de données doivent être séparés du refactor ;
• les fichiers .env, cookies et secrets restent hors review publique.

C’est simple, mais ça évite beaucoup de commentaires inutiles.

Le bon AGENTS.md : court, précis, vérifiable​

Le piège serait de créer un pavé de 200 lignes que personne ne lit et que l’IA interprète mal. Pour une review IA, mieux vaut un fichier court, structuré, avec des règles testables.

Un bon AGENTS.md devrait répondre à 5 questions :

1. Quel est le but du projet ?
2. Comment lancer les tests ou vérifications ?
3. Quelles conventions respecter ?
4. Quelles actions sont interdites ou sensibles ?
5. Quel format de réponse est attendu dans une review ?

Si une règle n’aide pas à reviewer ou modifier le code, elle n’a probablement pas sa place ici.

Pour voir le contenu, vous devez réagir aux messages avec l'une de ces réactions :

Réagir, Love, Haha, Oula, Triste, Colère

Comment l’utiliser avec une PR​

La méthode propre :

1. ajoute AGENTS.md à la racine du repo ;
2. ouvre une petite PR dédiée ;
3. demande une review Copilot sur une PR de test ou une vraie correction ;
4. compare les commentaires avant/après ;
5. supprime les règles trop vagues ;
6. garde seulement ce qui améliore les reviews.

Ne cherche pas à tout verrouiller dès le premier jour. Un bon fichier agent se construit avec l’expérience : quand Copilot fait une remarque inutile, ajoute une règle. Quand il rate un risque récurrent, ajoute un rappel précis. Quand une règle n’apporte rien, retire-la.

Les erreurs à éviter​

• Trop vague : “fais du code propre” ne sert à rien.
• Trop long : plus il y a de règles, plus le signal se dilue.
• Trop permissif : ne donne jamais carte blanche sur secrets, prod, paiements ou déploiement.
• Trop agressif : si tu interdis tout, l’agent ne peut plus aider.
• Non vérifiable : une règle doit pouvoir guider une action ou un commentaire concret.

Le but n’est pas de transformer Copilot en chef de projet. Le but est de lui donner assez de contexte pour éviter les reviews génériques.

Mini workflow recommandé​

Pour un projet perso ou communautaire, je partirais sur ce rythme :

• 1 fichier AGENTS.md court à la racine ;
• 1 PR = 1 objectif ;
• review IA sur draft avant de demander une review humaine ;
• tests visibles dans la PR ;
• validation humaine avant merge ;
• pas de secrets dans les logs, jamais.

C’est particulièrement utile si plusieurs personnes touchent au même bot, au même site ou au même outil interne. L’IA rappelle les règles du repo, mais l’humain garde le dernier mot.

Pour voir le contenu, vous devez réagir aux messages avec l'une de ces réactions :

Réagir, Love, Haha, Oula, Triste, Colère

À retenir​

Le support de AGENTS.md dans Copilot Code Review va dans le bon sens : les agents IA deviennent plus utiles quand ils connaissent les règles locales du projet.

Pour les devs Cheat-Gam3, c’est une bonne habitude à prendre maintenant. Même un petit fichier de 30 lignes peut améliorer les reviews, réduire les commentaires inutiles et éviter les changements dangereux.

La règle simple : moins de blabla, plus de consignes concrètes. Explique comment tester, quoi protéger, ce qui est hors limites, et quel type de retour tu veux. Copilot fera une meilleure première passe, et toi tu gardes la vraie décision avant de merge.