Décoder un projet inconnu

Comprendre, contribuer et livrer sur une base de code qu’on n’a pas écrite

Trois semaines pour livrer sur un système que tu n'as pas écrit

Le dépôt est cloné depuis 20 minutes. 180 000 lignes, la moitié des dossiers ne dit rien de ce qu'elle contient, et la commande d'installation du README échoue à la deuxième étape. Quelqu'un attend une première livraison de ta part sous trois semaines.

Se repérer dans un système inconnu passe pour un trait de caractère. C'est une question d'ordre, pas de vitesse de lecture. Celui qui s'en sort ouvre la CI avant le code, la base avant les classes, l'historique avant les commentaires. Cet ordre-là s'apprend.

À quoi sert ce livre. Remplacer la lecture au hasard par une méthode : dix questions, un artefact par question. À quoi sert ce système. Est-ce que je peux le faire tourner. Où sont les frontières. Comment ça tourne en production. Où sont les données. Par où passe une requête. Qu'est-ce qui est vivant, qu'est-ce qui est mort. À quoi servent vraiment les tests. Qui casse quoi. Où je pose ma première ligne.

Chaque question se ferme sur un document que tu peux montrer : un inventaire des appels sortants, un schéma de base annoté, une carte des risques où aucune case « cher » n'est écrite sans la commande qui la prouve.

Ce que tu sauras faire après lecture

• Mesurer l'âge réel, les zones chaudes et le code mort d'un dépôt avec quelques commandes git.
• Reconstituer le trajet complet d'une requête, y compris les sauts qu'aucun appel écrit ne montre.
• Distinguer un test qui protège d'un test qui appelle sans rien vérifier.
• Croiser modifications, corrections et absence de filet pour chiffrer ce que coûte une ligne posée à tel endroit.
• Identifier qui relit vraiment un module, quand le fichier des propriétaires annonce trois noms dont deux sont partis.
• Faire travailler un agent IA sur la lecture d'un dépôt sans lui faire dire ce qu'il ne peut pas savoir.
• Tenir quand il n'y a ni documentation, ni tests, ni personne à qui parler.

Sans dépendance à une pile. Les exemples sont des artefacts : une sortie de commande, un fichier de CI, un schéma de base, une trace applicative, un extrait de revue. Les signaux qui comptent sont les mêmes sur un monolithe PHP de neuf ans et sur le service Go qu'on en a extrait.

Pour qui

Deux prérequis : savoir coder, avoir déjà livré en production. Aucun chapitre ne suppose la connaissance d'un langage ou d'un framework, ni une expérience de reprise de code, qui est justement le sujet. Ce livre tutoie son lecteur, comme il le fait de bout en bout.

Ce que contient le livre

• 16 chapitres répartis sur 187 pages, soit environ 51 355 mots.
• 16 diagrammes pour les schémas d’architecture et les flux.
• Trois formats livrés : PDF pour la lecture à l’écran, EPUB et Kindle pour la liseuse.