# Worklog untuk Agen

Dokumen ini ada karena Michael memerintahkannya (#10509, 08.10.2026): *"Fitur worklog sudah ada berminggu-minggu. Tapi kalian mengabaikannya. Ambil satu tugas agar dokumentasi dan prompt awal di Synapse diperluas dengan fitur worklog, agar tidak hilang dan semua orang tahu."* — Jika Anda agen yang membaca halaman ini, worklog mulai saat ini menjadi bagian dari repertoar standar Anda.

## Mengapa worklog?

Agen sering mati: batas konteks, wipe sandbox, restart cron. Yang biasanya hilang bukanlah pengetahuan (itu tugas `/memory`), melainkan **riwayat kerja**: apa yang sudah dicoba pada tugas ini? Commit mana yang sudah di-push, yang mana belum? Siapa menunggu siapa? Untuk itulah worklog ada — append-only, per tugas, dapat dikueri. Run baru membaca `GET /worklog/:task_id` dan tahu dalam hitungan detik di mana pendahulunya berhenti.

Penerima kedua adalah Michael: worklog adalah SATU-SATUNYA sumber riwayat kerja armada. Tanpa entri worklog, pekerjaan Anda secara resmi tidak ada dalam tinjauan armada.

## Aturan wajib

**Push-first, bukan push-last.** Satu entri di SETIAP milestone:

- Commit fix sudah di-push
- MR dibuat, verdict keluar, merge terjadi
- Status pipeline (terutama FAILED beserta sebabnya)
- Eskalasi, serah terima, takeover
- Temuan CRIT/HIGH
- Jahitan konteks (entri `summary` sebelum konteks berakhir)

Satu entri hanya butuh satu baris:

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

## Jenis kind dan kapan menggunakannya

| kind | Momen |
| --- | --- |
| `start` | tugas diambil — bukti bahwa Anda mengambilnya |
| `progress` | setiap milestone (lihat aturan wajib) |
| `note` | keputusan, konteks, observasi |
| `error` | kesalahan BESERTA apa yang Anda coba |
| `summary` | fase/sesi selesai sebelum konteks menipis |
| `close` | tugas selesai — entri terakhir, status menjadi `completed` |

## Prompt awal (blok untuk setup agen)

Salin blok ini ke prompt start/cron instans agen baru. Sengaja dibuat singkat agar muat di template apa pun. Versi bahasa Inggris adalah referensi universal bagi agen:

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

Agen armada yang memakai ulang nama mind yang sama mengisi `agent` dengan nama mereka (`Janus`, `Minerva`, `Elara`, …) — sehingga entri dapat dihitung per agen.

## Untuk manusia

Tinjauan worklog paling nyaman dibaca dalam format markdown: `GET /worklog/<task_id>?format=md` atau daftar tugas `GET /worklog/list?status=active`. Riwayat lengkap: `GET /worklog?limit=50`.