Zwei Stunden, höchstens: das Kanban-Board antwortet jetzt mit P50 und P90


Auf dem Kanban-Board liegt eine Karte. Die Beschreibung ist gut, und sie endet mit „estimate: 2 hours“. Du gibst sie einem Worker und machst etwas anderes. Drei Stunden später läuft sie noch. Sechs Stunden später laufen Tests. In Stunde neun hast du endlich einen PR.

Beim nächsten ähnlichen Task schreibst du wieder „estimate: 2 hours“. Nicht weil dein Gedächtnis schlecht ist, sondern weil nirgendwo festgehalten wird, dass diese Klasse von Task tatsächlich neun gebraucht hat. Schätzen scheitert selten an fehlender Methodik. Es scheitert an fehlendem Feedback.

Epoch, ein Community-Plugin, das jetzt im Hermes-Katalog steht, schließt genau diesen Kreis: schätzen, messen, kalibrieren.

Was es auf dem Board tatsächlich tut

Drei Züge, alle zu Momenten, die dich ohnehin interessieren:

  1. In dem Moment, in dem ein Worker eine Task beansprucht, postet das Plugin eine Monte-Carlo-Schätzung als Task-Kommentar — P50 und P90, mit P80/P95 daneben, kein vages „etwa zwei Stunden“.
  2. Wenn dieser Lauf endet, schreibt es die Wall-Clock-Stunden des Laufs in Epochs eigenes Ledger zurück, getaggt mit auto_wallclock — gemessen, nicht von einem Menschen eingetippt.
  3. Die nächste Schätzung kalibriert aus diesen Actuals. Je mehr Läufe, desto kleiner der Fehler.

Es hängt an zwei Kanban-Hooks: kanban_task_claimed und kanban_task_completed. Du änderst deinen Task-Workflow nicht. Wenn das Plugin installiert ist und das Board benutzt wird, erscheint die Schätzung auf der Karte.

Es registriert außerdem ein epoch_estimate-Tool und einen /epoch-Slash-Command, um eine eigenständige Schätzung anzufordern.

Drei Dinge, die du vor der Installation wissen solltest

Erstens: Es ist ein Community-Plugin, nichts in Hermes Eingebautes. Die Katalog-Stufe ist community, der Maintainer ist KyaniteLabs, und requires_hermes ist >=0.21.6.

Zweitens: Es braucht Node 22+ und beim ersten Lauf Netzzugang zu npm. Das Plugin ist eine dünne Shell; der Estimator selbst ist ein Child-Prozess, der npx -y @kyanitelabs/[email protected] ausführt und beim ersten Mal Epoch und seine Dependencies herunterlädt.

Drittens: Der Task-Titel wird an diese lokale CLI übergeben — die ersten 80 Zeichen plus dein Drei-Punkt-Hinweis. Nichts verlässt die Maschine, aber „bleibt lokal“ und „sendet nichts“ sind unterschiedliche Versprechen, und dieses ist das erstere.

Die Installation ist ein Befehl:

hermes plugins install epoch

Dann bestätige, dass es in der Liste steht und aktiviert ist:

hermes plugins list

Plugins greifen im nächsten Load-Zyklus. Wenn du es installiert hast, während eine session schon lief, und sein Tool nicht auftaucht, ist ein einmaliger Neustart des gateway der einfachste Fix.

Eine Karte schreiben, die sich tatsächlich kalibrieren lässt

Standardmäßig fällt es auf eine Reference-Class-Schätzung zurück — eine Spanne aus historischen Tasks derselben Art. Dieser Default ist ab Tag eins nützlich, weil Epoch eine mitgelieferte Referenzdatenbank hat.

Was Schätzungen aber genau macht, ist eine explizite Drei-Punkt-Spanne in der Task:

Refactor fee calculation to remove floating point drift

epoch: 2/4/10h

2/4/10h heißt am optimistischsten / am wahrscheinlichsten / am pessimistischsten. Mit drei Zahlen hat die Monte-Carlo-Simulation eine Verteilung zum Samplen, und P50/P90 bedeuten etwas. Ohne sie kann das Plugin nur eine Reference-Class-Spanne liefern — brauchbar, aber nicht so gut wie dein eigener Input.

Halte die Einheiten einfach: h für Stunden, drei durch Slash getrennte Zahlen. „2-10 hours“ ist keine Drei-Punkt-Schätzung.

Wo es bewusst eng bleibt

Plugins, die über deine Arbeit Buch führen, neigen dazu, ihren Scope zu sprengen, und Epochs Offenlegung ist ungewöhnlich konkret. Ein paar Punkte lohnen die Wiederholung:

  • Die Umgebung des Child-Prozesses wird gesäubert: Nur PATH, HOME, Locale und Temp-Verzeichnisse sowie Node/npm-Cache, Registry, CA- und proxy-Variablen kommen durch. Die Parent-Umgebung, API-Keys und Hermes-Secrets werden nie übergeben.
  • Telemetrie ist zwangsweise aus: Jeder Plugin-Lauf setzt EPOCH_TELEMETRY=0. Standalone-Epoch-Telemetrie ist opt-in; das Plugin meldet dich nie an.
  • Daten liegen unter HERMES_HOME/plugin-data/epoch/: Schätzungen, Actuals und Run-Bindings, geteilt von jedem profile.
  • /epoch ist ein eingeschränkter Passthrough: Es leitet andere Subcommands weiter, verweigert aber serve, self-improve und alles, was Telemetrie oder Daten mutiert. Auf gateway-Plattformen verweigert es außerdem Ledger-schreibende Subcommands, außer du setzt allow_write_slash_on_gateway: true.
  • Kommentare sind reine Anzeige: Schätzungen werden über ein Mapping neben dem Ledger an Läufe gebunden, ein gefälschter Marker in einem Kommentar kann die Aufzeichnung also nicht umleiten.

Hook-Arbeit läuft auf kurzlebigen Hintergrund-Threads mit einem kopierten contextvars-Kontext, verzögert also nie den Worker-Spawn. Wenn der Prozess endet, bevor ein Job fertig ist, spielt eine profile-lokale Outbox ihn beim nächsten Laden des Plugins erneut ab.

Drei Vorbehalte, die zählen

Eins: die 12-Stunden-Obergrenze bei der Aufzeichnung. Ein Sanity-Gate akzeptiert nur Läufe zwischen 0,05 und 12 Stunden und nicht mehr als das 10-fache der Schätzung. Der Intent ist offensichtlich — offensichtlich falsche Messungen abweisen —, aber es heißt auch, dass der Actual eines 14-Stunden-Laufs nicht aufgezeichnet wird. Wenn deine Tasks lang sind, bleiben die Kalibrierdaten dünn.

Zwei: Der erste Lauf kann an npm hängen bleiben. Dependencies werden beim ersten Gebrauch heruntergeladen. Mit einer npm-Policy im Stil von min-release-age ist die gepinnte Version vielleicht noch nicht alt genug, und der Download wird verweigert. Das Plugin hält den Job in der Queue und versucht es erneut, statt mit Fehler abzubrechen, das Symptom ist also „die Schätzung erscheint nie“, kein klarer Fehlschlag. Trigger es nach der Installation einmal manuell, um zu bestätigen, dass der Download funktioniert.

Drei: Es kennt die 2 Stunden, die du im Kopf hattest, nicht. Die Drei-Punkt-Spanne ist deine; das Plugin kann sie nur samplen. Gewohnheitsmäßig optimistische Most-Likely-Werte ergeben einen optimistischen P50 — außer dass dieser Bias diesmal aufgezeichnet und von der nächsten Schätzung absorbiert wird. Das ist der Teil, in dem es einen Menschen schlägt, aber es heißt auch, dass die ersten paar Schätzungen Skepsis verdienen.

Für wen es passt, für wen nicht

Passt: Teams mit wiederkehrenden Task-Typen, Karten mit klarer Definition of Done und zehn Sekunden übrig für eine Drei-Punkt-Spanne. Nach zwei oder drei Wochen ist „wie lange dauert so ein Task“ keine Frage von Gedächtnis und Laune mehr.

Passt nicht: einmalige Exploration (keine nennenswerte Reference Class), Projekte mit mehr als 12 Stunden pro Task (das Gate verwirft sie) und vollständig Offline-Hosts, die npm nicht erreichen.

Eine Anmerkung, wie es zu Hermes’ eigener Board-Maschinerie steht: Task-Lebenszyklus, Review und Reclaim-Verhalten sind in Hermes eingebaut; Epoch hängt nur eine Schätzungsschicht an die Claim- und Complete-Hooks. Um das Board selbst zu verstehen, siehe den Kanban-Review-Lebenszyklus. Was sonst noch eine Installation wert ist, erklärt diese Aufschlüsselung des Katalog-Batch-Sweeps mit den Aufnahmeregeln.

Wann du es nutzen kannst

Der Katalog-Eintrag wurde am 8. November 2026 gemergt (PR #149757), Version 0.7.0, und ist bereits auf main. Auf einem stabilen Release kannst du es installieren, solange requires_hermes erfüllt ist (>=0.21.6) — der Katalog wird zur Laufzeit gelesen, es ist also kein Hermes-Release nötig.

Die Kurzfassung

Schätzungen verfehlen, weil niemand die tatsächlichen Stunden zurückspeist. Epoch legt an zwei Momenten auf dem Kanban-Board Hand an: beim Claim postet es eine Monte-Carlo-Schätzung mit P50/P90, beim Abschluss schreibt es die echten Stunden in ein Ledger. Der Preis ist ein npm-Download beim ersten Lauf und eine 12-Stunden-Obergrenze für das, was aufgezeichnet wird; der Gewinn ist, dass die Zahl auf deiner Karte ab etwa der dritten Woche anfängt, der Realität zu ähneln.