Un diff est la différence entre l'ancien contenu d'un fichier et le nouveau contenu proposé. Cursor l'affiche sous une forme visuelle claire : lignes ajoutées d'un côté, lignes supprimées de l'autre. Ce guide vous fait provoquer un vrai diff sur index.html, et vous apprend à le lire avant de l'accepter.

L'état actuel de index.html

Ouvrez index.html : vous devez y retrouver la ligne <h1>Bonjour</h1>, telle que créée au guide 3. C'est cette ligne précise que vous allez demander à l'Agent de modifier.

Demander une modification ciblée

Ouvrez le panneau Agent avec Ctrl+I, et formulez une demande précise, avec les trois éléments appris au guide précédent.

« Dans @index.html, remplace le texte du titre h1, actuellement "Bonjour", par "Bienvenue sur mon site". Ne touche à rien d'autre. »

Lire le diff proposé

À la fin de sa réponse, l'Agent affiche généralement un aperçu du changement directement dans la conversation, avant de l'appliquer au fichier. Vous devez y retrouver une représentation proche de ceci :

Le signe - (souvent affiché en rouge, avec la ligne barrée ou surlignée) indique la ligne supprimée : c'est l'ancien contenu, tel qu'il existait avant la proposition. Le signe + (généralement en vert) indique la ligne ajoutée : c'est le nouveau contenu proposé. Une ligne qui n'apparaît dans aucune des deux couleurs signifie qu'elle reste inchangée, ce qui est exactement le cas pour tout le reste de index.html ici.

Pourquoi vérifier avant d'accepter

Sur cet exemple, la modification est volontairement simple et sans surprise. Mais le réflexe de lecture compte davantage que la difficulté de l'exemple : c'est en le pratiquant sur un changement simple que vous saurez le reproduire naturellement sur un changement plus important, où une ligne inattendue pourrait facilement passer inaperçue si vous cliquiez sur Accepter sans lire.

Accepter le changement

Si le diff correspond à ce que vous attendiez, utilisez le bouton d'acceptation proposé par Cursor, souvent nommé « Accept » ou représenté par une coche, associé au fichier concerné. Sur une tâche qui toucherait plusieurs fichiers, Cursor propose généralement une revue fichier par fichier, ce qui vous permet d'accepter ou de refuser chaque fichier individuellement plutôt que tout d'un bloc.

Vérifier le résultat dans le fichier

Une fois accepté, ouvrez à nouveau index.html pour confirmer que la ligne a bien changé, et que rien d'autre n'a bougé.

Vous pouvez aussi ouvrir index.html dans un navigateur pour voir concrètement ce changement de texte, en double-cliquant sur le fichier depuis votre explorateur.

Si vous n'êtes pas d'accord avec la proposition

Vous n'êtes jamais obligé d'accepter un diff tel quel. Vous pouvez le refuser, ou répondre dans la conversation pour préciser ce qui ne convient pas, avant qu'une nouvelle proposition ne soit générée. Refuser une proposition n'a aucune conséquence négative : c'est exactement le mécanisme de contrôle que ce guide cherche à vous faire pratiquer.

Vérifiez que vous avez compris

En relisant le diff proposé par l'Agent, vous remarquez une ligne supplémentaire modifiée dans style.css, alors que votre demande ne portait que sur le titre de index.html. Que devriez-vous faire ?

Refuser cette partie de la proposition, ou demander à l'Agent pourquoi ce fichier supplémentaire a été touché avant d'accepter quoi que ce soit. Un changement non demandé, même qui semble anodin, mérite toujours une clarification avant validation : c'est exactement la situation que la lecture attentive du diff, pratiquée dans ce guide, est censée détecter.

Chapitre terminé