Révision de AGENTS.md
Les verdicts appliquent le test défini dans agents-md : plus d'un tour de retour bon marché pour découvrir et corriger, et indiqué dans aucune compétence ou fichier toujours lu.
Vérifier, puis classer
Examinez le fichier tel qu'il vous est fourni et précisez la version révisée. Vérifiez chaque bloc par rapport à la réalité avant de le juger ; un élément de preuve par verdict suffit.
- Exemples et formats par rapport à l'outil qui les consomme (générateur de changelog, outils de release, workflows CI) : Erroné. Lire la configuration de l'outil suffit ; ce qu'il rendrait incorrectement est erroné, que la mauvaise sortie ait été livrée ou non.
- Listes par rapport à l'arborescence et à la branche par défaut distante : Obsolète.
- Conventions revendiquées par rapport à l'historique des PR fusionnées : Jamais une convention lorsque personne ne la suit et que le mainteneur confirme que personne ne l'a décidée. Un mainteneur peut introduire délibérément la règle, et un commiteur humain ne prouve rien sur qui l'a décidée ; une règle non suivie sur laquelle le mainteneur ne s'est pas prononcé va dans la liste des décisions humaines.
- Règles par rapport aux compétences installées et aux fichiers toujours lus : Redondant.
- Tout le reste par rapport au test ci-dessus : Découvrable, Sans contenu ou Commande simple.
- Un pointeur toujours chargé vers un long guide : Mal placé ; il appartient à la compétence qui en a besoin.
Un bloc peut obtenir plus d'un verdict, chacun avec sa propre preuve ; donnez la priorité à celui qui ne nécessite aucune confirmation humaine, afin que l'élagage puisse commencer avant que le mainteneur ne réponde.
Recherchez également ce qui est Manquant : politique que l'organisation applique ailleurs (règles de fichier d'intention, conventions d'écriture, marqueurs de commentaires), mises en page non standard sans pointeur, et un AGENTS.md sans lien symbolique CLAUDE.md frère.
agents-md/references/before-after.md est la réponse travaillée d'un dépôt ; revérifiez chaque ligne par rapport au dépôt devant vous, ne la collez jamais.
Rapport
| Bloc | Verdict | Preuve |
|---|---|---|
| `Issue: #456`, `Issue: N/A` comme pieds de page valides | Erroné, Jamais une convention | `cliff.toml` transforme chaque valeur `Issue:` en lien Jira ; le mainteneur confirme qu'aucune des deux n'a été décidée |
| Les tests pilotent le binaire CLI, pas la bibliothèque ; voir `testsuite/AGENTS.md` | Conserver | refaire une suite de tests au niveau de la bibliothèque nécessite plus d'un tour ; aucune compétence ne l'indique |
Proposez ensuite le fichier entièrement épuré, listez ce qui a été déplacé vers une compétence ou un AGENTS.md imbriqué, et listez ce qui nécessite une décision humaine.
N'appliquez pas les modifications sauf demande explicite.