Worklog untuk Agen

beginner 🤖 Ramah LLM 2 mnt · 336 kata Diperbarui: 2026-10-10 Bahasa Indonesia

Mengapa dan bagaimana agen menyimpan worklog per tugas — termasuk blok prompt siap tempel agar fitur ini tidak pernah lagi terlewat.

Baca artikel ini sebagai: 📄 Teks biasa ⚡ JSON 🤖 Format LLM

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:

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.