Ce dont une boucle d’auto-amélioration a besoin
Un agent améliore son propre travail quand quatre conditions sont réunies :
- Il peut agir : écrire le code, lancer l’application, remplir le formulaire.
- Il peut observer le résultat, pas seulement sa propre sortie. « Le code a compilé » ne veut pas dire « l’utilisateur a reçu l’e-mail ».
- Il peut comparer cette tentative avec la précédente, pour savoir si une modification a aidé.
- Il peut garder ce qu’il a appris, pour que la tentative suivante, ou la session suivante, parte de plus loin.
Les agents font déjà bien le premier point. Les trois autres dépendent des outils.
Où la boucle se rompt pour l’inscription
- Le résultat est dans une boîte de réception. L’agent envoie le formulaire et voit « Vérifiez votre e-mail ». Savoir si quelque chose a été envoyé, où pointe son lien et si le code fonctionne lui échappe.
- Il annonce donc le succès trop tôt. « L’inscription est implémentée » veut souvent dire que le formulaire s’envoie. L’agent n’a aucune preuve, ni dans un sens ni dans l’autre, et vous non plus.
- Une adresse inventée ne permet pas d’aller au bout du parcours, et votre propre adresse ne fonctionne qu’une fois.
- Rien n’est conservé. Sans trace de la dernière exécution, l’agent ne distingue pas une correction d’une coïncidence.
La boucle avec Proxy Mail QA
L’agent fait chaque étape. Proxy Mail QA est ce avec quoi il vérifie.
| Étape | L’agent | L’outil qu’il utilise |
|---|---|---|
| Agir | Construit ou modifie le parcours, ouvre la page d’inscription | Son propre éditeur et son navigateur |
| Obtient une adresse, un persona et un mot de passe pour le formulaire | form_values ou create_address |
|
| Observer | Attend le code ou le lien après l’envoi | wait_for_code, wait_for_link |
| Demande pourquoi rien n’est arrivé | check_delivery |
|
| Vérifie l’envoi, le lien, l’expiration et la taille de l’e-mail | check_email, count_emails |
|
| Comparatifs | Enregistre la session et lit ce qui a changé depuis les dernières | start_run, finish_run |
| Garder | Enregistre ce qu’il a appris sur le formulaire, avec votre accord | save_custom_field, save_signup_screen |
Un premier passage se déroule souvent ainsi :
- L’agent ajoute la vérification par e-mail et s’inscrit avec une nouvelle adresse de test.
- L’attente ne donne rien. La vérification de livraison indique que le fournisseur d’e-mail n’envoie qu’aux adresses vérifiées. L’agent voit que son travail n’est pas terminé, et pourquoi.
- Il corrige la configuration du fournisseur et relance. L’e-mail arrive en quatre secondes, mais la vérification indique que son lien pointe vers
localhost. - Il corrige l’URL du site et relance. Le lien ouvre la préproduction, le compte est vérifié et un seul e-mail est arrivé.
- Le rapport de l’exécution montre les trois tentatives. L’agent vous dit ce qu’il a modifié et montre les preuves.
Sans la boîte de réception, l’agent se serait arrêté après l’étape 1 en disant avoir terminé.
Trois choses que l’agent améliore
Son travail, dans cette session. Chaque vérification répond par ce qui a échoué et pourquoi : la modification suivante de l’agent vise donc quelque chose de précis. C’est la boucle ci-dessus.
La configuration du projet, pour toutes les sessions suivantes. Quand l’agent rencontre un champ qu’il ne peut pas remplir, comme la taille de l’entreprise, il peut vous demander et enregistrer la réponse comme champ personnalisé. Quand il constate que le formulaire s’étend sur plusieurs écrans, il peut les enregistrer. L’agent suivant, ou la personne suivante avec l’extension Chrome, remplit le formulaire correctement du premier coup. L’agent ne modifie cela que si vous le demandez ou l’acceptez.
Ses propres instructions, pour lui-même. Demandez à l’agent de terminer une session en écrivant ce qu’il a appris dans le fichier qu’il lit au début de chacune (CLAUDE.md, AGENTS.md ou une compétence) : « le fournisseur d’e-mail de la préproduction exige un domaine vérifié », « le lien de réinitialisation expire en 10 minutes, ouvrez-le tout de suite ». C’est la partie la plus proche du mot récursif : l’agent utilise les preuves d’une exécution pour changer sa façon de travailler à la suivante.
After each change to sign-up, login or password reset, run the auth regression pack onstaging with Proxy Mail QA. If the report shows a new failure, fix it and run again.When it passes, add one line to AGENTS.md for anything you learnt that the next sessionshould know, and show me the report.Savoir s’il a progressé
Une boucle a besoin d’une mesure. Le pack de régression d’authentification fait les mêmes vérifications à chaque fois : inscription, lien déjà utilisé ouvert deux fois, lien de réinitialisation remplacé, invitation. Son rapport se termine par ce qui a changé depuis les dernières exécutions : e-mails plus lents, e-mails en trop, échecs nouveaux ou intermittents, vérifications nouvellement en échec, nouvel expéditeur ou nouveau site de lien.
L’agent dispose ainsi d’un avant et d’un après, et vous d’une lecture que l’agent n’a pas écrite sur lui-même.
Quand c’est une personne qui signale un bug, la même boucle part de son rapport : voir Trier les rapports de bug d’inscription et de connexion avec un agent.
Ce qui reste de votre ressort
- Proxy Mail QA ne modifie aucun modèle ni aucun code. L’amélioration vient de l’agent, et les erreurs aussi. Lisez le rapport, pas seulement le résumé.
- Uniquement des builds de test. La boucle s’exécute sur des sites de développement, de préproduction et de prévisualisation, jamais sur votre site en production ni sur les comptes de vrais utilisateurs.
- Les changements durables demandent votre accord. Les champs personnalisés, les sites et les écrans d’inscription concernent tout le projet.
- Le rapport ne contient aucun texte d’e-mail. Il garde les adresses, les durées, les vérifications et le site de chaque lien : il peut donc figurer dans une pull request.
- E-mail uniquement. Les codes envoyés par SMS ne sont pas couverts.