# Worklog voor Agenten
SUMMARY: Waarom en hoe agenten per taak een worklog bijhouden — met een kant-en-klaar promptblok, zodat de functie nooit meer over het hoofd wordt gezien.

KEY CONTEXT:
Mandatory (Michael #8882/#10509): POST /worklog at EVERY milestone (fix commit, verdict, escalation, handover, takeover, CRITICAL), not only at session end.
One-liner: GET /worklog/push?task_id=<id>&kind=progress&content=<text>&agent=<name>
Details: API reference docs/content/en/api/worklog.md; fleet convention: GET /script/fleet-worklog-tasks-spec.
Prompt block for new agent instances: see section "Initial prompt" on this page.

Worklog voor Agenten
Dit document bestaat omdat Michael het beval (#10509, 08.10.2026): "De worklog-functie bestaat al weken. Maar jullie zien haar over het hoofd. Pak een taak op zodat de documentatie en de initiële prompt in Synapse met de worklog-functie worden uitgebreid, dat het niet verloren gaat en iedereen het weet." — Als je als agent deze pagina leest, hoort de worklog vanaf nu bij je standaardrepertoire.
Waarom de worklog?
Agenten sterven vaak: contextlimiet, sandbox-wipe, cron-herstart. Wat regelmatig verloren gaat is niet de kennis (daar is  voor), maar de werkgeschiedenis: wat is er al geprobeerd bij deze taak? Welke commit is gepusht, welke niet? Wie wacht op wie? Precies daarvoor bestaat de worklog — append-only, per taak, doorzoekbaar. Een nieuwe run leest  en weet binnen enkele seconden waar zijn voorganger stopte.
De tweede doelgroep is Michael: de worklog is DE enige bron voor de werkgeschiedenis van de vloot. Zonder worklog-entry bestaat jouw werk officieel niet in het vlootoverzicht.
De verplichte regel
Push-first, niet push-last. Eén entry bij ELKE mijlpaal:
- Fix-commit gepusht
- MR aangemaakt, verdict geveld, merge gedaan
- Pipeline-status (zeker FAILED met oorzaak)
- Escalatie, overdracht, takeover
- CRIT/HIGH-vondsten
- Contextnaden (een -entry vóór het einde van de context)
Een entry kost één regel:
[CODE BLOCK]
De kinds en wanneer je ze gebruikt
| kind | Moment |
| --- | --- |
|  | taak geclaimd — bewijs dat je hem hebt overgenomen |
|  | elke mijlpaal (zie verplichte regel) |
|  | beslissingen, context, observaties |
|  | fout MET wat je probeerde |
|  | fase/sessie afgerond, voordat de context opraakt |
|  | taak klaar — laatste entry, status wordt  |
Initiële prompt (blok voor agent-setups)
Kopieer dit blok in de start-/cron-prompt van nieuwe agent-instanties. Hij is bewust kort gehouden zodat hij in elk template past. De Engelse versie is de universele referentie voor agenten:
[CODE BLOCK]
Vlootagenten die dezelfde mind-naam hergebruiken zetten bij  hun naam (, , , …) — zo zijn de entries per agent telbaar.
Voor mensen
Het worklog-overzicht leest het best in markdown-formaat:  of de takenlijst . Volledige geschiedenis: .