Chapitre 6.5 — Atelier : reprendre un projet

⏱️ TL;DR — On met bout à bout la reprise : cartographier (zoom-out + Explore) → déduire les conventions → rétro-installer un CLAUDE.md → faire une première modif sûre (petite, sur une branche, prouvée). En une session, un repo opaque devient un terrain balisé, cadré et versionné — reprenable indéfiniment. C’est le patron à appliquer sur tous tes anciens projets et sur tout repo d’équipe.

🎯 Objectifs

• Enchaîner onboarding → conventions → mémoire → action.
• Rétro-installer un CLAUDE.md exploitable.
• Faire une première contribution qui épouse l’existant.
• Repartir avec un projet « reprenable ».

Le contexte de l’atelier

Imagine reprendre un vieux projet à toi (ou un repo d’équipe) : pas de CLAUDE.md, des conventions dans ta tête (ou oubliées), du code qui a « un peu vécu ». Objectif de la session : le rendre pilotable et y faire une première modif propre — sans tout casser.

Étape 1 — Cartographier

Session lancée à la racine, en modèle fort (on va raisonner sur l’archi), pas de modif encore.

1) zoom-out : « Donne-moi le paysage — modules, responsabilités, relations. Haut niveau. »
2) Explore ciblé : « Où sont les points d'entrée (routes/pages), la couche data,
   la gestion des erreurs ? Renvoie les fichiers clés et le flux, sans coller le code. »

En quelques minutes, tu as la carte (6.1) : structure, zones, points d’entrée. Tu sais où les choses vivent.

Étape 2 — Déduire les conventions

« Lis 3-4 fichiers représentatifs (une page, un composant, un module data) et DÉDUIS
les conventions : nommage, structure d'un module, data-fetching, gestion d'erreurs,
style de composant. Liste-les. Je veux ensuite du code indiscernable de l'existant. »

Tu vérifies la liste : ce qu’il a bien capté, ce qu’il a mal compris (tu corriges), et — souvent — une convention que tu suivais sans l’avoir formulée (6.2).

Étape 3 — Rétro-installer le CLAUDE.md

« À partir de ces conventions et de la structure, propose un CLAUDE.md court
(stack, conventions tranchables, comment vérifier). Priorise, < 40 lignes. »

Tu corriges le jet : tu enlèves le descriptif déductible, tu ajoutes tes interdits et intentions (ce que le code ne dit pas), tu ordonnes (vital en haut). Tu commits ce CLAUDE.md. Le projet a maintenant une mémoire versionnée.

Étape 4 — La première modif sûre

Règle d’or de la reprise : la première contribution est petite, sur une branche, prouvée. On ne se jette pas sur un gros refactor dans un repo qu’on redécouvre.

git checkout -b reprise/petit-fix

Prompt à trois ingrédients (5.1), ancré sur l’existant (6.2) :

OBJECTIF : corrige [petit bug réel / ajoute un petit champ].
ANCRAGES : écris EXACTEMENT comme src/…/fichier-voisin.ts. Respecte les conventions
  déduites. Ne refactore/modernise RIEN d'autre.
CRITÈRE : tests verts + build ; l'écran/flux concerné exercé et observé.

On lit la diff (5.4) avec attention : est-ce que ça épouse le style ? y a-t-il du hors-périmètre (un « tant que j’y étais » à refuser) ? On conclut par une preuve. Puis commit avec un message qui porte le pourquoi (6.3).

⚠️ Piège — Vouloir « tout nettoyer » dès la reprise, tant qu’on y est. Non : la reprise établit d’abord le cadre (carte + CLAUDE.md) et fait une petite modif de confiance. Les gros refactors, s’il en faut, sont des chantiers séparés et cadrés (P11), une fois le terrain balisé.

Ce qu’on a gagné

• Un repo cartographié (tu sais où sont les choses).
• Un CLAUDE.md versionné : les reprises futures démarrent cadrées.
• Une première contribution propre, qui épouse l’existant, prouvée.
• Un état reprenable (build vert, commit qui porte le pourquoi).

En une session, tu es passé de « repo opaque » à « terrain balisé et documenté ». Et le bénéfice compose : chaque reprise suivante part du CLAUDE.md, donc de plus en plus vite.

🧭 Sur TaskFlow — TaskFlow n’a pas eu besoin de cette reprise (il est né cadré). Mais applique ce patron ce soir sur un de tes vieux projets : c’est le geste qui transforme « l’IA n’arrive pas à continuer mon projet » en « l’IA reprend mon projet en cinq minutes ». La différence n’est pas dans l’IA — elle est dans le cadre que tu poses.

✏️ Exercices

Exercice 1 — Reprise complète. Applique les 4 étapes sur un vrai vieux projet à toi. Livrable : une carte, un CLAUDE.md committé, une petite modif prouvée sur une branche.

Exercice 2 — Refuse le hors-périmètre. Sur ta première modif, si l’agent « modernise » au passage, refuse et recadre (« respecte l’existant, ne refactore rien »). Note ce qu’il voulait changer — c’est peut-être un futur chantier séparé.

🧠 Quiz de révision

Fin de la Partie 6. Tu sais reprendre n’importe quel projet et le rendre pilotable. On passe à l’automatisation : Partie 7 — Automatiser avec les hooks.