Chapitre 4 · Quand ça coince
Bien décrire un bug
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementPourquoi la description compte autant
Un bug, c'est un comportement inattendu : un menu qui ne s'ouvre plus, une image qui disparaît, un formulaire qui ne part pas. La tentation est d'écrire « corrige ça ». Mais Claude Code ne voit pas ton écran. Avec une description floue, il devine. Et quand on devine, on corrige souvent un symptôme en cassant autre chose.
Exemple : tu écris « le bouton a disparu ». Claude Code regarde la page sur ordinateur : le bouton est là. Il modifie quand même quelque chose, au hasard. En réalité, le bouton disparaît seulement sur iPhone, dans Safari, quand on fait défiler la page. Avec ces trois informations, la cause se trouve beaucoup plus vite.
Comment décrire un bug
1. Les quatre informations indispensables
- La page : sur quelle page le problème apparaît.
- L'appareil et le navigateur : ordinateur ou téléphone, et lequel (par exemple iPhone avec Safari, ordinateur Windows avec Chrome).
- Les étapes pour le reproduire : ce que tu fais, dans l'ordre, pour voir le problème. « 1. J'ouvre l'accueil. 2. Je fais défiler. 3. Le bouton disparaît. »
- Ce qui se passe et ce qui devrait se passer.
2. Une capture d'écran
Fais une capture de l'état actuel, sur l'appareil concerné. Si tu as un exemple du résultat attendu (une ancienne capture, un croquis pris en photo), ajoute-le.
3. Les messages de la console
Sur ordinateur, appuie sur F12, ouvre l'onglet Console, refais les étapes qui provoquent le bug, et copie les messages en rouge s'il y en a. Tu n'as pas besoin de les comprendre : Claude Code, lui, saura les lire.
4. Un diagnostic avant toute correction
Demande d'abord la cause probable, expliquée en mots simples, sans rien modifier. Ensuite seulement, la plus petite correction possible.
Le prompt à copier
J'ai un bug.
Page : [page].
Appareil et navigateur : [ex. iPhone, Safari].
Étapes pour le reproduire : [1, 2, 3].
Ce qui se passe : [description].
Ce qui devrait se passer : [description].
Capture : [glisse l'image ici].
Messages de la console : [colle les messages en rouge, ou « aucun »].
1. Lis le code concerné et explique-moi la cause probable en mots
simples, sans rien modifier.
2. Propose la correction la plus petite possible, et dis-moi si elle
risque d'affecter d'autres pages.
3. Après mon accord : commit, correction, puis dis-moi exactement
comment vérifier que c'est réglé (y compris sur mobile).
Cas particulier : un problème d'affichage mobile
Sur mobile, la page [page] [description du problème].
Capture : [image].
Objectif : corriger sans changer l'affichage sur ordinateur.
Trouve d'abord la cause dans le CSS sans rien modifier.
Correction limitée aux petits écrans.
Format attendu : cause en 2 lignes, correction proposée, fichiers touchés.
Je vérifierai à 375 px et 1280 px, puis sur mon téléphone.
Erreurs à éviter
- « Ça ne marche plus. » Sans page, sans appareil, sans étapes, Claude Code part à l'aveugle.
- Oublier l'appareil. Beaucoup de bugs n'existent que sur téléphone, ou que dans un navigateur précis.
- Ne pas regarder la console. C'est souvent là que se trouve l'indice décisif.
- Accepter une correction sans diagnostic. Si Claude Code corrige sans expliquer la cause, demande-lui de s'arrêter et de l'expliquer d'abord.
À toi de jouer
- Ouvre ton site sur ton téléphone et parcours chaque page. Cherche un détail qui ne va pas : un texte qui déborde, un bouton trop petit, une image coupée.
- Remplis le modèle de description de bug avec les quatre informations.
- Sur ordinateur, ouvre la console (F12) sur cette page et note les messages en rouge éventuels.
- Envoie le prompt à Claude Code et lis le diagnostic. Ne valide la correction que si la cause expliquée te paraît claire.