passation - SKILL.md Agent Skill

name: passation description: >- Préparer un résumé de passation pour continuer le travail dans un nouveau chat. Capturer le travail accompli, les tâches en attente, les blocages, et les enseignements ; livrer sur Notion (lien seul) quand c'est disponible. Se déclenche sur "/passation", "passation", "sauvegarde la passation", "sauvegarde le contexte", "prépare une passation", "écris la passation", "avant /clear", "avant de clear", "efface la passation", "abandonne la passation", "passation propre", "finalise", "on conclut", "j'ai terminé", "résume pour continuer demain", "conversation trop longue", "on reprend dans un nouveau chat", "fin", "au revoir". Utiliser quand l'utilisateur veut transférer le contexte vers une conversation future ou couper la session proprement.

/passation — Résumé de fin de session

Prépare un document de passation pour continuer le travail dans une nouvelle conversation. Transfert de contexte, pas documentation.

Voir README.md pour les décisions de conception.

Quand utiliser /passation vs /brief

/passation — cible une conversation future. Résumé d'ensemble du travail en cours
/brief — cible Claude Code. Document de mission autonome (l'agent n'a pas accès à la conversation)

Déclenchement

Explicite : /passation, "prépare une passation", "résume pour continuer demain", "la conversation est trop longue, on repart à zéro".
Fin de session : "fin", "au revoir". L'utilisateur veut couper la session proprement — déclencher la passation sans demander confirmation.

Protocole

1. Rassembler le contexte

Parcourir la conversation pour identifier :

Travail accompli — résultats, livrables, fichiers produits
Tâches en attente — avec assez de contexte pour agir sans relire
Blocages et points d'attention — causes racines, pas symptômes
Décisions prises — quoi et pourquoi (rationale)
Enseignements — patterns découverts, anti-patterns identifiés

2. Produire le document

Générer le contenu en markdown suivant le template dans references/template.md.

Cible : 75-150 lignes de contenu.

En dessous de 75 : probablement incomplet
75-150 : équilibre entre détail et concision
Au-dessus de 150 : vérifier si tout est nécessaire

3. Préserver les détails qui font gagner du temps

Inclure :

Chemins de fichiers, URLs, références concrètes
Décisions prises avec rationale
Approches écartées et pourquoi (éviter de refaire le travail)
Métriques, chiffres, données spécifiques
Causes racines des problèmes, pas seulement les symptômes

Omettre :

Déroulé pas à pas des actions
Résultats évidents ou confirmations
Debugging intermédiaire sans issue
Information redondante

4. Documenter les enseignements

Format :

## Enseignements

**[Sujet/Pattern] :**
- Découverte : [insight concret]
- Impact : [pourquoi ça compte]
- Recommandation : [comment appliquer]

Se concentrer sur : découvertes techniques, patterns d'outils efficaces, améliorations de processus, anti-patterns à éviter.

5. Livrer la passation

Deux voies selon l'environnement.

Sur Notion (projet hybride, ou claude.ai avec Notion connecté) — voie privilégiée :

Créer la page sous le parent pertinent — la page projet ou domaine que concerne la conversation — avec notion-create-pages. Si le parent est ambigu, le demander. Inclure un résumé d'une ligne à côté de la référence <page>.
Pas de double génération. Ne pas regénérer le contenu en fichier local ni utiliser present_files. Produire uniquement un lien [Titre](url) vers la page Notion. Même règle pour tout document déjà enregistré sur Notion : Notion fait foi.

Sans Notion (claude.ai seul) :

Présenter le fichier via present_files. Le document doit être prêt à être collé dans le premier message d'une nouvelle conversation.

6. Afficher le titre de la session courante

Après livraison, suggérer un titre pour la session qui se termine — pas la prochaine — afin de la retrouver dans l'historique claude.ai. Le placer dans un bloc de code, sans le mot "titre" ni préfixe ("titre :"), juste le texte :

Intégration API paiement — auth OAuth2 en place

Anti-pattern : afficher le titre de la prochaine conversation. Le titre décrit ce qui s'est passé dans cette session, pas ce qui va suivre.

Terminer par une note courte sur la prochaine action immédiate.

Ce que la passation ne fait pas

Ne produit pas un document de mission pour Claude Code (→ /brief)
Ne gère pas la transmission — l'utilisateur ouvre la page Notion ou copie le document par le moyen de son choix

Ressources

references/template.md — Structure du document de passation
references/examples.md — Exemples de passations