Memahami Codebase Anda

Salah satu tugas terpenting seorang software engineer adalah membangun peta mental tentang suatu codebase. Sebelum Anda bisa mengubah sesuatu secara efektif, Anda perlu memahami cara kerjanya.

Dulu, menelusuri codebase besar berarti menghafal pola regex atau mempelajari tool khusus untuk melakukan pencarian. Sekarang, Anda bisa mengajukan pertanyaan dalam bahasa alami dan mendapatkan jawaban yang terperinci.

Pencarian agentik

Cara paling akurat untuk menemukan potongan kode adalah mencari kecocokan tepat, baik itu nama fungsi, nama variabel, atau string kesalahan.

Agen dapat menggunakan grep, alat untuk mencari string persis, dan mereka bisa membuat pola regex yang tepat untuk menemukan apa yang Anda cari. OpenCode juga menggunakan ripgrep, implementasi grep yang jauh lebih cepat.

Anda tidak perlu mengonfigurasi apa pun atau mengubah cara kerja Anda untuk menggunakan alat-alat ini. Agen menggunakannya secara otomatis saat mencari kode.

Pencarian semantik

Saat Anda tidak tahu persis apa yang Anda cari, pencarian semantik membantu Anda menemukan bagian codebase berdasarkan makna, bukan hanya teks yang persis. Misalnya, Anda bisa mencari “di mana sesi pengguna divalidasi?” dan menemukan middleware/session.ts meskipun file tersebut tidak mengandung kata “validate”.

Hal ini dimungkinkan karena OpenCode mengubah codebase Anda menjadi representasi vektor yang memungkinkan pencarian berdasarkan makna semantik.

Menggabungkan pencarian semantik dengan grep menghasilkan akurasi yang jauh lebih tinggi dibandingkan hanya menggunakan pencarian semantik saja.

Anda tidak perlu mengonfigurasi apa pun untuk menggunakannya. OpenCode secara otomatis mengindeks codebase Anda di latar belakang.

Mengajukan pertanyaan yang tepat

Cara Anda merumuskan pertanyaan memengaruhi alat pencarian mana yang digunakan agen dan seberapa efektif hasilnya.

Pencarian terarah (gunakan ketika Anda tahu apa yang dicari):

Temukan semua file yang mengimpor dari PaymentService kita dan tunjukkan bagaimana mereka menangani error pembayaran.

Eksplorasi luas (gunakan ketika Anda menjelajahi area yang belum familiar):

Bagaimana aplikasi kita menangani pembayaran yang gagal? Jelaskan alur error dari formulir checkout hingga pengguna.

Diagram arsitektur

Untuk codebase yang besar atau belum Anda kenal, Anda dapat meminta agen untuk membuat diagram arsitektur. Agen dapat menghasilkan diagram Mermaid yang dapat Anda render di GitHub, Notion, atau alat lainnya.

Buat diagram Mermaid yang menunjukkan alur data untuk sistem pembayaran kami, termasuk form checkout, validasi, pemrosesan, dan penanganan error.

Diagram ini berguna untuk onboarding, dokumentasi, dan tinjauan desain. Diagram ini juga dapat mengungkapkan masalah arsitektur yang mungkin tidak terlihat saat membaca kode.

Pola kegagalan umum: mengubah sebelum memahami

Kesalahan yang sering terjadi adalah meminta agen mengubah kode tanpa terlebih dulu memahami apa yang ada. Agen mungkin memodifikasi kode yang tampaknya relevan, tetapi ternyata melewatkan konteks penting yang akan mengubah pendekatannya.

Sebelum meminta perubahan, minta agen untuk menjelajahinya terlebih dulu:

Sebelum melakukan perubahan apa pun, tunjukkan bagaimana validasi formulir yang sudah ada bekerja. Perhatikan komponen mana yang terlibat dan bagaimana error ditangani.

Coding agents menafsirkan permintaan Anda secara harfiah. Ketika Anda tidak menjelaskan niat secara eksplisit, mereka mengisi kekosongan dengan asumsi yang mungkin tidak sesuai dengan tujuan Anda.

Langkah berikutnya

Anda dapat menemukan dan memahami kode. Di bab berikutnya, Anda akan mempelajari cara beralih dari memahami ke membangun—cara membuat fitur baru dengan efektif menggunakan coding agents.