Bouw een eerlijke tijdsindicatie voor je codingagent

Het eerste artikel beschreef het planningsprobleem: moet ik wachten, een kleine taak doen of aan een ander onderwerp beginnen terwijl mijn agent werkt? Deze handleiding bouwt een klein lokaal bestand met het volgende verwachte moment waarop aandacht nodig is.

Het voorbeeld voorspelt de taakduur niet automatisch. Jij of je agent rapporteert expliciet een status en, wanneer dat te onderbouwen is, een ruwe bandbreedte. Het doel is die informatie leesbaar te maken en te voorkomen dat verouderde prognoses betrouwbaar lijken.

1. Voer een losstaand voorbeeld uit

Je hebt Python 3 nodig in een macOS- of Linux-terminal. Controleer dit met python3 --version. Download en inspecteer agent-eta.py, en sla het daarna op in een tijdelijke werkmap. Voer onderstaande opdrachten vanuit die map uit. Pakketten installeren of Claude Code-instellingen wijzigen is niet nodig.

Elke taak heeft een eigen lokaal JSON-bestand nodig. Deel niet één bestand tussen meerdere agents. De bovenliggende map moet al bestaan.

python3 agent-eta.py --file ./eta-demo.json write --state working --phase verification --min 5 --max 12
python3 agent-eta.py --file ./eta-demo.json show

Aanvankelijk ziet de uitvoer er ongeveer zo uit:

verification | WORKING | rough next-attention window 5-12m | declared, not calibrated

Vijf tot twaalf minuten is verzonnen demonstratie-invoer. Het is geen benchmark, garantie of bewijs over je werkelijke taak. Het tijdvenster beschrijft wanneer je aandacht mogelijk weer nodig is, niet wanneer een afgeronde oplossing gegarandeerd is.

2. Laat onbekende tijd onbekend

Als er geen bruikbare basis voor een tijdsbereik is, vermeld dan alleen de status:

python3 agent-eta.py --file ./eta-demo.json write --state working --phase research

De weergave meldt next attention window unknown. Een ontbrekende schatting wordt niet omgezet in nul. Zolang een opgegeven tijdvenster geldig blijft, trekt de weergave de verstreken tijd ervan af. Zodra de bovengrens is verstreken, meldt die declared window expired; refresh needed in plaats van een misleidende afteller op nul te laten staan.

3. Meld wanneer iemand nodig is

python3 agent-eta.py --file ./eta-demo.json write --state needs-input --phase implementation
python3 agent-eta.py --file ./eta-demo.json write --state waiting --phase external
python3 agent-eta.py --file ./eta-demo.json write --state ready --phase review

Voer deze afzonderlijk uit om echte overgangen weer te geven; dit is geen reeks die je blind moet uitvoeren. INPUT NEEDED heeft voorrang op elk tijdvenster. READY FOR REVIEW beweert niet dat tests geslaagd zijn. Een externe wachttijd zonder opgegeven bandbreedte blijft onbekend.

Het script kan geen daadwerkelijk toestemmingsvenster of testresultaat waarnemen. Het bestand is slechts zo actueel en betrouwbaar als degene die het bijwerkt.

4. Voeg expliciete updates toe aan de workflow

Werk bij een eerste proef de registratie zelf bij wanneer een fase verandert. Als je later een codingagent vraagt dat te doen, geef die dan het goedgekeurde script en een apart bestand. Vereis updates voordat om invoer wordt gevraagd en nadat het werk stopt, en laat bandbreedtes weg die de agent niet kan onderbouwen.

Dat is een workflowinstructie, geen geverifieerde automatische Claude Code-integratie. Een eigen statusregel of adapter voor lifecyclehooks is apart werk. Een show aanroep toont één momentopname; die maakt geen live dashboard en controleert niets op de achtergrond. Je kunt deze aanroepen wanneer je de taak bekijkt.

Bekijk of het je helpt een passende bezigheid voor de tussentijd te kiezen. Leid uit het getal alleen niet af dat je gerust weg kunt: er kan eerder dan verwacht een vraag komen.

5. Test de grenzen en verwijder het bestand

De bijbehorende implementatie is gecontroleerd met synthetische klokken en invoer: ontbrekende of ongeldige bestanden, onbekende tijdvensters, verlopen vensters, aandachtsstatussen, ongeldige bereiken en klokwijzigingen. Een bestand ouder dan 24 uur wordt als verouderd gemarkeerd. De nauwkeurigheid van echte taakvoorspellingen is niet vastgesteld.

Alleen vaste status- en fasenamen, een bijwerktijdstip en de opgegeven bandbreedte worden opgeslagen. Er zijn geen netwerkoproepen, opgeslagen prompts of historisch archief. Hetzelfde bestand wordt bij een update overschreven en niet automatisch verwijderd. Verwijder eta-demo.json na de proef met je bestandsbeheerder. Door het script en dat bestand te verwijderen maak je dit voorbeeld ongedaan; er zijn geen agentinstellingen om terug te zetten.

Kalibratie op basis van eerdere taken komt later, zodra vergelijkbare afgeronde taken beschikbaar zijn. Tot die tijd is een expliciet bereik met een zichtbare geldigheidsduur nuttiger dan een exact ogende voorspelling zonder onderbouwing.