Parlons de votre projet
Aller au contenu
Toutes les publications

Migration de code legacy avec l’IA : prouver l’équivalence avant la bascule

Par Docteur en intelligence artificielle · Conseil, conception de systèmes et formation

LegacyAgents de codeMigration4 novembre 202610 min

Changer de langage, de framework ou de plateforme exige un contrat de comportement. Les agents peuvent aider à réécrire ; ils ne décident pas seuls de l’équivalence.

Illustration de l’article « Migration de code legacy avec l’IA : prouver l’équivalence avant la bascule »

Une migration de code legacy remplace une technologie d’implémentation tout en préservant les comportements dont dépendent les utilisateurs et les systèmes connectés. Avec l’IA, le critère de réussite reste cette continuité démontrée, pas le volume de code traduit.

La reprise d’un logiciel sans documentation traite de la compréhension de l’existant. Cet article porte sur le changement de langage, de framework ou de plateforme une fois le périmètre identifié. La méthode proposée par Anand Candassamy organise le corpus de référence, les tests d’équivalence et la décision de bascule, sans supposer qu’un agent peut certifier son propre résultat.

Que faut-il préserver pendant une migration de code legacy ?

Une migration doit préserver les contrats observables nécessaires au fonctionnement réel : résultats, formats, erreurs, droits, effets de bord et contraintes d’exploitation acceptées par les responsables.

La recommandation est de commencer par une liste de parcours plutôt que par les fichiers du dépôt. Un traitement peut sembler identique sur son résultat principal et différer sur un export, un arrondi ou une erreur. Le propriétaire métier doit indiquer ce qui constitue une rupture pour les utilisateurs.

Le contrat décrit les entrées acceptées, les sorties attendues et les changements d’état. Il précise aussi les comportements que l’équipe souhaite abandonner. Cette distinction empêche de conserver involontairement une anomalie historique ou de supprimer une compatibilité encore utilisée. Un changement voulu doit être approuvé comme tel.

Les contraintes d’exploitation entrent dans le même dossier : reprise après interruption, accès aux données, observabilité et retour à la version précédente. Une application qui reproduit une réponse mais ne sait plus reprendre un traitement n’est pas équivalente sur ce parcours.

Le livrable initial est donc un contrat de migration. Il nomme les comportements conservés, les écarts autorisés et les responsables capables de les accepter, avant toute réécriture importante.

Faut-il migrer progressivement ou basculer toute l’application ?

La migration progressive convient lorsque des frontières permettent de remplacer un parcours à la fois ; une bascule globale demande un périmètre et une reprise suffisamment maîtrisés.

Martin Fowler décrit le motif Strangler Fig : construire progressivement le nouveau système autour de l’ancien, puis remplacer ses fonctions par étapes. C’est un principe d’architecture, pas la promesse qu’une migration progressive sera toujours facile ou préférable.

Dans la méthode proposée, le choix dépend des frontières réellement disponibles. Peut-on isoler un flux ? Quel système écrit la donnée pendant la coexistence ? Comment éviter une double exécution ? Sans réponse, la progressivité peut déplacer le risque vers la synchronisation et le routage.

StratégieCondition à examinerPreuve attendue avant décision
Remplacement par parcoursUne frontière fonctionnelle existeRoutage et retour testés
Exécution parallèleLes effets réels sont isolésSorties comparables sans double écriture
Bascule globaleLe périmètre est bornéRépétition complète et reprise démontrée

Ce tableau est une grille de choix d’Anand Candassamy. Il ne donne pas un classement universel. Une petite application isolée peut justifier un autre parcours qu’un système transactionnel partagé par plusieurs services. La décision doit conserver cette justification et les risques acceptés.

Pourquoi écrire des tests de caractérisation avant de réécrire ?

Les tests de caractérisation capturent ce que fait l’ancien système sur un corpus choisi, afin de disposer d’une référence indépendante du code nouvellement produit.

La méthode consiste à enregistrer les entrées, les résultats et les effets observables avant de modifier l’implémentation. Elle demande de distinguer un comportement constaté d’un comportement souhaité. Le test décrit ce qui existe ; le responsable décide ensuite s’il doit être conservé ou corrigé.

Le corpus réunit les parcours ordinaires, les données limites et les erreurs connues. Il faut aussi consigner l’environnement : paramètres, fuseau horaire, droits et dépendances. Une différence entre environnements pourrait autrement être imputée à tort au nouveau code ou dissimuler un défaut de migration.

Je recommande de réserver des cas que l’agent de réécriture ne modifie pas. S’il change à la fois le programme et les réponses attendues, un test vert ne représente plus une vérification extérieure. La procédure d’acceptation doit protéger cette frontière, avec une revue des modifications du corpus.

La méthode pour construire un jeu de tests aide à lancer ce travail. L’objectif n’est pas un nombre arbitraire de tests, mais une correspondance lisible entre chaque contrat important et une observation reproductible.

Un corpus commun alimente l’ancien et le nouveau système ; la comparaison précède la décision.
Un corpus commun alimente l’ancien et le nouveau système ; la comparaison précède la décision.

Comment démontrer l’équivalence fonctionnelle du nouveau code ?

L’équivalence fonctionnelle se démontre sur un périmètre explicite en comparant les mêmes entrées, les mêmes effets et des critères d’acceptation fixés avant les résultats.

Une comparaison octet par octet convient à certaines sorties, mais pas à toutes. Si un identifiant technique ou un horodatage change légitimement, le protocole doit expliquer ce qui est normalisé et pourquoi. Masquer toutes les différences variables pour obtenir un résultat identique retirerait au test sa valeur.

Le rapport de comparaison garde les écarts bruts et leur qualification. Certains révèlent un défaut du nouveau système, d’autres une anomalie historique ou un changement autorisé. La personne qui tranche doit pouvoir retrouver le cas d’entrée et le contrat concerné sans relancer une enquête complète.

Les résultats principaux ne suffisent pas. Il faut observer les écritures, les événements émis, les erreurs et les permissions. Pour les opérations non répétables, la recommandation est d’isoler les effets dans un environnement dédié. Un essai parallèle ne doit pas créer une seconde facture ou envoyer un second message.

Enfin, la conclusion doit annoncer ses limites. Une équivalence sur le corpus retenu ne démontre pas tous les comportements possibles. Le dossier identifie les situations non couvertes et les moyens prévus pour les surveiller après la bascule.

Quel lien existe entre migration et réimplémentation en salle blanche ?

La migration et la salle blanche peuvent partager une cible de comportement et des tests d’équivalence, mais elles répondent à des contraintes de provenance différentes.

Une migration interne peut partir d’un code que l’organisation est autorisée à consulter. Une réimplémentation en salle blanche organise une séparation entre observation et écriture. Confondre les deux donnerait l’impression qu’une simple traduction par agent établit une séparation qu’elle n’a jamais organisée.

L’article sur PhotoCraft et la salle blanche expose cette distinction et les limites d’une revendication de compatibilité. Les tests permettent de comparer un comportement ; ils ne prouvent pas à eux seuls la provenance du code, des ressources ou des dépendances.

La méthode proposée recommande un dossier séparé pour cette provenance : sources autorisées, licences, personnes ou outils ayant accédé aux éléments et règles transmises aux agents. Ce travail doit être adapté aux droits détenus par l’organisation. Aucun résultat technique ne remplace cette vérification.

Pour les questions juridiques, voir ce que le droit autorise en rétro-ingénierie. Ici, la comparaison sert à décider si le remplacement fonctionne dans le périmètre annoncé ; elle ne donne aucune autorisation juridique générale de reproduire un logiciel tiers.

Que peut-on confier à un agent de code pendant la migration ?

Un agent peut proposer des transformations et corriger des écarts reproductibles, tandis que les contrats, les tolérances, les droits et la décision de bascule restent sous responsabilité humaine.

La documentation de GitHub sur l’usage responsable de ses agents décrit leurs capacités et leurs limites. Elle rappelle notamment le rôle de la revue et de la vérification des changements. Il ne faut pas confondre production d’une modification et validation de son adéquation au contexte.

Dans le protocole proposé, l’agent reçoit une unité bornée, un contrat et un test reproductible. Il peut adapter une interface, proposer une traduction ou expliquer un écart. Son environnement limite les accès aux données et aux services nécessaires. Les identifiants de production ne sont pas des moyens de validation à lui fournir par défaut.

L’agent ne choisit pas seul les cas qu’il est autorisé à ignorer. Il ne doit pas réduire une tolérance pour faire passer une comparaison, supprimer un test gênant ou approuver son propre changement de comportement. Ces modifications demandent une décision séparée et traçable.

L’article sur REA et la rétro-ingénierie assistée complète cette répartition. L’automatisation prend de la valeur quand la cible et le retour d’erreur sont précis ; elle ne remplace pas la définition de cette cible.

Isoler, comparer, basculer et surveiller, avec un chemin de retour conservé.
Isoler, comparer, basculer et surveiller, avec un chemin de retour conservé.

Comment préparer une bascule réversible sans perdre de données ?

Une bascule réversible prépare le routage, l’état des données et le retour avant l’ouverture aux utilisateurs, avec des critères explicites de maintien ou d’annulation.

La recommandation est de répéter le scénario complet dans un environnement adapté. Il inclut le déploiement, les migrations de données, les contrôles et la restauration. Tester seulement le démarrage du nouveau programme laisserait de côté ce qui rend le retour difficile.

Le dossier distingue retour du code et retour des données. Si le nouveau système écrit dans un format que l’ancien ne comprend plus, rétablir un ancien exécutable ne suffit pas. Il faut une compatibilité préparée ou une procédure de reprise dont les limites sont connues et acceptées.

Pour une coexistence progressive, l’équipe définit un propriétaire des écritures et une manière de traiter les demandes en cours. Les opérations différées, les files et les traitements planifiés doivent entrer dans l’exercice. La surveillance doit pouvoir relier un écart à la version et au parcours concernés.

La décision de retour appartient à une personne joignable. Le protocole dit ce qui déclenche cette décision, où se trouvent les preuves et comment informer les équipes. Il ne se contente pas d’une promesse de rollback écrite après la mise en production.

Quels livrables demander avant d’accepter la migration ?

L’acceptation doit réunir un contrat de comportement, un corpus protégé, un rapport d’écarts, une procédure de reprise et une décision signée par les responsables concernés.

La séquence proposée évite de confondre avancement de la réécriture et réduction du risque.

  1. Fixer le périmètre et les comportements à conserver.
  2. Capturer la référence avant les transformations.
  3. Réécrire une unité avec des droits limités.
  4. Comparer les résultats et qualifier les écarts.
  5. Répéter la bascule et le retour avec les données prévues.
  6. Autoriser l’ouverture puis surveiller les contrats essentiels.

Les réserves doivent rester lisibles après l’acceptation. Une fonction non migrée, un format partiellement couvert ou une reprise manuelle ne disparaissent pas parce que l’interface est terminée. Le dossier les affecte à un responsable et à une conduite à tenir.

Un audit IA peut cadrer la place des agents dans ce parcours. Le résultat attendu reste une migration dont l’équipe sait expliquer et contrôler les conséquences. Le nombre de fichiers générés ne remplace aucune des preuves nécessaires à cette décision.

Questions fréquentes

L’IA peut-elle convertir seule toute une application legacy ?

Un agent peut proposer des transformations, mais une conversion produite ne démontre pas l’équivalence fonctionnelle. La méthode recommande des contrats, un corpus indépendant, une revue et une décision humaine avant la bascule.

Quelle différence entre refonte et migration ?

Dans cet article, la migration change la technologie tout en conservant les comportements convenus. Une refonte peut aussi modifier ces comportements ; ces changements doivent alors être explicitement séparés et acceptés.

Faut-il conserver tous les bugs historiques ?

La caractérisation les rend visibles sans décider de les conserver. Le responsable métier choisit lesquels corriger et lesquels maintenir provisoirement pour préserver une compatibilité. Chaque décision doit être documentée.

Un test d’équivalence doit-il comparer tous les octets ?

Cela dépend du contrat. Les éléments variables peuvent être normalisés si cette règle est définie et justifiée avant comparaison. Les écarts bruts doivent rester accessibles pour éviter de masquer une régression.

Le motif Strangler Fig impose-t-il des microservices ?

La méthode proposée retient le principe du remplacement progressif décrit par Fowler. Elle n’impose pas ici de découpage en microservices : les frontières sont choisies selon les parcours et les contraintes réelles.

Quel premier chantier confier à un agent ?

Une unité isolable, avec entrées, sorties et effets clairement définis, est un bon point de départ pour la méthode. L’agent reçoit le contrat et les tests, sans pouvoir réécrire seul les critères d’acceptation.

Sources

Analyse et méthode proposées par Anand Candassamy au 4 novembre 2026.

Votre prochain projetParlons-en.Réserver un échange de 15 minutes sur Cal.com, dans un nouvel onglet