Chapitre 1 · Comprendre pourquoi un site casse
Les 3 raisons pour lesquelles un site casse
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementPourquoi un site casse
Un site ne casse presque jamais « tout seul ». Quand une modification tourne mal, on retrouve souvent l'une de ces trois causes.
Raison 1 : une demande trop large
« Change le haut de la page. » « Améliore le design. » « Rends ça plus moderne. »
Ces phrases peuvent vouloir dire dix choses. Claude Code en choisira une, pas forcément la bonne. Et plus la demande est large, plus il touche de fichiers. Si quelque chose casse, impossible de savoir quoi.
Exemple : tu demandes « fais un plus beau menu ». Claude Code réécrit le menu, change sa structure, ajuste le style commun à tout le site. Résultat : sur mobile, le bouton du menu (les trois traits) ne s'ouvre plus. Le problème est enfoui au milieu de dizaines de changements.
Raison 2 : la refonte cachée
Tu demandes une petite chose. Claude Code en profite pour « améliorer » autre chose : il reformate un fichier entier, renomme une classe (un nom qui relie un élément de la page à son style), réorganise un dossier. Rien de tout ça n'était demandé.
Exemple : tu veux agrandir un bouton. Claude Code renomme au passage la classe bouton-principal en btn-primary, parce que c'est « plus propre ». Mais la page contact utilisait encore l'ancien nom. Le bouton de la page contact perd tout son style.
Raison 3 : aucune sauvegarde
C'est la cause qui transforme une petite erreur en catastrophe. Sans point de sauvegarde, tu ne peux pas revenir à la version qui marchait. Tu essaies de réparer, puis de réparer la réparation, et le site s'éloigne de plus en plus de son état d'origine.
Comment éviter ces trois pièges
Chaque piège a sa parade, et tu vas toutes les apprendre :
- Contre la demande trop large : une demande précise, avec où (page, section), quoi (l'état actuel), ce que tu veux (le résultat attendu) et ce qui ne doit pas changer. Avec une capture d'écran si possible.
- Contre la refonte cachée : exiger un plan avant toute modification, avec la liste des fichiers touchés. Et une règle : Claude Code ne touche à rien d'autre.
- Contre l'absence de sauvegarde : Git, avec un point de sauvegarde avant et après chaque modification. C'est tout le chapitre 2.
Voici un prompt qui applique déjà les deux premières parades. Remplace les parties entre crochets.
Sur la page [nom de la page], section [nom ou position de la section],
voici une capture de l'état actuel : [glisse l'image ici].
Ce que je veux : [description précise, ex. le bouton « Me contacter »
à droite du titre au lieu de dessous, même couleur].
Ce qui ne doit pas changer : les textes, les autres pages,
la version mobile actuelle du menu.
Avant de modifier, dis-moi quels fichiers tu vas toucher
et ce que tu vas changer, en 5 lignes maximum. Attends mon accord.
Ne fais aucune autre amélioration, aucun renommage, aucun reformatage.
Pour donner une capture à Claude Code, glisse l'image dans sa fenêtre ou indique le chemin du fichier. Une capture vaut souvent un long paragraphe.
Erreurs à éviter
- « Améliore le site. » Trop vague. Décris un seul changement à la fois.
- Tout demander en une fois. « Refais le design et ajoute un blog » touche tout le site. Découpe en petites étapes.
- Valider un plan sans le lire. Si le plan cite un fichier que tu n'attendais pas, demande pourquoi.
- Accepter les « petites améliorations » non demandées. Même si elles semblent utiles, elles sont la première source de surprises.
À toi de jouer
Pense à une modification que tu veux faire sur ton site depuis longtemps.
- Écris-la d'abord comme tu l'aurais dite spontanément.
- Réécris-la avec le modèle ci-dessus : où, quoi, ce que tu veux, ce qui ne doit pas changer.
- Fais une capture de la zone concernée, sur ordinateur et sur téléphone.
Garde ce texte et ces captures, mais ne l'envoie pas encore. Tu l'utiliseras après avoir mis Git en place, au chapitre suivant.