"L'export est corrigé, il reste à vérifier" - et le travail s'arrête là. Le lendemain, vous rouvrez le projet sans savoir quels fichiers ont changé, sur quelle version l'export a été examiné ni où la vérification s'est interrompue.
Pour reprendre sans refaire toute l'analyse, l'étape suivante a besoin du résultat conservé, des vérifications déjà effectuées et de la prochaine action. Voyons ce passage de relais sur une seule tâche : elle peut être menée par une seule session, par plusieurs intervenants ou par vous-même en deux fois.
Transmettez un résultat consultable
Dans une liste de courses, l'export CSV ne fonctionne pas. Exigence : l'export ne contient que les lignes affichées, dans le même ordre. Pour une liste vide, on a convenu de conserver la ligne d'en-tête, sans lignes de données. Le format des colonnes et le séparateur ne doivent pas changer.
Au lieu de noter "corrigé, reste à vérifier", consignons de quoi retrouver les changements et poursuivre le travail. Les hashs et résultats ci-dessous sont fictifs : c'est un exemple pédagogique, pas le compte rendu de vrais essais.
HANDOFF
Objectif : le CSV ne contient que les lignes affichées, dans leur ordre actuel.
Version d'entrée : commit de base 4f1c2ab.
État transmis : commit 9d3e740 sur la branche fix-export, aucune modification supplémentaire.
Résultat : src/export-csv.js - l'export récupère la liste après filtrage et tri.
Vérifié manuellement sur 9d3e740 : enregistrements source A, B, C ; à l'écran C, A ;
dans le CSV, lignes de données C, A ; l'enregistrement B est absent. L'en-tête ne compte pas comme un enregistrement.
Non vérifié : liste vide ; mode "uniquement les éléments non terminés".
Décision : ne pas modifier le format des colonnes ni le séparateur.
Étape suivante : la session principale vérifie les deux scénarios restants.
État global de la tâche : vérification inachevée.Les lettres désignent les trois enregistrements de la liste. Le scénario vérifie deux choses à la fois : l'enregistrement masqué B ne figure pas dans l'export et l'ordre C, A correspond à celui de l'écran. Obtenir simplement deux lignes dans une liste qui n'en contient que deux ne suffit pas : un export sans filtrage produirait le même résultat.
Vous pouvez enregistrer cette note dans HANDOFF.md ou l'ajouter au document de tâche existant. Il n'y a pas de format de champs obligatoire. L'essentiel, c'est que la personne qui prend le relais puisse consulter la note avec les fichiers nécessaires, même si la conversation précédente ne lui est pas accessible.
Si une commande a effectué la vérification, indiquez-la avec le résultat observé et la version du code. "12 sur 12 réussis" ne précise pas le comportement testé. Pour un scénario manuel, notez les données de départ, l'action et ce que vous avez observé, comme dans l'exemple ci-dessus.
Vous pouvez confier le brouillon à Claude Code : "Prépare une note de passation à partir des fichiers actuels et des vérifications effectuées. Distingue les faits des suppositions. Indique l'état qui a été vérifié, ce qu'il reste à faire et par où reprendre. Ne présente pas comme réussies les vérifications qui n'ont pas été faites." Avant de vous en servir, comparez la version aux fichiers, et les résultats aux notes de vérification manuelle ou à la sortie des commandes.
Définissez les conditions d'entrée et de sortie
Un passage de relais est utile quand l'étape suivante peut juger si les informations reçues lui suffisent. Pour notre tâche, on peut le décrire en trois lignes.
| Étape | Entrée | Sortie | Critère d'acceptation |
|---|---|---|---|
| Clarification | Exigence et fichiers actuels | Cause du problème, avec référence au code, et comportement attendu | Les lignes exportées, leur ordre et le comportement avec une liste vide sont définis |
| Modification | Comportement convenu et version d'entrée | Correction de l'export et note de vérification locale | L'état enregistré est accessible, les fichiers modifiés sont nommés et ce qui a été vérifié est séparé du reste |
| Vérification | État transmis et scénarios | Observations pour chaque scénario, limites et remarques | Les résultats correspondent à la version transmise ; chaque scénario a un résultat et chaque remarque indique la suite à donner |
La colonne la plus importante est celle de droite. Au passage à la vérification, elle répond à la question : "Peut-on commencer à vérifier ?" Même une modification décrite en détail peut être incorrecte. Et une vérification terminée peut révéler un problème à corriger : un compte rendu utile n'a pas à annoncer une réussite.
Si la version n'est pas indiquée, commencez par établir l'état actuel des fichiers. Vous pouvez le vérifier, mais pas lui appliquer un ancien compte rendu sans comparaison préalable. Il n'est pas nécessaire d'avoir des agents ou des documents distincts pour chaque étape : une petite tâche peut traverser les trois étapes dans une seule session, avec une seule note.
Conservez l'état validé
Dans une note de passation, on peut facilement confondre trois choses :
- l'état enregistré du code - une version précise que l'on peut restaurer ;
- la note de suivi - ce qui a été fait, vérifié et convenu ;
- l'acceptation du résultat - la décision que le travail suffit pour atteindre l'objectif fixé.
Un commit désigne les fichiers qu'il contient. Mais s'il reste des changements après ce commit, la référence ne décrit plus tout l'état transmis : il faut aussi enregistrer ces modifications, y compris les nouveaux fichiers, et les indiquer séparément. Pour transmettre un ensemble de changements, précisez également la version de départ par rapport à laquelle vous les examinez. Une simple référence à une branche ne suffit pas : elle continue d'évoluer.
Imaginez que la note indique 9d3e740, mais que le fichier d'export ait été modifié depuis. Le destinataire reconnaît le hash, mais travaillera sur un autre code. Il commence par déterminer ce qui a changé. Si la modification concerne le choix ou l'ordre des lignes, l'ancienne vérification C, A ne confirme pas le comportement actuel. Si seul le texte d'un commentaire a changé, cela ne justifie pas à lui seul de rejouer le scénario.
Il n'est pas nécessaire de créer un commit après chaque étape ni de regrouper en un seul commit vos modifications et celles des autres. L'essentiel est que l'état transmis existe dans son intégralité et que le destinataire y ait accès ; les règles du projet déterminent comment l'enregistrer. Si les fichiers ne sont pas là, commencez par vérifier la version enregistrée. Si les changements n'ont été enregistrés nulle part, une note ne les restaurera pas.
Reprendre une conversation ne restaure pas à lui seul les fichiers dans la version décrite. Les checkpoints de Claude Code ne couvrent pas non plus toutes les modifications : les modifications faites avec Bash ne sont pas suivies, et la restauration des modifications d'autres intervenants est limitée. La passation s'appuie donc sur les fichiers enregistrés et leur version. Pour en savoir plus : Checkpointing.
Identifiez la cause de l'interruption
"Ça n'a pas marché" peut désigner au moins trois situations différentes.
Une exécution locale a été interrompue. La commande ne s'est pas terminée ou la vérification s'est arrêtée en cours de route. Commencez par déterminer ce qui a été exécuté et modifié. Si la cause est corrigée et qu'une nouvelle tentative ne répète pas une action déjà effectuée, vous pouvez relancer l'action inachevée. Pour notre exemple, convenons d'un seul nouvel essai ; s'il est lui aussi interrompu, notons la cause et ce qu'il faut pour reprendre. La limite dépend de l'opération, et répéter indéfiniment n'expliquera rien.
Le comportement attendu n'est pas clair. Par exemple, l'intervenant ne sait pas quelles lignes considérer comme affichées lorsque le filtre est activé. Il consulte d'abord l'exigence consignée. Si elle ne donne pas la réponse, il pose la question à la personne responsable de l'exigence. La correction ne peut reprendre qu'après la réponse ; relancer l'exécution ne remplace pas cette réponse.
Un nouveau fait invalide la décision prise. On découvre qu'un autre programme lit le CSV. Après clarification, les colonnes à inclure sont redéfinies et l'exigence sur l'ordre est abandonnée. Il faut revenir à la clarification : consigner le nouveau critère, revoir la modification qui en dépend et les vérifications associées. Un scénario déjà exécuté peut rester utile, mais il ne valide plus toute la tâche mise à jour.
Ici, le retour mène à la clarification parce que la décision de départ a changé. Si l'exigence reste la même et que le problème vient de l'implémentation, il suffit de revenir à l'étape de modification. On réexamine les résultats qui dépendent de la décision concernée.
Reprenez au point où vous en êtes
Pour reprendre le travail, suivez ces cinq étapes :
- lisez toute la note de passation, y compris ce qui n'a pas été vérifié ;
- comparez l'état transmis aux fichiers disponibles et aux modifications supplémentaires ;
- déterminez le résultat de l'opération interrompue, le cas échéant ;
- identifiez les résultats précédents qui restent valides ;
- effectuez la prochaine étape inachevée et mettez à jour la note.
Revenons à l'exemple initial, où les exigences n'ont pas changé. La session suivante a ouvert la note de passation et vérifié l'état : le commit 9d3e740 est disponible, il n'y a pas d'autres modifications, les données et les conditions de vérification sont inchangées. Le scénario C, A est déjà terminé et son résultat reste valable. Inutile de réécrire la correction.
Le destinataire vérifie maintenant la liste vide. Selon l'exigence, le CSV doit conserver la ligne d'en-tête, sans données. Dans la suite fictive de notre exemple, c'est bien ce qui s'est passé. Il suffit d'ajouter le résultat à la note et de remplacer l'étape restante :
Vérifié manuellement sur 9d3e740 : l'export d'une liste vide ne contient que l'en-tête.
Le scénario C, A déjà vérifié reste valable.
Non vérifié : mode "uniquement les éléments non terminés".
Étape suivante : la session principale vérifie ce mode.
État global de la tâche : vérification inachevée.La note de passation évolue avec le travail. L'un des deux scénarios restants est terminé, l'autre figure toujours dans la note. Ce résultat partiel n'atteint pas l'objectif initial ; transférer la vérification dans une autre tâche nécessite une décision distincte sur le périmètre.
Si une exécution est interrompue, il faudra peut-être recommencer le scénario depuis le début : tous les outils ne savent pas reprendre au milieu. Les vérifications déjà terminées restent valides tant que le code, les données d'entrée et les conditions n'ont pas changé.
Une opération peut avoir été exécutée même si vous n'avez pas reçu de réponse confirmant le résultat. Avant de renvoyer des données, de publier ou d'écrire dans un fichier, vérifiez si l'action a déjà eu lieu. Le lieu d'exécution ne garantit rien : une commande locale peut elle aussi ajouter deux fois les mêmes données. Tant que le résultat n'est pas connu, ne remplacez pas la vérification de l'état par une nouvelle tentative.
Qui prépare la passation ?
Claude Code peut rassembler les faits, vérifier les éléments nécessaires à l'étape suivante et exécuter une action déjà convenue. Vous vérifiez que la note correspond aux fichiers et aux résultats des essais. Les exigences contestées et les changements de périmètre sont tranchés par une personne ou par le responsable désigné ; dans notre processus, l'acceptation finale revient à une personne.
Une version enregistrée aide à reprendre le travail, mais n'élargit pas les pouvoirs de l'intervenant. Si on lui a demandé de vérifier l'export, l'existence d'un point de restauration ne l'autorise pas à modifier aussi le format des colonnes. Les limites de la tâche restent les mêmes après la passation.
GO TO FULL VERSION