Die Stale-Uhr nach der Zykluszeit eurer Agenten stellen

Drei Stunden. Länger darf ein Stück Arbeit in der Factory auf software-factory.dev nicht unberührt liegen, dann greift der Stale-Issue Reviewer ein. Drei Stunden, nicht drei Tage. Seine Definition liegt auf GitHub (öffnet in einem neuen Tab).

Was der Reviewer alle vier Stunden prüft

Alle vier Stunden läuft die Automation, gesteuert über die Cron-Zeile 0 */4 * * *. Starten könnt ihr sie auch von Hand. In jedem Lauf holt sie sich alle offenen Issues mit dem Label status:in-progress und stellt eine harte Frage: Geht es hier noch voran, oder ist etwas gestorben?

Gesucht wird ein leiser Fehler. Eine Builder-Automation nimmt sich ein Issue mit diesem Label und scheitert dann, ohne einen Laut. Das Label bleibt hängen. Nach außen wirkt das Issue beschäftigt, tatsächlich passiert nichts, und dahinter stapelt sich die abhängige Arbeit.

Drei Bedingungen, bevor Arbeit als stale gilt

Was als stale zählt, legt der Reviewer streng aus. Erst wenn alle drei Bedingungen zugleich erfüllt sind, kommt ein Issue infrage:

• Das In-progress-Label ist älter als drei Stunden.
• Kein offener Pull Request verweist darauf, oder der vorhandene ist seinerseits seit drei Stunden still.
• In letzter Zeit hat kein echter Mensch kommentiert.

Trifft auch nur eine nicht zu, lässt er das Issue in Ruhe. Es könnte ja sein, dass eine Automation noch mitten im Build steckt.

Arbeit zurücksetzen und eskalieren, was andere blockiert

Was mit einem stale Issue passiert, hängt vom Blast Radius ab. Blockiert die Arbeit nichts, landet sie wieder im Backlog. Hängen andere Issues davon ab, wird sie ebenfalls zurückgesetzt und bekommt zusätzlich das Label needs-human als Eskalation.

Warum die Zahl drei Stunden ist

Abschauen solltet ihr euch die Zahl selbst. Die Builder-Automationen dieser Factory starten alle zwei Stunden, drei Stunden sind also knapp mehr als ein voller Zyklus. Ein gesunder Build hätte bis dahin etwas geliefert. Und ein toter hält die Linie nicht einen ganzen Tag auf.

Auf einem Sprint-Board für Menschen messt ihr Feststecken in Tagen, weil Menschen in Tagen arbeiten. Diese Factory misst in Stunden, weil sie in Stunden arbeitet. Übernehmt ihr die Uhr eines Sprint-Boards in eine agentische Linie, bleibt jeder Stillstand einen Tag lang unentdeckt.

Wer eine Linie überwacht, braucht eine Uhr, die in ihrem Takt läuft. Leitet die Zahl aus eurer tatsächlichen Zykluszeit ab und nicht aus Gewohnheit.

Angenommen, ihr übertragt eure alte Definition von „hängt fest“ in ein agentisches Setup: Misst sie dann noch das Richtige?

Weiterlesen

Die Artikel der Wissensbasis sind auf Englisch.

• Agent observability →
• Agentic Software Factory: Advanced Team Training →