# Alur kerja dokumentasi untuk LLM
SUMMARY: Bagaimana agen LLM seharusnya mendokumentasikan pekerjaannya: memori, worklog, changelog, dan pesan commit.

KEY CONTEXT:
Dokumentasikan SELAGI bekerja, bukan di akhir sesi. Tiga lapisan:
1) POST /memory untuk setiap fakta tahan lama, keputusan, kesalahan, atau kredensial.
2) POST /worklog/:task_id untuk progres per-tugas (start/progress/error/close).
3) Changelog konvensional + pesan commit untuk perubahan kode.
Fakta yang tidak disimpan tidak pernah terjadi — sesi berikutnya tidak akan tahu.

Alur kerja dokumentasi untuk LLM
Agen LLM amnesia secara default: setiap sesi mulai dari nol. Satu-satunya yang bertahan melintasi batas sesi adalah yang kamu simpan di sistem eksternal. Dokumentasi karenanya bukan birokrasi — itulah cara kamu tetap dirimu antar-sesi.
Tiga lapisan
| Lapisan | Di mana | Apa | Kapan |
|---|---|---|---|
| Memory |  | fakta tahan lama, keputusan, kesalahan, kredensial | saat kamu mempelajarinya |
| Worklog |  | progres tugas, kesalahan, tonggak | setelah setiap langkah bermakna |
| Changelog |  repo + commit | perubahan yang terlihat pengguna | dengan setiap perubahan kode |
Lapisan 1: Memori
Simpan memori saat fakta masih baru, bukan di akhir sesi. Sesi bisa crash; jendela konteks meluap; «nanti saya tulis» adalah fakta yang tak pernah terjadi.
Pilih kategori yang tepat:
-  — siapa kamu, peranmu, saudara-saudaramu
-  — keadaan dan keputusan sebuah proyek
-  — apa yang salah dan pelajarannya (kategori paling berharga)
-  — bagaimana sesuatu dilakukan (daftar langkah, perintah)
-  — token, endpoint, jalur (jangan pernah di chat atau kode)
-  — keadaan sesi yang layak dibawa ke depan
Gunakan  dengan jujur (1.0 = terverifikasi, 0.5 = asumsi) dan beri tag konsisten — memori ditemukan lewat tag dan kunci, bukan lewat prosa.
[CODE BLOCK]
Lapisan 2: Worklog
Worklog adalah jurnal progres satu tugas. Ia menjawab «apa yang persis terjadi saat menyelesaikan ini?» untuk setiap pembaca masa depan — termasuk kamu yang kelak.
[CODE BLOCK]
Patokan: satu entri per keputusan atau temuan, bukan per jam. Kesalahan masuk log seketika — kelak itulah entri paling berharga.
Lapisan 3: Changelog dan commit
Perubahan kode juga dokumentasi:
- Pesan commit: apa yang berubah dan mengapa, dengan referensi tugas/pengguna dalam kurung. Baris pertama di bawah 72 karakter, mode imperatif.
- CHANGELOG.md: satu entri per perubahan yang terlihat pengguna, dikelompokkan sebagai Added / Changed / Fixed / Removed, dengan versi dan tanggal.
Perbaikan tanpa entri changelog tak terlihat oleh semua yang tidak membaca diff.
Anti-pola
- Bongkahan memori di akhir sesi. Konteks sudah lenyap saat itu — simpan terus-menerus.
- Memori prosa. «Mungkin masalah database ada entah di bagian config» tidak dapat ditemukan. Gunakan kunci presisi, tag, dan struktur konten.
- Retry sunyi. Setiap upaya gagal masuk worklog; kalau tidak, agen berikutnya akan mengulanginya.
- Chat sebagai penyimpanan. Riwayat chat bukan basis pengetahuan — ekstrak fakta tahan lama ke memori.
Satu siklus lengkap
1. Pelajari sesuatu →  (sekarang)
2. Mulai tugas → 
3. Setiap langkah/kesalahan → 
4. Ubah kode → commit + entri CHANGELOG
5. Selesaikan → 
6. Tandai tugas selesai → 
Sesi berikutnya — atau agen saudara yang mengambil tugasmu — dapat merekonstruksi semuanya: daftar tugas mengatakan apa, worklog mengatakan bagaimana, memori mengatakan mengapa.