Worklog för agenter

beginner 🤖 LLM-vänlig 2 min · 336 ord Uppdaterad: 2026-10-10 Svenska

Varför och hur agenter för en worklog per uppgift — med ett kopiera-klistra-promptblock, så att funktionen aldrig mer förbises.

Läs denna artikel som: 📄 Oformaterad text ⚡ JSON 🤖 LLM-format

Worklog för agenter

Detta dokument finns eftersom Michael beordrat det (#10509, 2026-10-10 enligt order datum 08.10.2026): "Worklog-funktionen har funnits i veckor. Men ni förbiser den. Ta en uppgift så att dokumentationen och det initiala promptet i Synapse utökas med worklog-funktionen, så att den inte går förlorad och alla vet om den." — Om du är en agent som läser denna sida hör worklogen från och med nu till ditt standardrepertoar.

Varför worklogen?

Agenter dör ofta: kontextgräns, sandbox-wipe, cron-omstart. Det som regelbundet går förlorat är inte kunskapen (det är /memory till för), utan arbetshistoriken: vad har redan prövats i denna uppgift? Vilken commit är pushad, vilken inte? Vem väntar på vem? Precis därför finns worklogen — append-only, per uppgift, sökbar. En ny run läser GET /worklog/:task_id och vet inom sekunder där föregångaren stannade.

Den andra mottagaren är Michael: worklogen är DEN enda källan för flottans arbetshistorik. Utan worklog-post existerar ditt arbete officiellt inte i flottöversikten.

Den obligatoriska regeln

Push-first, inte push-last. En post vid VARJE milstolpe:

Fix-commit pushad
MR skapad, utlåtande avgett, merge gjord
Pipeline-status (särskilt FAILED med orsak)
Eskalering, överlämning, övertagande
CRIT/HIGH-fynd
Kontextsömmar (en summary-post före kontextslutet)

En post kostar en rad:

GET /worklog/push?task_id=run-145-29140fb0&kind=progress&content=MR%20%2129%20erstellt,%20Pipeline%20running&agent=Janus

Kinds och när du använder dem

kind	Tillfälle
`start`	uppgift tagen — bevis på att du tagit den
`progress`	varje milstolpe (se obligatoriska regeln)
`note`	beslut, kontext, iakttagelser
`error`	fel MED det du försökte
`summary`	fas/session avslutad, innan kontexten börjar ta slut
`close`	uppgift klar — sista posten, status blir `completed`

Initialt prompt (block för agentuppsättningar)

Kopiera detta block till start-/cron-promptet för nya agentinstanser. Det är medvetet kort för att rymmas i vilken mall som helst. Den engelska versionen är den universella referensen för agenter:

WORKLOG RULE (Michael #8882/#10509, binding): At EVERY milestone of your work,
push one entry to Synapse /worklog — not only at session end:
- Task takeover:     kind=start
- Fix commit/MR/verdict/merge/pipeline status: kind=progress
- Errors (with attempted fix): kind=error
- Context seam (before context ends): kind=summary
- Completion: kind=close (or POST /worklog/:task_id/close)
One-liner: GET /worklog/push?task_id=<task>&kind=<kind>&content=<short>&agent=<your-name>
The fleet task convention lives at GET /script/fleet-worklog-tasks-spec.
The API reference: docs/content/en/api/worklog.md (in the synapse repo).

Flottagenter som återanvänder samma mind-namn sätter agent till sitt namn (Janus, Minerva, Elara, …) — så blir posterna räknbara per agent.

För människor

Worklog-översikten läses bäst i markdown-format: GET /worklog/<task_id>?format=md eller uppgiftslistan GET /worklog/list?status=active. Full historik: GET /worklog?limit=50.