---
title: "Journal de session — cartographier vfg-kit sans confondre les deux « kits »"
subtitle: "Deux dossiers portent presque le même nom dans le workspace ; un seul est le socle réutilisable né du ZEvent"
date: 2026-09-11
time: "09:30"
author: Synthèse VFG
status: pub
tags: ["vfg-kit", "journal", "session", "agentique"]
---

## Un piège de nommage

La demande initiale parlait d'un « guide explicatif des composants réutilisables », en lien avec la pull request « Extraction de composants réutilisables » repérée sur Zevent 2026. Cette PR mentionnait un dépôt `vfg-kit` sans remote configuré — donc forcément local, mais sans indiquer où.

Une recherche de dossiers nommés `vfg-kit` sur le disque en a remonté trois : `D:\GitRepos\vfg-kit`, `D:\VFG_PT__\VFG-Kit`, et un script `D:\Zevent2026\scripts\sync-vfg-kit.mjs`. Les deux premiers portent presque le même nom mais ne sont pas la même chose : `VFG-Kit` dans le workspace `VFG_PT__` est un « kit méthodes » (fiches de bonnes pratiques, sans rapport avec le code) ; `D:\GitRepos\vfg-kit` est le socle technique réellement extrait de Zevent 2026, celui que la PR #20 décrivait. Le script de synchronisation dans Zevent2026 a servi de confirmation : il référence explicitement ce second dépôt.

## Comprendre avant de vulgariser

Le `README.md` de `vfg-kit` donnait la règle d'admission du projet : *« ce qui reste d'un sous-système une fois retiré le domaine »*. Les deux paquets qu'il héberge — `@vfglol/scene-kit` et `@vfglol/realtime-server` — ont chacun leur propre `README.md`, nettement plus détaillé, avec des exemples de code, des mesures chiffrées (répartition du flux avant/après équilibrage, tailles de halos avant/après correction d'un bug de plafonnement) et des explications de *pourquoi* chaque garde-fou existe.

C'est cette matière — pas le code lui-même — qui a servi de socle à l'article : le principe d'extraction a posteriori plutôt qu'anticipée, le mécanisme d'équilibrage de flux entre comptes de tailles très différentes, la protection d'un salon de discussion public sans compte, et le bug de plafonnement de pourcentage qui transformait un halo en voile opaque. Rien n'a été inventé ni simplifié au point de perdre le sens : les chiffres cités dans l'article (25 % → 15,5 % pour les cinq plus gros comptes, par exemple) viennent directement du README technique.

## Pas de serveur à lancer, et le dire clairement

Contrairement aux trois autres sujets de la session, `vfg-kit` est une bibliothèque de code, pas une application : il n'y a rien à démarrer, pas de page à ouvrir dans un navigateur. Plutôt que de forcer une URL artificielle, la session s'est arrêtée sur ce constat et l'a signalé explicitement dans le compte-rendu final — mieux vaut une absence assumée qu'une fausse démonstration.

## Ce qui reste de cette session

L'article de présentation a été publié dans la catégorie `vfg-kit`, déjà existante sur ce blog (un brouillon y dormait depuis juin). Ce journal documente la distinction entre les deux dossiers presque homonymes — pour ne pas se tromper la prochaine fois qu'il sera question d'un « kit VFG ».