Berikan konteks repositori yang berguna kepada agen

Mulai dari checkout saat ini

Agen perlu mengetahui repositori dan branch yang diubah. Agen juga perlu mengetahui apakah direktori kerja memuat perubahan yang tidak terkait. Fakta ini memengaruhi hal yang dapat diedit dengan aman dan cara menafsirkan diff akhir.

Minta agen memeriksa instruksi proyek dan konfigurasi paket sebelum implementasi. Perintah yang diingat dari repositori lain dapat keliru di sini. Nama framework yang dikenal tidak membuktikan versi terpasang atau konvensi proyek.

Untuk perubahan kecil, berikan modul relevan, kode pemanggil, pengujian, dan keputusan arsitektur. Tambahkan informasi ketika penyelidikan menunjukkan kebutuhan spesifik.

Gunakan instruksi repositori untuk aturan yang stabil

File instruksi dapat menjelaskan perintah yang didukung, batas modul, persyaratan peninjauan, dan tindakan yang memerlukan keputusan penanggung jawab. Konvensi AGENTS.md menyediakan lokasi yang mudah dikenali alat pemrograman untuk informasi ini. Dukungan alat dan prioritas instruksi dapat berbeda, jadi periksa perilaku alat Anda.

Simpan aturan proyek yang stabil dalam repositori. Simpan tugas saat ini dalam ringkasan tugas. Jangan mengubah file instruksi menjadi riwayat setiap percakapan atau daftar rencana sementara.

Instruksi yang berguna menyatakan “Jalankan pengujian integrasi otorisasi ketika route mengubah perilaku akses.” Instruksi yang kabur menyatakan “Selalu berhati-hati dengan keamanan.” Instruksi pertama mengidentifikasi pemicu dan tindakan yang dapat diverifikasi peninjau.

Periksa instruksi terhadap kode

Instruksi menjadi usang ketika perintah, direktori, atau arsitektur berubah. Jika panduan menyebut script yang tidak ada, periksa konfigurasi paket. Jika dokumen menyatakan layanan hanya dapat membaca, periksa izinnya sebelum mengandalkan klaim tersebut.

Catat pertentangannya. Gunakan bukti langsung tentang versi saat ini untuk memahami perilaku implementasi. Jangan diam-diam membuang kebijakan yang disengaja karena kode lama melanggarnya. Kebijakan dan perilaku saat ini menjawab pertanyaan berbeda.

Misalnya, panduan mungkin melarang penulisan langsung ke branch bersama sementara script lama masih melakukannya. Respons yang tepat adalah mempertahankan kebijakan dan memperbaiki script. Kode yang sudah ada bukan izin untuk mengulang tindakan terlarang.

Jaga konteks tetap relevan dan aman

Repositori lengkap dapat memuat kredensial, fixture privat, ekspor pelanggan, dan log dukungan lama. Akses repositori tidak otomatis membuat setiap file sesuai untuk layanan model.

Gunakan alat dan aturan penanganan data yang disetujui. Keluarkan secret dari konteks. Ganti contoh pelanggan dengan data rekaan jika memungkinkan. Periksa alat yang terhubung serta file yang diunggah: konektor pencarian dapat mengambil informasi yang tidak pernah ada dalam prompt awal.

Instruksi repositori “jangan baca secret” merupakan panduan yang berguna. Instruksi itu bukan pengganti pembatasan akses ke penyimpanan secret dan direktori sensitif.

Tinggalkan catatan yang berguna untuk orang berikutnya

Setelah selesai, catat perubahan perilaku, verifikasi, dan keterbatasan yang belum terselesaikan dalam pull request. Perbarui dokumentasi proyek yang menjadi rujukan jangka panjang ketika alur kerja yang didukung berubah. Hindari menyalin seluruh transkrip agen ke repositori.

Catatan tersebut harus membantu pemelihara berikutnya mengulang pekerjaan tanpa menyusun ulang percakapan panjang. Tautkan dokumen kanonis dan pertahankan satu penjelasan yang berwenang untuk setiap aturan stabil.

Konteks yang baik mengurangi penyelidikan berulang. Konteks juga memudahkan deteksi kesalahan karena perilaku yang diharapkan dan perintah yang berfungsi dinyatakan secara eksplisit.