01 · Masalahnya
Hal yang saya pelajari tersebar di banyak tempat, dan semuanya cepat basi.
Ada di repo, memori agent, rencana yang tersimpan, dan catatan setengah jadi. Menuliskannya setelah tugas selesai adalah langkah yang paling sering saya lewati saat capek. Padahal, justru saat itulah detailnya paling segar.
02 · Tiga pemicu
Pencatatan berjalan di tiga titik.
Urutannya:
- saat sesi berjalan: di akhir tugas yang layak dicatat, agent memanggil juru tulis. Contohnya proyek baru, perubahan stack atau deploy, fitur yang rilis, dan perubahan design token. Perbaikan rutin tidak dihitung
- saat sesi selesai: sebuah hook tanpa model membandingkan repo dengan kondisinya di awal sesi, lalu menulis sinyal ke inbox
- saat sesi dimulai: kalau inbox tidak kosong, agent mendapat pengingat, dan sinkronisasi berjalan di belakang layar
03 · Hook tanpa model
Hook-nya hanya skrip shell, jadi murah dan hasilnya selalu sama.
Ia mencari commit feat: baru, manifest dan config deploy yang berubah, file style, instruksi agent, migrasi schema, remote yang berubah, atau proyek baru. Kalau juru tulis sudah mencatat sesuatu di sesi itu, hook-nya berhenti. Model baru dipanggil kalau memang ada yang layak ditulis.
04 · Sinkronisasi yang tetap jalan saat offline
Vault-nya repo git, dan harus tetap bisa dipakai di pesawat.
Setiap perubahan di-commit di laptop lebih dulu. Lalu skrip sinkronisasi mengecek koneksi dengan batas waktu singkat. Kalau online, ia menarik perubahan terbaru lalu push. Kalau offline, ia langsung berhenti. Kalau ada konflik, ia membatalkan sinkronisasi dan mencatatnya supaya saya perbaiki sendiri. Inbox-nya dibuat per mesin dan tidak masuk git.
git commit -m "docs: update project note"
if curl -sI --max-time 4 https://github.com >/dev/null; then
git pull --rebase --autostash && git push
fi05 · Indeks yang menyusun dirinya sendiri
Tidak ada yang mengurus halaman ringkasan secara manual.
Sebuah skrip membaca frontmatter setiap catatan, lalu menyusun ulang indeks proyek, referensi style, dan peta stack. Dengan begitu, ringkasannya selalu sama dengan isi catatannya.
06 · Status sebenarnya
Sistem ini masih baru.
Commit pertama vault dan alur pencatatan ini sama-sama dibuat bulan ini. Terlalu dini untuk mengklaim waktu yang dihemat. Berikutnya, saya perlu mengukur seberapa sering sebuah sinyal benar-benar menjadi catatan yang berguna. Artikel ini sendiri disusun dari catatan di vault itu.