"Dos horas, como mucho": el tablero Kanban ahora responde con P50 y P90

Hay una tarjeta en el tablero Kanban. La descripción está bien y termina con «estimación: 2 horas». Se la pasas a un worker y te vas a hacer otra cosa. Tres horas después sigue corriendo. Seis horas después está ejecutando tests. En la hora nueve por fin tienes un PR.
La próxima vez que aparezca una tarea parecida, vuelves a escribir «estimación: 2 horas». No porque tengas mala memoria, sino porque en ningún sitio queda registrado que este tipo de tarea tardó de verdad nueve. La estimación rara vez falla por falta de metodología. Falla por falta de feedback.
Epoch, un plugin de la comunidad que ya está en el catálogo de Hermes, cierra justo ese bucle: estimar, medir, calibrar.
Qué hace realmente en el tablero
Tres movimientos, todos en momentos que ya te importan:
- En el instante en que un worker reclama una tarea, el plugin publica una estimación Monte Carlo como comentario de la tarea: P50 y P90, con P80/P95 al lado, no un vago «unas dos horas».
- Cuando esa ejecución termina, registra las horas de reloj de pared en el propio libro de Epoch, etiquetadas
auto_wallclock: medidas, no escritas por una persona. - La siguiente estimación se calibra con esos datos reales. Cuantas más ejecuciones, menor el error.
Se cuelga de dos hooks de Kanban: kanban_task_claimed y kanban_task_completed. No cambias tu flujo de tareas. Si el plugin está instalado y el tablero se usa, la estimación aparece en la tarjeta.
También registra una herramienta epoch_estimate y un comando slash /epoch para pedir una estimación suelta.
Tres cosas que saber antes de instalar
Primero, es un plugin de la comunidad, no algo integrado en Hermes. El nivel del catálogo es community, el mantenedor es KyaniteLabs y requires_hermes es >=0.21.6.
Segundo, necesita Node 22+ y acceso de red a npm en la primera ejecución. El plugin es una cáscara fina; el estimador en sí es un proceso hijo que corre npx -y @kyanitelabs/[email protected], el cual descarga Epoch y sus dependencias la primera vez.
Tercero, el título de la tarea se pasa a ese CLI local: los primeros 80 caracteres, más tu pista de tres puntos. Nada sale de la máquina, pero «se queda local» y «no envía nada» son promesas distintas, y esta es la primera.
La instalación es un solo comando:
hermes plugins install epoch
Luego confirma que está en la lista y habilitado:
hermes plugins list
Los plugins surten efecto en el siguiente ciclo de carga. Si lo instalaste con una session ya en marcha y su herramienta no aparece, reiniciar el gateway una vez es el arreglo más simple.
Escribir una tarjeta que se pueda calibrar de verdad
Por defecto, recurre a una estimación de clase de referencia: un rango derivado de tareas históricas del mismo tipo. Ese valor por defecto es útil desde el primer día, porque Epoch trae una base de datos de referencia incluida.
Lo que hace precisas las estimaciones, eso sí, es un rango explícito de tres puntos en la tarea:
Refactor fee calculation to remove floating point drift
epoch: 2/4/10h
2/4/10h es más optimista / más probable / más pesimista. Con tres números, el Monte Carlo tiene una distribución que muestrear, y P50/P90 significan algo. Sin ellos, el plugin solo puede producir un rango de clase de referencia: usable, pero no tan bueno como tu propio dato.
Mantén las unidades simples: h para horas, tres números separados por barras. «2-10 horas» no es una estimación de tres puntos.
Dónde se queda deliberadamente estrecho
Los plugins que llevan la contabilidad de tu trabajo son fáciles de sobredimensionar, y la divulgación de Epoch es inusualmente específica. Vale la pena repetir algunos puntos:
- El entorno del proceso hijo se limpia: solo pasan
PATH,HOME, los directorios de locale y temporales, más las variables de caché de Node/npm, registry, CA y proxy. El entorno del padre, las API keys y los secretos de Hermes nunca se pasan. - La telemetría está forzada a off: cada ejecución del plugin pone
EPOCH_TELEMETRY=0. La telemetría de Epoch en standalone es opt-in; el plugin nunca te apunta a ti. - Los datos viven en
HERMES_HOME/plugin-data/epoch/: estimaciones, datos reales y vínculos de ejecución, compartidos por todos los profiles. /epoches un passthrough restringido: reenvía otros subcomandos pero rechazaserve,self-improvey cualquier cosa que mute telemetría o datos. En plataformas de gateway también rechaza los subcomandos que escriben en el libro salvo que pongasallow_write_slash_on_gateway: true.- Los comentarios son solo de visualización: las estimaciones se vinculan a las ejecuciones mediante un mapeo guardado junto al libro, así que un marcador falsificado en un comentario no puede redirigir el registro.
El trabajo de los hooks corre en hilos de fondo de vida corta con un contexto contextvars copiado, así que nunca retrasa el arranque del worker. Si el proceso sale antes de que un trabajo termine, una outbox local del profile lo reproduce la próxima vez que el plugin se carga.
Tres advertencias que importan
Uno: el techo de registro de 12 horas. Una puerta de cordura solo acepta ejecuciones entre 0,05 y 12 horas, y no más de 10× la estimación. La intención es obvia —rechazar mediciones claramente erróneas—, pero también significa que el dato real de una ejecución de 14 horas no se registra. Si tus tareas son largas, los datos de calibración serán escasos.
Dos: la primera ejecución puede atascarse en npm. Las dependencias se descargan en el primer uso. Con una política tipo min-release-age de npm, puede que la versión fijada no tenga la antigüedad suficiente y la descarga se rechace. El plugin mantiene el trabajo en cola y reintenta en lugar de fallar, así que el síntoma es «la estimación nunca aparece», no un error claro. Después de instalar, dispáralo una vez a mano para confirmar que la descarga funciona.
Tres: no sabe las 2 horas que tenías en la cabeza. El rango de tres puntos es tuyo; el plugin solo puede muestrearlo. Unos valores de «más probable» habitualmente optimistas producen un P50 optimista, salvo que esta vez el sesgo queda registrado y lo absorbe la siguiente estimación. Ahí es donde le gana a un humano, pero también significa que las primeras estimaciones merecen escepticismo.
A quién le sirve y a quién no
Sirve: a equipos con tipos de tarea recurrentes, tarjetas con una definición de terminado clara, y diez segundos para un rango de tres puntos. A las dos o tres semanas, «cuánto tarda este tipo de tarea» deja de ser cuestión de memoria y humor.
No sirve: para exploración puntual (no hay clase de referencia que valga), proyectos con tareas de más de 12 horas (la puerta las descarta) y hosts totalmente offline que no alcanzan npm.
Una nota sobre cómo se relaciona con la maquinaria de tablero propia de Hermes: el ciclo de vida de la tarea y el comportamiento de review y reclaim vienen integrados en Hermes; Epoch solo cuelga una capa de estimación de los hooks de claim y complete. Para entender el tablero en sí, mira el ciclo de vida de review en Kanban. Para saber qué más vale la pena instalar, este desglose del barrido por lotes del catálogo explica las reglas de admisión.
Cuándo puedes usarlo
La entrada del catálogo se fusionó el 8 de noviembre de 2026 (PR #149757), versión 0.7.0, y ya está en main. En una release estable puedes instalarlo siempre que se cumpla requires_hermes (>=0.21.6): el catálogo se lee en runtime, así que no hace falta ninguna release de Hermes.
La versión corta
Las estimaciones fallan porque nadie devuelve las horas reales al sistema. Epoch echa una mano en dos momentos del tablero Kanban: al reclamar publica una estimación Monte Carlo con P50/P90, y al completar escribe las horas reales en un libro. El costo es una descarga de npm en la primera ejecución y un techo de 12 horas sobre lo que se registra; la recompensa es que, a partir de la tercera semana aproximadamente, el número de tu tarjeta empieza a parecerse a la realidad.