Ubah pengalaman membangun Platform Donasi Amanah menjadi SOP reusable: dari kebutuhan, PRD, rules, prompt spec-driven, verifikasi, iterasi, sampai checkpoint.
Platform Donasi Amanah akan selesai. Tapi skill kerja yang kamu bangun jangan ikut selesai.
Sepanjang perjalanan ini, kamu sebenarnya mengulang pola yang sama:
textpahami kebutuhan
→ tulis PRD mini
→ turunkan rules
Pola itu jauh lebih berharga daripada satu prompt tertentu. Prompt bisa berubah. Tool bisa berubah. UI Antigravity bisa berubah. Tapi urutan berpikirnya bisa kamu bawa ke project lain.
Tugas sekarang: tulis SOP pribadi yang bisa dipakai ulang.
Banyak orang menyimpan prompt seperti koleksi mantra. Masalahnya, prompt tanpa konteks cepat basi.
Contoh prompt yang tampak bagus tapi lemah:
textBuatkan fitur donasi yang lengkap dan aman.Apa definisi lengkap? Aman di layer mana? Donasi statusnya apa? Siapa yang boleh melihat data? Bagaimana verifikasinya?
SOP yang baik menjawab pertanyaan sebelum prompt ditulis.
Buat file:
textdocs/sop/ai-coding-terarah-sop.mdIsi awal:
md# SOP AI Coding Terarah
## 1. Pahami kebutuhan
Selesai ketika aku bisa menjelaskan user, tujuan, alur utama, dan batasan non-goal.
## 2. Tulis PRD mini
Selesai ketika PRD punya: problem, user, main flow, data yang dibutuhkan, non-goals, dan acceptance criteria.
## 3. Turunkan rules
Selesai ketika aturan bisnis/teknis bisa diuji, bukan sekadar opini.
## 4. Siapkan context pack
Selesai ketika agent diarahkan membaca AGENTS.md, DESIGN.md, docs/README.md, PRD, rules, dan file terkait.
## 5. Prompt spec-driven
Selesai ketika prompt punya tujuan tunggal, file target, batasan scope, acceptance criteria, dan format laporan.
## 6. Review output agent
Selesai ketika aku membaca diff, mengecek file yang berubah, dan menolak perubahan di luar scope.
## 7. Verifikasi nyata
Selesai ketika command/browser/SQL/test membuktikan acceptance criteria.
## 8. Iterate atau checkpoint
Selesai ketika error direvisi berdasarkan bukti, atau perubahan yang lulus disimpan sebagai checkpoint.Perhatikan frasa “selesai ketika”. Itu membuat SOP bisa diuji.
SOP terlalu umum kalau tidak punya contoh nyata. Tambahkan satu contoh pendek di tiap langkah.
Contoh:
md## 3. Turunkan rules
Contoh dari Platform Donasi:
- Donation selalu mulai dari `pending`.
- Upload bukti tidak otomatis `verified`.
- Laporan publik hanya menghitung `verified`.
- Guest confirmation memakai token lookup.
Selesai ketika rules bisa diuji lewat schema, RLS, function, atau flow browser.Atau:
md## 7. Verifikasi nyata
Contoh dari Platform Donasi:
- `npm run build` membuktikan production build.
- SQL menghitung total verified untuk laporan transparansi.
- Confirmation tanpa token harus 404.
- Grep bundle memastikan service role tidak bocor.SOP yang punya contoh terasa hidup. SOP yang terlalu abstrak akan dilupakan.
Buat file kedua:
textdocs/sop/prompt-patterns.mdIsi dengan pola yang benar-benar dipakai.
textMulai dari AGENTS.md, DESIGN.md, dan docs/README.md.
Baca:
- docs/prd-mini.md
- docs/project-rules.md
- [file/route terkait]
Tugas: [satu tujuan]
Batasan:
- Jangan mengubah [area non-scope].
- Jangan menambah fitur di luar requirement.
Acceptance criteria:
- [kriteria yang bisa diuji]
Setelah selesai, laporkan:
- file yang diubah
- alasan perubahan
- cara verifikasiHasil sebelumnya belum lulus acceptance criteria.
Bukti gagal:
- Command: [command]
- Expected: [expected]
- Actual: [actual/error]
Tugas: perbaiki penyebabnya.
Batasan: jangan refactor area yang tidak terkait.
Laporkan diff dan verifikasi ulang.Audit dulu, jangan ubah file.
Scope audit:
- [area]
Format:
- Temuan
- Risiko
- Bukti
- Rekomendasi
- SeverityPattern 3 penting. Banyak agent terlalu cepat mengubah file. Dengan “audit dulu”, kamu memisahkan diagnosis dari tindakan.
SOP baru berguna jika bisa dipakai.
Pilih perubahan kecil, misalnya:
textTambahkan copy bantuan pada halaman donasi: "Pastikan nominal dan metode pembayaran sudah benar sebelum lanjut."Lalu ikuti SOP dari awal:
Kalau saat dipakai kamu bingung, berarti SOP perlu diperbaiki. Itu normal.
SOP bukan buku. Targetkan 1–2 halaman yang benar-benar dipakai.
Kalau terlalu panjang, buat dua lapis:
textSOP ringkas: docs/sop/ai-coding-terarah-sop.md
Detail pattern: docs/sop/prompt-patterns.mdYang ringkas dipakai saat kerja harian. Yang detail dibuka ketika butuh contoh.
docs/sop/ai-coding-terarah-sop.md dibuat.docs/sop/prompt-patterns.md berisi minimal 3 pattern.Nah, di titik ini kamu bukan cuma punya app. Kamu punya cara kerja. Kalau nanti masuk project lain dan mulai bingung, buka SOP ini dulu sebelum nulis prompt pertama. Biasanya masalah besar berkurang banyak saat konteks dan verifikasi sudah dipasang dari awal.
Kuis ini wajib untuk sertifikat. Kamu tetap bisa lanjut ke pelajaran berikutnya dan mengerjakannya nanti.
Ajukan pertanyaan, beri solusi, atau diskusikan materi pelajaran ini.
Belum ada komentar untuk pelajaran ini.
Jadilah yang pertama memulai diskusi atau mengajukan pertanyaan!