Sebelum agen coding menulis satu baris kode pun, ia hanya tahu apa yang Anda ceritakan. Kalau ceritanya kabur, hasilnya aplikasi yang rapi tetapi menjawab pertanyaan yang salah. Di sinilah dokumen persyaratan produk, yang biasa disingkat PRD, berguna: ia memindahkan kebutuhan dari kepala Anda ke tulisan yang bisa dibaca ulang, diperiksa, dan dipegang agen.
Tulisan ini tidak membahas apa itu PRD secara umum. Pertanyaannya lebih sempit: bagian mana dari sebuah PRD yang benar-benar menentukan mutu hasil kerja agen, dan bagaimana menguji PRD Anda sebelum dipakai.
Apa yang diminta standar rekayasa persyaratan
Rekayasa persyaratan bukan istilah baru dari dunia AI. Standar ISO/IEC/IEEE 29148:2018 tentang rekayasa persyaratan menetapkan proses serta item informasi yang dihasilkan, lengkap dengan isi minimal dan panduan formatnya, dan berlaku untuk proyek sistem maupun perangkat lunak tanpa memandang skala atau metodologinya. Per halaman standar tersebut yang diakses untuk tulisan ini, statusnya terbit dan sedang masuk tahap revisi. Pelajarannya: menulis persyaratan adalah pekerjaan yang punya disiplin, bukan sekadar daftar keinginan.
Mengapa agen lebih membutuhkannya daripada manusia
Rekan kerja manusia bisa bertanya di tengah jalan. Agen tidak selalu bertanya sendiri. Dokumentasi resmi Claude Code menyebut bahwa model dapat menyimpulkan maksud, tetapi tidak bisa membaca pikiran, jadi rujukan file, batasan, dan pola contoh perlu disebutkan. Panduan yang sama menekankan pemisahan tahap: eksplorasi dan perencanaan dulu, baru implementasi, supaya agen tidak memecahkan masalah yang keliru.
Pendekatan spec-driven development yang dijelaskan di repositori GitHub Spec Kit memakai urutan serupa: spesifikasi memuat apa dan mengapa, sedangkan pilihan teknologi baru masuk di tahap rencana. Artinya, PRD yang baik tidak dibuka dengan "pakai framework ini". Ia dibuka dengan siapa penggunanya dan masalah apa yang diselesaikan.
Lima bagian yang paling menentukan
- Pengguna dan tujuan. Siapa yang memakai, untuk menyelesaikan apa, dalam satu atau dua kalimat.
- Alur pengguna. Langkah demi langkah dari awal sampai selesai, termasuk apa yang terjadi saat salah input.
- Di luar cakupan. Daftar hal yang sengaja tidak dikerjakan. Panduan Claude Code menyebut spesifikasi yang paling berguna menyatakan apa yang berada di luar cakupan.
- Batasan. Teknologi yang wajib dipakai atau dihindari, serta pola yang sudah ada di proyek.
- Kriteria penerimaan. Cara membuktikan fitur sudah benar.
Bagian kelima paling sering dilewati, padahal paling berpengaruh. Menurut dokumentasi yang sama, tanpa pemeriksaan yang bisa dijalankan, "terlihat selesai" menjadi satu-satunya sinyal yang dimiliki agen, dan Anda sendiri yang menjadi penguji setiap kesalahan. Contoh dalam panduan itu: alih-alih meminta fungsi pengecek email, tuliskan contoh masukan beserta hasil yang diharapkan, lalu minta pengujian dijalankan.
Ingin mendalaminya lebih terstruktur? Taalenta punya kelas Agentic AI dengan Google AntiGravity dan Codex Untuk Akademik dan Perkantoran.
Uji PRD Anda dengan tiga pertanyaan
Pertama, apakah setiap kalimat persyaratan bisa dijawab "lulus" atau "gagal"? Kalimat seperti "halaman harus terasa cepat" tidak bisa diuji. "Daftar pesanan tampil kurang dari dua detik untuk 500 baris" bisa.
Kedua, apakah ada hal yang hanya Anda yang tahu? Istilah internal, aturan bisnis, atau alasan di balik sebuah keputusan harus tertulis, sebab agen tidak ikut rapat Anda.
Ketiga, apakah dokumen ini cukup berdiri sendiri? Panduan Claude Code menyarankan memulai sesi baru untuk eksekusi setelah spesifikasi selesai, sehingga konteks agen bersih dan terfokus. PRD yang hanya masuk akal bersama riwayat obrolan berarti belum selesai.
Kalau lebih enak mendengar pengantarnya, ada klip singkat di halaman video.
Sumber
- ISO, "ISO/IEC/IEEE 29148:2018 Systems and software engineering: Life cycle processes: Requirements engineering". https://www.iso.org/standard/72089.html
- Anthropic, "Best practices for Claude Code". https://code.claude.com/docs/en/best-practices
- GitHub, "Spec Kit: spec-driven development toolkit" (README). https://github.com/github/spec-kit