Aller au contenu

Suppression de l'agent coach d'usage IA

Billet #246 : Suppression de l'agent coach d'usage IA
Type : Automatisation / Workflow / Gouvernance
Composants concernés : .github/agents/ai-coach.agent.md, .github/ai-coach.config.json, .github/hooks/ai-coach-session-start.json, .github/prompts/ai-coach-report.prompt.md, scripts/hooks/ai_coach_session_start.ps1, scripts/hooks/ai_coach_append_event.ps1, tests/test_ai_coach_infrastructure.py

1. Contexte et décision

Le coach d'usage IA a été introduit en deux itérations successives — billets #224 et #232 — avec l'objectif d'analyser les sessions de travail avec GitHub Copilot, mesurer la pression token et produire des rapports de coaching ciblés pour améliorer les habitudes de prompt.

Après avoir opéré le système sur plusieurs sessions, deux problèmes structurels sont apparus clairement :

1 — Qualité des métriques insuffisante

Malgré le travail de fiabilisation réalisé au billet #232, la collecte d'événements demeurait trop mince pour produire des évaluations de session véritablement utiles. Le coach pouvait confirmer qu'une session avait démarré, mais peinait à reconstituer ce qui s'était réellement passé — quel était l'objectif, quelles actions avaient été posées, quel résultat avait été obtenu. Les rapports générés restaient trop superficiels pour provoquer un vrai changement de comportement.

2 — Coût token non-négligeable

L'infrastructure d'activation du coach — hooks de démarrage, fichiers d'événements, fichiers de configuration et prompt de rapport — ajoutait une charge de contexte à chaque session. Cette surcharge allait directement à l'encontre de l'objectif central que l'agent était censé servir : réduire le gaspillage de tokens. L'outil consommait la ressource même qu'il était supposé optimiser.

Au vu de ces deux constats, la décision a été prise de retirer l'agent complètement plutôt que d'investir dans une troisième itération au retour incertain.

2. Ce qui a été supprimé

Sept fichiers ont été retirés :

Fichier Rôle
.github/agents/ai-coach.agent.md Définition de l'agent et instructions de comportement
.github/ai-coach.config.json Configuration centrale (mode de capture, paramètres de rétention)
.github/hooks/ai-coach-session-start.json Déclaration du hook de démarrage de session
.github/prompts/ai-coach-report.prompt.md Prompt de génération du rapport
scripts/hooks/ai_coach_session_start.ps1 Hook de démarrage — génération de l'identifiant de session et création des artefacts
scripts/hooks/ai_coach_append_event.ps1 Hook d'écriture des jalons de session
tests/test_ai_coach_infrastructure.py Tests de non-régression de l'infrastructure du coach

3. Ce qui a été conservé

Les trois rapports d'activité documentant les décisions de conception, l'implémentation technique et les problèmes rencontrés sont préservés à titre de mémoire institutionnelle :

Cette documentation garantit que si le problème resurgit dans le futur, le raisonnement derrière chaque choix architectural et chaque point de défaillance est traçable sans avoir à le reconstituer de zéro.

4. Résultat

Les 123 tests automatisés ont continué de passer après la suppression. Aucune dépendance fonctionnelle sur l'infrastructure du coach n'existait dans le reste de la base de code. La suppression a été propre, réversible via le contrôle de version, et committée sur la branche ai-agent-coach-deletion.