- Saat pertama kali menggunakan Claude Code, pendekatannya hanyalah instruksi prompt dan revisi berulang, tetapi pada pekerjaan yang kompleks muncul masalah ketergantungan pada riwayat percakapan dan keterbatasan konteks
- Untuk mengatasinya, sebelum implementasi fitur dimulai, AI diminta menulis dokumen rencana (plan document), lalu dokumen ini dijadikan single source of truth (SSOT) untuk sesi baru
- Dokumen rencana mencakup penyusunan ulang kebutuhan, penjelasan detail implementasi, perintah untuk memeriksa kualitas kode, dan terus diperbarui selama implementasi sebagai living document
- Dengan cara ini, masalah hilangnya konteks dapat diatasi, dan bahkan di sesi baru proyek bisa dilanjutkan hanya dengan satu dokumen
- Hasilnya, AI bukan sekadar alat eksekusi, melainkan berperan sebagai mitra desain kolaboratif yang mendorong developer berpikir dan mendokumentasikan desain dengan lebih mendalam
Kesadaran masalah: batas pendekatan percakapan sederhana
- Saat bekerja secara interaktif dengan Claude Code, pendekatan ini cocok untuk tugas sederhana, tetapi ketika pekerjaan kompleks membesar, muncul beberapa batasan penting
- Percakapan menjadi satu-satunya sumber kebenaran, sehingga pesan baru dapat dengan mudah menimpa instruksi sebelumnya, dan sulit menyadari dengan jelas kapan itu terjadi
- Karena batas ukuran konteks AI, semakin panjang percakapan, semakin besar kemungkinan informasi sebelumnya terlewat
- Claude Code memang memiliki fitur kompresi percakapan, tetapi itu tidak sepenuhnya menghilangkan keterbatasan ini
Eksperimen pendekatan berpusat pada dokumen rencana
- Untuk menyelesaikan masalah ini, dicoba pendekatan berbasis dokumen rencana
- Di awal, Claude Code diberi penjelasan sedetail mungkin tentang fitur yang akan diimplementasikan atau bug yang perlu diperbaiki
- File sumber yang sudah ada atau dokumen rencana yang pernah ditulis sebelumnya juga disebutkan sebagai referensi
- Instruksi implementasi yang terlalu spesifik dihindari, agar AI terdorong berperan memberi usulan desain
- Jika dokumen rencana sudah cukup memuaskan, riwayat percakapan dihapus dan pekerjaan dimulai lagi dengan hanya rencana tersebut sebagai konteks
- Rencana mencakup ringkasan fitur, rencana implementasi, kode dan pseudocode, serta perintah type/lint/test
Proses desain kolaboratif
- Saat desain yang diusulkan AI tidak sesuai, diberikan umpan balik yang spesifik untuk mendorong pendekatan yang direvisi
- Dalam proses diskusi, kadang disadari bahwa usulan awal AI justru lebih cocok, dan ini lebih efisien dibanding menulis kode hanya dengan desain sendiri
- Percakapan yang terstruktur memberi pengalaman yang mirip dengan mendiskusikan rencana bersama rekan developer
- AI memang tidak selalu mengajukan pendekatan yang sepenuhnya berbeda dengan sendirinya, tetapi jika ditanya, ia juga dapat menawarkan alternatif lain
Pendekatan Living Document
- Dokumen rencana tidak ditulis sekali lalu selesai, melainkan terus diperbarui bahkan selama implementasi fitur berlangsung
- Perubahan yang terungkap selama proses implementasi, type check, lint, dan test langsung dicerminkan secara real time
- Terbentuk kebiasaan meminta pemeriksaan status terbaru rencana setiap kali melakukan commit kode
- Karena rencana selalu dijaga dalam keadaan terbaru, pada sesi percakapan baru pun pekerjaan dapat dilanjutkan tanpa kehilangan konteks cukup dengan melampirkan rencana tersebut
Code review dan perubahan kebiasaan pengembangan
- Setelah implementasi dimulai, perubahan ditinjau secara berkala, dan jika hasilnya memuaskan, pekerjaan AI pun bisa lebih dipercaya
- Saat meninjau kode akhir, dokumen rencana yang telah diperbarui membantu memahami dasar pengambilan keputusan teknis
- Dengan menyusun dan mendokumentasikan rencana secara teliti sejak awal, diperoleh pengalaman bertumbuh menjadi developer yang lebih baik
- Karena harus menjelaskannya kepada AI, proses pengambilan keputusan sendiri menjadi tersusun lebih jelas
Dari kekacauan menuju keteraturan
- Pendekatan ini membuat dokumen rencana menjadi single source of truth, mengatasi masalah hilangnya konteks, dan mendorong pemikiran arsitektural
- Dokumen rencana mencakup sekaligus spesifikasi dan log implementasi, merekam bukan hanya ‘apa’, tetapi juga ‘mengapa’ dan ‘bagaimana’
- Hasil akhirnya adalah proses pengembangan yang terencana, terdokumentasi dengan baik, dan andal
- AI menempatkan diri bukan sebagai implementor semata, melainkan sebagai mitra desain kolaboratif
Belum ada komentar.