Skip to main content
Anda dapat mengubah apa yang ditandai Code Review pada repositori Anda dengan melakukan commit instruksi ke repositori tersebut. Beginilah cara Anda mengurangi jumlah nit, menghentikan komentar pada file yang dihasilkan, atau menambahkan aturan yang penting bagi tim Anda. Letakkan instruksi tersebut di salah satu dari dua file:
  • CLAUDE.md: instruksi proyek yang dibaca Claude Code untuk setiap tugas, termasuk review. Code Review membacanya sebagai konteks proyek dan menandai perubahan yang melanggarnya.
  • REVIEW.md: instruksi khusus untuk review. Gunakan file ini untuk menyatakan apa yang ingin ditandai oleh tim Anda, pada tingkat keparahan apa, dan apa yang harus dilewati.
Tambahkan REVIEW.md di root repositori Anda dan merge file tersebut. Kemudian lindungi default branch Anda.
Untuk mengubah seberapa menyeluruh review atau kapan review dijalankan, minta seorang Owner untuk mengubah tingkat review atau pengaturan Review runs.

​
Gunakan CLAUDE.md untuk aturan di seluruh proyek

Code Review membaca file CLAUDE.md di repositori Anda sebagai konteks proyek. Perubahan yang melanggar salah satu aturannya menjadi temuan pada tingkat keparahan mana pun yang sesuai dengan masalahnya. Sebuah review membaca CLAUDE.md di root repositori Anda dan file CLAUDE.md di direktori induk dari setiap file yang diubah. CLAUDE.md di sebuah subdirektori dibaca ketika pull request mengubah file di bawah path tersebut.

​
Gunakan REVIEW.md untuk aturan khusus review

REVIEW.md adalah file di root repositori Anda yang menyesuaikan Code Review dengan repositori Anda. Anda juga dapat menambahkan REVIEW.md di sebuah subdirektori untuk menambahkan pemeriksaan bagi perubahan di bawah path tersebut, di samping file root. Agent yang menemukan masalah dan agent yang memverifikasinya menerima isinya sebagai instruksi review repositori Anda, bersama dengan panduan review default Code Review. Langkah yang menulis review akhir merujuk ke file ini sebelum menetapkan tingkat keparahan dan menulis ringkasan. Contoh tata letak ini memiliki file root dan satu file subdirektori:
Sebelum Anda mengandalkan file subdirektori, lindungi default branch Anda dan periksa apa yang dibaca review untuk pengaturan branch Anda.
Layanan Code Review dan perintah /code-review lokal adalah dua tool terpisah, dan keduanya membaca file yang berbeda. Layanan ini membaca CLAUDE.md dan REVIEW.md. Perintah /code-review, yang Anda jalankan di dalam sesi Claude Code di mesin Anda sendiri, membaca file CLAUDE.md Anda dan tidak membaca REVIEW.md. Letakkan panduan yang ingin Anda terapkan di kedua tempat dalam CLAUDE.md, dan gunakan REVIEW.md untuk aturan yang khusus untuk review pull request.

​
Contoh REVIEW.md

REVIEW.md ini mengkalibrasi ulang tingkat keparahan untuk layanan backend, membatasi nit, melewati file yang dihasilkan, dan menambahkan pemeriksaan khusus repo.

​
Pilih apa yang ditulis di REVIEW.md

REVIEW.md adalah Markdown bentuk bebas yang mengubah apa yang ditemukan dan dilaporkan oleh review. File ini tidak mengubah format review. Temukan masalah yang Anda alami, lalu tambahkan instruksi seperti yang ditunjukkan. Contoh menggunakan empat yang pertama.
  • Hal yang salah ditandai sebagai Important: definisikan ulang arti 🔴 Important untuk repositori Anda. Kalibrasi default menargetkan kode produksi, sedangkan repositori dokumentasi, repositori konfigurasi, atau prototipe mungkin menginginkan definisi yang jauh lebih sempit. Nyatakan kelas temuan mana yang Important dan mana yang paling tinggi hanya Nit. Anda juga dapat menaikkan tingkat, misalnya memperlakukan setiap pelanggaran CLAUDE.md sebagai Important.
  • Terlalu banyak nit: batasi berapa banyak komentar 🟡 Nit yang diposting oleh satu review. Batasan seperti “laporkan paling banyak lima nit” menjaga review tetap dapat ditindaklanjuti.
  • Komentar pada file yang dihasilkan atau pada hal yang sudah diperiksa CI: daftarkan path dan kategori temuan di mana Claude harus melewati temuan. Kandidat umum adalah kode yang dihasilkan, lockfile, dan dependensi vendored, beserta apa pun yang sudah ditegakkan CI Anda seperti linting atau pemeriksaan ejaan. Untuk path yang memerlukan sedikit review tetapi tidak pemeriksaan penuh, tetapkan ambang yang lebih tinggi sebagai gantinya: “di scripts/, hanya laporkan jika hampir pasti dan serius.”
  • Aturan tim tidak diperiksa: tambahkan aturan yang ingin Anda tandai di setiap pull request, seperti “rute API baru harus memiliki tes integrasi.”
  • Temuan yang ternyata salah: wajibkan bukti sebelum suatu kelas temuan diposting. Misalnya, “klaim perilaku memerlukan kutipan file:line di sumber, bukan inferensi dari penamaan” mengurangi positif palsu yang jika tidak akan membuat penulis harus bolak-balik.
Beberapa instruksi ini memerlukan file root pada default branch yang dilindungi. Batasi REVIEW.md pada instruksi yang mengubah perilaku review, dan biarkan konteks proyek umum di CLAUDE.md.

​
Dari branch mana REVIEW.md dibaca

Code Review membaca REVIEW.md dari base branch pull request atau dari default branch, tidak pernah dari perubahan pull request itu sendiri. Untuk mengubah perilaku review, merge perubahan REVIEW.md terlebih dahulu. Simpan REVIEW.md di default branch Anda dan lindungi branch tersebut. Ketika review membaca salinan pada default branch yang dilindungi, yaitu baris pertama tabel di bawah, review mematuhi instruksi berikut dari file root:
  • Menurunkan tingkat keparahan temuan
  • Mengecualikan path, file, atau kelas masalah
  • Membatasi komentar nit

​
Apa yang dihitung sebagai perlindungan branch

Code Review menghitung pengaturan berikut sebagai perlindungan:
  • Default branch: aturan perlindungan branch klasik atau ruleset
  • Branch lainnya: hanya ruleset
Sebuah ruleset dihitung ketika membatasi pembaruan atau mewajibkan pull request dengan setidaknya satu persetujuan. Jika mewajibkan pull request, ruleset tersebut juga harus membatalkan persetujuan itu pada push baru atau mewajibkan persetujuan datang setelah push terakhir.

​
Apa yang dibaca review untuk setiap pengaturan branch

Temukan situasi repositori Anda di kolom pertama tabel di bawah. Jika check run menyebutkan REVIEW.md, lihat The check run mentions REVIEW.md.