Session 3 โ€” 30 mars 2026

Amelioration des Skills Claude Code

Le cheminement de pensee pour optimiser /close-session et /new-subject

1

Le signal vient de Yann, pas de moi

Les skills /new-subject et /close-session tournent depuis un mois. Je les utilise quotidiennement, ca marche. Mais Yann me remonte : "le close-session est lent". Specifiquement l'etape ou il met a jour l'index.

En parallele, j'avais aussi note que l'index contenait une colonne Tags enorme โ€” certains sujets avec 20+ tags. Pas sur que ca serve a quoi que ce soit.

2

Comprendre ou le temps part avant de toucher a quoi que ce soit

J'ai demande a Claude d'analyser toutes les etapes du /close-session , une par une, avec une estimation de vitesse.

Le goulot : l'etape 4.5 relit le frontmatter de chaque README.md du workspace โ€” 75+ fichiers, un par un, en sequentiel. C'est O(n) sur le nombre de sujets, et on en a 80.
3

Edit cible au lieu de full-scan

75+ Read โ†’ 1 Edit

Le /close-session ne regenere plus l'index. Il edite uniquement la ligne du sujet courant. Le full-scan reste reserve au /new-subject (creation).

Restait le probleme du /new-subject qui, lui, a besoin de scanner tous les sujets pour matcher. Mon intuition : "y'a pas un trick bash pour recup tous les frontmatters d'un coup ?"

Un for/awk bash extrait les 80 frontmatters en 1 seul appel au lieu de 80 Read. Teste et valide.

4

Les tags : utiles mais pas la ou ils sont

En regardant l'index, j'ai realise que la colonne Tags prenait une place enorme et que personne ne les lisait depuis l'index. Le matching semantique du /new-subject se fait sur les frontmatters (Tier 2), pas sur l'index.

~20 tags/sujet โ†’ 0 dans l'index, 5-10 dans frontmatter

Tags supprimes de l'index, gardes dans les frontmatters . Au /close-session : review et prune (5-10 tags discriminants, supprimer les generiques).

5

Les checks de validation : garder mais consolider

L'etape 4 du /close-session (validation/cleanup) enchainait 18+ appels outils โ€” des Glob et Grep separees pour detecter les fichiers temporaires, mal places, sensibles.

18+ appels โ†’ 2 appels

15+ Glob consolides en 1 commande find. 3 Grep en 1 seul. Le check des hash hex retire (trop de faux positifs). Meme couverture, 89% d'appels en moins.

6

La repasse qui trouve ce qu'on n'aurait pas vu

Apres implementation, j'ai demande une repasse complete. Elle a trouve 7 references stales โ€” le rename skills-session โ†’ skills-improvements avait laisse des liens morts dans 7 fichiers differents.

Bilan

75+ Read โ†’ 1 Edit
Index au /close-session
18+ outils โ†’ 2 outils
Checks de validation
~20 tags โ†’ 5-10
Tags par sujet (prunes)

15 fichiers modifies, 7 references stales corrigees, 0 fonctionnalite supprimee.

Cette page applique les principes du DR transfert de connaissance โ€” progressive disclosure, alternatives rejetees, tags AI trust , le cheminement comme produit principal.

preview.smilewanted.com ยท main 8dd8738 ยท changelog