Gunakan PRD dan rules untuk memperbaiki bug nyata: kartu campaign di halaman utama mengarah ke route yang salah. Prompt dibuat sempit, berbasis bukti, dan punya acceptance criteria.
30m bacaanKuis WajibMicro Badge Lesson
Prompt Pertama yang Benar: Spec-Driven
Sekarang kamu sudah punya dua pagar:
text
docs/prd-mini.mddocs/project-rules.md
Baru sekarang kita minta Antigravity menyentuh kode.
Tugas pertama sengaja kecil: memperbaiki link campaign di halaman utama.
Kenapa kecil? Karena perubahan kecil mudah dipahami, mudah direview, dan mudah dibatalkan kalau salah.
Sekarang cek route yang tersedia. Di starter, flow donasi berada di:
text
/campaigns/[slug]/donate
Artinya link dari halaman utama mengarah ke:
text
/campaigns/paket-pangan-keluarga
Padahal yang kita butuhkan untuk alur v1 adalah:
text
/campaigns/paket-pangan-keluarga/donate
Ini bug kecil, tapi cocok untuk prompt pertama. Masalahnya jelas, file targetnya jelas, acceptance criteria-nya jelas.
Kenapa tidak cukup menulis “perbaiki bug”
Kalau kamu menulis:
text
perbaiki bug link campaign
AI mungkin benar, mungkin juga melebar. Ia bisa membuat halaman detail baru, mengubah routing, atau memperbaiki styling yang tidak diminta.
Prompt pertama harus menjaga agent tetap sempit.
Unsur yang perlu ada:
konteks project;
dokumen yang harus dibaca;
masalah aktual;
file/route yang relevan;
batasan perubahan;
acceptance criteria;
format laporan setelah selesai.
Prompt yang akan dijalankan
Gunakan prompt ini di Antigravity:
text
Project: Platform Donasi Amanah.Sebelum mengubah kode, baca:- docs/prd-mini.md- docs/project-rules.md- src/app/page.tsxMasalah:Di halaman utama, kartu campaign mengarah ke /campaigns/{slug}.Di starter ini route donasi yang tersedia adalah /campaigns/{slug}/donate.Akibatnya alur PRD "lihat campaign → donasi" putus karena klik campaign bisa menuju 404.Tugas:1. Perbaiki link kartu campaign di halaman utama agar mengarah ke /campaigns/{slug}/donate.2. Jangan membuat halaman detail campaign baru.3. Jangan mengubah schema database, migration, validasi, atau styling yang tidak perlu.4. Jangan mengubah file lain jika tidak diperlukan.Acceptance criteria:- Dari http://localhost:3000, klik campaign "Paket Pangan untuk Keluarga" menuju halaman donasi, bukan 404.- Halaman tujuan menampilkan form donasi.- Diff hanya menyentuh file yang relevan untuk link ini.- `npm run lint` dan `npm run build` tetap berhasil.Setelah selesai, laporkan:- file yang diubah,- perubahan yang dilakukan,- cara saya memverifikasi hasilnya.
Perhatikan: prompt ini tidak panjang karena ingin terlihat canggih. Prompt ini jelas karena bug-nya jelas.
Jalankan, lalu berhenti sejenak
Setelah Antigravity bekerja, jangan langsung lanjut.
Cek dulu diff:
bash
git diff --statgit diff
Untuk bug ini, perubahan idealnya kecil. Kemungkinan hanya src/app/page.tsx yang berubah dari:
tsx
href={`/campaigns/${c.slug}`}
menjadi:
tsx
href={`/campaigns/${c.slug}/donate`}
Kalau agent membuat route baru, mengubah database, atau menambahkan komponen besar, itu bukan solusi yang kamu minta. Minta revert atau revisi.
Verifikasi hasil
Jalankan app:
bash
npm run dev
Buka:
text
http://localhost:3000
Klik campaign Paket Pangan untuk Keluarga.
Yang harus terjadi:
kamu masuk ke halaman donasi;
URL mengandung /campaigns/.../donate;
form donasi tampil;
bukan halaman 404.
Setelah itu jalankan:
bash
npm run lintnpm run build
Untuk bug sekecil ini, build gagal berarti ada efek samping yang tidak boleh diabaikan.
Kalau hasil agent melebar
Gunakan prompt revisi seperti ini:
text
Perubahanmu terlalu luas untuk bug ini.Scope yang saya minta hanya memperbaiki link kartu campaign di src/app/page.tsx.Jangan membuat halaman baru, jangan mengubah schema, dan jangan mengubah styling.Tolong revert perubahan di luar scope, lalu sisakan perubahan minimal yang membuat link menuju /campaigns/{slug}/donate.
Ini bukan galak. Ini bagian dari kerja sebagai pemilik keputusan.
Prinsip yang perlu dibawa
Prompt spec-driven bukan berarti selalu membuat dokumen panjang. Intinya:
masalah bisa ditunjuk;
konteks tersedia;
scope dibatasi;
hasil punya acceptance criteria;
verifikasi bisa dilakukan.
Semakin kecil tugas pertama, semakin bagus. Kamu sedang melatih siklus, bukan membuktikan AI bisa menulis banyak kode.
Yang perlu kamu hasilkan
Simpan prompt dan hasil verifikasi:
text
docs/prompts/01-link-campaign-ke-donasi.md
Isi minimal:
md
# Prompt 01 — Link Campaign ke Halaman DonasiMasalah:- ...Prompt yang dipakai:- ...Diff:- file berubah: ...Verifikasi:- klik campaign: berhasil/gagal- npm run lint: berhasil/gagal- npm run build: berhasil/gagalCatatan revisi:- ...
Kalau kamu belum ingin membuat file notes, minimal simpan catatan ini di tempat yang mudah kamu baca ulang.
Checkpoint
Prompt menyebut PRD dan rules.
Prompt punya scope sempit.
Prompt punya acceptance criteria yang bisa diuji.
Kamu membaca diff sebelum menerima hasil.
Klik campaign menuju halaman donasi.
npm run lint dan npm run build berhasil.
Ini prompt pertama yang benar-benar menyentuh kode. Perubahannya kecil, tapi pelajarannya besar: semakin jelas masalah dan buktinya, semakin mudah kamu mengendalikan agent.
Checkpoint KuisTarget: 70%
Kuis 01.3 — Prompt Pertama yang Benar: Spec-Driven
Kuis ini wajib untuk sertifikat. Kamu tetap bisa lanjut ke pelajaran berikutnya dan mengerjakannya nanti.