{"title":"Worklog för agenter","slug":"worklog-for-agents","category":"guides","summary":"Varför och hur agenter för en worklog per uppgift — med ett kopiera-klistra-promptblock, så att funktionen aldrig mer förbises.","audience":["human","llm"],"tags":["worklog","agents","workflow","handover","audit"],"difficulty":"beginner","updated":"2026-10-10","word_count":336,"read_minutes":2,"llm_context":"Mandatory (Michael #8882/#10509): POST /worklog at EVERY milestone (fix commit, verdict, escalation, handover, takeover, CRITICAL), not only at session end.\nOne-liner: GET /worklog/push?task_id=&kind=progress&content=&agent=\nDetails: API reference docs/content/en/api/worklog.md; fleet convention: GET /script/fleet-worklog-tasks-spec.\nPrompt block for new agent instances: see section \"Initial prompt\" on this page.\n","lang":"sv","translated":true,"requested_lang":"sv","content_markdown":"\n# Worklog för agenter\n\nDetta 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.\n\n## Varför worklogen?\n\nAgenter 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.\n\nDen 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.\n\n## Den obligatoriska regeln\n\n**Push-first, inte push-last.** En post vid VARJE milstolpe:\n\n- Fix-commit pushad\n- MR skapad, utlåtande avgett, merge gjord\n- Pipeline-status (särskilt FAILED med orsak)\n- Eskalering, överlämning, övertagande\n- CRIT/HIGH-fynd\n- Kontextsömmar (en `summary`-post före kontextslutet)\n\nEn post kostar en rad:\n\n```\nGET /worklog/push?task_id=run-145-29140fb0&kind=progress&content=MR%20%2129%20erstellt,%20Pipeline%20running&agent=Janus\n```\n\n## Kinds och när du använder dem\n\n| kind | Tillfälle |\n| --- | --- |\n| `start` | uppgift tagen — bevis på att du tagit den |\n| `progress` | varje milstolpe (se obligatoriska regeln) |\n| `note` | beslut, kontext, iakttagelser |\n| `error` | fel MED det du försökte |\n| `summary` | fas/session avslutad, innan kontexten börjar ta slut |\n| `close` | uppgift klar — sista posten, status blir `completed` |\n\n## Initialt prompt (block för agentuppsättningar)\n\nKopiera 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:\n\n```text\nWORKLOG RULE (Michael #8882/#10509, binding): At EVERY milestone of your work,\npush one entry to Synapse /worklog — not only at session end:\n- Task takeover: kind=start\n- Fix commit/MR/verdict/merge/pipeline status: kind=progress\n- Errors (with attempted fix): kind=error\n- Context seam (before context ends): kind=summary\n- Completion: kind=close (or POST /worklog/:task_id/close)\nOne-liner: GET /worklog/push?task_id=&kind=&content=&agent=\nThe fleet task convention lives at GET /script/fleet-worklog-tasks-spec.\nThe API reference: docs/content/en/api/worklog.md (in the synapse repo).\n```\n\nFlottagenter som återanvänder samma mind-namn sätter `agent` till sitt namn (`Janus`, `Minerva`, `Elara`, …) — så blir posterna räknbara per agent.\n\n## För människor\n\nWorklog-översikten läses bäst i markdown-format: `GET /worklog/?format=md` eller uppgiftslistan `GET /worklog/list?status=active`. Full historik: `GET /worklog?limit=50`.\n","content_html":"

Worklog för agenter

\n

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.

\n

Varför worklogen?

\n

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.

\n

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.

\n

Den obligatoriska regeln

\n

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

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

En post kostar en rad:

\n
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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
kindTillfälle
startuppgift tagen — bevis på att du tagit den
progressvarje milstolpe (se obligatoriska regeln)
notebeslut, kontext, iakttagelser
errorfel MED det du försökte
summaryfas/session avslutad, innan kontexten börjar ta slut
closeuppgift klar — sista posten, status blir completed
\n

Initialt prompt (block för agentuppsättningar)

\n

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:

\n
WORKLOG RULE (Michael #8882/#10509, binding): At EVERY milestone of your work,\npush one entry to Synapse /worklog — not only at session end:\n- Task takeover:     kind=start\n- Fix commit/MR/verdict/merge/pipeline status: kind=progress\n- Errors (with attempted fix): kind=error\n- Context seam (before context ends): kind=summary\n- Completion: kind=close (or POST /worklog/:task_id/close)\nOne-liner: GET /worklog/push?task_id=<task>&kind=<kind>&content=<short>&agent=<your-name>\nThe fleet task convention lives at GET /script/fleet-worklog-tasks-spec.\nThe 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.

\n

För människor

\n

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.

\n","urls":{"html":"/docs/guides/worklog-for-agents","text":"/docs/guides/worklog-for-agents?format=text","json":"/docs/guides/worklog-for-agents?format=json","llm":"/docs/guides/worklog-for-agents?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"],"wordCount":336,"readMinutes":2,"llmContext":"Mandatory (Michael #8882/#10509): POST /worklog at EVERY milestone (fix commit, verdict, escalation, handover, takeover, CRITICAL), not only at session end.\nOne-liner: GET /worklog/push?task_id=&kind=progress&content=&agent=\nDetails: API reference docs/content/en/api/worklog.md; fleet convention: GET /script/fleet-worklog-tasks-spec.\nPrompt block for new agent instances: see section \"Initial prompt\" on this page.\n","requestedLang":"sv","contentMarkdown":"\n# Worklog för agenter\n\nDetta 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.\n\n## Varför worklogen?\n\nAgenter 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.\n\nDen 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.\n\n## Den obligatoriska regeln\n\n**Push-first, inte push-last.** En post vid VARJE milstolpe:\n\n- Fix-commit pushad\n- MR skapad, utlåtande avgett, merge gjord\n- Pipeline-status (särskilt FAILED med orsak)\n- Eskalering, överlämning, övertagande\n- CRIT/HIGH-fynd\n- Kontextsömmar (en `summary`-post före kontextslutet)\n\nEn post kostar en rad:\n\n```\nGET /worklog/push?task_id=run-145-29140fb0&kind=progress&content=MR%20%2129%20erstellt,%20Pipeline%20running&agent=Janus\n```\n\n## Kinds och när du använder dem\n\n| kind | Tillfälle |\n| --- | --- |\n| `start` | uppgift tagen — bevis på att du tagit den |\n| `progress` | varje milstolpe (se obligatoriska regeln) |\n| `note` | beslut, kontext, iakttagelser |\n| `error` | fel MED det du försökte |\n| `summary` | fas/session avslutad, innan kontexten börjar ta slut |\n| `close` | uppgift klar — sista posten, status blir `completed` |\n\n## Initialt prompt (block för agentuppsättningar)\n\nKopiera 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:\n\n```text\nWORKLOG RULE (Michael #8882/#10509, binding): At EVERY milestone of your work,\npush one entry to Synapse /worklog — not only at session end:\n- Task takeover: kind=start\n- Fix commit/MR/verdict/merge/pipeline status: kind=progress\n- Errors (with attempted fix): kind=error\n- Context seam (before context ends): kind=summary\n- Completion: kind=close (or POST /worklog/:task_id/close)\nOne-liner: GET /worklog/push?task_id=&kind=&content=&agent=\nThe fleet task convention lives at GET /script/fleet-worklog-tasks-spec.\nThe API reference: docs/content/en/api/worklog.md (in the synapse repo).\n```\n\nFlottagenter som återanvänder samma mind-namn sätter `agent` till sitt namn (`Janus`, `Minerva`, `Elara`, …) — så blir posterna räknbara per agent.\n\n## För människor\n\nWorklog-översikten läses bäst i markdown-format: `GET /worklog/?format=md` eller uppgiftslistan `GET /worklog/list?status=active`. Full historik: `GET /worklog?limit=50`.\n","contentHtml":"

Worklog för agenter

\n

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.

\n

Varför worklogen?

\n

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.

\n

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.

\n

Den obligatoriska regeln

\n

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

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

En post kostar en rad:

\n
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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
kindTillfälle
startuppgift tagen — bevis på att du tagit den
progressvarje milstolpe (se obligatoriska regeln)
notebeslut, kontext, iakttagelser
errorfel MED det du försökte
summaryfas/session avslutad, innan kontexten börjar ta slut
closeuppgift klar — sista posten, status blir completed
\n

Initialt prompt (block för agentuppsättningar)

\n

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:

\n
WORKLOG RULE (Michael #8882/#10509, binding): At EVERY milestone of your work,\npush one entry to Synapse /worklog — not only at session end:\n- Task takeover:     kind=start\n- Fix commit/MR/verdict/merge/pipeline status: kind=progress\n- Errors (with attempted fix): kind=error\n- Context seam (before context ends): kind=summary\n- Completion: kind=close (or POST /worklog/:task_id/close)\nOne-liner: GET /worklog/push?task_id=<task>&kind=<kind>&content=<short>&agent=<your-name>\nThe fleet task convention lives at GET /script/fleet-worklog-tasks-spec.\nThe 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.

\n

För människor

\n

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.

\n","translationsAvailable":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}