Agent de revue de session Copilot avec Chronicle

Billet #357 : Ajout d'un agent de revue de session Copilot avec Chronicle
Type : Automatisation / Workflow / Optimisation des coûts
Date : 2 septembre 2026
Composants concernés : .github/copilot-instructions.md, .github/agents/speckit.session-review.agent.md, docs/fr/activity_report/sep-26_copilot-session-review-agent.md

1. Contexte et objectif

La présente session avait pour objectif d'améliorer l'utilisation de GitHub Copilot dans le projet, avec une priorité particulière donnée à la réduction de la consommation de jetons.

L'analyse des sessions récentes a montré que le travail était déjà structuré avec Spec Kit, mais que certaines sessions restaient très longues et nécessitaient plusieurs relances pour poursuivre, vérifier les résultats, mettre à jour la documentation et clôturer le travail.

La décision a donc été prise de mettre en place un agent de revue de clôture capable d'analyser avec Chronicle une session terminée et de formuler des recommandations concrètes, sans ajouter une collecte permanente d'événements qui augmenterait le coût de chaque session.

2. Travaux réalisés

Activation des instructions du projet

Le fichier .github/copilot-instructions.md a été créé à l'emplacement reconnu automatiquement par VS Code. Il reprend les règles essentielles du projet concernant :

l'utilisation séquentielle de Spec Kit ;
la consultation prioritaire du LLM Wiki ;
les tests ciblés après modification ;
la documentation, les rapports d'activité et la couverture ;
la lecture limitée aux fichiers nécessaires ;
la langue française et les noms de fichiers publiés en anglais.

Le fichier détaillé existant dans .github/agents/copilot-instructions.md a été conservé comme référence complémentaire.

Création de l'agent de revue de session

Le nouvel agent .github/agents/speckit.session-review.agent.md est disponible sous le nom speckit.session-review et peut être appelé avec :

/speckit.session-review

Son fonctionnement est encadré pour limiter le contexte et le coût :

analyse Chronicle en deux passes, avec agrégats compacts avant lecture détaillée ;
utilisation obligatoire de requêtes en lecture seule ;
comparaison avec 3 à 5 rapports d'activité pertinents au maximum ;
recherche des relances, corrections, tests échoués, gros collages et répétitions ;
distinction entre données de jetons disponibles dans le cloud et indicateurs indirects du stockage local ;
production de 3 à 5 recommandations prioritaires au maximum ;
mise à jour directe du rapport français et du rapport anglais miroir lorsque le rapport correspondant est identifié.

3. Décisions de conception

Déclenchement volontaire : la commande est lancée une seule fois à la clôture d'une session. VS Code ne fournit pas de déclencheur fiable permettant d'exécuter automatiquement un agent à la fermeture du chat.
Écriture directe : l'agent ajoute ou remplace uniquement une section dédiée aux recommandations ; les sections métier, les tags et les résultats de tests existants restent inchangés.
Périmètre historique limité : seuls les rapports les plus récents et les plus proches de la fonctionnalité sont utilisés, afin d'éviter une relecture exhaustive coûteuse.
Mesure prudente : le stockage local ne fournit pas de mesure détaillée par modèle et par jeton. L'agent utilise alors le nombre de tours, la durée, la taille des demandes, l'absence de compaction et les répétitions comme indicateurs indirects.
Compatibilité Spec Kit : Spec Kit conserve son rôle de spécification, clarification, planification, tâches, analyse et implémentation. Le nouvel agent intervient après ces étapes comme contrôle d'amélioration du processus.

4. Résultat et bénéfice attendu

Les règles du projet sont désormais chargées automatiquement par VS Code, et un agent spécialisé peut transformer la clôture d'une session en retour d'expérience structuré.

Le gain de jetons attendu est indirect mais mesurable dans les prochaines sessions : moins de rappels de règles, moins de lectures documentaires répétées, moins de relances générales et un meilleur découpage entre planification, implémentation et clôture.

L'agent n'est pas destiné à être exécuté après chaque message. Son exécution unique en fin de session évite d'ajouter une charge permanente au contexte de travail.

5. Validation

Le fichier .github/copilot-instructions.md ne présente aucune erreur détectée par la validation VS Code.
Le fichier .github/agents/speckit.session-review.agent.md ne présente aucune erreur détectée par la validation VS Code.
git diff --check a été exécuté avec succès sur les fichiers créés.
La présence du nouvel agent a été confirmée dans la liste des agents disponibles de VS Code.
Aucun test applicatif n'était nécessaire : cette session modifie uniquement la configuration Copilot et la documentation du projet.

6. Limites et prochaines observations

L'analyse automatique à la fermeture d'une session n'est pas disponible ; la commande /speckit.session-review doit être lancée explicitement.
Le rapport correspondant doit déjà exister pour que l'agent puisse y ajouter sa section sans créer un rapport métier ambigu.
Les mesures locales produiront des estimations par indicateurs indirects tant que les données détaillées de consommation ne seront pas disponibles.
L'efficacité réelle devra être évaluée après plusieurs utilisations, en comparant le nombre de tours, les relances et la durée des sessions avant et après activation.

7. Bilan d'utilisation de jetons

Cette session de moins de 2 heures, a consacré une analyse ciblée à l'historique Chronicle, puis a créé un agent de revue de clôture. La consommation relevée est de 15,72 crédits Copilot AI, pour un montant de 0,16 $.

Le choix d'un déclenchement manuel et d'une comparaison limitée à 3 à 5 rapports vise précisément à éviter que l'outil d'amélioration ne consomme davantage de contexte qu'il n'en économise.