Mécanisme lu dans le code du backend le 8 octobre 2026. Les chiffres du journal viennent d’un vrai passage ce jour-là. Rien ici n’est une projection.
Comment un skill est créé
Cinq étapes, dans l’ordre où elles se déroulent. Chaque seuil ci-dessous est une valeur par défaut du code.
Les notes se relient
À chaque création ou mise à jour d’une note, PO la relie aux notes proches par des liens pondérés appelés synapses. Une tâche périodique complète ceux qui manquent, et une autre use un peu chaque lien toutes les six heures : les liens que personne n’utilise s’effacent.
Les groupes sont détectés
Les notes qui ont des liens forment un graphe. Un algorithme de détection de communautés (Louvain pondéré, résolution 1,5) le découpe en groupes de notes fortement liées. Il faut au moins 15 notes avec des liens dans le projet ; en dessous, il répond « pas assez de données », après avoir essayé de créer les liens manquants pour 200 notes au plus.
Les groupes sont filtrés
Un groupe doit contenir au moins 3 notes et avoir une cohésion d’au moins 0,5. Une note dont le poids moyen des liens dans le groupe est sous 0,2 en est retirée. Un groupe qui recouvre à 70 % ou plus un skill existant met ce skill à jour au lieu d’en créer un nouveau.
Un skill est créé, « émergent »
Son nom est formé des trois étiquettes les plus fréquentes du groupe, en majuscules de titre. Sa description est un décompte (« Auto-detected skill from N notes… »). Aucun modèle de langage n’écrit l’un ou l’autre. Son énergie est l’énergie moyenne de ses notes, pondérée par leur importance. Des déclencheurs et un modèle de contexte sont générés.
Quand ça tourne
Trois façons. La vérification de maintenance en arrière-plan passe toutes les 15 minutes par tranches, avec au moins 24 heures entre deux passes sur un même projet. Le serveur fait un échauffement au démarrage pour un projet sans skill ou dont les skills ont plus d’un jour. Ou à la main : l’action d’administration « détecter les skills ».
De « émergent » à « supprimé »
émergent → actif
Les quatre à la fois : énergie d’au moins 0,3, cohésion d’au moins 0,4, au moins 3 notes membres, et au moins 2 activations par un hook. La passe quotidienne remplace les seuils d’énergie et de cohésion par les percentiles du projet (le 60e pour la promotion) dès qu’il compte 4 skills ou plus.
actif → dormant
Énergie sous 0,1 ET (inactif depuis 30 jours ou plus, ou cohésion sous 0,2). Trente jours d’inactivité ne suffisent pas : l’énergie doit aussi être basse. Un skill jamais activé compte comme inactif depuis toujours.
dormant → archivé → supprimé
Archivé après 90 jours d’inactivité. Un skill émergent sans aucune activation, d’énergie sous 0,1 et de plus de 90 jours est archivé directement. Un skill archivé que personne ne référence est supprimé après 7 jours.
Comment il sert
Avant un appel d’outil, un hook compare la demande aux déclencheurs du skill (expression régulière, motif de fichier, sémantique ou action MCP), garde ce qui dépasse 0,5 de confiance, et remet à l’assistant les notes du skill dans un budget de 3 200 caractères. Les skills émergents sont injectés aussi, c’est ainsi qu’ils peuvent atteindre leurs 2 activations. Chaque activation ajoute 1 au compteur et donne un peu d’énergie aux notes membres.
La procédure que nous avons construite design-system-sync
Une procédure est un protocole : une machine à états que PO peut suivre pas à pas. Celle-ci, design-system-sync, garde un seul système de design entre l’application et le site. Ses six états :
detect
Mesurer la dérive entre l’application et le site : lancer le contrôle de design, lire les lignes strictes et la liste des fichiers portés qui ont changé. Ne rien changer encore.
decide
Une décision consignée par dérive. La source est toujours l’application. Avant de porter, chercher dans le site ce que le produit a supprimé : un nom retiré qui est encore lu casse une animation sans aucune erreur.
port
Classes : étendre le générateur, puis synchroniser. Composants : une copie littérale, déclarée dans le manifeste. Si la copie demande une correction d’une ligne, la même ligne est corrigée dans la source, dans la même passe : une seule source.
verify
Types, lint, tests, les deux lignes strictes au vert, puis la réalité dans un navigateur : la valeur calculée (curseur, flou, position), le clavier à un rythme humain, la page prérendue. Prouver chaque test rouge en retirant le changement, puis le rétablir. Tout échec renvoie la passe à port : jamais de contournement.
record
Une note par piège trouvé, reliée par ses étiquettes, plus la décision, le manifeste et ce journal. Les dérives laissées de côté sont écrites avec leur nombre, pas oubliées. Ces notes, reliées entre elles, sont ce qui peut faire émerger un skill.
done
Dérive stricte à zéro, le reste documenté, et un compte rendu qui dit ce qui a été observé contre ce qui était supposé, et ce qui n’a pas été vu.
Le premier état commence par cette commande :
Terminal
pnpm check:design --summaryJournal de construction
Une entrée par étape réellement faite, écrite pendant le travail et jamais après coup. Les heures sont en UTC quand PO les a enregistrées.
- Détecter
Le système de design commun avait dérivé
On a demandé que les menus et les sélecteurs du site ressemblent à ceux du produit (translucides, floutés) et de garder un seul système de design : le premier geste a été de mesurer. Le contrôle de design échouait sur sa ligne stricte : les classes générées étaient périmées, et 23 fichiers portés avaient changé dans le produit. Le menu de langue de l’en-tête était opaque, et le sélecteur de langue du pied de page était un select natif, dont la liste ne peut pas être translucide.
Où retrouver la preuve :
pnpm check:design --summary - Décider
Porter tel quel aurait cassé des animations, sans bruit
La source est l’application (une décision de la veille dit que le frontend fait foi). Avant de régénérer, une recherche dans le site a montré qu’il lit encore trois noms de mouvement que le produit avait supprimés. Une variable CSS inconnue ne lève aucune erreur : la durée devient invalide et l’animation disparaît, c’est tout. La décision : régénérer, et garder les trois noms comme alias avec leurs anciennes valeurs.
Où retrouver la preuve :
site.css (« Anciens noms de mouvement ») - Porter
Le générateur a appris deux règles de plus, le select a été porté
Le générateur qui copie les classes partagées du produit reprend maintenant aussi la recette du menu déroulant et l’anneau de focus doux. Le composant Select du produit a été copié tel quel et déclaré dans le manifeste, et le sélecteur du pied de page l’utilise. Le menu de langue de l’en-tête est devenu une couche de verre translucide. Après la régénération, les lignes strictes du contrôle de design étaient au vert : classes à jour, palette identique.
Où retrouver la preuve :
scripts/design-sync-lib.mjs, design-sync.manifest.json - Vérifier
Premier regard dans un navigateur : le menu s’ouvrait en haut à gauche
Les valeurs calculées étaient bonnes (flou de 20 px, curseur main) mais le menu n’était pas accroché à son bouton. Cause : le composant décide au chargement si le navigateur sait ancrer en CSS. La page prérendue disait non, le navigateur disait oui, et React garde les attributs du serveur : l’ancre n’était jamais posée. Dans l’application, qui n’est pas prérendue, personne ne pouvait le voir. Le correctif est un hook qui répond « non » pendant le rendu serveur et le premier rendu client, puis la vraie réponse. Il a été fait dans la source et dans la copie en même temps.
Où retrouver la preuve :
menuPosition.ts (useSupportsAnchorPositioning) - Vérifier
Le test clavier a échoué, puis réussi : c’était le test
Appuyer sur Bas, Bas, Entrée dans un script ne changeait rien. Avec 250 ms entre les touches, le rythme d’une personne, le menu s’ouvrait sur la langue courante, passait à la suivante, et Entrée y naviguait et fermait le menu. Le premier essai avait mesuré une course entre les touches et l’événement asynchrone « popover ouvert » du navigateur. La course existe pour quelqu’un qui tape plus vite que le navigateur, dans la source aussi, et elle n’est pas corrigée.
Où retrouver la preuve :
note « Tester un composant au clavier avec un script » - Consigner
La procédure a été écrite comme un protocole
Ce qui venait d’être fait est devenu un protocole PO nommé « design-system-sync » : six états, sept transitions, et un retour de verify vers port. Dix notes ont été écrites, une par piège rencontré ce jour-là, étiquetées pour qu’elles se relient entre elles.
Où retrouver la preuve :
protocol 431b1612 ; notes taguées design-system-sync - Skill
La détection a été lancée, et un skill est apparu
L’action « détecter les skills » a trouvé 12 groupes candidats parmi 157 notes et 906 liens (modularité 0,45), créé 6 skills et en a mis à jour 6. L’un des nouveaux, « Design System Sync Design Accessibility », contient 11 notes : six des nôtres et cinq plus anciennes sur les contrôles de design et le mouvement, que les liens ont attirées. Sa cohésion est de 0,56. Un autre nouveau skill, « Design Mobile A11y », contient cinq notes, dont notre note sur le curseur main. Trois de nos dix notes (l’observation sur le flou, la mesure du décompte d’usages et la note sur la règle de couleur) n’étaient dans aucun des douze skills touchés : elles sont restées dehors, et nous n’avons pas vérifié pourquoi.
Où retrouver la preuve :
admin detect_skills ; skills fda0cf7d et c5b4b51f - Skill
Une activation de test, et aucun raccourci
Interrogé sur un menu qui s’ouvre dans le mauvais coin après le prérendu, le nouveau skill a répondu avec une confiance de 1,0 et rendu ses 11 notes. Cela a compté pour une activation. La promotion à « actif » demande deux activations par un hook, et nous n’avons pas répété l’appel pour l’atteindre : un skill promu parce qu’on l’a poussé n’est pas un skill qui a servi. Il reste « émergent ».
Où retrouver la preuve :
skill get_health fda0cf7d
Le skill aujourd’hui
Un relevé daté, pas un compteur en direct. Au 2026-10-08 11:44 UTC
Design System Sync Design Accessibility
- Statut
- émergent
- Notes
- 11
- Cohésion
- 0.56
- Énergie
- 0.98
- Activations
- 1
- Qualité du déclencheur
- 0.34
Il devient actif après deux activations par un hook. D’ici là c’est un candidat, pas un skill éprouvé.
Ce que le mécanisme ne fait pas
- Aucun modèle de langage n’intervient : le nom et la description sont des heuristiques (étiquettes fréquentes, compteurs), un nom de skill peut donc être un mélange étrange comme « Design System Sync Design Accessibility ».
- Les déclencheurs générés sont bruités. Celui de notre skill vaut 0,34 sur 1 et contient des mots comme « 200 » et « règle ».
- Prérequis cachés : au moins 15 notes avec des liens dans le projet, et les liens s’usent avec le temps, ce qui peut remettre un projet sous le seuil. L’échauffement au démarrage ne couvre que les projets dont le dossier existe sur le disque.
- Rien n’est promu sans usage : un skill ne devient actif qu’après 2 activations par un hook. Sans hook installé côté client, ni le hook interne du chat, un skill émergent reste émergent.
- Une procédure (un protocole) peut créer un skill à la main (« composer »), mais aucun mécanisme ne transforme un skill détecté en protocole. Le seul protocole fourni qui touche aux skills le fait par une consigne à l’assistant, pas par du code.
- Une partie de la documentation dans le code est périmée : un commentaire donne 0,3 pour la cohésion minimale alors que le code utilise 0,5, et un réglage étiqueté « désactivé, prévu pour une version future » n’arrête pas la vérification en arrière-plan, qui tourne bien.