« Améliore mon site. » C'est le genre de demande qu'on tape naturellement en premier réflexe, et c'est précisément celle qu'il faut apprendre à éviter. Ce guide vous montre pourquoi, et comment la reformuler pour garder le contrôle sur ce que Gemini va réellement faire.

Le problème d'une demande vague

« Améliore mon site » ne précise ni quel fichier, ni quel type d'amélioration, ni ce qui ne doit surtout pas changer. Face à une telle demande, Gemini doit deviner votre intention à partir de très peu d'éléments : il pourrait modifier la structure HTML, changer des couleurs, réorganiser des sections, ou toucher plusieurs fichiers à la fois, alors que vous n'imaginiez peut-être qu'un tout petit changement précis. Le résultat peut être correct, mais il peut aussi partir dans une direction que vous n'attendiez pas, et vous ne le saurez qu'après coup, en relisant un diff potentiellement large.

Trois ingrédients d'une bonne demande

Une demande contrôlable indique en général trois choses : le fichier concerné, le résultat attendu, et ce qui ne doit pas changer. On peut y ajouter une quatrième précision très utile pour une tâche un peu plus grande : demander d'abord un plan, avant toute modification réelle.

Comparons deux formulations

Voici la version vague, celle à éviter pour une tâche précise :

Et voici une version qui contient les trois ingrédients : le fichier, le résultat attendu, la limite.

Cette seconde version limite explicitement le fichier concerné (index.html uniquement), précise le résultat attendu (un paragraphe de deux phrases, à un endroit précis), exclut un fichier qui ne doit pas bouger (style.css), et demande une explication préalable avant toute action. Une réponse à cette demande sera bien plus facile à relire et à vérifier qu'une réponse à « améliore mon site ».

Demander un plan avant d'agir

Pour une tâche qui touche plusieurs fichiers, ou dont vous n'êtes pas certain du résultat exact, demandez explicitement à Gemini de décrire son plan avant toute modification, sans encore rien exécuter.

Vous pouvez alors lire ce plan, l'ajuster avec une nouvelle précision si besoin, et ne l'autoriser à agir qu'une fois que la direction générale vous convient. C'est une méthode particulièrement utile pour une tâche qui touche plus d'un fichier, ce que vous pratiquerez concrètement dans les guides 9 et 10 de ce parcours.

Pas de syntaxe magique à apprendre

Il n'existe pas de formule secrète ni de mots-clés obligatoires pour bien formuler une demande. Ce qui fonctionne, c'est la même clarté que vous utiliseriez pour expliquer une tâche à une personne qui découvre votre projet pour la première fois : le contexte, le résultat voulu, et les limites à respecter.

Bon réflexe

Avant d'envoyer une demande de modification, relisez-la une fois : contient-elle le nom du fichier concerné ? Le résultat attendu est-il assez précis pour que vous puissiez le vérifier ensuite d'un simple coup d'œil ? Si la réponse est non aux deux questions, la demande gagnera probablement à être reformulée avant d'être envoyée.

Vérifiez que vous avez compris

Entre « corrige mon fichier » et « dans style.css, corrige uniquement la couleur du bouton principal pour qu'elle soit bleu foncé, sans toucher au reste du fichier », laquelle des deux demandes sera la plus simple à vérifier après coup ?

La seconde. Elle précise le fichier, l'endroit exact du changement et le résultat attendu : après la réponse, il suffit d'ouvrir style.css, de vérifier que seule la couleur du bouton a changé, et de comparer la nouvelle couleur à ce qui était demandé. La première demande ne donne aucun repère de ce genre pour vérifier le résultat.

Chapitre terminé