Brief de session
Un agent travaille comme un prestataire : il lui faut un but, ce qui est hors périmètre, les fichiers concernés et un critère de fin observable. « Améliore la landing » n'est pas un brief.
- brief
- hors périmètre
- critère de fin
- done
- plan
- ticket
Syntaxe
But : le changement attendu, en une phraseHors périmètre : ce qu'il ne faut pas toucherFichiers : un à quatre fichiers nommésFin : un critère observable (commande qui passe, comportement visible)Plan d'abord si la surface est large ou le risque élevéExemple
But : le bouton « Essayer une leçon » mène à la première leçon SQLHors périmètre : page des tarifs, authentificationFichiers : src/components/LandingPage.tsxFin : le lien ne pointe plus vers /register, et npm run lint renvoie 0 erreurRésultat attendu : un diff d'un seul fichier, vérifiable en trente secondes.À retenir
- Sans hors-périmètre explicite, l'agent profite souvent de la tâche pour remanier du code voisin que personne n'a demandé de relire.
- « Plus propre » n'est pas un critère de fin ; « npm run lint sans erreur » ou « le test X passe » en sont.
- Si la même vérification échoue deux fois de la même façon (deux erreurs tsc identiques, par exemple), l'agent doit s'arrêter et rendre la main plutôt que tenter une troisième réécriture.
- Piège : lister dix fichiers « au cas où ». L'agent se sent autorisé à les modifier ; ne nommez que ceux qui doivent changer.
Voir aussi
- Chat, Plan ou AgentTrois niveaux d'autonomie : le chat explique sans toucher aux fichiers, le plan fait valider les étapes avant le code, l'agent modifie et exécute dans les limites d'un brief.
- Chaîne spécification → plan → PRUne fonctionnalité confiée à un agent suit une chaîne courte : une spécification avec critères testables, un plan de fichiers ordonné, une implémentation bornée, puis une revue humaine.
- Itérer un promptLe premier prompt est rarement le bon. Une boucle demande, sortie, critique, amélioration corrige un défaut précis à chaque tour, au lieu de tout relancer en espérant un meilleur résultat.
- Agents en ligne de commandeUn agent de code en terminal lit, modifie et lance des commandes pour prouver que son travail compile. Sa valeur tient à la boucle lire, modifier, exécuter, corriger, et aux limites qu'on lui pose.