Transition (Handoff)
La transition imprime un instantané : le résumé de forme fixe que la prochaine session lira en premier. Elle ne crée aucun fichier pour l'instantané lui-même, car celui-ci est redérivable depuis la branche par défaut, les PRs fusionnées et les notes de version ; un ticket permanent qui ne fait que le répéter serait du bruit. Elle n'ouvre un ticket que pour du travail que quelqu'un fera : chaque élément du prochain cycle devient un ticket, après vérification des tickets ouverts existants. Tout ce qui a été différé par décision est enregistré avec sa raison là où la décision vit déjà, car cette raison est la seule chose que la prochaine session ne peut pas reconstruire.
Le mécanisme d'accueil reprend déjà l'historique complet d'une session avec --continue ou --resume et conserve la mémoire automatique locale de la machine. L'instantané ne transporte donc que ce que celles-ci ne peuvent pas fournir : les prochaines étapes et les décisions qu'une autre machine ou personne doit retrouver dans le dépôt ou ses tickets. Les verdicts de passerelle et les tableaux de compteurs en sont délibérément exclus : les deux se rejouent en quelques secondes à partir du SHA enregistré, et un nombre rejoué ne peut pas être fabriqué comme le serait un nombre copié.
Cette compétence peut ouvrir et fermer des tickets, donc elle ne se déclenche jamais seule. Exécutez-la uniquement sur demande, et seulement au moment où une session se termine réellement.
Chemin par défaut
- Rassembler l'état de l'arborescence : SHA, propreté, worktrees, PRs ouvertes.
- Lister ce qui a été livré depuis le dernier tag de version, ou depuis le début de la session s'il n'y a pas de tag.
- Énoncer une conclusion principale, avec les preuves qui la soutiennent.
- Écrire la liste du prochain cycle : ordonnée, concrète, chaque élément avec son raisonnement.
- Pour chaque élément du prochain cycle, vérifier les tickets ouverts pour voir si l'un d'eux le couvre déjà ; n'ouvrir un nouveau ticket que si aucun ne le fait, et enregistrer son numéro.
- Pour tout ce qui a été différé par décision, enregistrer la raison là où la décision vit déjà (le CHANGELOG, un enregistrement de décision, le commentaire de code sur place) ; ne créer un ticket fermé comme non planifié que si aucun endroit de ce type n'existe. Ne jamais faire cela pour quelque chose qui n'a simplement pas été fait ; cela reste un élément du prochain cycle ou disparaît silencieusement.
- Nettoyage des éléments hérités : si un ticket ouvert intitulé "Rapport de session" existe, le fermer avec un commentaire pointant vers les tickets dans lesquels son contenu a été réparti.
- Imprimer l'instantané dans la réponse : l'avertissement d'obsolescence, l'état de l'arborescence, ce qui a été livré, la conclusion principale, la liste du prochain cycle avec les numéros de tickets, et les éléments différés par décision avec l'endroit où chacun est enregistré.
Rassembler l'état de l'arborescence
Exécuter ces commandes sur la branche par défaut du dépôt, et non sur la branche où se trouve la session :
git rev-parse HEAD
git status --short
git worktree list
gh pr list --state open
Enregistrer le SHA exact, si l'arborescence est propre, combien de worktrees existent, et combien de PRs sont ouvertes. Une mention vague comme "les choses sont en bon état" n'est pas un état d'arborescence ; le SHA est le fait qui permet à la prochaine session de confirmer que rien n'a bougé en dessous, et c'est celui contre lequel chaque passerelle et chaque compteur se rejoue, ce qui explique pourquoi aucun de ces résultats n'est archivé.
Lister ce qui a été livré
Depuis le dernier tag de version (ou, s'il n'y en a pas, depuis le début de la session) jusqu'au HEAD actuel, lister chaque PR qui a fusionné, une ligne par PR : numéro et ce qu'elle a fait. Si rien n'a fusionné, écrire "Aucun" sous ce titre. Ne pas omettre le titre parce que la liste est vide ; une section absente se lit comme "personne n'a vérifié", et non comme "rien n'a été livré".
Énoncer la conclusion principale
Une seule conclusion, formulée comme une décision avec les preuves qui la soutiennent, et non comme un résumé de tout ce qui s'est passé. Si rien au cours de cette session n'a atteint ce niveau, écrire "Aucune conclusion principale cette session" plutôt que de gonfler une observation mineure pour remplir l'espace.
Écrire la liste du prochain cycle, et transformer chaque élément en ticket
Une liste ordonnée d'actions concrètes, chacune avec le raisonnement d'une ligne qui la motive. "Commencez ici" signifie que le premier élément est vraiment l'endroit par lequel la prochaine session devrait commencer, et non pas simplement la première chose qui vient à l'esprit.
Pour chaque élément, rechercher les tickets ouverts avant d'en ouvrir un nouveau :
gh issue list --search "<résumé de l'élément>" --state open
Si un ticket ouvert le couvre déjà, utiliser son numéro. Sinon, en ouvrir un :
gh issue create --title "<élément>" --body "<le raisonnement d'une ligne>"
Un ticket existe pour du travail que quelqu'un fera ; un élément du prochain cycle qui n'en devient jamais un est une liste en prose que la prochaine session doit croire, au lieu d'un suivi sur lequel elle peut agir.
Enregistrer les éléments différés par décision là où la décision vit
Quelque chose que cette session a choisi de ne pas faire, délibérément, n'est pas la même chose que quelque chose qui n'a simplement pas été fait cette session. Seul le premier cas est enregistré, avec sa raison, à l'endroit où la décision vit déjà : l'entrée du CHANGELOG qui a accompagné la livraison, un enregistrement de décision, ou le commentaire de code sur place. Pointer vers cet endroit dans l'instantané. Ce n'est que lorsqu'aucun endroit de ce type n'existe qu'il est archivé comme un ticket ouvert puis fermé :
gh issue create --title "<élément>" --body "Différé par décision : <la raison>"
gh issue close <N> --reason "not planned"
La raison est la seule ligne que la prochaine session ne peut pas reconstruire seule ; une chose simplement non faite n'a besoin d'aucun enregistrement, car elle est soit encore un élément du prochain cycle, soit elle n'a jamais été un engagement.
Héritage : retirer un ticket de rapport ouvert
Si un ticket intitulé "Rapport de session" est encore ouvert depuis avant ce changement de pratique, le fermer plutôt que de le laisser ouvert indéfiniment :
gh issue list --search "Rapport de session" --state open
gh issue close <N> --comment "Retiré : réparti dans <numéros de tickets de cette transition>."
Sauter cette étape une fois qu'il ne reste plus de tel ticket.
Imprimer l'instantané
Commencer par l'avertissement d'obsolescence, textuellement dans l'esprit : "Vérifiez tout ce qui se trouve ici avant de vous y fier ; il s'agit d'un instantané et le dépôt bouge." Ensuite, dans l'ordre : état de l'arborescence, PRs livrées, conclusion principale, liste du prochain cycle avec le numéro de ticket de chaque élément, éléments différés par décision avec l'endroit où chacun est enregistré. L'imprimer dans la réponse ; il n'est jamais archivé.
Échappatoires
- Pas d'interface en ligne de commande
gh, ou elle n'est pas authentifiée. Imprimer quand même l'instantané et les éléments du prochain cycle et différés par décision, dire qu'aucun ticket n'a pu être ouvert, et laisser la personne les créer à la main. - Rien n'a été livré, aucune conclusion principale, aucun élément du prochain cycle, ou rien n'a été différé par décision. Le dire clairement dans cette section plutôt que de l'omettre ou de l'allonger.
Ne pas
- Ne pas exécuter cette compétence seule. Elle peut ouvrir et fermer des tickets et ne s'exécute que sur demande.
- Ne pas copier un verdict de passerelle ou un tableau de compteurs dans l'instantané ; ils se rejouent à partir du SHA enregistré, et un lecteur fait confiance au rejeu, pas à la copie.
- Ne pas ouvrir un ticket pour un élément du prochain cycle sans vérifier s'il en existe déjà un qui le couvre.
- Ne pas ouvrir un ticket pour quelque chose qui n'a simplement pas été fait ; ce n'est pas la même chose que différé par décision.
- Ne pas sauter l'avertissement d'obsolescence sous prétexte que la session semble à jour ; le prochain lecteur n'a aucun moyen de le savoir s'il n'est pas indiqué.
- Ne pas allonger une conclusion principale manquante ou une liste de livraisons vide pour donner à l'instantané l'air plus substantiel que ne l'a été la session.
- Ne pas laisser un ticket "Rapport de session" ouvert une fois que cette transition a été exécutée.