Je veux
comprendre un projet que je n’ai pas écrit
Quatre passes : ce qu’il y a dedans, ce qui va mal, ce que le code voulait dire, et ce qu’on peut simplifier sans rien casser.
2 lames sur 4 viennent de la même enseigne —Les Juges, le verdict.
Le tirage — 4 lames
La lecture
analyze
La cartographie : langages, frameworks, points d’entrée, dépendances.
controleusegéographe des stacks en place
etat des lieux
L’audit sur dix axes, chacun noté, avec ce qui est urgent en tête.
recenseuserecenseuse des dix axes
reverse prompt
La documentation reconstituée à partir du code, pour un projet qui n’en a jamais eu.
restauratricerestauratrice des codes muets
simplifier
La complexité mesurée, et les endroits où elle se réduit sans risque.
scaphandrieresondeuse des profondeurs du code
À la fin : Un projet inconnu devenu lisible en une journée.
Si ce n’est pas tout à fait ça
- Je veux faire le tri dans un dépôt à l’abandonCe qui reste, ce qui sert, ce qui ment. On inventorie avant de supprimer, on répare la documentation, on ferme la séance proprement.
- Je veux réduire la dette sans tout réécrireMesurer d’abord, couper ensuite. La complexité se chiffre ; la réécriture totale est presque toujours le mauvais geste.
- Je veux réparer une documentation qui mentLes chemins morts, les commandes disparues, les captures d’un écran qui n’existe plus. On mesure l’écart puis on le referme.
Tirage écrit à la main dans data/parcours.json, tenu parscripts/parcours/check-parcours.sh : chaque lame citée existe dans le registre du framework.