« Deux heures, grand maximum » — le tableau Kanban répond désormais avec un P50 et un P90


Il y a une carte sur le tableau Kanban. La description est bonne, et elle se termine par « estimation : 2 heures ». Vous la confiez à un worker et vous passez à autre chose. Trois heures plus tard, ça tourne encore. Six heures plus tard, ça lance les tests. À la neuvième heure, vous avez enfin une PR.

La fois suivante, quand une tâche similaire se présente, vous écrivez de nouveau « estimation : 2 heures ». Pas parce que votre mémoire est mauvaise, mais parce que rien, nulle part, n’enregistre que cette classe de tâche a en réalité pris neuf heures. L’estimation échoue rarement par manque de méthode. Elle échoue par manque de retour d’information.

Epoch, un plugin communautaire désormais au catalogue Hermes, ferme exactement cette boucle : estimer, mesurer, calibrer.

Ce qu’il fait réellement sur le tableau

Trois gestes, tous à des moments qui vous intéressent déjà :

  1. À l’instant où un worker réclame une tâche, le plugin publie une estimation Monte Carlo en commentaire de tâche — P50 et P90, avec P80/P95 à côté, pas un vague « environ deux heures ».
  2. Quand cette exécution se termine, il enregistre les heures réelles dans le registre propre à Epoch, étiquetées auto_wallclock — mesurées, pas saisies par un humain.
  3. L’estimation suivante se calibre sur ces valeurs réelles. Plus il y a d’exécutions, plus l’erreur diminue.

Il se branche sur deux hooks Kanban : kanban_task_claimed et kanban_task_completed. Vous ne changez rien à votre façon de travailler. Si le plugin est installé et que le tableau est utilisé, l’estimation apparaît sur la carte.

Il enregistre aussi un outil epoch_estimate et une commande slash /epoch pour demander une estimation ponctuelle.

Trois choses à savoir avant d’installer

Premièrement, c’est un plugin communautaire, pas quelque chose d’intégré à Hermes. Le niveau au catalogue est community, le mainteneur est KyaniteLabs, et requires_hermes vaut >=0.21.6.

Deuxièmement, il faut Node 22+ et un accès réseau à npm au premier lancement. Le plugin n’est qu’une coquille : l’estimateur lui-même est un processus enfant qui exécute npx -y @kyanitelabs/[email protected], ce qui télécharge Epoch et ses dépendances la première fois.

Troisièmement, le titre de la tâche est transmis à ce CLI local — les 80 premiers caractères, plus votre indice à trois points. Rien ne quitte la machine, mais « reste en local » et « n’envoie rien » sont deux promesses différentes, et celle-ci est la première.

L’installation tient en une commande :

hermes plugins install epoch

Vérifiez ensuite qu’il figure dans la liste et qu’il est activé :

hermes plugins list

Les plugins prennent effet au cycle de chargement suivant. Si vous l’avez installé alors qu’une session tournait déjà et que son outil n’apparaît pas, redémarrer le gateway une fois est la solution la plus simple.

Écrire une carte qui puisse vraiment être calibrée

Par défaut, il retombe sur une estimation par classe de référence — une fourchette dérivée de tâches historiques du même type. Ce défaut est utile dès le premier jour, parce qu’Epoch embarque une base de référence.

Ce qui rend les estimations précises, en revanche, c’est une fourchette explicite à trois points dans la tâche :

Refactor fee calculation to remove floating point drift

epoch: 2/4/10h

2/4/10h, c’est le plus optimiste / le plus probable / le plus pessimiste. Avec trois nombres, le Monte Carlo dispose d’une distribution à échantillonner, et P50/P90 veulent dire quelque chose. Sans eux, le plugin ne peut produire qu’une fourchette par classe de référence — utilisable, mais moins bonne que votre propre saisie.

Gardez les unités simples : h pour les heures, trois nombres séparés par des slashs. « 2-10 heures » n’est pas une estimation à trois points.

Où il reste délibérément étroit

Les plugins qui tiennent les comptes de votre travail sont faciles à surdimensionner, et la divulgation d’Epoch est inhabituellement précise. Quelques points méritent d’être répétés :

  • L’environnement du processus enfant est nettoyé : seuls PATH, HOME, les variables de locale et de répertoire temporaire, plus les variables Node/npm de cache, de registre, de CA et de proxy passent. L’environnement parent, les clés API et les secrets Hermes ne sont jamais transmis.
  • La télémétrie est forcée à l’arrêt : chaque exécution du plugin pose EPOCH_TELEMETRY=0. La télémétrie d’Epoch en autonome est opt-in ; le plugin ne vous y inscrit jamais.
  • Les données vivent sous HERMES_HOME/plugin-data/epoch/ : estimations, valeurs réelles et liaisons d’exécution, partagées par tous les profils.
  • /epoch est un passe-plat restreint : il relaie les autres sous-commandes mais refuse serve, self-improve, et tout ce qui modifie la télémétrie ou les données. Sur les plateformes de type gateway, il refuse aussi les sous-commandes qui écrivent dans le registre, sauf si vous mettez allow_write_slash_on_gateway: true.
  • Les commentaires sont purement décoratifs : les estimations sont liées aux exécutions par une table de correspondance stockée à côté du registre, donc un marqueur forgé dans un commentaire ne peut pas détourner l’enregistrement.

Le travail des hooks tourne sur des threads d’arrière-plan de courte durée avec un contexte contextvars copié, donc il ne retarde jamais le lancement d’un worker. Si le processus sort avant qu’un job ne se termine, une outbox locale au profil le rejoue au chargement suivant du plugin.

Trois réserves qui comptent

Un : le plafond d’enregistrement à 12 heures. Une porte de cohérence n’accepte que les exécutions entre 0,05 et 12 heures, et pas plus de 10× l’estimation. L’intention est évidente — rejeter les mesures manifestement fausses — mais cela signifie aussi que la valeur réelle d’une exécution de 14 heures n’est pas enregistrée. Si vos tâches sont longues, les données de calibration seront clairsemées.

Deux : le premier lancement peut se bloquer sur npm. Les dépendances se téléchargent au premier usage. Avec une politique du type min-release-age sur npm, la version épinglée peut ne pas être assez ancienne et le téléchargement est refusé. Le plugin garde alors le job en file et réessaie au lieu d’échouer franchement, donc le symptôme est « l’estimation n’apparaît jamais », pas une erreur claire. Après l’installation, déclenchez-le une fois à la main pour confirmer que le téléchargement fonctionne.

Trois : il ne connaît pas les 2 heures que vous aviez en tête. La fourchette à trois points est la vôtre ; le plugin ne peut que l’échantillonner. Des valeurs « plus probables » habituellement optimistes produisent un P50 optimiste — sauf que cette fois le biais est enregistré et absorbé par l’estimation suivante. C’est là qu’il bat un humain, mais cela veut aussi dire que les premières estimations méritent de la méfiance.

À qui ça convient, à qui non

Ça convient : aux équipes avec des types de tâches récurrents, aux cartes avec une définition de « terminé » claire, et dix secondes à consacrer à une fourchette à trois points. Au bout de deux ou trois semaines, « combien de temps prend ce genre de tâche » cesse d’être une affaire de mémoire et d’humeur.

Ça ne convient pas : à l’exploration ponctuelle (pas de classe de référence digne de ce nom), aux projets dont les tâches dépassent 12 heures (la porte les rejette), et aux hôtes totalement hors ligne qui ne peuvent pas joindre npm.

Une remarque sur son rapport à la machinerie de tableau de Hermes elle-même : le cycle de vie des tâches, la revue et le comportement de récupération sont intégrés à Hermes ; Epoch ne fait qu’accrocher une couche d’estimation aux hooks de réclamation et de complétion. Pour comprendre le tableau lui-même, voir le cycle de vie de la revue Kanban. Pour savoir quoi d’autre vaut la peine d’être installé, cette analyse de la passe groupée sur le catalogue explique les règles d’admission.

Quand pourrez-vous en profiter

L’entrée au catalogue a été fusionnée le 8 novembre 2026 (PR #149757), version 0.7.0, et elle est déjà sur main. Sur une release stable, vous pouvez l’installer tant que requires_hermes est satisfait (>=0.21.6) — le catalogue est lu à l’exécution, donc aucune release de Hermes n’est nécessaire.

La version courte

Les estimations ratent parce que personne ne renvoie les heures réelles. Epoch ajoute une main à deux moments sur le tableau Kanban : à la réclamation, il publie une estimation Monte Carlo avec P50/P90 ; à la complétion, il écrit les heures réelles dans un registre. Le coût, c’est un téléchargement npm au premier lancement et un plafond de 12 heures sur ce qui est enregistré ; le gain, c’est qu’à partir de la troisième semaine environ, le chiffre sur votre carte commence à ressembler à la réalité.