Cartographier avant de toucher
Ce que fait le système, par où il entre et sort, de quoi il dépend, où sont les données. Une journée de lecture évite une semaine de reprise.
Formations · Module 12 · Praticien
De plus en plus d’équipes héritent d’un produit que personne n’a écrit ligne à ligne. Il fonctionne, il est propre en apparence, et il devient dangereux au premier changement.
Le problème
Un produit livré par un agent a une propriété inhabituelle : il paraît mieux écrit qu’il n’est compris. Le code est cohérent, commenté, correctement nommé — et personne dans l’équipe ne sait pourquoi telle décision a été prise, ni ce qui casse si on la défait.
Le danger n’est pas la qualité du code, c’est l’absence d’intention documentée et de filet. Les tests, quand ils existent, ont souvent été produits par le même agent, à partir du même malentendu éventuel.
Ce module traite une situation qui devient courante et que presque personne n’enseigne : prendre la responsabilité d’un système qu’on n’a pas conçu, sans le réécrire.
Objectifs pédagogiques
Quatre objectifs formulés de façon observable, et chacun produit une pièce du livrable. Rien n’est laissé à l’impression.
Programme
Ce que fait le système, par où il entre et sort, de quoi il dépend, où sont les données. Une journée de lecture évite une semaine de reprise.
Écrire les tests qui figent le comportement actuel — y compris les comportements qu’on trouve douteux. On corrige après, jamais avant.
Dépendances ajoutées sans nécessité, abstractions prématurées, gestion d’erreurs décorative, commentaires qui décrivent une intention qui n’a jamais existé.
Le critère de décision, et pourquoi la réécriture intégrale reproduit presque toujours le même problème un cran plus loin.
Public et prérequis
Développeurs, tech leads et indépendants qui héritent d’une base de code produite par IA.
Prérequis : Savoir lire du code et exécuter un projet en local.
Chaque participant est positionné avant la session, par un questionnaire et un échange avec le commanditaire. Le programme est adapté à ce que ce positionnement révèle. Si le module n’est pas le bon, je le dis avant l’inscription.
Méthodes mobilisées
Plus de 60 % du temps est consacré à la production. Les apports théoriques ne dépassent jamais quinze minutes consécutives, et chaque atelier produit une pièce du livrable final.
Méthodes employées : ateliers individuels et en sous-groupes, revue croisée entre participants, travail sur grille, argumentation devant le groupe. Un kit d’outils réutilisables est remis et rempli en séance sur vos propres cas.
Vous ne repartez pas avec un classeur. Vous repartez avec ce que vous avez produit.
Évaluation et suivi
Questionnaire de positionnement : vérification des prérequis, mesure du niveau de départ sur les quatre objectifs, et adaptation du programme au contexte réel.
Évaluation formative continue : mise en commun, revue croisée entre participants, challenge sur les faits. On régule en continu plutôt qu’on ne sanctionne à la fin.
Évaluation des acquis sur le livrable produit, au moyen d’une grille critériée remise dès l’ouverture. Attestation de fin de formation mentionnant les objectifs et les résultats.
Questionnaire de satisfaction, consolidé et analysé après chaque session.
Questionnaire de transfert : ce qui a été décidé en salle a-t-il réellement été engagé, et l’indicateur a-t-il bougé.
Ce sur quoi je m’appuie
Vingt-cinq ans de reprise et de modernisation de bases de code existantes, et une pratique quotidienne de la revue humaine systématique du code produit par agents.
Informations pratiques
3 à 6 semaines entre la demande et le démarrage, selon le temps nécessaire à l’analyse du besoin, au positionnement des participants et à l’instruction éventuelle d’un dossier de financement.
Sur devis, établi après l’entretien d’analyse du besoin. Le suivi à 60 jours est inclus.
Chaque participant est interrogé sur ses besoins d’aménagement dans le questionnaire de positionnement. Les adaptations portent sur les supports, le rythme, l’organisation de la salle et les modalités d’évaluation. Si un besoin ne peut être satisfait en interne, nous orientons vers les ressources compétentes. Aucune demande n’est laissée sans réponse.
Module créé en 2026. Les indicateurs de satisfaction, d’atteinte des objectifs et de transfert seront publiés à l’issue des premières sessions.
Avant toute inscription
Trente minutes pour comprendre votre situation, votre niveau de départ et ce que vous devez pouvoir faire à la fin. Si le besoin est ailleurs, je le dirai.
Réserver un échange