Dari Ide ke Aplikasi Jadi dengan AI: PRD, Agent, lalu Deploy

Kamu punya ide aplikasi. Kamu buka Cursor atau Claude Code, ketik satu paragraf soal apa yang kamu mau, tekan enter. Agent langsung nulis kode. Setengah jam kemudian kamu sadar dia bikin skema data yang beda dari bayanganmu, nama kolom asal comot, dan satu fitur yang tidak pernah kamu minta. Agennya tidak bodoh. Kamu cuma belum kasih dia spesifikasi.

Panduan ini soal alur yang bikin AI coding agent nurut: dari ide mentah, jadi PRD terstruktur, serahkan ke agent, iterasi terkontrol, sampai deploy. Bagian yang paling sering dilewati orang: bikin PRD dulu, sebelum satu baris kode ditulis. Ini bukan tutorial satu bahasa tertentu, tapi pola kerjanya.

Kenapa agent AI suka ngarang

AI coding agent tidak baca pikiranmu. Dia mengisi setiap kekosongan dengan tebakan yang paling masuk akal secara statistik. Kalau kamu cuma bilang "bikin aplikasi kasir", dia harus menebak semua yang tidak kamu sebut.

• Skema data: tabel apa saja, kolomnya apa, tipe datanya, mana yang wajib diisi
• Alur: apa yang terjadi saat stok habis, saat input kosong, saat angka minus
• Aturan bisnis: diskon dihitung sebelum atau sesudah pajak, pembulatan ke mana
• Batasan teknis: ini jalan di platform apa, ada limit apa, siapa yang boleh akses

Tebakannya tidak selalu salah. Masalahnya, kamu baru tahu tebakannya meleset setelah kode jadi, dan membongkar kode yang sudah jadi jauh lebih mahal daripada menulis spesifikasi di awal.

Peta alur end-to-end

Alurnya lima langkah, dan langkah pertama yang menentukan mutu empat sisanya.

1. Ide: satu-dua paragraf soal masalah yang mau kamu selesaikan
2. PRD: ide itu diubah jadi dokumen spesifikasi terstruktur (di sini Skematik masuk)
3. Serahkan: PRD jadi konteks awal untuk Cursor atau Claude Code
4. Iterasi: bangun per fitur, cocokkan dengan PRD, perbaiki
5. Deploy: naikkan ke hosting atau sebagai Web App

Langkah 1: ubah ide jadi PRD

PRD (Product Requirements Document) adalah dokumen yang menjelaskan apa yang dibangun dan kenapa, cukup rinci sampai orang lain (atau agent) bisa mengerjakannya tanpa nanya balik. Kalau istilah ini baru buatmu, mulai dari apa itu PRD lalu cara membuat PRD untuk aplikasi.

Kendala utamanya bukan format, tapi cara memindahkan yang ada di kepalamu ke teks yang tidak ambigu. Soal ini ada panduannya sendiri: cara menjelaskan ide aplikasi ke AI.

Di sinilah Skematik dipakai. Kamu tulis idemu dalam bahasa biasa, lalu Skematik mengubahnya jadi PRD terstruktur: ringkasan produk, daftar fitur, skema data, alur pengguna, sampai daftar fungsi yang perlu dibangun. Kamu tinggal koreksi bagian yang meleset, bukan menulis dokumen dari nol.

Kalau targetmu Google Apps Script, ada mode Web GAS. PRD-nya menyesuaikan bentuk GAS: struktur tab Spreadsheet dipetakan jadi skema data, ada daftar fungsi server, dan konvensinya sadar batasan GAS. Kamu bahkan bisa export setup-sheets.gs untuk menyiapkan sheet-nya.

Kenapa PRD dulu bikin agent tak ngarang

Balik ke masalah ngarang. PRD menutup celah tebakan karena dia mengubah "bikin aplikasi kasir" jadi kontrak yang eksplisit. Agent tidak perlu menebak nama kolom, karena kolomnya sudah tertulis. Tidak perlu menebak alur checkout, karena alurnya sudah ada. Yang tadinya diisi asumsi, sekarang diisi keputusan.

Bedanya paling terasa di detail teknis yang gampang dianggap remeh. Contoh nyata di Web GAS: tanpa spesifikasi, agent gampang menulis baca-tulis sheet per sel di dalam loop. Itu jalan, tapi lambat dan cepat kena limit waktu eksekusi (sekitar 6 menit di akun gratis). PRD yang sadar batasan GAS mengarahkan agent ke pola borongan sejak awal, pola yang dibahas di baca-tulis data Sheet secara efisien:

// baca sekali, olah di memori, tulis sekali
const sheet = SpreadsheetApp.getActive().getSheetByName('Stok');
const data = sheet.getDataRange().getValues();          // 1x baca
for (let i = 1; i < data.length; i++) {
  data[i][2] = data[i][1] * 1.1;                        // olah di array
}
sheet.getRange(1, 1, data.length, data[0].length)
     .setValues(data);                                  // 1x tulis

Perbedaan ini tidak muncul dari ngobrol lebih banyak dengan agent di tengah jalan. Muncul karena konvensinya sudah ditetapkan di PRD sebelum agent mulai.

Langkah 2: serahkan PRD ke Cursor atau Claude Code

PRD siap. Sekarang serahkan ke agent. Cara paling andal: simpan PRD sebagai file di dalam repo (misalnya PRD.md), lalu suruh agent membacanya sebelum menulis apa pun.

• Taruh PRD sebagai file di repo, bukan cuma tempel di chat yang nanti hilang dari konteks
• Di prompt pertama, minta agent baca PRD dan konfirmasi rencananya sebelum ngoding
• Minta dia bangun satu fitur dulu, bukan seluruh aplikasi sekaligus

Prompt pembukanya bisa sesederhana ini:

Baca PRD.md di root repo. Jangan tulis kode dulu.
Ringkas rencanamu untuk fitur "input transaksi" saja,
lalu tunggu aku setuju sebelum mulai.

Menahan agent di gerbang "konfirmasi dulu" itu murah dan mencegah dia lari ke mana-mana. PRD jadi rujukan bersama: kalau outputnya menyimpang, kamu tinggal tunjuk bagian PRD yang dilanggar, bukan menjelaskan ulang dari awal.

Langkah 3: iterasi terkontrol

Bangun per fitur, cocokkan dengan PRD, lanjut. PRD-mu efektif jadi checklist. Selesai satu fitur, cek terhadap spesifikasinya, baru ambil fitur berikutnya.

• Satu fitur per sesi, biar konteks agent tetap fokus dan hasilnya gampang di-review
• Setiap ada perubahan keputusan, update PRD dulu, baru minta agent menyesuaikan kode
• Kalau agent mulai ngarang lagi, biasanya karena PRD-nya memang belum menjawab pertanyaan itu. Perjelas PRD, jangan berdebat panjang di chat

Langkah 4: deploy

Fitur jalan, sekarang naikkan. Bentuk deploy tergantung target yang sudah kamu tetapkan di PRD, jadi keputusannya tidak dadakan.

Untuk aplikasi web biasa, deploy ke hosting pilihanmu. Untuk yang berbasis Google Apps Script, kamu deploy sebagai Web App: fungsi doGet(e) atau doPost(e) mengembalikan HtmlService atau ContentService, akses diset ke "Anyone", dan sisi client memanggil server lewat google.script.run, bukan fetch. Satu jebakan yang sering kena: Session.getActiveUser() balik kosong di deploy anonim, jadi jangan andalkan itu untuk mengenali pengguna. Langkah lengkapnya di cara membuat web app Google Spreadsheet, dan cek dulu batas kuota Apps Script biar tidak kaget saat trafik naik.

Kesalahan yang bikin balik ke titik nol

• Lempar ide satu kalimat, berharap agent tahu sisanya. Dia akan menebak, dan kamu bayar di belakang
• Bikin PRD, lalu tidak pernah update saat keputusan berubah. Dokumen basi lebih menyesatkan daripada tidak ada
• Minta seluruh aplikasi sekaligus. Susah di-review, dan satu asumsi salah menular ke mana-mana
• Menulis PRD sedetail kode. PRD menjelaskan apa dan kenapa, biar agent yang mengurus bagaimana

Urutannya sederhana: putuskan dulu di PRD saat mengubah masih murah, baru serahkan ke agent saat mengubah sudah mahal. Idemu tidak berubah, tapi hasilnya berhenti jadi tebakan.