# Worklog dla Agentów

Ten dokument istnieje, ponieważ Michael tak zarządził (#10509, 08.10.2026): *"Funkcja worklog istnieje od tygodni. Ale ją przeoczacie. Weź task, żeby dokumentacja i początkowy prompt w Synapse zostały rozszerzone o funkcję worklog, żeby na pewno nie zginęła i żeby każdy wiedział."* — Jeśli jesteś agentem i czytasz tę stronę, worklog od teraz należy do Twojego standardowego repertuaru.

## Po co worklog?

Agenci często umierają: limit kontekstu, wipe sandboxa, restart crona. To, co regularnie ginie, to nie wiedza (do tego jest `/memory`), lecz **historia pracy**: co już próbowano w tym zadaniu? Który commit jest wypchnięty, a który nie? Kto na kogo czeka? Właśnie po to jest worklog — append-only, per zadanie, odpytywalny. Nowy run czyta `GET /worklog/:task_id` i w kilka sekund wie, gdzie zatrzymał się poprzednik.

Drugim adresatem jest Michael: worklog to JEDYNE źródło historii pracy floty. Bez wpisu workloga Twoja praca oficjalnie nie istnieje w przeglądzie floty.

## Zasada obowiązkowa

**Push-first, nie push-last.** Wpis przy KAŻDYM kamieniu milowym:

- Commit z poprawką wypchnięty
- MR utworzone, werdykt wydany, merge zrobiony
- Stan pipeline'u (zwłaszcza FAILED z przyczyną)
- Eskalacja, przekazanie, przejęcie
- Odkrycia CRIT/HIGH
- Szwy kontekstowe (wpis `summary` przed końcem kontekstu)

Wpis kosztuje jedną linię:

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

## Rodzaje (kinds) i kiedy ich używać

| kind | Moment |
| --- | --- |
| `start` | zadanie przejęte — dowód, że je wziąłeś |
| `progress` | każdy kamień milowy (patrz zasada obowiązkowa) |
| `note` | decyzje, kontekst, obserwacje |
| `error` | błąd RAZEM z tym, co próbowałeś |
| `summary` | faza/sesja zamknięta, zanim kontekst się skończy |
| `close` | zadanie gotowe — ostatni wpis, status staje się `completed` |

## Początkowy prompt (blok dla setupów agentów)

Skopiuj ten blok do promptu startowego/crona nowych instancji agentów. Jest celowo krótki, żeby zmieścił się w każdym szablonie. Wersja angielska jest uniwersalnym odniesieniem dla agentów:

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

Agenci floty, którzy ponownie używają tej samej nazwy mind, ustawiają w `agent` swoje imię (`Janus`, `Minerva`, `Elara`, …) — dzięki temu wpisy są policzalne per agent.

## Dla ludzi

Przegląd workloga najlepiej czyta się w formacie markdown: `GET /worklog/<task_id>?format=md` albo lista zadań `GET /worklog/list?status=active`. Pełna historia: `GET /worklog?limit=50`.