Memberi konteks proyek: berkas aturan untuk asisten AI
Setiap sesi baru dengan asisten AI dimulai tanpa ingatan tentang keputusan sebelumnya. Akibatnya Anda mengulang penjelasan yang sama, dan AI sering melanggar kebiasaan proyek. Solusinya adalah berkas konteks di dalam repositori yang berisi aturan, struktur, dan keputusan penting, sehingga setiap sesi dapat memulai dengan pemahaman yang sama.
Apa itu berkas konteks
Berkas konteks adalah dokumen teks, biasanya di akar proyek, yang dibaca asisten AI di awal sesi. Banyak alat mendukung konvensi seperti berkas aturan khusus atau README yang diperluas.
Isinya adalah panduan ringkas agar AI bekerja sesuai cara proyek Anda.
Isi yang bermanfaat
Sertakan hal-hal berikut:
- Tujuan proyek dan pengguna utamanya.
- Teknologi dan versi yang dipakai.
- Struktur folder dan konvensi penamaan.
- Perintah untuk menjalankan, menguji, dan membangun.
- Hal yang tidak boleh dilakukan, seperti menambah pustaka tanpa izin.
Catat keputusan penting
Tuliskan alasan di balik keputusan besar, misalnya mengapa memilih basis data tertentu atau cara menangani autentikasi. Dengan begitu AI tidak mengusulkan perubahan yang bertentangan dengan keputusan sebelumnya.
Catatan ini juga berguna bagi manusia yang bergabung kemudian.
Singkat dan terawat
Berkas aturan yang panjang dan usang lebih merugikan daripada tidak ada. Perbarui seperlunya.
Jaga agar tetap ringkas
Konteks yang terlalu panjang memakan token dan mengaburkan hal penting. Prioritaskan aturan yang paling sering dilanggar dan informasi yang paling berguna.
Tinjau berkas secara berkala dan hapus bagian yang sudah tidak relevan.
Perbarui dari kesalahan berulang
Setiap kali AI melakukan kesalahan yang sama untuk kedua kalinya, tambahkan aturan singkat di berkas konteks. Dengan cara ini berkas tumbuh dari pengalaman nyata dan hasilnya makin sesuai.
Dalam beberapa minggu, kualitas keluaran AI akan terasa lebih konsisten.
Manfaat untuk tim
Dalam tim, berkas konteks menyamakan perilaku AI antaranggota. Siapa pun yang membuka proyek mendapat hasil dengan gaya dan standar yang sama.
Simpan di Git agar perubahan aturan dapat ditinjau seperti kode lainnya.
Contoh isi berkas aturan singkat
Contoh: 'Proyek ini adalah aplikasi pemesanan klinik. Stack: Next.js, TypeScript, Tailwind, Supabase. Jalankan tes dengan npm test. Jangan menambah pustaka tanpa konfirmasi. Semua teks tampilan berbahasa Indonesia. Akses data selalu melalui fungsi di folder lib.'
Hanya beberapa baris seperti ini sudah cukup mengurangi banyak kesalahan berulang dan menghemat waktu menjelaskan di setiap sesi.
Pertanyaan yang sering muncul
Ya, tanpa komitmen. Kami balas dalam 1×24 jam kerja.
Tentang Tim AnabisolutionsStudio digital dari Pekanbaru yang mengerjakan website, aplikasi, dan sistem untuk klien di Riau dan sekitarnya.
Anabisolutions

