Tageskennzahlen ohne Drift: gestern vom heutigen Gesamtstand abziehen

Die meisten Dashboards, die mir begegnet sind, driften. Seit wann, kann das Team nicht sagen. Daily Metrics, eine Automation der Software Factory, die öffentlich auf software-factory.dev (öffnet in einem neuen Tab) entsteht, soll genau das verhindern. Warum das klappt, steht in einer einzigen Instruktion, die der Prompt immer wieder aufgreift.

Diese Automation sorgt dafür, dass ihre Zahlen ehrlich bleiben.

Ein fester Snapshot, einmal am Tag

Einmal täglich läuft sie, ausgelöst von einer einzigen Cron-Zeile: 0 9 * * *. Um 9 Uhr steht der Snapshot, egal ob gerade jemand hinschaut.

Die Arbeit ist absichtlich mechanisch. Feste Befehle zählen Codezeilen, Pull Requests, Commits, Issues, Tests, den CI-Zustand und die Coverage. Das Ergebnis landet in einer strengen JSON-Datei, deren Felder alle vorab feststehen. Die Automation prüft die Datei gegen das Schema. Anschließend setzt sie aus sämtlichen Tages-Snapshots auf der Platte die komplette Zeitreihe neu zusammen.

Optional ist dabei kein Feld. Steht ein Zähler auf null, ist das Feld trotzdem da, eben mit null. Fehlt ein Feld, wertet die Automation das als Bug und nicht als leeren Tag.

Das Delta entsteht durch Subtraktion

An dieser Stelle lohnt sich das Abschauen. Das Delta, also die Veränderung von einem Tag zum nächsten, misst die Automation nie über eine Abfrage mit Datumsfilter. Der Prompt schreibt das für Pull Requests vor und für Commits gleich noch einmal: keine Abfrage mit Datumsfilter. Stattdessen zieht sie den kumulierten Gesamtstand von gestern vom heutigen ab.

Abfragen mit Datumsfilter driften, und zwar ohne Vorwarnung. Eine Zeitzone, ein Index, der hinterherhinkt, ein Issue, das jemand nach Mitternacht bearbeitet hat: Schon liegt euer „merged today“-Zähler um zwei daneben, und kein Fehler schlägt an. Bei der Differenz zweier kumulierter Gesamtstände gibt es diese Drift nicht. War die Zahl von gestern richtig und ist die von heute richtig, ist auch die Differenz richtig.

Eine Methode, jeden Tag gleich

Mehr steckt nicht dahinter. Vertrauenswürdige Zahlen liefert keine clevere Abfrage. Sie entstehen aus einer einzigen Methode, die ihr jeden Tag exakt gleich anwendet, verankert am Vortag.

Für ein Team, das seine eigene Factory aufbaut, ist das die unscheinbare Arbeit. Von ihr hängt ab, ob das Dashboard in sechs Monaten noch einen Blick wert ist.

Die Automation zum Nachlesen: daily-metrics.yaml im Repository der Factory (öffnet in einem neuen Tab).

Welche Tageszahl in eurem Team wird jedes Mal, wenn ihr hinschaut, ein wenig anders berechnet?

Weiterlesen

Die Artikel der Wissensbasis sind auf Englisch.

• Quality and productivity metrics →
• Agentic Software Factory: Advanced Team Training →