Garder le contexte frais sur les longues tâches

Une session qui a commencé en force peut devenir brouillonne deux heures plus tard. Rien n’a brisé. La fenêtre s’est juste remplie de vieilles versions de fichiers, de pistes abandonnées et d’instructions sur lesquelles vous êtes revenu depuis.

La solution n’est pas une plus grande fenêtre. C’est une habitude : point de contrôle, redémarrage, reprise.

Reconnaître une session encrassée

Retournez les cartes. Si vous en reconnaissez deux ou plus dans votre session actuelle, c’est le temps de redémarrer.

🃏 Symptômes d’un contexte encrassé

Touchez une carte pour la retourner

Il réintroduit un bogue qu’il a corrigé il y a une heureUne ancienne version du fichier est encore dans le contexte et fait concurrence à l’actuelle. Redémarrez et laissez-le relire.Il suit une instruction que vous avez annuléeL’ancienne et la nouvelle instruction sont toutes deux dans la fenêtre. Mettez la règle actuelle par écrit et repartez à neuf.Il réessaie sans arrêt la même approche qui échoueLes culs-de-sac l’ancrent. Une session propre avec une note sur ce qui n’a pas marché brise la boucle.Les réponses deviennent plus vagues et plus lentesLa fenêtre est encombrée de sorties peu utiles. Élaguez, ou redémarrez à partir d’un résumé.Il oublie une contrainte donnée au début de la sessionLes détails du début s’enfouissent sous des heures de sorties d’outils. Mettez les règles durables dans un fichier qu’il relit.Vous êtes sur le point de commencer une autre tâche dans la même sessionNe le faites pas. L’historique sans lien, c’est du pur bruit pour la nouvelle tâche. Une tâche, une session.

Point de contrôle, redémarrage, reprise

1. 🛠️TravaillerUn morceau ciblé de la tâche
2. ↓→
3. 📝Point de contrôleCommit, puis note de passation
4. ↓→
5. 🧹RedémarrerFermer la session, en ouvrir une neuve
6. ↓→
7. ▶️ReprendrePartir de la note et du code

↺ À répéter à chaque jalon naturel

L’idée clé : l’état vit dans le dépôt, pas dans le chat. Un commit capture ce qui a été fait. Une courte note capture ce que le code ne dit pas : ce qui reste, ce qui a échoué, ce qui a été décidé.

Une note de passation qui marche

Demandez à l’agent de l’écrire avant de redémarrer. Puis lisez-la : c’est vous qui savez si elle est exacte.

Avant d'arrêter, écris docs/progress/csv-export.md avec :

- Objectif : une phrase
- Fait : ce qui est terminé et commité (avec les hash de commit)
- Prochaines étapes : les 2-3 prochaines étapes concrètes, dans l'ordre
- Décisions : les choix faits et pourquoi (pour ne pas y revenir)
- Culs-de-sac : les approches essayées qui ont échoué, et pourquoi
- Questions ouvertes : ce que moi (l'humain) je dois trancher

Maximum 40 lignes. Pas de code, seulement des pointeurs vers des fichiers.

Ensuite, la nouvelle session démarre avec une seule ligne : « Lis docs/progress/csv-export.md et continue avec la prochaine étape. »

Cette même note de passation est ce qui permet de répartir le travail entre plusieurs agents en parallèle, ce qu’on verra au module 5.

Avant de continuer

✅ À retenir

0 / 4 complété

• Je reconnais les symptômes d’une session encrassée et je redémarre au lieu de m’acharner.
• Je garde une tâche par session et je commite à chaque jalon.
• Je fais écrire une note de passation par l’agent, et je la relis avant de redémarrer.
• Les règles durables et les décisions vivent dans des fichiers, pas dans l’historique du chat.

↺ Réinitialiser