Nulis PRD: Spesifikasi yang Bikin AI Ngerti Maumu

Di episode 2, "Kapan Pakai Tool yang Mana: Panduan Memilih", kita sudah menentukan senjata. Sekarang masalah berikutnya muncul. Tools secanggih apa pun tidak ada gunanya kalau perintahmu samar. Kamu pasti pernah mengalami ini. Kamu mengetik "buatkan aplikasi kasir", AI menghasilkan sesuatu, dan hasilnya jauh dari yang kamu bayangkan. Bukan AI-nya yang bodoh. Ia hanya menebak, karena kamu tidak memberinya cukup bahan untuk tidak menebak.

Di dunia profesional, masalah ini diselesaikan dengan sebuah dokumen bernama PRD, singkatan dari Product Requirements Document. Episode 3 ini akan mengajarkanmu menulis PRD versi mini yang cukup untuk membuat AI coding paham maumu. Tenang, ini bukan dokumen 50 halaman ala korporat. Versi kita cukup satu halaman, tapi satu halaman yang tajam.

Apa Itu PRD dan Kenapa AI Butuh Itu

PRD adalah dokumen yang menjelaskan apa yang harus dibangun, kenapa dibangun, dan kapan dianggap selesai. Perhatikan, PRD tidak menjelaskan bagaimana cara membangunnya. Itu wilayah AI dan kamu sebagai programmer. PRD adalah kontrak antara ide di kepalamu dan hasil di layar.

Kenapa AI butuh ini? Karena AI coding pada dasarnya adalah mesin penebak yang sangat pintar. Setiap detail yang tidak kamu tulis akan ia isi dengan tebakannya sendiri. Tebakan untuk warna tombol mungkin tidak masalah. Tapi tebakan untuk alur pembayaran bisa berakibat fatal. PRD memindahkan keputusan penting dari tebakan AI ke tanganmu, sebelum satu baris kode pun ditulis. Semakin sedikit yang harus ditebak AI, semakin dekat hasilnya dengan maumu.

Struktur PRD yang Ramah AI

PRD profesional punya banyak bagian, tapi untuk dipakai bersama AI coding, lima bagian ini sudah cukup. Pertama, latar belakang. Satu atau dua kalimat tentang masalah yang ingin diselesaikan. Ini memberi AI konteks kenapa fitur ini ada. Kedua, tujuan. Apa yang ingin dicapai, ditulis dengan konkret. Bukan "memudahkan pengguna", tapi "kasir bisa menyelesaikan satu transaksi dalam waktu kurang dari 30 detik". Ketiga, daftar fitur. Poin-poin kemampuan yang harus ada, ditulis sebagai daftar bernomor. Keempat, batasan. Apa yang TIDAK boleh dilakukan atau dipakai. Bagian ini sering dilupakan padahal paling powerful. Kelima, kriteria sukses. Bagaimana kamu tahu PRD ini sudah terpenuhi? Tulis sebagai checklist yang bisa dicek satu per satu.

Urutannya penting. Latar belakang dan tujuan menjawab "kenapa", daftar fitur menjawab "apa", batasan menjawab "jangan", dan kriteria sukses menjawab "kapan selesai". AI yang membaca struktur ini tidak perlu menebak arah.

Contoh PRD Mini: Aplikasi Kasir Sederhana

Teori tanpa contoh itu hambar. Berikut PRD mini untuk aplikasi kasir warung kopi, lengkap dan siap kamu copy lalu modifikasi. Perhatikan betapa konkretnya setiap poin.

PRD MINI: APLIKASI KASIR WARUNG KOPI

1. LATAR BELAKANG
Warung kopi "Kopi Pagi" masih mencatat transaksi di buku tulis.
Hitung kembalian sering salah saat jam ramai.

2. TUJUAN
Kasir bisa menyelesaikan satu transaksi (pilih menu, hitung total,
hitung kembalian) dalam waktu kurang dari 30 detik.

3. DAFTAR FITUR
1. Daftar menu (nama, harga) yang bisa ditambah dan dihapus
2. Keranjang: tambah menu, ubah jumlah, hapus item
3. Hitung total otomatis dan kembalian dari uang yang dibayar
4. Simpan riwayat transaksi hari ini

4. BATASAN
- Satu file HTML saja, tanpa framework dan tanpa library eksternal
- Data disimpan di localStorage browser, tanpa backend
- Bahasa tampilan: Bahasa Indonesia

5. KRITERIA SUKSES
[ ] Bisa menambah menu baru lewat tampilan
[ ] Total dan kembalian selalu benar untuk 5 transaksi uji
[ ] Riwayat transaksi tampil setelah halaman di-refresh

Perhatikan tiga hal dari contoh di atas. Pertama, angkanya konkret. "Kurang dari 30 detik", bukan "cepat". Kedua, batasannya tegas. "Satu file HTML saja" menutup pintu bagi AI untuk menambahkan hal yang tidak perlu. Ketiga, kriteria suksesnya bisa dicek. Kamu bisa benar-benar mencentang satu per satu setelah AI selesai bekerja.

Cara Memberikan PRD ke AI Coding

Menulis PRD saja tidak cukup, cara memberikannya juga menentukan hasil. Ada tiga cara yang umum. Pertama, tempel langsung di prompt. Cocok untuk PRD mini seperti contoh di atas. Awali dengan kalimat "Ikuti PRD berikut dengan tepat, jangan menambahkan fitur di luar daftar." Kedua, simpan sebagai file di proyek. Misalnya PRD.md di folder proyek, lalu perintahkan AI untuk membacanya dulu sebelum bekerja. Cara ini cocok untuk PRD yang lebih panjang. Ketiga, jadikan rujukan per bagian. Untuk proyek besar, jangan berikan semuanya sekaligus. Berikan satu bagian PRD untuk satu sesi kerja. Kita akan mendalami teknik ini di episode 4 tentang prompt berlapis.

Satu tips penting. Setelah AI selesai, minta AI mengecek hasilnya sendiri terhadap kriteria sukses di PRD-mu. Ini mengubah AI dari tukang kode menjadi pemeriksa kualitasnya sendiri. Berikut prompt pembuka yang bisa kamu pakai setiap kali.

Ikuti PRD berikut dengan tepat. Jangan menambahkan fitur
di luar daftar fitur. Jangan mengubah batasan.
Setelah selesai, cek hasil kerjamu terhadap kriteria sukses
dan laporkan mana yang terpenuhi dan mana yang belum.

[Tempel PRD-mu di sini]

Terakhir, anggap PRD sebagai dokumen hidup, bukan prasasti. Saat proyek berjalan, kamu akan menemukan hal baru: ternyata kasir butuh fitur diskon, atau ternyata satu file HTML mulai terasa sempit. Update PRD-mu setiap ada keputusan baru, lalu berikan versi terbarunya ke AI. PRD yang basi lebih berbahaya daripada tidak punya PRD, karena AI akan setia mengikuti instruksi yang sudah tidak relevan lagi.

Jebakan: PRD Terlalu Detail atau Terlalu Samar

Ada dua jurang di kiri dan kanan jalan PRD. Jurang pertama adalah PRD yang terlalu samar. Contohnya: "Buatkan aplikasi kasir yang bagus dan modern." Kata "bagus" dan "modern" tidak punya arti teknis. AI akan menebak, dan kamu akan kecewa. Jurang kedua adalah PRD yang terlalu detail. Contohnya menulis sendiri nama variabel, struktur folder, dan algoritma lengkap. Kalau kamu sudah tahu semua itu, kamu tidak butuh AI. Kamu butuh asisten pengetik.

Zona amannya ada di tengah. Spesifik di hasil yang kamu mau, bebas di cara mencapainya. Kamu yang menentukan apa (fitur, batasan, kriteria sukses), AI yang menentukan bagaimana (nama variabel, struktur kode, pendekatan). Prinsip ini sama dengan yang kita bahas di episode 1 soal prompt yang baik: spesifik di konteks dan batasan, bebas di implementasi.

Latihan Minggu Ini

Latihanmu minggu ini cuma satu, tapi berbobot. Tulis PRD mini untuk satu proyek kecil yang sedang kamu kerjakan atau ingin kerjakan. Pakai lima bagian di atas. Batasi satu halaman. Lalu berikan PRD itu ke AI coding tools pilihanmu dari episode 2, dan bandingkan hasilnya dengan saat kamu memberi perintah samar seperti biasa. Catat bedanya. Kebanyakan orang kaget melihat betapa jauh hasilnya berubah hanya karena perintahnya ditulis dengan benar.

Di episode 4 kita akan naik satu level dengan "Teknik Prompt Berlapis untuk Fitur Kompleks". PRD itu peta besarnya, tapi fitur yang kompleks tidak bisa dikerjakan dalam satu perintah raksasa. Episode berikutnya mengajarkan cara memecah fitur besar menjadi lapisan-lapisan prompt yang kecil dan terkendali. Sampai jumpa besok jam 21:00. Bakar semangat kodingmu seperti api kompor.