Au guide précédent, votre demande portait naturellement sur index.html, puisque c'est le seul fichier du projet. Sur un projet avec plusieurs fichiers, ce que vous visez devient beaucoup moins évident pour l'Agent si vous ne le précisez pas. Ce guide vous montre comment fixer ce contexte explicitement, même sur un tout petit projet comme le vôtre.

Référencer un fichier explicitement

Dans le panneau Agent, vous pouvez mentionner un fichier précis en tapant @ suivi du début de son nom : une liste de suggestions apparaît, parmi lesquelles vous pouvez choisir index.html. Cette référence explicite ancre votre demande sur ce fichier précis, plutôt que de laisser l'Agent deviner lequel vous visez parmi ceux du projet ouvert.

Les trois éléments d'une demande contrôlable

Une bonne demande à l'Agent contient en général le fichier concerné, le résultat attendu, et une limite explicite sur ce qui ne doit pas changer. C'est exactement la même logique que celle enseignée dans le parcours Gemini CLI de Web-Shine Docs pour un autre outil : le principe ne dépend pas de l'outil utilisé, seulement de la clarté de votre formulation.

Un exemple sur mon-premier-site

Ouvrez le panneau Agent et tapez une demande qui applique ces trois éléments, sans encore demander de modification réelle :

« Dans @index.html, explique-moi précisément le rôle du titre principal, la balise h1. Ne modifie rien. »

Remarquez la différence avec une question plus vague comme « explique-moi ce fichier » : ici, vous ciblez un élément précis du fichier, ce qui rend la réponse plus facile à vérifier d'un simple coup d'œil, puisque vous savez exactement quelle partie du fichier elle est censée décrire.

Seulement après, une demande de modification

Une fois l'explication obtenue et jugée correcte, vous pouvez enchaîner avec une demande de modification, en gardant la même rigueur de contexte. Vous ne l'exécuterez pas encore dans ce guide : les guides 8 et 9 vous montreront respectivement comment lire un diff avant de l'accepter, et comment utiliser Tab et l'édition en ligne pour de plus petites retouches. Pour l'instant, contentez-vous d'observer que la formulation ci-dessus, une fois adaptée avec un résultat attendu précis, deviendrait directement utilisable pour une vraie modification.

Bon réflexe

Avant d'envoyer une demande à l'Agent, relisez-la : contient-elle une référence claire au fichier concerné, avec @ si plusieurs fichiers existent dans le projet ? Le résultat attendu est-il assez précis pour être vérifié d'un coup d'œil ? Ces deux questions valent la peine d'être posées à chaque demande un peu importante.

Vérifiez que vous avez compris

Sur un projet qui contiendrait à la fois index.html et style.css, une demande comme « change la couleur du titre » sans référence à un fichier précis pourrait-elle prêter à confusion pour l'Agent ?

Oui, potentiellement. La couleur du titre pourrait être définie directement dans index.html ou dans style.css, selon la structure du projet. Sans précision, l'Agent doit deviner où intervenir, ce qui peut le mener à modifier un fichier différent de celui que vous aviez en tête. Une référence explicite avec @ évite complètement cette ambiguïté.

Chapitre terminé