IA et legacy : l'incohérence n'a plus d'excuse

Le legacy, conséquence d'un produit qui dure

Une plateforme qui a vécu accumule des couches : Rails, Liquid, jQuery, CoffeeScript, plusieurs versions de Bootstrap, des sélecteurs CSS inutilisés, plusieurs façons de nommer un bouton. C'est le résultat normal d'un produit qui a servi.

La difficulté tient au rapport entre coût et visibilité. Supprimer un sélecteur mort ou harmoniser l'arrondi des boutons ne justifie pas un projet : chaque correction est trop petite pour être priorisée, et leur ensemble trop important pour être traité d'un coup.

L'effet de l'IA

L'IA fait tendre le coût d'une petite correction vers zéro. Depuis l'été 2026, je travaille au quotidien avec elle, et l'effet est visible dans mes pull requests :

Il s'agit de petites PR de nettoyage, chacune relue et réversible :

• code mort : sélecteurs CSS sans markup, clés de traduction qu'aucun template ne lit, polyfills et bibliothèques devenus inutiles
• cohérence visuelle : une seule valeur pour les arrondis, des menus qui suivent la forme des boutons, une seule couleur pour les états vides
• accessibilité : couleurs de statut contrastées, filtres annoncés aux lecteurs d'écran
• montées de version : icônes manquantes après Font Awesome 6, sélecteur de date modernisé

Un glossaire appliqué

Le glossaire vivait auparavant dans un document rarement consulté. Il est maintenant écrit pour l'IA, versionné dans le dépôt, et appliqué à chaque modification :

| Notion                      | Préféré | À éviter                      |
| Nom d'un bouton, d'un champ | Libellé | Label                         |
| Couleur derrière un élément | Fond    | Arrière-plan, Couleur de fond |

J'ai rédigé ces règles pour le dépôt des thèmes (wording, structure des réglages, CSS, Liquid, emails), ainsi que des outils d'audit qui mesurent le travail restant après une passe de corrections. Le glossaire recense même les écarts connus sur la branche principale.

Les limites

La relecture humaine devient le goulot d'étranglement : 132 PR en un mois représentent autant de relectures pour l'équipe. Elles doivent rester petites, lisibles et regroupées par thème, avec des captures avant/après quand le changement est visuel.

Les règles doivent être entretenues : un glossaire obsolète produit des corrections erronées, appliquées avec assurance.

Enfin, l'IA utilisée de façon générique produit des idées convenues. Sa valeur se trouve dans son application à notre code et à nos règles.

Pendant des années, la dette technique avait ses chantiers, tandis que la dette de design (incohérences visuelles et de vocabulaire) n'avait pas de responsable. Elle peut désormais être traitée au même rythme que le reste.