Comment lâcher l'IA sur un vieux code legacy sans rien casser

Imaginez un scénario typique : vous avez hérité d'un projet avec cinq ans d'historique. Il n'y a pas de documentation, l'auteur original du code est parti il y a trois ans, et la logique métier est étalée sur des centaines de fichiers. Connecter un agent IA comme Claude Code ou Cursor à une telle base de code est terrifiant. Vous lui demandez de corriger une fonction — il réécrit le module voisin et détruit des dépendances implicites que personne ne soupçonnait même.

Récemment, un outil intéressant appelé Reversa est apparu sur GitHub, créé par un développeur avec le nom d'utilisateur sandeco. Le framework résout ce problème de manière originale : il plonge dans un projet legacy, effectue une rétro-ingénierie, et transforme le code source en spécifications exécutables.

Pourquoi remplacer le code par des spécifications

La plupart des agents de codage excellent dans la création de projets à partir de zéro. Vous écrivez une invite, l'outil génère une structure propre et un code fonctionnel. Cette astuce ne fonctionne pas avec le code legacy. Si l'agent ne comprend pas les contraintes architecturales et le contexte, il travaille à l'aveugle.

Reversa fait office de pont entre l'ancien code et les assistants IA modernes. L'outil n'écrit pas de documentation pour les humains au sens traditionnel. Au lieu de cela, il génère des contrats opérationnels. Sur cette base, n'importe quel agent de codage peut immédiatement voir les règles du jeu, les tables de base de données, les matrices de permissions et les algorithmes qui ne doivent pas être violés.

Comment fonctionne le processus de recherche

L'installation s'exécute dans la racine du projet via une seule commande :

npx reversa install

L'installateur détecte automatiquement les moteurs IA installés sur le système — Cursor, Claude Code, Codex, Windsurf ou Copilot. Ensuite, il copie les ensembles de compétences dans le répertoire .agents/skills/ et crée un fichier de configuration.

Lorsque vous exécutez la commande /reversa dans votre client IA, un pipeline de plusieurs agents spécialisés se déclenche. Chacun d'eux joue son propre rôle dans le processus d'analyse :

• Scout analyse la structure de surface, identifie les langages, les frameworks et les points d'entrée.
• Archaeologist plonge en profondeur dans les modules, analyse les structures de données et les algorithmes complexes.
• Detective extrait les règles métier implicites, les diagrammes d'état et les règles d'accès.
• Architect compile les données collectées en diagrammes C4, schémas ERD et cartes d'intégration.
• Writer formate les spécifications finales en contrats avec des liens vers des lignes de code spécifiques.

Un détail intéressant : Reversa marque chaque déclaration dans les documents finaux avec un badge de précision spécial. L'icône 🟢 signifie que la règle est directement étayée par du code avec des références de fichier et de ligne. L'icône 🟡 est placée là où l'IA a fait une inférence logique. Le marqueur rouge 🔴 indique des « zones blanches » où le code n'a pas pu expliquer quelque chose et où une intervention humaine est nécessaire.

Sûr par défaut

La principale crainte lors du lancement de tout utilitaire automatisé sur un dépôt complexe est la perte de données ou les modifications accidentelles. Les créateurs de Reversa ont insisté sur l'isolement complet.

Le framework suit une règle stricte : le code source du projet n'est jamais modifié ou supprimé pendant l'analyse. Tous les résultats sont écrits par les agents dans seulement deux dossiers de service : .reversa/ pour l'état de l'analyse et _reversa_sdd/ pour les spécifications terminées.

De plus, l'outil ne demande ni ne transmet de clés API. Tout le travail analytique est déchargé vers l'outil IA que vous utilisez déjà localement.

Ce qui se passe après l'extraction des données

Créer des spécifications n'est que la première étape. Basé sur le dossier _reversa_sdd/ généré, vous pouvez lancer d'autres flux de travail via des commandes supplémentaires.

• /reversa-forward aide à faire évoluer le système étape par étape, transformant les nouvelles exigences en code fonctionnel avec contrôle de régression.
• /reversa-migrate prépare un plan pour migrer la pile legacy vers une architecture moderne.
• /reversa-docs compile les données collectées en un site HTML statique avec des graphiques D3 interactifs et une carte d'architecture 3D.
• /reversa-debugger enregistre les bugs et les lie causalement aux spécifications.

Si vous avez besoin d'exécuter un cycle complet sans arrêts et confirmations constants, il existe un mode autonome /reversa-autonomous. Dans ce mode, l'utilitaire pose toutes les questions de clarification lors d'un entretien de démarrage, puis travaille de manière indépendante.

Où les résultats sont sauvegardés

Dans le dossier _reversa_sdd/, une structure claire de fichiers Markdown apparaît. Vous y trouverez un dictionnaire de données, une description du domaine, des matrices de rôles, des spécifications OpenAPI et des diagrammes de séquence au format Mermaid.

_reversa_sdd/
├── inventory.md              # Инвентаризация файлов
├── dependencies.md           # Зависимости и версии
├── code-analysis.md          # Помодульный технический анализ
├── data-dictionary.md        # Словарь данных
├── domain.md                 # Бизнес-правила и глоссарий
├── state-machines.md         # Конечные автоматы в формате Mermaid
├── architecture.md           # Обзор архитектуры
├── confidence-report.md      # Отчет о точности анализа 
└── sdd/                      # Спецификации отдельных компонентов

Si vous modifiez le code via /reversa-forward lors du raffinement du système, un agent Sync spécial ajoute soigneusement des informations sur les nouvelles fonctionnalités au dossier _reversa_sdd/addenda/, préservant l'historique des modifications.

Cela vaut-il la peine d'adopter

Reversa ressemble à une tentative mature de mettre de l'ordre dans le chaos des projets legacy avant de les confier à l'IA. Le projet se développe activement, et une prépublication récente sur arXiv de mai 2026 corrobore l'architecture du framework avec une approche académique.

L'outil sera utile pour les équipes qui ont hérité de services négligés sans documentation, ainsi que pour celles qui prévoient une migration progressive des anciennes piles technologiques. Vous pouvez essayer l'utilitaire sur n'importe quel dépôt de test, car il ne modifie aucun fichier existant.

Pour un démarrage rapide, exécutez simplement npx reversa install dans le terminal et ouvrez le projet dans votre éditeur IA habituel.