J'hérite d'un projet sans documentation
Reprise de code legacy, abandonné, ou généré par IA : état des lieux, plan, exécution
En bref : Vous récupérez un projet sans documentation — prestataire parti, développeur unique, ou code massivement généré par IA que personne ne comprend. Je fais l'état des lieux sans complaisance, je vous dis ce qui est récupérable et ce qui ne l'est pas, et je reprends la main.
Reprendre un projet, c'est retrouver la maîtrise d'une base de code héritée — comprendre ce qu'elle fait réellement, sécuriser son fonctionnement, et la remettre sur une trajectoire évolutive.
Vous reconnaissez-vous ?
- Le prestataire ou le développeur qui connaissait le code est parti.
- Il n'y a ni documentation, ni tests, ni historique exploitable.
- Une grande partie du code a été générée par IA et personne ne sait ce qu'elle fait vraiment.
- Vous avez peur de toucher au code de production, alors il fige.
La situation
Reprendre un projet hérité, c’est d’abord lever le brouillard. Sans documentation ni tests, le code est la seule vérité — et il faut le faire parler avant d’oser y toucher. Le code généré par IA ajoute une difficulté : il a l’air fini, mais personne n’en porte le modèle mental.
Comment j’interviens
1. État des lieux honnête. Je lis le code, je cartographie ce qu’il fait, ses dépendances, ses zones dangereuses. Je vous dis franchement ce qui est sain, récupérable, ou à remplacer.
2. Mise sous contrôle. Versionnement propre, environnement reproductible, tests sur les chemins critiques. L’objectif : pouvoir modifier sans craindre de tout casser.
3. Stabilisation. Je corrige ce qui est cassé ou dangereux en priorité, sans tout refondre. La production doit rester debout.
4. Trajectoire. Une fois le terrain stable, j’établis un plan d’évolution réaliste et je documente l’essentiel pour que vous ne soyez plus à la merci d’une seule personne.
Ce que vous obtenez
Une compréhension réelle de ce que vous possédez, un code remis sous contrôle, et un plan pour le faire vivre — au lieu de prier pour qu’il continue de tourner.
Questions fréquentes
Le code généré par IA est-il un cas particulier ?
Oui, et c'est un créneau récent. Ce code paraît propre mais cache souvent des incohérences, des dépendances fantômes et une absence totale de modèle mental. Je vérifie ce qu'il fait réellement, par la lecture et par les tests, avant de m'y fier.
Faut-il tout jeter et recommencer ?
Pas par réflexe. Je distingue ce qui est sain, ce qui est récupérable et ce qui doit être remplacé. La réécriture totale est un choix coûteux qu'on ne fait qu'après le constat, jamais avant.
Par quoi commencez-vous ?
Par sécuriser le présent : comprendre le périmètre, mettre le code sous contrôle de version propre, ajouter des tests sur les parties critiques. On stabilise avant de faire évoluer.
