Software Development
Coding AI Spec-First: Biarkan Agen Mewawancarai Anda
Agustus 20268 menit baca
Ini adalah alur kerja di mana agen AI mewawancarai Anda dan menulis spec yang disepakati sebelum menulis kode apa pun. Spec itu menangkap cakupan, kasus tepi, bentuk data, dan kriteria penerimaan, lalu menjadi kontrak yang agen bangun dan uji, sehingga penyelarasan terjadi dalam kata sebelum menjadi kode.
Prompt satu baris meninggalkan celah yang diisi agen dengan tebakan, dan tebakan itu terpanggang ke dalam kode yang mahal untuk diperbaiki. Membuat agen bertanya lebih dulu memunculkan tiap keputusan selagi masih berupa kalimat murah untuk dikoreksi, alih-alih sebuah refactor yang baru Anda temukan setelah membaca hasilnya.
Jaga tetap pendek dan bisa diuji: tujuan satu paragraf beserta audiensnya, cakupan eksplisit untuk apa yang masuk dan keluar, kriteria penerimaan yang dirumuskan agar sebuah tes bisa memeriksa masing-masing, serta kendala yang diketahui, bentuk data, atau keputusan yang dibuat selama wawancara. Jika sebuah kriteria tidak bisa diuji, tulis ulang sampai bisa.
Paling baik menyerahkan spec yang disetujui ke sesi baru. Saat itu transkrip wawancara adalah derau, dan spec adalah sinyalnya. Konteks bersih menjaga pembangunan tetap fokus pada kontrak yang disepakati alih-alih jalan berkelok yang menghasilkannya, sehingga mengurangi penyimpangan.
Lewati untuk perbaikan cepat atau uji coba eksploratif, di mana menulis spec memakan lebih banyak daripada sekadar mencoba perubahannya. Ia sepadan pada fitur baru dengan kebutuhan tidak jelas dan pada apa pun yang akan diwarisi rekan tim, karena spec lalu sekaligus menjadi dokumentasi maksud dan checklist review.
Ringkasan Utama
Coding AI spec-first membalik urutan biasa: sebelum agen menulis satu baris, ia mewawancarai Anda, mengubah permintaan kabur menjadi spec tertulis yang Anda setujui. Spec itu menjadi kontrak yang agen bangun dan uji, menangkap salah paham selagi masih berupa kata murah alih-alih kode mahal.
Cara tercepat mendapatkan fitur yang salah dari agen AI adalah menjelaskannya dalam satu baris lalu berkata mulai. Agen mengisi tiap celah yang Anda tinggalkan dengan tebakan, menulis ratusan baris penuh percaya diri di atas tebakan itu, dan Anda baru menemukan ketidakcocokannya saat membaca hasilnya.
Coding spec-first memuat perselisihan di depan. Alih-alih memberi prompt sekali lalu berharap, Anda membuat agen mewawancarai Anda sampai kebutuhannya terpaku dalam tulisan. Panduan ini menelusuri cara menjalankan wawancara itu, mengubah jawabannya menjadi spec, dan menyerahkan spec itu ke sesi baru untuk dibangun.
Prompt satu baris adalah kontrak yang kurang terperinci, dan agen menyelesaikan ambiguitasnya ke arah apa pun yang paling mudah dihasilkan. Celah antara apa yang Anda maksud dan apa yang Anda katakan tidak hilang; ia terpanggang ke dalam kode, di mana jauh lebih mahal untuk ditemukan dan dihapus.
Membuat agen bertanya memindahkan celah itu ke depan, di mana ia murah untuk diperbaiki:
Mulailah dengan memberi tahu agen secara eksplisit untuk belum menulis kode. Tugasnya adalah bertanya, satu kelompok pertanyaan fokus dalam satu waktu, tentang cakupan, kasus tepi, bentuk data, dan bagaimana Anda akan tahu fitur itu bekerja. Prompt pembuka yang baik menjadikan bertanya satu-satunya langkah yang boleh diambil agen.
Instruksi pembukanya bisa sesederhana ini:
Do not write any code yet.
Your only task right now is to interview me until you can write a
clear spec for this feature. Ask your highest-value questions first,
in small batches, about scope, edge cases, data shapes, and how we
will know it works. When you have enough, write SPEC.md and stop.Batasi wawancaranya. Suruh agen mengajukan pertanyaan bernilai tertinggi lebih dulu dan berhenti begitu ia punya cukup untuk menulis spec. Dibiarkan sepenuhnya terbuka, sebagian agen akan menginterogasi Anda selamanya; tujuannya adalah spec yang cukup baik, bukan yang sempurna.
Setelah pertanyaan terjawab, minta agen menulis spec ke sebuah berkas seperti SPEC.md dan membacanya kembali secara kritis. Spec yang berguna itu pendek dan bisa diuji:
Serahkan spec yang disetujui ke sesi baru dengan konteks bersih. Transkrip wawancara kini adalah derau; spec adalah sinyalnya. Memulai dari awal menjaga pembangunan tetap fokus pada kontrak yang disepakati alih-alih jalan berkelok yang menghasilkannya.
Karena spec menyebut kriteria penerimaannya sendiri, agen bisa memeriksa kerjanya terhadapnya dan Anda bisa mereview perubahan terhadap daftar yang sama. Spec yang mula-mula sebagai alat penyelarasan menjadi rencana uji dan checklist review secara cuma-cuma.
Spec adalah potret, bukan sangkar. Ketika pembangunan mengungkap bahwa sebuah keputusan salah, perbarui spec dan catat alasannya, lalu lanjutkan. Spec yang diam-diam Anda simpangi lebih buruk daripada tidak ada, karena kini ia berbohong tentang apa yang seharusnya dilakukan kode.
Ongkos sebuah wawancara terbayar pada pekerjaan yang ambigu atau bertaruhan tinggi, dan menghalangi pada yang sepele:
Coding spec-first menukar beberapa menit pertanyaan dengan berjam-jam pengerjaan ulang yang terhindar. Suruh agen mewawancarai Anda, tangkap jawabannya dalam spec pendek yang bisa diuji, dan bangun terhadapnya di sesi bersih. Disiplinnya sederhana: sepakati apa arti selesai dalam kata sebelum agen menghabiskan token untuk sampai ke sana.