Jangan Gunakan Claude Code Tanpa Persiapan Ini

AAI LABS
Computing/SoftwareSmall Business/StartupsInternet Technology

Transcript

00:00:00Kenyataannya adalah AI tidak akan pernah merevolusi proses pembuatan perangkat lunak, setidaknya tidak seperti yang Anda pikirkan.
00:00:05Ini tentu membuat segalanya lebih cepat, dan juga memudahkan pemulihan ketika terjadi kesalahan.
00:00:10Namun proses yang telah ditetapkan selama 60 tahun pembangunan produk masih sama pentingnya saat ini, hanya karena alasan yang berbeda,
00:00:16sebelumnya mereka diterapkan untuk memastikan manusia memiliki cara yang terstruktur dalam mengembangkan produk-produk ini.
00:00:21Tapi sekarang hal itu telah bergeser untuk memungkinkan agen AI bekerja seperti cara manusia bekerja.
00:00:25Jadi agar agen AI bekerja dengan benar, Anda perlu mengatur lingkungan mereka dengan cara yang tepat sehingga mereka benar-benar mengikuti prosesnya.
00:00:32Dan kita akan membahas semua langkah yang perlu Anda ambil bahkan sebelum Anda mulai membangun.
00:00:36Merencanakan persyaratan Anda dengan benar adalah hal terpenting yang Anda lakukan sebelum menulis satu prompt pun.
00:00:41Ini adalah bagian di mana tidak peduli seberapa bagus modelnya nanti, Anda tetap perlu meluangkan waktu.
00:00:45Sekarang ada beberapa cara untuk merencanakan.
00:00:46Anda dapat merencanakan aplikasi Anda menggunakan Claude code dalam mode perencanaan, tetapi perencanaannya sangat fokus pada teknis, bukan fokus pada produk.
00:00:52Seperti yang kami sebutkan di video sebelumnya bahwa dengan perkembangan agen saat ini,
00:00:56mode perencanaan tidak perlu terlalu mendetail atau teknis dan sebaliknya harus sangat fokus pada aspek produk
00:01:01karena model baru sangat kuat dan perencanaan harus berbeda dari sebelumnya saat model awal tidak terlalu mampu.
00:01:07Jadi alih-alih mode perencanaan Claude, Anda dapat membuat agen lain untuk membantu merencanakan aplikasi Anda.
00:01:11Ini berisi instruksi untuk membantu membangun PRD yang tepat dengan templat juga untuk memandu Claude tentang apa sebenarnya persyaratannya.
00:01:18Setelah Anda menyiapkan agen tersebut, Anda dapat memberi Claude prompt untuk menggunakannya dan merencanakan aplikasi yang ingin Anda bangun.
00:01:23Ini sebenarnya memuat agen perencana dan terus mengajukan pertanyaan sampai ia memahami semua persyaratannya.
00:01:28Ia terus mengajukan pertanyaan sampai Anda puas dengan perencanaannya.
00:01:32Sekarang untuk memahami MVP, agen tersebut dirancang untuk mengajukan banyak pertanyaan.
00:01:36Dan pada akhirnya, ia akan menanyakan apakah ada hal lain yang Anda perlukan di aplikasi Anda.
00:01:40Jika ada, Anda dapat menambahkan hal-hal yang Anda ingin agen tersebut implementasikan.
00:01:43Jika Anda puas dengan semua pertanyaan dan berpikir bahwa agen telah memahami rencananya, Anda cukup mengatakan selesai.
00:01:49Setelah sesi tanya jawab, ia membuat dokumen PRD dan menyimpannya ke folder proyek.
00:01:54Dokumen ini berisi detail tentang semua persyaratan yang Anda diskusikan.
00:01:57Implementasinya dibagi menjadi fase-fase dan berisi semua keputusan desain utama dan segala sesuatu yang diperlukan untuk aplikasi tersebut.
00:02:04Sekarang setelah Anda menyempurnakan aplikasi apa yang ingin Anda bangun, langkah selanjutnya adalah menentukan file Claude.md dengan benar.
00:02:10File ini penting karena berisi semua instruksi yang Anda ingin agen Anda ikuti.
00:02:15Anda menautkan dokumen PRD sehingga ia dapat mengakses semua persyaratan aplikasi langsung dari sana dan Anda tidak perlu mengulang apa pun di sini.
00:02:21File ini seharusnya hanya berisi hal-hal yang tidak diketahui oleh agen alih-alih menyebutkan hal-hal yang sudah diketahuinya.
00:02:27Ini merujuk pada aturan yang Anda ingin proyek tersebut ikuti.
00:02:30Anda dapat menambahkan konvensi proyek Anda dan semua instruksi yang Anda ingin Claude ikuti secara spesifik saat mengimplementasikan aplikasi.
00:02:37Pendekatan yang ideal adalah Anda tidak membuat file Claude.md dari perintah init dan malah membuatnya sendiri
00:02:43karena perintah ini hanya menghasilkan file berdasarkan basis kode yang ada, bukan apa yang sebenarnya perlu diketahuinya.
00:02:49Tetapi file ini bukanlah file sekali tulis yang Anda atur lalu lupakan.
00:02:53Anda harus terus menambahkan hal-hal ke dalamnya sehingga ia dapat meningkatkan proses pembangunan aplikasi secara bertahap saat Anda bekerja.
00:02:58Sekarang seperti yang kita bicarakan di video sebelumnya, file ini dimuat sekali dan tetap berada di dalam konteks selamanya, bertindak sebagai panduan saat ia bekerja.
00:03:05Jadi pastikan file ini tidak berisi hal-hal yang sebenarnya tidak diperlukan atau spesifik untuk satu area implementasi saja.
00:03:12Hal-hal yang perlu Anda tambahkan ke file ini adalah praktik terbaik yang akan diikuti proyek Anda, konvensi pengkodean Anda, gaya penulisan dan konvensi,
00:03:19dan hal serupa lainnya tetapi bukan hal-hal yang dapat ia cari tahu sendiri seperti bagaimana struktur proyeknya.
00:03:24Untuk itu ia dapat membaca struktur file dan memahaminya sendiri.
00:03:28Jadi luangkan waktu Anda saat menulis file ini dan pastikan file tersebut disesuaikan dengan kebutuhan dan proyek Anda sebelum benar-benar mengimplementasikan aplikasi.
00:03:36Hal berikutnya yang Anda siapkan adalah keterampilan, agen, dan MCP apa pun yang ingin Anda gunakan dalam proyek Anda, semuanya sebelum benar-benar membangunnya.
00:03:42MCP lebih mudah untuk dihubungkan.
00:03:44Anda cukup menghubungkan layanan eksternal mana pun yang Anda ingin agen tersebut akses dan menginstalnya dengan menjalankan perintah instalasinya.
00:03:50Sebagai contoh, kami ingin backend kami dibangun di atas Supabase jadi kami menghubungkan Supabase MCP ke agen kami di proyek tersebut.
00:03:57Jika Anda menggunakan Shad CN UI untuk komponen UI dan Playwright untuk pengujian browser,
00:04:01Anda harus menghubungkan semuanya sebelum membangun aplikasi sehingga agen dapat mengakses alat-alat ini saat membangun.
00:04:07Tapi itu tadi baru untuk menghubungkan ke layanan eksternal dan Anda juga perlu mengonfigurasi agen.
00:04:12Anda dapat mengonfigurasi agen sebanyak yang diperlukan.
00:04:14Anda sudah memiliki agen perencana khusus untuk perencanaan.
00:04:16Anda juga dapat membuat agen commit yang bertanggung jawab untuk melakukan commit, menjalankan pemeriksaan awal, dan mengikuti pesan commit konvensional.
00:04:23Anda dapat memiliki agen refactoring yang memfaktorkan ulang kode dan meningkatkan performa secara keseluruhan.
00:04:28Dan Anda dapat memiliki agen verifikasi yang menggunakan alat Playwright MCP sehingga ia dapat memverifikasi apakah UI dan alur pengguna bekerja sesuai rencana dan berisi semua instruksi tentang cara melakukannya.
00:04:39Sekarang selain agen, Anda juga perlu mengonfigurasi keterampilan (skills).
00:04:42Anda dapat membuat keterampilan sebanyak yang Anda butuhkan dan Anda dapat dengan mudah membuatnya menggunakan Skill Creator yang tersedia di repo GitHub sumber terbuka.
00:04:49Anda dapat menambahkan referensi sebanyak yang Anda inginkan dan juga menyertakan skrip sehingga ia dapat menjalankan skrip secara langsung dan menggunakan output-nya.
00:04:55Untuk perbedaan antara kapan harus menggunakan agen dan kapan menggunakan keterampilan, terapkan semua alur kerja yang berulang dan butuh panduan serta referensi sebagai keterampilan.
00:05:04Contohnya, Anda dapat membuat keterampilan front-end karena ini adalah alur kerja yang berulang dan perlu mengikuti panduan khusus secara konsisten di seluruh aplikasi.
00:05:11Terapkan agen untuk tugas-tugas yang membutuhkan jendela konteks khusus.
00:05:14Anda juga dapat menggunakan keterampilan front-end yang sumber terbuka dan aktif digunakan oleh pencipta Claude code itu sendiri.
00:05:20Anda juga perlu menambahkan aturan khusus jalur (path specific rules) untuk aspek-aspek tertentu dari aplikasi Anda.
00:05:23Aturan-aturan ini mendefinisikan jalur mana yang berlaku dan mencakup semua instruksi yang diperlukan untuk mengimplementasikan bagian spesifik tersebut.
00:05:29Anda dapat mengonfigurasi sebanyak mungkin yang Anda suka dan juga menautkannya di Claude.md Anda sehingga agen tahu bahwa ia harus mengikuti instruksi ini.
00:05:36Seperti yang kami sebutkan sebelumnya, Claude.md adalah untuk prinsip-prinsip luas, itulah sebabnya Anda memiliki aturan khusus jalur yang disesuaikan dengan bagian tertentu sehingga agen tahu apa yang perlu dilakukan untuk implementasi spesifik.
00:05:46Kami membahas semua pengaturan ini dan lebih banyak lagi tentang membangun produk dengan AI di saluran ini, jadi jika Anda ingin melihat lebih banyak, berlanggananlah dan nantikan video mendatang.
00:05:54Namun bahkan dengan semua instruksi positif ini, masih ada celah.
00:05:58Agen cenderung berorientasi pada tindakan dan mungkin mengimplementasikan hal-hal di luar apa yang ditentukan oleh batasan positif Anda.
00:06:03Oleh karena itu, Anda perlu memberi tahu agen secara eksplisit apa yang tidak boleh ia lakukan.
00:06:06Anda dapat membuat file ini di folder dokumen Anda dan menautkannya di Claude.md sehingga agen tahu batasan ini ada.
00:06:12Ini harus berisi semua instruksi yang disesuaikan dengan proyek, menentukan setiap hal yang tidak ingin Anda buat oleh agen.
00:06:19Batasan negatif penting karena spesifikasi positif menyisakan celah tersirat dan batasan negatif menutup celah tersebut, menghilangkan ambiguitas dan mencegah agen bereksperimen di tempat yang tidak seharusnya.
00:06:29Mereka memberikan tujuan yang lebih jelas tentang seperti apa output yang seharusnya tidak dihasilkan.
00:06:32Contohnya, jika Anda tidak ingin AI mengikuti kombinasi warna ungu atau biru dan putih default yang biasanya digunakan, nyatakan secara eksplisit bahwa Anda tidak menginginkan itu alih-alih hanya menyiratkannya.
00:06:41Tapi sebelum kita lanjut, mari kita dengar sepatah kata dari sponsor kami, Way in Video.
00:06:44Jika Anda bekerja dengan video panjang, Anda tahu kesulitannya. Berjam-jam menelusuri rekaman hanya untuk menemukan satu momen bagus, lalu lebih banyak waktu lagi mengeditnya.
00:06:52Way in Video memperbaiki semua itu. Ini adalah platform video AI yang benar-benar memahami video Anda.
00:06:56Keterampilan kliping AI mereka di OpenClaw mengambil video panjang apa pun, menemukan momen paling viral, membingkai ulangnya secara otomatis ke vertikal dan menambahkan teks.
00:07:04Tanpa pengkodean, tanpa pengaturan. Cukup jalankan keterampilannya dan klip Anda siap untuk diposting. Begitu saja.
00:07:08Jika Anda menginginkan sesuatu yang spesifik, Anda dapat mencari di dalam video apa pun menggunakan bahasa Inggris sederhana. Cukup ketik "reaksi lucu" atau "kutipan terbaik" dan itu akan langsung melompat ke sana.
00:07:16Ini juga menangani ringkasan video dan transkripsi dengan label pembicara. Sempurna untuk podcast, kuliah, dan streaming.
00:07:22Baik Anda sedang mengubah tujuan konten atau mengotomatiskan alur kerja Anda, Way in Video menghemat waktu berjam-jam setiap minggu.
00:07:27Berhentilah membuang-buang waktu untuk pengeditan manual. Klik tautan di komentar yang disematkan untuk memulai.
00:07:32Sekarang ini adalah satu hal yang digunakan sebagian besar kerangka kerja AI dalam satu bentuk atau lainnya, yaitu menggunakan beberapa dokumen untuk tujuan yang berbeda.
00:07:38Tetapi inti di balik semua dokumen tersebut adalah dokumen kemajuan dan pembelajaran.
00:07:42File kemajuan (progress file) sangat penting karena saat Anda mengerjakan aplikasi skala besar dengan banyak fitur, agen kehilangan jejak fitur mana yang sudah ia terapkan dan mana yang belum dikerjakan.
00:07:52Tanpa file ini, agen harus kembali, membaca implementasi dan membandingkannya dengan dokumen untuk mencari tahu apa yang telah dilakukan.
00:07:58Hal itu menciptakan overhead dan membuang waktu serta token.
00:08:01Jadi buatlah file kemajuan di mana agen dapat melihat di satu tempat dan tahu persis di mana posisi segala sesuatunya.
00:08:07Tetapi melacak kemajuan saja tidak cukup karena agen juga perlu tahu apa yang salah.
00:08:11Oleh karena itu, Anda juga memerlukan file pembelajaran (learnings file) di mana agen mencatat kesalahannya, apa penyebabnya, dan bagaimana ia memperbaikinya.
00:08:17Dengan cara ini, ketika ia menghadapi situasi serupa nantinya, ia tidak akan melakukan kesalahan yang sama dua kali.
00:08:22Sekarang karena kedua file ini dimaksudkan untuk diperbarui secara aktif saat agen mengimplementasikan aplikasi,
00:08:26Anda perlu menginstruksikan agen secara eksplisit di Claude.md sehingga ia terus menambahkan ke file-file ini, meningkatkan basis pengetahuannya selama pembangunan.
00:08:34Sekarang kedua file ini adalah yang paling penting yang dibutuhkan setiap pengaturan.
00:08:38Anda dapat menggunakan ini saat Anda membangun pengaturan pengkodean untuk Anda sendiri.
00:08:41Kami juga sebelumnya telah membuat video yang membahas tentang bagaimana Anda dapat membangun kerangka kerja Anda sendiri, yang dapat Anda tonton di saluran ini.
00:08:46Tetapi jika Anda tidak ingin repot-repot menyiapkan sendiri,
00:08:49Anda cukup mengandalkan kerangka kerja pengkodean karena mereka menggunakan mekanisme yang berbeda untuk melakukan hal itu yang dapat Anda terapkan secara langsung.
00:08:56Kesalahan umum lainnya adalah menerapkan pengujian hanya pada akhir pengembangan.
00:09:00Ini bermasalah karena jika Anda meminta agen untuk menulis dan mengimplementasikan tes setelah fitur dibangun,
00:09:05tes tersebut tidak akan seefektif jika ditulis sebelumnya.
00:09:09Saat menulis tes, Anda harus meminta agen merujuk ke PRD yang Anda buat dan berdasarkan itu, menyimpulkan bagaimana fungsionalitasnya seharusnya bekerja.
00:09:16Agen kemudian harus menulis tes dari persyaratan yang disimpulkan ini,
00:09:19pada dasarnya merekayasa balik fungsionalitas dan hal-hal di mana aplikasi mungkin salah dari PRD.
00:09:24Setelah tes siap, Anda dapat menjalankannya di akhir untuk memverifikasi silang apakah implementasi memenuhi persyaratan.
00:09:29Alasan penulisan tes terlebih dahulu adalah karena jika Anda menerapkannya setelah itu, agen hanya tahu apa yang sebenarnya telah diimplementasikan.
00:09:35Ia akan mengoptimalkan tes untuk fitur-fitur yang ada, bukan untuk fungsionalitas yang diperlukan dalam spesifikasi.
00:09:41Hal ini dapat menyebabkan Anda melewatkan pengujian fitur yang telah ditentukan tetapi tidak diimplementasikan dengan benar.
00:09:46Karena agen mengoptimalkan ke arah pendekatan yang diterapkan, ia mungkin lalai dalam pengujian menyeluruh,
00:09:50melewatkan kasus tepi (edge cases) yang bisa saja tertangkap jika tes diturunkan langsung dari spesifikasi.
00:09:55Anda tidak boleh memberi agen instruksi terbuka seperti "uji aplikasinya" karena dengan cara ini Claude hanya mengoptimalkan implementasi.
00:10:02Sebaliknya, terapkan tes yang tepat yang dipandu oleh spesifikasi sehingga agen tahu persis apa yang harus dioptimalkan.
00:10:07Juga, jika Anda menikmati konten kami, pertimbangkan untuk menekan tombol hype karena itu membantu kami membuat lebih banyak konten seperti ini dan menjangkau lebih banyak orang.
00:10:14Masalah lain yang dihadapi banyak orang selama pengembangan aplikasi adalah kurangnya pelacakan masalah di awal.
00:10:19Tanpa itu, masalah menumpuk tanpa catatan tentang apa penyebabnya atau kapan mulainya dan seiring bertambahnya skala aplikasi, akan semakin sulit untuk dilacak.
00:10:26Oleh karena itu, memelihara log yang tepat selama pengujian sangatlah penting.
00:10:29Banyak orang menggunakan GitHub untuk ini dan GitHub adalah platform yang sangat baik untuk melacak dan mengelola masalah.
00:10:34Menggabungkannya dengan pesan commit Git yang terstruktur dengan baik memberikan panduan kepada Claude tentang apa yang dilakukan di setiap commit dan memungkinkannya melacak kemajuannya.
00:10:42Salah satu fitur terbaik Git adalah jika sebuah perubahan merusak basis kode, Anda dapat mengembalikan commit (revert).
00:10:47Dan jika Anda ingin menguji sesuatu yang eksperimental, Anda dapat menggunakan work tree untuk melakukannya secara terisolasi.
00:10:51Anda dapat mengonfigurasi pengaturan Anda sehingga agen melakukan commit setelah setiap implementasi menggunakan pesan mendetail untuk menjaga kejelasan.
00:10:58Tapi GitHub bekerja dengan baik untuk pengguna teknis dan anggota tim non-teknis mungkin kesulitan untuk mengirimkan masalah.
00:11:03Oleh karena itu, bagi mereka, menghubungkan agen ke alat manajemen proyek seperti Trello atau Notion adalah hal yang ideal.
00:11:08Ini memungkinkan pencatatan masalah, pelacakan kemajuan, dan kolaborasi pada perbaikan.
00:11:12Anda harus menghubungkan MCP dari alat masing-masing sehingga agen dapat mengaksesnya, melacak masalah, memindahkannya di papan, dan mengelola pelaporan secara efisien.
00:11:20Anda juga perlu menambahkan instruksi di Claude.md yang menentukan bahwa agen harus menggunakan Notion MCP untuk melacak bug dan masalah dengan benar.
00:11:28Menyiapkan ini di awal sangat berharga seiring bertambahnya skala proyek dan banyak orang mulai mengembangkan bersama, memastikan bahwa semuanya dapat dicatat dan dilacak secara efisien.
00:11:36Tetapi bahkan jika aplikasi Anda bekerja dengan sempurna dalam pengujian, kode yang dihasilkan AI secara inheren tidak dibangun untuk menangani banyak pengguna secara bersamaan.
00:11:43Inilah sebabnya mengapa banyak orang menemukan implementasi AI berkinerja buruk di lingkungan produksi.
00:11:47Oleh karena itu, Anda perlu bersiap untuk itu juga.
00:11:49Jika Anda memiliki perkiraan, Anda dapat memberi tahu agen Anda jumlah pengguna yang diharapkan dan bahwa banyak pengguna akan menggunakan aplikasi pada saat yang sama.
00:11:56Agen kemudian harus menulis kasus uji untuk pengujian stres beban berdasarkan informasi ini.
00:12:01Ada banyak alat pengujian yang dapat Anda gunakan dan Anda dapat memilih mana yang sesuai dengan persyaratan Anda.
00:12:05Kami menggunakan K6 untuk aplikasi Next.js karena mudah diimplementasikan dan sesuai dengan persyaratan kami.
00:12:10Anda juga dapat menggunakan mode rencana Claude di sini untuk memetakan beberapa pendekatan untuk aplikasi karena di sini kita memerlukan rencana teknis yang mendetail.
00:12:17Claude merencanakan berdasarkan PRD dan perkiraan jumlah pengguna yang Anda harapkan akan menggunakannya secara bersamaan.
00:12:23Claude mengajukan banyak pertanyaan dari perspektif berbeda dan mengklarifikasi masalah potensial yang bisa muncul di produksi.
00:12:29Ini membantu aplikasi gagal dengan anggun bahkan jika terjadi masalah dan memastikan pengalaman pengguna dioptimalkan.
00:12:34Menggunakan mode ini, Anda dapat memperjelas niat Anda dan memiliki rencana agen untuk skalabilitas juga.
00:12:39Rencana ini menjadi bagian terakhir dalam membawa aplikasi Anda dari sebuah ide menjadi siap produksi.
00:12:43Sekarang semua agen dan keterampilan yang disebutkan di sini tersedia di AI Labs Pro untuk video ini dan untuk semua video kami sebelumnya dari mana Anda dapat mengunduh dan menggunakannya untuk proyek Anda sendiri.
00:12:53Jika Anda menemukan nilai dalam apa yang kami lakukan dan ingin mendukung saluran ini, ini adalah cara terbaik untuk melakukannya.
00:12:57Tautannya ada di deskripsi.
00:12:59Itu membawa kita ke akhir video ini.
00:13:00Jika Anda ingin mendukung saluran ini dan membantu kami terus membuat video seperti ini, Anda dapat melakukannya dengan menggunakan tombol super thanks di bawah.
00:13:07Seperti biasa, terima kasih telah menonton dan sampai jumpa di video berikutnya.

Key Takeaway

Keberhasilan pengembangan perangkat lunak dengan Claude Code bergantung pada persiapan lingkungan yang terstruktur melalui dokumen PRD, file Claude.md manual, batasan negatif yang eksplisit, serta mekanisme pelacakan kemajuan untuk meminimalkan ambiguitas agen AI.

Highlights

Perencanaan persyaratan (PRD) yang matang harus mendahului penulisan kode karena model AI saat ini membutuhkan konteks produk yang kuat daripada sekadar instruksi teknis.

File Claude.md harus dibuat secara manual dan berisi instruksi spesifik, konvensi proyek, serta tautan ke dokumen PRD agar agen AI memiliki panduan yang konsisten dalam jendela konteks.

Batasan negatif dalam instruksi AI mencegah agen bereksperimen di luar parameter desain, seperti melarang skema warna tertentu atau pola arsitektur yang tidak diinginkan.

Pemisahan tugas antara agen dan keterampilan (skills) dilakukan dengan menerapkan alur kerja berulang sebagai keterampilan, sementara tugas dengan jendela konteks khusus menggunakan agen terpisah.

File progress.md dan learnings.md yang diperbarui secara aktif mencegah pemborosan token dan kegagalan memori agen pada proyek skala besar.

Penulisan tes fungsional harus dilakukan sebelum implementasi fitur dengan merujuk langsung pada PRD untuk menghindari optimalisasi tes yang bias terhadap kode yang sudah ada.

Penggunaan alat pengujian beban seperti K6 untuk aplikasi Next.js memastikan kode buatan AI mampu menangani banyak pengguna simultan di lingkungan produksi.

Timeline

Pergeseran Peran AI dalam Pengembangan Produk

  • Proses pembangunan produk selama 60 tahun tetap relevan untuk memberikan struktur kerja bagi agen AI.
  • Lingkungan kerja AI harus diatur dengan tepat agar agen mengikuti proses pengembangan manusia secara konsisten.

AI tidak mengubah esensi pengembangan perangkat lunak tetapi mempercepat eksekusi dan pemulihan kesalahan. Fokus utama saat ini bergeser dari sekadar alat bantu manusia menjadi penyediaan lingkungan yang memungkinkan agen AI bekerja secara mandiri namun terstruktur.

Metode Perencanaan dan Pembuatan PRD

  • Perencanaan persyaratan produk merupakan langkah paling krusial sebelum melakukan prompting.
  • Agen perencana khusus lebih efektif dalam menghasilkan PRD dibandingkan mode perencanaan teknis bawaan Claude.
  • Dokumen PRD yang dihasilkan mencakup fase implementasi, keputusan desain utama, dan persyaratan fungsional mendetail.

Mode perencanaan teknis standar Claude seringkali terlalu sempit sehingga penggunaan agen perencana khusus sangat disarankan. Agen ini akan mengajukan pertanyaan interaktif hingga seluruh persyaratan MVP dipahami, kemudian menyimpan hasilnya dalam folder proyek sebagai dokumen PRD yang komprehensif.

Konfigurasi File Claude.md dan Instruksi Proyek

  • File Claude.md manual lebih unggul daripada hasil perintah init karena berisi kebutuhan spesifik proyek.
  • Instruksi dalam Claude.md harus fokus pada hal-hal unik yang tidak bisa diketahui AI melalui pembacaan struktur file.
  • Pembaruan berkala pada file panduan meningkatkan efisiensi pembangunan aplikasi secara bertahap.

File ini berfungsi sebagai kompas permanen dalam konteks percakapan AI. Isinya mencakup praktik terbaik, konvensi pengkodean, dan gaya penulisan, namun harus menghindari detail yang hanya relevan untuk satu area implementasi agar tidak memenuhi jendela konteks secara tidak efisien.

Integrasi MCP, Agen Khusus, dan Keterampilan

  • Model Context Protocol (MCP) memungkinkan agen terhubung ke layanan eksternal seperti Supabase, Shad CN UI, dan Playwright.
  • Tugas berulang seperti pengembangan front-end dikonfigurasi sebagai keterampilan (skills).
  • Agen khusus didefinisikan untuk peran spesifik seperti commit, refactoring, dan verifikasi UI.

Persiapan alat eksternal harus selesai sebelum proses pembangunan dimulai agar AI dapat mengakses fungsi-fungsi tersebut secara instan. Penggunaan Skill Creator membantu otomatisasi alur kerja yang membutuhkan referensi konsisten, sementara aturan khusus jalur (path specific rules) memberikan instruksi mendalam untuk bagian tertentu dari aplikasi.

Penerapan Batasan Negatif dan Dokumentasi Kemajuan

  • Batasan negatif menutup celah ambiguitas yang sering kali dieksperimentasikan oleh agen AI yang berorientasi tindakan.
  • File kemajuan (progress.md) mencegah overhead token dengan memberikan status fitur yang jelas di satu tempat.
  • File pembelajaran (learnings.md) mencatat kesalahan masa lalu agar AI tidak mengulangi kegagalan teknis yang sama.

Tanpa instruksi eksplisit tentang apa yang dilarang, AI cenderung mengambil inisiatif yang mungkin merusak konsistensi desain. Selain itu, file progress dan learnings bertindak sebagai memori eksternal yang efisien, memastikan agen selalu tahu posisi proyek saat ini dan solusi untuk masalah yang pernah dihadapi sebelumnya.

Strategi Pengujian dan Kesiapan Produksi

  • Pengujian yang ditulis setelah kode hanya akan mengoptimalkan fitur yang ada, bukan persyaratan asli.
  • Integrasi alat manajemen proyek seperti Notion melalui MCP memfasilitasi pelacakan bug bagi tim non-teknis.
  • Pengujian stres menggunakan K6 diperlukan untuk memvalidasi performa aplikasi di bawah beban pengguna simultan.

Menulis tes dari PRD sebelum implementasi memastikan seluruh kasus tepi tertangani tanpa bias kode. Untuk skalabilitas, mode perencanaan Claude digunakan kembali untuk memetakan pendekatan teknis yang detail terhadap perkiraan jumlah pengguna, memastikan aplikasi gagal secara anggun (graceful failure) saat menghadapi lonjakan trafik.

Community Posts

View all posts