Lompat ke konten
Rahman FakhruDiskusi proyek

Pelajaran 04 / 14

Menulis Dokumen Kontrak Ala AGENTS.md

Satu file, banyak agent yang paham aturan yang sama Cara paling praktis mengoordinasikan banyak agent atau banyak SESI agent yang sama di waktu berbeda adalah menulis SATU dokumen kontrak yang dibaca lebih dulu sebelum k

#Satu file, banyak agent yang paham aturan yang sama

Cara paling praktis mengoordinasikan banyak agent (atau banyak SESI agent yang sama di waktu berbeda) adalah menulis SATU dokumen kontrak yang dibaca lebih dulu sebelum kerja dimulai. Formatnya sudah mengarah jadi standar terbuka bernama AGENTS.md — semacam README, tapi ditujukan untuk agent, bukan manusia.

#Isi minimal dokumen kontrak yang baik

  1. Apa proyek ini — dalam 2-3 kalimat, tanpa jargon.
  2. Aturan keras (P0) — hal yang TIDAK BOLEH dilanggar apa pun alasannya (mis. jangan sentuh rahasia, jangan hapus data user).
  3. Konvensi kerja — gaya kode, penamaan file, cara commit.
  4. Wilayah kerja — siapa boleh menulis di mana.
  5. Definisi selesai — kapan sebuah tugas dianggap benar-benar beres.
  6. Prosedur ketika buntu — apa yang dilakukan agent kalau menemui keputusan yang tidak bisa diambil sendiri.

Tulis kontrak SEBELUM merekrut worker pertama, bukan setelah ada masalah. Kontrak yang ditulis reaktif (setelah insiden) cenderung jadi tumpukan aturan tambal sulam.

Latihan gratis: buat satu file instruksi di proyekmu sendiri, isi enam poin di atas — walau proyeknya masih dikerjakan sendirian. Kamu akan berterima kasih begitu proyek membesar.

#Referensi