# 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:

```text
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`.