Cara Menulis Brief untuk Agent AI yang Bisa Diperiksa

Pekerjaan seperti “rapikan website” terdengar jelas bagi pemilik bisnis, tetapi menyimpan banyak keputusan. Apakah yang dimaksud memperbaiki tampilan ponsel, mengganti isi, atau mempercepat halaman? Agent AI membutuhkan brief yang menghubungkan masalah dengan hasil yang dapat diperiksa. Brief yang baik juga membantu manusia menilai apakah perubahan benar-benar menyelesaikan kebutuhan.

Mulai dari kondisi dan tujuan

Tuliskan kondisi sekarang dengan contoh nyata. Misalnya, pada ponsel tombol konsultasi menutup judul layanan. Tujuannya adalah membuat judul terbaca dan tombol mudah disentuh. Sertakan halaman yang terdampak, ukuran layar yang menunjukkan masalah, serta tangkapan layar bila tersedia. Hindari mencampurkan beberapa permintaan yang tidak saling bergantung dalam satu instruksi panjang.

Pisahkan fakta dari dugaan. “Tombol tidak merespons setelah dibuka dua kali” adalah laporan yang bisa direproduksi. “Framework pasti rusak” merupakan hipotesis. Pembedaan ini mencegah agent langsung mengganti bagian besar proyek sebelum mengetahui sumber masalah.

Tentukan hasil dan batas perubahan

Contoh brief untuk tim kecil: perbaiki tombol konsultasi pada halaman layanan, pertahankan logo dan warna merek, gunakan komponen yang sudah ada, lalu periksa buka-tutup popup dengan mouse serta keyboard. Hasilnya berupa perubahan kode dan ringkasan bukti pemeriksaan. Kriteria penerimaan perlu menyebut perilaku, bukan hanya tampilan “lebih modern”.

• Cantumkan file atau direktori yang diketahui relevan.
• Nyatakan konten dan alur bisnis yang harus dipertahankan.
• Jelaskan tindakan yang membutuhkan persetujuan pemilik.
• Tentukan keluaran, seperti draf, laporan, atau perubahan kode.
• Sebutkan cara memeriksa sukses dan kegagalan.

Jangan menempelkan kata sandi atau token ke brief. Informasi akses sebaiknya diberikan melalui mekanisme yang memang disiapkan untuk pekerjaan tersebut, dengan hak sesuai kebutuhan.

Tutup dengan pertanyaan yang terarah

Jika informasi belum lengkap, minta agent menyebut bagian yang bisa dikerjakan dan keputusan yang masih dibutuhkan. Misalnya, ukuran tombol dapat diperbaiki sekarang, sementara alamat Telegram menunggu pemilik. Dengan begitu, ketidakjelasan satu detail tidak menghentikan seluruh pekerjaan.

Untuk proyek berulang, simpan contoh brief yang berhasil beserta alasan keberhasilannya. Periksa kembali setelah kebutuhan bisnis berubah. Brief bukan jaminan bahwa keluaran AI akurat; review tetap diperlukan, terutama ketika pekerjaan menyentuh data pelanggan atau sistem produksi. Arah CTRL PANEL sebagai terminal AI menempatkan instruksi, proses agent, dan peninjauan hasil dalam satu alur kerja.

Sumber dan bacaan

• Panduan GitHub menyusun tugas untuk coding agent.