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.
Mengapa wawancara datang lebih dulu
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:
- Tiap pertanyaan klarifikasi adalah keputusan yang dimunculkan sebelum menjadi baris kode.
- Anda mengoreksi salah paham dalam satu kalimat alih-alih dalam sebuah refactor.
- Jawaban tertulis menjadi rujukan bersama yang bisa dituju kembali oleh Anda dan agen.
Jalankan wawancaranya
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.
Ubah jawaban menjadi spec
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:
- Pernyataan satu paragraf tentang tujuan dan untuk siapa itu.
- Cakupan eksplisit: apa yang masuk, dan yang sama pentingnya, apa yang keluar.
- Kriteria penerimaan yang dirumuskan agar sebuah tes bisa memeriksa masing-masing.
- Kendala yang diketahui, bentuk data, dan keputusan apa pun yang dibuat selama wawancara.
Bangun terhadap spec di sesi baru
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.
Kapan spec-first sepadan
Ongkos sebuah wawancara terbayar pada pekerjaan yang ambigu atau bertaruhan tinggi, dan menghalangi pada yang sepele:
- Sepadan untuk fitur baru dengan kebutuhan tidak jelas, di mana tebakan salah memakan sehari pengerjaan ulang.
- Sepadan untuk apa pun yang akan diwarisi rekan tim, karena spec sekaligus menjadi dokumentasi maksud.
- Lewati untuk perbaikan cepat atau uji coba eksploratif, di mana menulis spec memakan lebih banyak daripada sekadar mencoba perubahannya.
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.