Repository Agent sebagai Sandbox: Alur Kerja AI yang Aman untuk Kode Kantor

2026-10-31

AI coding assistant dapat membaca berkas, menjalankan tes, membuat commit, bahkan mengirim perubahan ke remote. Kemampuan itu berguna, tetapi akses tulis langsung ke repository kantor membuat satu kesalahan konfigurasi atau instruksi yang keliru berpotensi mengganggu branch bersama. Memisahkan repository kantor dan repository kerja agent mengurangi risiko tersebut, asalkan batasnya nyata: agent punya kredensial tulis hanya untuk repositori sandbox, sementara repository kantor tetap tidak dapat ditulis oleh identitas agent.

Pemisahan repository bukan pengganti review maupun pengamanan mesin. Kode yang disalin ke sandbox tetap dapat mengandung rahasia, dan program yang dijalankan dalam CI dapat mencoba mengakses jaringan atau kredensial runner. Pola ini paling tepat dipahami sebagai lapisan kendali: agent mengusulkan perubahan dalam ruang kerja terpisah; manusia dan proses resmi perusahaan menentukan apakah perubahan layak masuk ke proyek utama.

Dua repository, dua tingkat kepercayaan

Repository kantor adalah sumber resmi. Branch utamanya hanya menerima perubahan melalui mekanisme yang disetujui perusahaan, misalnya pull request, pemeriksaan wajib, atau pipeline rilis. Repository agent adalah salinan kerja yang dikelola di akun atau organisasi terpisah. Di sana agent boleh membuat branch, mengubah kode, menjalankan tes, melakukan commit, dan push sesuai izin yang diberikan.

Aturan akses harus ditegakkan oleh platform Git, bukan sekadar ditulis dalam prompt. Jangan memasukkan token berhak tulis repository kantor ke lingkungan agent. Berikan token berumur terbatas yang hanya dapat mengakses repository agent dan izin minimum yang diperlukan. GitHub, misalnya, menyediakan fine-grained personal access token yang dapat dibatasi ke repository tertentu dan permission tertentu; dokumentasinya menyarankan memilih akses repositori dan permission minimum. Periksa pula cakupan SSH key, token CI, dan kredensial lain yang tersedia di mesin kerja.

Salinan kantor menuju sandbox adalah alur masuk. Perubahan dari sandbox kembali ke kantor adalah alur keluar yang harus melalui gerbang manusia. Kedua arah ini tidak boleh tertukar. Hindari remote kantor bernama samar yang dapat menjadi tujuan push otomatis. Bila remote itu diperlukan untuk mengambil pembaruan, pastikan kredensial agent hanya read-only dan periksa URL remote sebelum menjalankan perintah Git.

Sinkronisasi tanpa menghapus pekerjaan

Sebelum tugas dimulai, perbarui sandbox dari sumber resmi. Tentukan branch kantor yang menjadi dasar, lalu catat commit dasar tersebut agar reviewer dapat melihat apa yang berubah sejak sinkronisasi. Untuk fork, gunakan mekanisme pembaruan upstream yang sesuai dengan platform atau fetch dari remote read-only, kemudian integrasikan perubahan ke branch kerja.

Jangan melakukan reset keras secara otomatis hanya untuk membuat sandbox tampak sama dengan kantor. Jika agent sudah memiliki commit lokal, tindakan itu dapat membuang pekerjaan. Periksa status, branch, dan riwayat terlebih dahulu. Konflik sinkronisasi harus diselesaikan dengan sadar; bila perubahan upstream bertabrakan dengan tugas agent, berhenti dan minta peninjauan, bukan menimpa berkas secara membabi buta.

Pembaruan otomatis harian dapat membantu proyek yang bergerak cepat, tetapi tidak selalu membuat basis kerja relevan. Untuk tugas yang sensitif, lakukan sinkronisasi tepat sebelum pekerjaan dan simpan identitas commit dasar di catatan tugas. Tarik hanya dari sumber yang telah disetujui. Jangan menyalin artefak build, file konfigurasi lokal, dump produksi, atau rahasia ke sandbox hanya karena semuanya ada di checkout kantor.

Branch per tugas dan jejak perubahan

Buat branch khusus untuk setiap tugas, misalnya ai-task/perbaiki-validasi-tagihan. Branch bernama jelas memudahkan pencarian, review, dan pembersihan setelah pekerjaan selesai. Hindari memakai satu branch agent untuk banyak perubahan yang tidak berhubungan, karena reviewer akan kesulitan memisahkan ruang lingkup dan mengidentifikasi commit yang relevan.

Sebelum commit, agent perlu menampilkan ringkasan perubahan, daftar berkas yang berubah, hasil tes, dan hal yang belum diverifikasi. Reviewer juga memeriksa git diff terhadap branch dasar, bukan hanya membaca deskripsi agent. Perhatikan perubahan tak terduga pada workflow CI, file dependency, skrip instalasi, konfigurasi jaringan, dan berkas yang menyimpan rahasia. Commit kecil dan pesan yang spesifik membuat asal-usul perubahan lebih mudah ditelusuri.

Pipeline di repository agent sebaiknya berjalan dengan permission minimum. Menjalankan tes yang tidak dipercaya pada runner dengan akses ke rahasia organisasi dapat mengubah sandbox menjadi jalur eksfiltrasi. Mulailah dengan runner terisolasi, tanpa kredensial deployment, dan akses jaringan yang dibatasi bila memungkinkan. Jangan menganggap label “sandbox” otomatis berarti prosesnya terisolasi dari host.

Pemeriksaan manusia sebelum kode masuk

Setelah agent push ke repository sandbox, manusia menilai apakah perubahan sesuai kebutuhan dan standar kantor. Jalankan tes yang relevan dari lingkungan yang dipercaya, tinjau dependency baru, periksa kemungkinan kebocoran rahasia, dan pastikan tidak ada perubahan di luar ruang lingkup. Tes lulus bukan bukti bahwa kode aman atau benar; hasilnya hanya satu masukan dalam keputusan review.

Jika platform dan kebijakan perusahaan mendukung, buat pull request atau merge request dari fork ke repository kantor. Pada GitLab, alur fork memang memungkinkan perubahan diusulkan ke proyek upstream melalui merge request. Namun, konfigurasi organisasi dapat membatasi kontribusi lintas proyek. Jika alur lintas-repository tidak diizinkan, reviewer dapat memeriksa diff lokal lalu memindahkan perubahan melalui proses internal yang terdokumentasi.

Perubahan akhir ke repository kantor dilakukan oleh manusia atau pipeline resmi dengan identitas yang memiliki otorisasi kantor. Jangan mengandalkan klaim “AI tidak akan push” sebagai kontrol. Kontrol yang kuat adalah agent memang tidak memiliki token, key, atau hak tulis ke tujuan tersebut. Branch protection dan persetujuan wajib menjadi lapisan tambahan, bukan satu-satunya penghalang.

Contoh alur untuk perbaikan validasi

Bayangkan agent diminta memperbaiki validasi tanggal jatuh tempo pada aplikasi keuangan internal. Pemilik proyek menyegarkan sandbox dari commit kantor yang telah disetujui, lalu mencatat hash commit dasar. Agent diberi branch tugas dan akses tulis hanya pada repository sandbox. Tidak ada salinan data transaksi nyata maupun token deployment dalam lingkungannya.

Agent mengubah fungsi validasi, menambah tes untuk tanggal kosong dan tanggal lampau, lalu mengirim commit ke branch tugas. CI sandbox menjalankan tes tanpa akses ke secret produksi. Sebelum mengusulkan perubahan, agent melaporkan file yang berubah, hasil tes, dan asumsi yang dibuat. Reviewer membandingkan diff dengan branch dasar, menjalankan pemeriksaan keamanan yang diwajibkan, serta memastikan perubahan tidak mengubah kebijakan pembayaran di bagian lain.

Bila hasilnya layak, pemilik kode mengajukan perubahan melalui PR/MR sesuai aturan kantor. Pemeriksaan dan persetujuan tim berjalan di repository resmi. Jika ada kegagalan atau temuan, agent memperbaiki branch sandbox; perubahan baru tetap melewati review. Dengan demikian, agent membantu pekerjaan teknis tanpa memperoleh wewenang untuk mengubah sumber resmi secara langsung.

Penutup: sandbox adalah batas akses, bukan janji

Repository agent terpisah berguna karena membatasi dampak kesalahan dan memberi ruang untuk eksperimen. Manfaatnya hilang jika agent tetap memegang kredensial kantor, runner sandbox dapat membaca secret produksi, atau perubahan dipindahkan tanpa pemeriksaan. Mulailah dengan satu proyek berisiko rendah, buat aturan sinkronisasi dan review yang jelas, lalu uji bahwa kredensial agent benar-benar ditolak saat mencoba menulis ke repository kantor.

Takeaway utama: berikan AI ruang untuk membuat perubahan, tetapi jangan berikan kunci ke sumber resmi. Akses tulis sandbox, sinkronisasi yang terlacak, pengujian terisolasi, dan persetujuan manusia membentuk alur yang jauh lebih dapat diaudit daripada mengandalkan niat baik agent.

Sumber