Introduction

Si votre base de code accumule du code inutilisé, de la logique dupliquée, des abstractions obsolètes, des fichiers volumineux ou d’anciennes pratiques qui rendent chaque modification plus coûteuse que nécessaire, envisagez une refactorisation pour réduire la dette technique. Vous pouvez ainsi améliorer la structure du système existant tout en conservant votre pile technologique.

Codex peut d’abord dresser un état des lieux de la partie du code concernée, puis procéder par petites étapes faciles à relire. Il peut supprimer les chemins d’exécution inutilisés, clarifier la structure des gros modules, regrouper les chemins d’exécution qui font double emploi, moderniser le code qui repose sur d’anciens mécanismes du framework et renforcer les vérifications à chaque étape.

L’objectif est d’améliorer la base de code en place :

1. Supprimez le code inutilisé, les fonctions utilitaires obsolètes, les anciens indicateurs et les couches de compatibilité devenues inutiles.
2. Allégez les modules difficiles à suivre en extrayant des fonctions utilitaires, en scindant des composants ou en isolant les effets de bord dans des parties du code au rôle bien défini.
3. Remplacez les anciennes pratiques par les conventions actuelles du dépôt : utilisez des primitives plus récentes du framework, des types plus explicites, une gestion d’état plus simple ou des utilitaires de la bibliothèque standard.
4. Préservez le comportement observable tout en réduisant le coût de la prochaine modification.

Marche à suivre

1. Avant toute modification, demandez à Codex d’examiner la partie du code concernée et d’y repérer les modules difficiles à suivre, la logique dupliquée, le code inutilisé, les tests, les contrats publics et les pratiques qui ne conviennent plus au dépôt.
2. Choisissez un seul objectif à la fois : supprimer le code inutilisé, simplifier le flux de contrôle, moderniser une pratique obsolète ou scinder un gros fichier en unités plus petites dont la responsabilité est clairement attribuée.
3. Avant que Codex modifie les fichiers, demandez-lui de décrire le comportement actuel, l’amélioration structurelle qu’il propose et la vérification minimale qui permettra de confirmer que le comportement reste identique.
4. Après chaque étape, relisez les modifications et exécutez la vérification minimale pertinente. Évitez de regrouper tout le nettoyage dans un seul diff.
5. Traitez les changements de pile technologique, les migrations de dépendances et les changements d’architecture comme des tâches distinctes, sauf s’ils sont nécessaires pour terminer le nettoyage.

Utilisez les ExecPlans

Le guide pratique de modernisation du code présente les ExecPlans. Ces documents permettent à Codex de garder une vue d’ensemble du nettoyage, de décrire précisément le résultat attendu et de consigner les vérifications effectuées après chaque étape. Ils sont utiles lorsque la refactorisation concerne plusieurs modules ou nécessite plusieurs sessions. Consignez-y les suppressions, les pratiques mises à jour, les contrats à préserver et les travaux encore en attente.

Utilisez les Skills pour les opérations récurrentes

Les Skills sont utiles lorsque plusieurs dépôts, services ou équipes appliquent les mêmes règles de nettoyage. Utilisez les Skills propres à votre framework lorsqu’elles existent. Pour les nettoyages à risque, ajoutez des Skills de sécurité et d’intégration continue. Si votre équipe dispose d’une liste de vérification éprouvée pour supprimer le code inutilisé, extraire des modules ou moderniser d’anciennes pratiques, créez une Skill d’équipe. Si vous devez appliquer la même modernisation à plusieurs bases de code, Codex peut vous aider à transformer la première intervention réussie en Skill réutilisable.