Prompt Claude Code: 25 Prompt Siap Pakai dan Cara Menulis Prompt Anda Sendiri

Pelanggan yang menggunakan kupon yang sudah kadaluwarsa akan menerima kesalahan 500 saat checkout. Periksa berkas @src/checkout/coupons.ts beserta tesnya. Perilaku yang diharapkan adalah munculnya pesan "kupon tidak valid" tanpa membuat pesanan. Tulis tes yang gagal yang dapat mereproduksi kesalahan tersebut, lalu perbaiki tanpa mengubah perilaku kupon yang valid. Jalankan [perintah tes checkout] dan tunjukkan hasilnya sebelum dan sesudah. Jika Anda tidak dapat mereproduksi kesalahan tersebut, laporkan apa yang telah Anda periksa sebelum mengubah implementasinya.

Tambahkan pemilih tanggal ke [path formulir pemesanan]. Ikuti konvensi komponen dan validasi yang terdapat di @src/components/TimeSelect.tsx. Pengguna harus dapat memilih [tanggal yang diizinkan], sementara [tanggal yang tidak tersedia] tetap dinonaktifkan. Jangan tambahkan pustaka. Jalankan [perintah pengujian komponen] dan [perintah pemeriksaan tipe], serta laporkan kriteria apa pun yang tidak tercakup oleh pemeriksaan tersebut.

Pisahkan berkas @src/reports/export.py menjadi fungsi-fungsi yang lebih kecil sambil mempertahankan masukan, format keluaran, dan perilaku kesalahan aslinya. Jalankan perintah [export test] sebelum mengedit dan laporkan kegagalan yang ada. Setelah refactoring, jalankan kembali tes tersebut dan tunjukkan kedua hasilnya. Jangan ubah antarmuka publik atau berkas yang tidak terkait.

“Claude menguji setiap perubahan yang saya terapkan di claude.ai/code menggunakan ekstensi Claude untuk Chrome. Ekstensi ini membuka browser, menguji antarmuka pengguna, dan mengulangi proses tersebut hingga kode berfungsi dengan baik dan pengalaman pengguna terasa nyaman. ”

Periksa berkas README, konfigurasi proyek, dan struktur direktori tingkat atas dari repositori ini. Gunakan referensi hanya jika diperlukan untuk menjelaskan:Apa fungsi aplikasi tersebutTitik masuk utama dan komponen utamanyaDi mana letak tes-tes tersebut dan perintah apa saja yang didefinisikan oleh repositori untuk menjalankannyaSebutkan jalur berkas yang mendukung penjelasan Anda. Bedakan antara perilaku yang terdokumentasi dengan kesimpulan Anda sendiri, dan tandai hal-hal yang tidak dapat Anda tentukan. Jangan membaca berkas rahasia atau berkas lingkungan, memeriksa dependensi yang terpasang, atau mengubah berkas apa pun. Akhiri dengan menyebutkan tiga berkas yang harus saya baca terlebih dahulu beserta alasannya.

Tinjau riwayat Git dari [file, fungsi, atau kelas], dengan fokus pada [masalah perilaku atau desain]. Identifikasi commit yang memperkenalkan atau secara signifikan mengubah perilaku tersebut. Untuk setiap commit yang relevan, cantumkan hash-nya, rangkum perubahannya, dan jelaskan alasan yang tercantum dalam pesan commit atau diskusi terkait yang dapat Anda akses. Tandai alasan yang disimpulkan sebagai "inferensi". Jika riwayat tidak menjelaskan suatu keputusan, nyatakan hal tersebut. Jangan memodifikasi file atau riwayat Git.

Lacak apa yang terjadi saat [tindakan pengguna atau peristiwa sistem], dimulai dari [rute, handler, atau folder yang diketahui]. Ikuti panggilan-panggilan yang relevan melalui proses validasi, logika bisnis, serta penulisan ke database atau permintaan eksternal. Buat daftar berkas dan fungsi sesuai urutan eksekusi, beserta referensi baris jika tersedia. Jelaskan jalur kegagalan utama dan identifikasi pengujian yang sudah ada yang mencakup alur tersebut. Tandai koneksi apa pun yang tidak dapat Anda konfirmasi dari kode. Jangan jalankan alur tersebut, panggil layanan eksternal, atau edit berkas.

Rencanakan cara mengimplementasikan [fitur] di [area repositori]. Perilaku yang diharapkan adalah [persyaratan], dan area-area berikut harus tetap tidak berubah: [batasan]. Periksa kode yang relevan dan tes yang sudah ada. Identifikasi berkas-berkas yang perlu diubah, urutan implementasi, serta risiko kompatibilitas atau migrasi data. Hubungkan setiap persyaratan dengan tes yang diusulkan atau langkah verifikasi lainnya. Cantumkan pertanyaan yang belum terjawab dan asumsi secara terpisah. Jangan implementasikan fitur tersebut dulu. Kirimkan rencana tersebut kepada saya untuk ditinjau.

Saya ingin membangun [deskripsi singkat] untuk [pengguna dan kasus penggunaan]. Bacalah [berkas atau persyaratan yang relevan] terlebih dahulu, lalu gunakan AskUserQuestion untuk mengklarifikasi keputusan yang akan berdampak signifikan pada implementasi. Fokuslah pada kasus tepi, penanganan data, izin, perilaku UI yang diharapkan, dan kompromi. Jangan ajukan pertanyaan yang jawabannya sudah terdapat dalam konteks yang disediakan. Setelah keputusan utama diselesaikan, buat draf spesifikasi yang mencakup persyaratan, kriteria penerimaan, batasan, dan hal-hal yang berada di luar cakupan. Tandai asumsi yang masih tersisa. Tunjukkan spesifikasi tersebut kepada saya sebelum menyimpannya ke [jalur spesifikasi], dan jangan menimpa berkas yang sudah ada tanpa persetujuan.

Nilai dampak perubahan [fungsi, komponen, atau antarmuka] dari [perilaku saat ini] ke [perilaku yang diusulkan]. Cari di [ruang lingkup repositori atau direktori] untuk definisinya, pemanggil langsung, impor, dan pengujian terkait. Buat daftar berkas yang kemungkinan memerlukan perubahan dan jelaskan bagaimana masing-masing dapat terpengaruh, dengan referensi berkas dan baris jika tersedia. Tandai panggilan yang diselesaikan secara dinamis, konsumen eksternal, atau ketergantungan lain yang tidak dapat Anda verifikasi. Identifikasi masalah kompatibilitas apa pun yang perlu dijawab sebelum implementasi. Jangan ubah berkas; kirimkan penilaian dampak tersebut dan tunggu tinjauan saya.

Tambahkan [fitur] ke [berkas atau halaman] dengan perilaku berikut: [kriteria penerimaan]. Periksa [implementasi yang ada] dan ikuti konvensinya dalam mengambil data, menangani kesalahan, serta mengatur komponen. Gunakan hanya pustaka yang sudah terpasang di proyek. Jaga agar perubahan tetap dalam [ruang lingkup] dan pertahankan [perilaku yang ada atau antarmuka publik]. Tambahkan atau perbarui pengujian untuk kriteria penerimaan. Jalankan [perintah pengujian] dan [perintah pemeriksaan tipe atau lint], lalu laporkan berkas yang berubah, hasil, dan pemeriksaan apa pun yang tidak dapat Anda selesaikan. Jika pola yang ada bertentangan dengan suatu persyaratan, jelaskan pertentangan tersebut sebelum melanjutkan.

Implementasikan [nama fungsi] di [berkas] untuk memenuhi [persyaratan]. Cakup [kasus normal], [kasus tepi], dan [perilaku input yang tidak valid]. Jalankan [perintah pengujian yang relevan] terlebih dahulu dan laporkan kegagalan yang ada. Tulis pengujian untuk perilaku yang diminta, lalu jalankan pengujian tersebut sebelum implementasi. Pastikan pengujian baru gagal karena alasan yang diharapkan. Implementasikan fungsi tersebut dan jalankan kembali pengujian. Jangan melemahkan asersi, melewatkan tes, atau mengubah perilaku yang diharapkan agar tes tersebut lulus. Jika persyaratan bertentangan dengan tes yang ada, hentikan dan jelaskan konflik tersebut. Tunjukkan hasil sebelum dan sesudah.

Terapkan desain terlampir di [komponen atau halaman], dengan menggunakan komponen dan gaya yang sudah ada dalam proyek. Pertahankan [perilaku yang diperlukan] dan hindari perubahan di luar [ruang lingkup]. Gunakan [browser yang telah dikonfigurasi atau alat tangkapan layar] untuk menangkap [rute lokal] pada [dimensi viewport] dengan [data uji dan status UI]. Jika alat atau aplikasi tersebut tidak tersedia, laporkan apa yang diperlukan daripada mengklaim telah melakukan pemeriksaan visual. Bandingkan tangkapan layar dengan referensi, dengan fokus pada [tata letak, spasi, tipografi, atau kriteria penerimaan lainnya]. Lakukan hingga [jumlah] putaran koreksi, lalu laporkan perbedaan yang tersisa. Jangan mengubah gambar referensi. Jalankan [pengujian komponen yang relevan] dan [perintah pengecekan tipe atau build]. Sertakan tangkapan layar yang diambil dan hasil pemeriksaan aktual dalam ringkasan Anda.

Pengguna mengalami [gejala] saat [pemicu atau masukan]. Perilaku yang diharapkan adalah [hasil yang diharapkan]. Mulailah dengan memeriksa [folder, fungsi, atau alur] serta tes yang terkait. Buatlah tes yang gagal yang dapat mereproduksi perilaku yang dilaporkan. Jika Anda tidak dapat mereproduksinya, jelaskan apa yang telah Anda periksa dan informasi apa yang masih kurang sebelum mengubah implementasinya. Setelah berhasil direproduksi, perbaiki penyebabnya tanpa mengubah [perilaku yang harus tetap utuh]. Jalankan tes baru dan [perintah tes terkait]. Tunjukkan kegagalan sebelum perbaikan, hasilnya setelah perbaikan, dan kegagalan yang masih tersisa.

[Perintah build] gagal di [lingkungan lokal atau CI] dengan output berikut: [log kesalahan yang telah disensor]. Periksa kode dan konfigurasi yang relevan untuk mengidentifikasi penyebabnya. Periksa perbedaan lingkungan atau dependensi jika kegagalan tersebut tidak dapat direproduksi secara lokal. Lakukan perubahan terkecil yang dapat mengatasi penyebabnya. Jangan menonaktifkan pemeriksaan, menekan kesalahan, melewatkan tes, atau melonggarkan pengaturan kompiler hanya untuk mendapatkan hasil build yang lulus. Jalankan kembali build setelah perubahan. Jika masih gagal setelah [jumlah] upaya perbaikan, hentikan dan laporkan apa yang telah Anda coba, kesalahan saat ini, serta langkah diagnostik berikutnya. Rangkum penyebabnya dan sertakan hasil build yang sebenarnya.

Bantu saya mempersempit cakupan bug sebelum mengusulkan perbaikan. Perilaku yang diamati: [apa yang terjadi]Perilaku yang diharapkan: [apa yang seharusnya terjadi]Kapan terjadi: [kondisi atau frekuensi]Apa yang sudah saya coba: [langkah-langkah dan hasil]Ajukan satu pertanyaan pada satu waktu, pilih pertanyaan yang paling tepat untuk membedakan antara penyebab yang mungkin. Jangan ulangi pertanyaan yang sudah terjawab oleh informasi yang diberikan. Setelah ada bukti yang cukup, rangkum penjelasan yang paling mungkin, hal-hal yang masih belum pasti, dan pengujian terkecil yang dapat mengonfirmasi atau menyingkirkan kemungkinan tersebut. Jangan mengedit berkas dulu.

Gunakan subagen untuk meninjau [perbedaan atau cabang yang dibandingkan dengan basis] terhadap [rencana yang disetujui atau berkas persyaratan]. Jika persyaratan tidak ada atau ambigu, laporkan hal tersebut sebelum menilai kelengkapan. Periksa apakah setiap persyaratan telah diimplementasikan, kasus tepi yang relevan memiliki pengujian, dan apakah ada perubahan yang berada di luar ruang lingkup yang disepakati. Periksa kode di sekitarnya jika diperlukan untuk memahami perbedaan tersebut. Laporkan masalah kebenaran dan persyaratan yang tidak terpenuhi dengan referensi berkas dan baris, dampaknya, serta bukti yang mendukung setiap temuan. Pisahkan masalah yang telah dikonfirmasi dari pertanyaan yang belum terselesaikan. Jangan mengada-ada temuan untuk memenuhi kuota atau menyertakan preferensi gaya yang tidak relevan. Jangan mengedit berkas.

Tinjau [berkas atau perbandingan] untuk risiko injeksi, pemeriksaan otorisasi yang terlewat, rahasia yang terpapar, dan penanganan masukan pengguna yang tidak aman. Periksa pemanggil yang relevan dan logika validasi sebelum melaporkan temuan. Untuk setiap masalah, identifikasi berkas dan baris yang terpengaruh, kondisi yang diperlukan untuk memicunya, dampak yang mungkin terjadi, serta solusi yang diusulkan. Bedakan jalur yang dipastikan rentan dari masalah yang memerlukan pengujian lebih lanjut. Jangan mencantumkan nilai rahasia dalam laporan, memodifikasi berkas, atau melakukan pengujian terhadap layanan yang sedang berjalan. Sebutkan area mana saja yang telah Anda tinjau dan apa saja yang berada di luar cakupan.

Rangkum cara Anda memverifikasi perubahan yang telah diselesaikan berdasarkan [kriteria penerimaan]. Untuk setiap kriteria, cantumkan pemeriksaan yang dilakukan, perintah tepatnya (jika ada), dan hasil yang diamati. Sertakan keluaran yang relevan, dengan informasi rahasia dan data sensitif disamarkan. Identifikasi kegagalan yang sudah ada sebelumnya secara terpisah. Bedakan dengan jelas antara pemeriksaan yang lulus, yang gagal, dan yang tidak dijalankan. Jelaskan pemeriksaan yang dilewati atau batasan cakupan. Jangan menyatakan bahwa seluruh perubahan telah diverifikasi jika masih ada kriteria yang belum diperiksa.

Lakukan refaktorisasi [file atau modul] untuk mencapai [tujuan spesifik, seperti memecah fungsi besar atau menghapus callback bersarang]. Pertahankan antarmuka publik, nilai kembalian, perilaku kesalahan, dan efek sampingnya. Jalankan [perintah pengujian yang relevan] sebelum mengedit untuk menetapkan baseline. Jika gagal, laporkan kegagalan tersebut sebelum melanjutkan. Identifikasi perilaku apa pun yang tidak tercakup oleh pengujian yang ada dan tambahkan pengujian yang terfokus di tempat yang diperlukan. Lakukan refaktorisasi tanpa perubahan yang tidak terkait atau ketergantungan baru. Jangan melemahkan asersi yang ada untuk mengakomodasi implementasi. Jalankan kembali tes dan [perintah pemeriksaan tipe atau lint]. Tunjukkan hasil sebelum dan sesudah, rangkum perubahan struktural, dan tandai perilaku apa pun yang tidak dapat Anda verifikasi.

Temukan penggunaan [API atau pustaka lama] di dalam [ruang lingkup direktori], tidak termasuk berkas yang dihasilkan secara otomatis dan berkas vendor. Buat daftar berkas yang terpengaruh serta konfigurasi bersama atau dependensi apa pun yang mungkin terpengaruh oleh migrasi. Usulkan tiga berkas representatif untuk migrasi percontohan ke [API atau versi baru], dengan menggunakan [panduan migrasi atau contoh yang sudah ada]. Jelaskan alasan pemilihan berkas tersebut dan tandai perubahan perilaku yang diperlukan. Tunggu persetujuan saya sebelum melakukan pengeditan. Setelah disetujui, lakukan migrasi hanya pada berkas uji coba dan dependensi bersama yang secara eksplisit disetujui. Jalankan [pengujian yang relevan] dan [perintah build atau pengecekan tipe]. Jangan perluas migrasi ke berkas lain. Laporkan perbedaan (diff), hasil pengujian, masalah kompatibilitas, dan perubahan apa pun yang diperlukan pada pendekatan migrasi. Hentikan untuk ditinjau sebelum melanjutkan ke berkas-berkas lainnya.

Periksa cabang saat ini, status Git, dan perbandingan (diff) untuk [fitur atau perbaikan]. Identifikasi berkas-berkas yang terkait dengan perubahan ini dan cantumkan berkas-berkas yang tidak terkait atau tidak dilacak secara terpisah. Buat draf pesan commit mengikuti format 10 commit terakhir. Siapkan deskripsi pull request yang mencakup apa yang berubah, alasannya, tes yang benar-benar dijalankan, dan batasan apa pun yang masih ada. Tunjukkan daftar berkas yang diusulkan, pesan commit, dan deskripsi PR sebelum melakukan staging atau mempublikasikan apa pun. Tunggu persetujuan saya. Setelah disetujui, lakukan staging hanya pada berkas yang telah disepakati, lakukan commit di [cabang fitur], lakukan push ke [remote], dan buka pull request terhadap [cabang dasar]. Jangan mengubah commit yang sudah ada, melakukan force-push, atau melakukan merge. Kirimkan hash commit dan tautan PR.

Buat draf bagian README untuk [modul] yang ditujukan kepada [pembaca, seperti insinyur backend yang bergabung dengan proyek]. Jelaskan prasyarat, pengaturan, tiga perintah yang paling sering digunakan, serta kesalahan umum yang didukung oleh kode atau dokumentasi yang ada. Verifikasi nama perintah dan opsi dengan membandingkannya terhadap [skrip paket, Makefile, bantuan CLI, atau konfigurasi CI]. Tandai apa pun yang tidak dapat Anda konfirmasi. Uji perintah lokal yang aman di [lingkungan pengujian] jika tersedia. Sebelum menjalankan perintah yang menginstal dependensi, menghapus file, memigrasi data, melakukan deployment, atau mengakses layanan eksternal, jelaskan dampaknya dan mintalah persetujuan. Bedakan dengan jelas antara perintah yang berhasil Anda jalankan dengan perintah yang hanya diverifikasi berdasarkan konfigurasi atau dokumentasi. Tunjukkan bagian README yang diusulkan sebelum mengedit [jalur dokumentasi], dan pertahankan konten yang tidak terkait.

Tinjau [jalur ke CLAUDE.md] berdasarkan struktur, skrip, dan konvensi repositori saat ini. Jangan edit berkas tersebut dulu. Identifikasi instruksi yang sudah usang, duplikat, kontradiksi, dan aturan yang dapat disimpulkan secara andal dari kode. Jelaskan setiap usulan penghapusan alih-alih hanya memotong instruksi demi memperpendek berkas. Sarankan perintah build atau pengujian yang hilang hanya jika Anda dapat memverifikasinya dalam skrip proyek, Makefile, konfigurasi CI, atau dokumentasi yang ada. Sebutkan sumber untuk setiap penambahan. Kirimkan usulan diff yang mempertahankan batasan-batasan penting proyek. Tandai instruksi khusus tugas yang akan lebih cocok ditempatkan dalam aturan berlingkup skill atau path, dan tunggu persetujuan sebelum menerapkan perubahan.

Usulkan hook perintah Claude Code yang menjalankan [perintah formatter yang sudah ada] setelah perubahan Edit atau Write pada [pola file]. Periksa terlebih dahulu konfigurasi yang ada di claude/settings.json dan konfigurasi formatter tersebut. Gunakan konfigurasi PostToolUse yang sesuai untuk versi Claude Code yang terinstal. Format hanya file yang terpengaruh, tangani jalur dengan aman, dan kecualikan [file yang dihasilkan atau jalur lain yang dikecualikan]. Jangan menginstal dependensi atau mengganti hook yang sudah ada. Tunjukkan perbedaan pengaturan yang diusulkan dan jelaskan bagaimana kegagalan pemformatan akan dilaporkan. Tunggu persetujuan sebelum menerapkannya. Setelah disetujui, uji dengan file sementara di proyek dan laporkan hasilnya. Sebutkan jalur pengeditan mana yang dicakup dan mana yang tidak, termasuk perubahan yang dilakukan melalui perintah shell.

Periksa [tool] –help dan bantuan untuk subperintah yang relevan dengan [tugas]. Jangan menginstal alat tersebut jika tidak tersedia; laporkan prasyarat tersebut sebagai gantinya. Usulkan perintah yang tepat yang diperlukan untuk menyelesaikan tugas. Jelaskan masukan, keluaran, serta apakah perintah tersebut menulis file, mengubah sumber daya jarak jauh, atau menggunakan kredensial. Sertakan opsi dry-run jika alat tersebut mendokumentasikannya. Tandai konfigurasi atau izin yang hilang, dan mintalah klarifikasi daripada menebak nama sumber daya atau tujuan. Tunggu persetujuan sebelum menjalankan perintah tugas. Setelah disetujui, jalankan hanya perintah yang telah disepakati dan laporkan hasil aktualnya, termasuk kesalahan atau langkah yang belum selesai.

Bandingkan [invoices.csv] dan [payments.csv] menggunakan [ID faktur atau kunci pencocokan]. Jangan mengubah file sumber. Terapkan aturan berikut: [mata uang dan toleransi pembulatan], [alokasi pembayaran sebagian], dan [penanganan pengembalian dana, kredit, dan kelebihan pembayaran]. Jika ada aturan yang terlewat atau kecocokan yang ambigu, tandai saja daripada langsung mengalokasikan pembayaran secara otomatis. Pertahankan ID baris sumber. Untuk setiap faktur, tampilkan jumlah yang difaktur, pembayaran yang telah diterapkan, dan saldo tersisa. Laporkan ID duplikat, faktur yang tidak cocok, pembayaran yang tidak cocok, dan saldo di luar toleransi. Rekonsiliasi total faktur dan pembayaran secara terpisah. Hitung setiap baris sumber tanpa penghitungan ganda; jika pembayaran dibagi ke beberapa faktur, tampilkan setiap alokasi dan pastikan alokasi tersebut tidak melebihi jumlah pembayaran. Simpan hasilnya ke [jalur keluaran baru] dan rangkum pengecualian yang memerlukan peninjauan.

Tulis skrip yang merangkum [export.csv] untuk periode mulai dari [tanggal dan waktu awal, termasuk] hingga [tanggal dan waktu akhir, tidak termasuk], menggunakan [zona waktu] dan [kolom tanggal]. Kelompokkan catatan berdasarkan [aturan kategori] dan hitung [metrik yang diperlukan]. Tangani ID duplikat dan nilai yang hilang sesuai dengan [aturan]. Jangan memodifikasi berkas masukan. Jalankan skrip pada [berkas masukan yang tepat]. Laporkan jumlah baris yang disertakan dan dikecualikan, total kategori, serta catatan yang tidak dapat diklasifikasikan. Bandingkan hasil untuk [tiga kategori] dengan jumlah yang telah diverifikasi secara independen dalam [berkas referensi]. Jika jumlah tersebut tidak tersedia, nyatakan bahwa validasi independen masih tertunda. Tampilkan perbedaan dan simpan laporan ke [jalur keluaran baru].

Baca [berkas atau folder yang ditentukan] dan susunlah [jenis dan panjang dokumen] untuk [pembaca], yang mencakup [pertanyaan atau topik]. Dukung setiap klaim faktual dengan nama berkas serta referensi halaman, bagian, atau baris jika tersedia. Bedakan kutipan langsung dari parafrasa, dan jangan menganggap proposal atau dokumen usang sebagai keputusan terkini yang telah dikonfirmasi. Tandai sumber yang bertentangan, informasi yang hilang, dan klaim yang tidak dapat Anda verifikasi. Jangan mengisi kekosongan dengan asumsi atau mengedit berkas sumber. Kembalikan draf beserta referensinya dan daftar singkat pertanyaan yang belum terjawab untuk peninjau.

Untuk menyesuaikan templat, ganti placeholder-nya dengan detail dari proyek Anda dan tentukan apa yang harus dilakukan Claude sebelum melakukan perubahan. Gunakan langkah-langkah ini untuk menyiapkan permintaan dan meninjau hasilnya.

Untuk perubahan kecil yang terdefinisi dengan jelas, Anda dapat meminta Claude untuk langsung mengimplementasikannya. Untuk kode yang belum dikenal, perubahan yang melibatkan beberapa berkas, atau persyaratan yang belum jelas, mulailah dengan membuat rencana.

Tekan Shift+Tab hingga mode Plan muncul, atau jalankan Claude Code dengan perintah claude --permission-mode plan. Dalam mode ini, Claude dapat memeriksa berkas dan menjalankan perintah read-only tanpa mengedit kode sumber Anda. Tinjau berkas, dependensi, dan pengujian yang diusulkan sebelum menyetujui implementasinya. Tekan Ctrl+G untuk membuka rencana yang diusulkan di editor Anda.

Berikan Claude bukti yang diperlukan untuk memahami tugas tersebut: referensi berkas, log kesalahan yang telah disaring, tangkapan layar, atau dokumen persyaratan. Gunakan simbol @ diikuti dengan jalur berkas untuk menyertakan isi berkas tersebut.

Pilih kumpulan sumber data terkecil yang berguna. Menyertakan log atau direktori secara utuh dapat menambah materi yang tidak relevan dan menghabiskan konteks. Hapus kredensial dan data sensitif sebelum membagikan log, serta pastikan Claude memiliki alat yang diperlukan untuk mengakses URL dokumentasi yang Anda berikan.

Misalnya, perintah `cat error.log | claude -p "Jelaskan kesalahan ini"` mengirimkan log melalui permintaan non-interaktif. Gunakan perintah ini hanya setelah memeriksa isi berkas tersebut. Inilah nilai praktis dari AI kontekstual: memberikan informasi yang relevan kepada model untuk tugas yang sedang dikerjakan.

Saat menambahkan fitur, identifikasi komponen atau fungsi serupa di repositori. Beritahu Claude konvensi mana yang harus diikuti, seperti klien API, logika validasi, penanganan kesalahan, atau struktur pengujian.

“Ikuti cara @src/widgets/Weather.tsx mengambil dan menyimpan data dalam cache” memberikan referensi konkret kepada Claude. Sebutkan juga perbedaan apa pun yang diperlukan oleh fitur baru tersebut agar Claude tidak meniru perilaku yang sudah tidak sesuai lagi. Konvensi-konvensi ini harus mencerminkan alur kerja pengembangan perangkat lunak tim Anda.

Untuk perubahan kode, tentukan perintah pengujian, build, atau lint yang relevan beserta perilaku yang harus diperiksa. Untuk penelitian, minta referensi berkas atau ID commit. Untuk pekerjaan antarmuka pengguna (UI), berikan gambar referensi dan cara yang telah dikonfigurasi untuk menangkap implementasi pada jendela tampilan yang sama.

Minta Claude untuk melaporkan apa yang sebenarnya telah diperiksa, termasuk kegagalan dan pemeriksaan yang dilewati. Tinjau apakah bukti tersebut memenuhi persyaratan; hasil build yang lulus tidak menjamin bahwa setiap perilaku yang diminta berfungsi.

Untuk tugas yang lebih panjang, Claude Code juga menyediakan kondisi /goal dan Stop hooks. Penilai tujuan (goal evaluator) mengevaluasi bukti yang muncul dalam percakapan, bukan dengan memeriksa berkas secara terpisah atau menjalankan tes. Stop hook yang telah dikonfigurasi dapat menghentikan penyelesaian, namun terdapat batasan pada pemblokiran berulang. Keduanya tidak menggantikan tes yang tepat dan tinjauan manusia.

Jika perbaikan berulang kali tidak menyelesaikan masalah, hentikan sejenak dan identifikasi apa yang tidak jelas dari permintaan awal. Simpan temuan yang berguna, status Git saat ini, dan pekerjaan yang tersisa sebelum menghapus percakapan.

Panduan praktik terbaik dari Anthropic merekomendasikan untuk memulai dari awal setelah dua kali koreksi yang tidak berhasil pada masalah yang sama. Gunakan perintah /clear, lalu berikan prompt yang telah direvisi yang mencakup hal-hal yang telah Anda pelajari. Menghapus riwayat percakapan tidak akan membatalkan perubahan pada file.

Tekan Esc untuk menghentikan respons yang sedang berjalan. Jika input prompt kosong, tekan Esc dua kali untuk membuka menu rewind dan pilih apa yang ingin dipulihkan. Fitur rewind tidak membatalkan semua efek eksternal, jadi gunakan titik pemeriksaan Git dan prosedur pemulihan terpisah untuk perubahan pada basis data atau layanan jarak jauh.

Simpan panduan untuk seluruh proyek dalam berkas CLAUDE.md, prosedur yang dapat diulang dalam "skills", dan instruksi untuk berkas tertentu dalam aturan yang berlaku pada jalur (path-scoped rules). Gunakan "hooks" untuk tindakan yang terkait dengan peristiwa tertentu, seperti menjalankan formatter setelah pengeditan.

Pilih berdasarkan kapan instruksi tersebut harus diterapkan:

Persyaratan untuk satu fitur biasanya sebaiknya dicantumkan dalam prompt tugas atau spesifikasinya, bukan di berkas CLAUDE.md. Menambahkan instruksi sementara ke berkas yang berlaku untuk seluruh proyek akan membuatnya lebih sulit dibedakan dari konvensi yang seharusnya berlaku di seluruh repositori.

Misalnya, simpan perintah pengujian proyek di berkas CLAUDE.md, letakkan konvensi khusus komponen dalam aturan yang berlaku pada jalur tertentu, dan simpan prosedur tinjauan berulang sebagai keterampilan. Tinjau berkas-berkas ini ketika perintah atau konvensi berubah, sama seperti yang Anda lakukan pada dokumentasi proyek lainnya.

Prompt, berkas CLAUDE.md, dan panduan keterampilan mengatur perilaku Claude; namun, hal-hal tersebut tidak menjamin bahwa suatu instruksi akan diikuti. Hook dapat menjalankan pemeriksaan pada peristiwa yang telah dikonfigurasi, tetapi keandalannya bergantung pada jenis hook dan implementasinya.

Hook perintah menjalankan skrip. Hook prompt atau agen bergantung pada penilaian model. Sebagaimana dijelaskan dalam panduan praktik terbaik Anthropic: “Hook prompt atau agen meminta model lain untuk mengambil keputusan, sehingga hasilnya juga tidak deterministik.” Untuk aturan yang harus ditegakkan, gunakan kontrol izin yang sesuai dan uji hook perintah atau HTTP yang relevan, termasuk cara hook tersebut menangani kegagalan.

Subagen khusus merupakan cara lain untuk mengatur pekerjaan yang berulang. Tentukan spesialis di claude/agents/ jika diperlukan peran tinjauan atau cakupan alat yang berbeda, daripada menambahkan setiap instruksi spesialis ke sesi utama. Panduan mengenai model Claude terbaik untuk pekerjaan dan jenis-jenis agen AI ini memberikan konteks tambahan.

Jika tim Anda mengelola prompt di beberapa produk AI, lihat alat rekayasa prompt ini untuk mengelola pustaka di luar Claude Code.

Jika suatu sesi menghasilkan hasil yang tidak lengkap atau tidak sesuai, periksa apakah permintaan tersebut meninggalkan keputusan penting yang belum diselesaikan. Lima kesalahan ini dapat mempersulit proses diagnosis dan tinjauan.

“Selidiki repositori” memberikan sedikit petunjuk kepada Claude mengenai file mana yang penting atau kapan harus berhenti. Anda mungkin menerima ringkasan yang luas tanpa jawaban atas masalah yang menjadi dasar permintaan tersebut.

Sebutkan perilaku atau keputusan yang perlu Anda pahami, tentukan titik awal, dan tentukan hasil yang diharapkan. Contoh: “Telusuri bagaimana titik akhir ini memeriksa izin dan sebutkan fungsi-fungsi yang relevan.” Jika Anda menggunakan subagen, berikan pertanyaan yang terbatas kepada masing-masing subagen daripada mendelegasikan pencarian yang tidak terbatas yang sama.

Beralih antara fitur, bug yang tidak terkait, dan permintaan dokumentasi membuat percakapan tetap membawa konteks yang mungkin tidak berlaku untuk tugas saat ini. Referensi seperti “file itu” atau “pendekatan sebelumnya” menjadi ambigu.

Gunakan sesi terpisah untuk pekerjaan yang tidak terkait. Jika beberapa sesi akan mengedit repositori, gunakan Git worktrees terpisah agar mereka tidak memodifikasi direktori kerja yang sama. Sebagai pertanyaan sampingan singkat, perintah /btw di Claude Code menjaga percakapan tersebut agar tidak masuk ke riwayat percakapan utama.

Sebuah build bisa lulus meskipun suatu fitur berperilaku tidak benar. Sebuah rangkaian uji bisa lulus karena tidak pernah menguji input yang menyebabkan kegagalan. Meminta Claude untuk “menjalankan uji” tidak menentukan persyaratan mana yang diverifikasi oleh uji-uji tersebut.

Hubungkan kriteria penerimaan dengan pemeriksaan spesifik. Untuk perbaikan bug, mintalah bukti bahwa uji reproduksi gagal sebelum perubahan dilakukan dan berhasil setelahnya. Tetap tampilkan kriteria yang belum diuji daripada menganggap satu perintah yang berhasil sebagai verifikasi atas seluruh perubahan.

Berkas CLAUDE.md yang terus berkembang dapat berisi perintah yang sudah usang, aturan yang berulang, dan instruksi yang bertentangan dengan persyaratan khusus tugas. Menambahkan kalimat yang lebih tegas tidak akan menyelesaikan konflik-konflik tersebut.

Tinjau berkas tersebut berdasarkan repositori terkini. Hapus panduan yang sudah tidak berlaku, perjelas aturan yang bertentangan, dan pindahkan instruksi yang berlaku secara terbatas ke dalam aturan atau keterampilan yang memiliki cakupan jalur. Jika suatu persyaratan perlu ditegakkan, konfigurasikan dan uji kontrol yang sesuai daripada mengandalkan pengingat berulang.

Sebuah tinjauan dapat mengidentifikasi cacat yang nyata, masalah yang belum pasti, dan saran refaktoring opsional secara bersamaan. Menerapkan setiap saran dapat memperluas cakupan perubahan tanpa meningkatkan perilaku yang diminta.

Mintalah bukti dan dampak di balik setiap temuan. Prioritaskan masalah kebenaran dan persyaratan yang belum terpenuhi, selidiki klaim yang tidak pasti, dan hindari memasukkan perbaikan yang tidak terkait ke dalam diff saat ini. Seorang peninjau harus dapat melaporkan tidak ada temuan yang memerlukan tindakan jika bukti mendukung kesimpulan tersebut.

Untuk menyesuaikan templat, ganti placeholder-nya dengan detail dari proyek Anda dan tentukan apa yang harus dilakukan Claude sebelum melakukan perubahan. Gunakan langkah-langkah ini untuk menyiapkan permintaan dan meninjau hasilnya.

Untuk perubahan kecil yang terdefinisi dengan jelas, Anda dapat meminta Claude untuk langsung mengimplementasikannya. Untuk kode yang belum dikenal, perubahan yang melibatkan beberapa berkas, atau persyaratan yang belum jelas, mulailah dengan membuat rencana.

Tekan Shift+Tab hingga mode Plan muncul, atau jalankan Claude Code dengan perintah claude --permission-mode plan. Dalam mode ini, Claude dapat memeriksa berkas dan menjalankan perintah read-only tanpa mengedit kode sumber Anda. Tinjau berkas, dependensi, dan pengujian yang diusulkan sebelum menyetujui implementasinya. Tekan Ctrl+G untuk membuka rencana yang diusulkan di editor Anda.

Berikan Claude bukti yang diperlukan untuk memahami tugas tersebut: referensi berkas, log kesalahan yang telah disaring, tangkapan layar, atau dokumen persyaratan. Gunakan simbol @ diikuti dengan jalur berkas untuk menyertakan isi berkas tersebut.

Pilih kumpulan sumber data terkecil yang berguna. Menyertakan log atau direktori secara utuh dapat menambah materi yang tidak relevan dan menghabiskan konteks. Hapus kredensial dan data sensitif sebelum membagikan log, serta pastikan Claude memiliki alat yang diperlukan untuk mengakses URL dokumentasi yang Anda berikan.

Misalnya, perintah `cat error.log | claude -p "Jelaskan kesalahan ini"` mengirimkan log melalui permintaan non-interaktif. Gunakan perintah ini hanya setelah memeriksa isi berkas tersebut. Inilah nilai praktis dari AI kontekstual: memberikan informasi yang relevan kepada model untuk tugas yang sedang dikerjakan.

Saat menambahkan fitur, identifikasi komponen atau fungsi serupa di repositori. Beritahu Claude konvensi mana yang harus diikuti, seperti klien API, logika validasi, penanganan kesalahan, atau struktur pengujian.

“Ikuti cara @src/widgets/Weather.tsx mengambil dan menyimpan data dalam cache” memberikan referensi konkret kepada Claude. Sebutkan juga perbedaan apa pun yang diperlukan oleh fitur baru tersebut agar Claude tidak meniru perilaku yang sudah tidak sesuai lagi. Konvensi-konvensi ini harus mencerminkan alur kerja pengembangan perangkat lunak tim Anda.

Untuk perubahan kode, tentukan perintah pengujian, build, atau lint yang relevan beserta perilaku yang harus diperiksa. Untuk penelitian, minta referensi berkas atau ID commit. Untuk pekerjaan antarmuka pengguna (UI), berikan gambar referensi dan cara yang telah dikonfigurasi untuk menangkap implementasi pada viewport yang sama.

Minta Claude untuk melaporkan apa yang sebenarnya telah diperiksa, termasuk kegagalan dan pemeriksaan yang dilewati. Tinjau apakah bukti tersebut memenuhi persyaratan; hasil build yang lulus tidak menjamin bahwa setiap perilaku yang diminta berfungsi dengan baik.

Untuk tugas yang lebih panjang, Claude Code juga menyediakan kondisi /goal dan Stop hooks. Penilai tujuan (goal evaluator) mengevaluasi bukti yang muncul dalam percakapan, bukan dengan memeriksa berkas secara terpisah atau menjalankan tes. Stop hook yang telah dikonfigurasi dapat menghentikan penyelesaian, namun terdapat batasan pada pemblokiran berulang. Keduanya tidak menggantikan tes yang tepat dan tinjauan manusia.

Jika perbaikan berulang kali tidak menyelesaikan masalah, hentikan sejenak dan identifikasi apa yang tidak jelas dari permintaan awal. Simpan temuan yang berguna, status Git saat ini, dan pekerjaan yang tersisa sebelum menghapus percakapan.

Panduan praktik terbaik dari Anthropic merekomendasikan untuk memulai dari awal setelah dua kali koreksi yang tidak berhasil pada masalah yang sama. Gunakan perintah /clear, lalu berikan prompt yang telah direvisi yang mencakup hal-hal yang telah Anda pelajari. Menghapus riwayat percakapan tidak akan membatalkan perubahan pada file.

Tekan Esc untuk menghentikan respons yang sedang berjalan. Jika input prompt kosong, tekan Esc dua kali untuk membuka menu rewind dan pilih apa yang ingin dipulihkan. Fitur rewind tidak membatalkan semua efek eksternal, jadi gunakan titik pemeriksaan Git dan prosedur pemulihan terpisah untuk perubahan pada basis data atau layanan jarak jauh.

Simpan panduan untuk seluruh proyek dalam berkas CLAUDE.md, prosedur yang dapat diulang dalam "skills", dan instruksi untuk berkas tertentu dalam aturan yang berlaku pada jalur (path-scoped rules). Gunakan "hooks" untuk tindakan yang terkait dengan peristiwa tertentu, seperti menjalankan formatter setelah pengeditan.

Pilih berdasarkan kapan instruksi tersebut harus diterapkan:

Persyaratan untuk satu fitur biasanya sebaiknya dicantumkan dalam prompt tugas atau spesifikasinya, bukan di berkas CLAUDE.md. Menambahkan instruksi sementara ke berkas yang berlaku untuk seluruh proyek akan membuatnya lebih sulit dibedakan dari konvensi yang seharusnya berlaku di seluruh repositori.

Misalnya, simpan perintah pengujian proyek di berkas CLAUDE.md, letakkan konvensi khusus komponen dalam aturan yang berlaku pada jalur tertentu, dan simpan prosedur tinjauan berulang sebagai keterampilan. Tinjau berkas-berkas ini ketika perintah atau konvensi berubah, sama seperti yang Anda lakukan pada dokumentasi proyek lainnya.

Prompt, berkas CLAUDE.md, dan panduan keterampilan mengatur perilaku Claude; namun, hal-hal tersebut tidak menjamin bahwa suatu instruksi akan diikuti. Hook dapat menjalankan pemeriksaan pada peristiwa yang telah dikonfigurasi, tetapi keandalannya bergantung pada jenis hook dan implementasinya.

Hook perintah menjalankan skrip. Hook prompt atau agen bergantung pada penilaian model. Sebagaimana dijelaskan dalam panduan praktik terbaik Anthropic: “Hook prompt atau agen meminta model lain untuk mengambil keputusan, sehingga hasilnya juga tidak deterministik.” Untuk aturan yang harus ditegakkan, gunakan kontrol izin yang sesuai dan uji hook perintah atau HTTP yang relevan, termasuk cara hook tersebut menangani kegagalan.

Subagen khusus merupakan cara lain untuk mengatur pekerjaan yang berulang. Tentukan spesialis di claude/agents/ jika diperlukan peran tinjauan atau cakupan alat yang berbeda, daripada menambahkan setiap instruksi spesialis ke sesi utama. Panduan mengenai model Claude terbaik untuk pekerjaan dan jenis-jenis agen AI ini memberikan konteks tambahan.

Jika tim Anda mengelola prompt di beberapa produk AI, lihat alat rekayasa prompt ini untuk mengelola pustaka di luar Claude Code.

Jika suatu sesi menghasilkan hasil yang tidak lengkap atau tidak sesuai, periksa apakah permintaan tersebut meninggalkan keputusan penting yang belum diselesaikan. Lima kesalahan ini dapat mempersulit proses diagnosis dan tinjauan.

“Selidiki repositori” memberikan sedikit petunjuk kepada Claude mengenai file mana yang penting atau kapan harus berhenti. Anda mungkin menerima ringkasan yang luas tanpa jawaban atas masalah yang menjadi dasar permintaan tersebut.

Sebutkan perilaku atau keputusan yang perlu Anda pahami, tentukan titik awal, dan tentukan hasil yang diharapkan. Contoh: “Telusuri bagaimana titik akhir ini memeriksa izin dan sebutkan fungsi-fungsi yang relevan.” Jika Anda menggunakan subagen, berikan pertanyaan yang terbatas kepada masing-masing subagen daripada mendelegasikan pencarian yang tidak terbatas yang sama.

Beralih antara fitur, bug yang tidak terkait, dan permintaan dokumentasi membuat percakapan membawa konteks yang mungkin tidak relevan dengan tugas saat ini. Referensi seperti “file itu” atau “pendekatan sebelumnya” menjadi ambigu.

Gunakan sesi terpisah untuk pekerjaan yang tidak terkait. Jika beberapa sesi akan mengedit repositori, gunakan Git worktrees terpisah agar mereka tidak memodifikasi direktori kerja yang sama. Sebagai pertanyaan sampingan singkat, perintah /btw di Claude Code menjaga percakapan tersebut agar tidak masuk ke riwayat percakapan utama.

Sebuah build bisa lulus meskipun suatu fitur berperilaku tidak benar. Sebuah rangkaian uji bisa lulus karena tidak pernah menguji input yang menyebabkan kegagalan. Meminta Claude untuk “menjalankan uji” tidak menentukan persyaratan mana yang diverifikasi oleh uji-uji tersebut.

Hubungkan kriteria penerimaan dengan pemeriksaan spesifik. Untuk perbaikan bug, mintalah bukti bahwa uji reproduksi gagal sebelum perubahan dilakukan dan berhasil setelahnya. Tetap tampilkan kriteria yang belum diuji daripada menganggap satu perintah yang berhasil sebagai verifikasi atas seluruh perubahan.

Berkas CLAUDE.md yang terus berkembang dapat berisi perintah yang sudah usang, aturan yang berulang, dan instruksi yang bertentangan dengan persyaratan tugas tertentu. Menambahkan kalimat yang lebih tegas tidak akan menyelesaikan konflik-konflik tersebut.

Tinjau berkas tersebut berdasarkan repositori saat ini. Hapus panduan yang sudah tidak berlaku, perjelas aturan yang bertentangan, dan pindahkan instruksi yang berlaku secara terbatas ke dalam aturan atau keterampilan yang memiliki cakupan jalur. Jika suatu persyaratan perlu ditegakkan, konfigurasikan dan uji kontrol yang sesuai daripada mengandalkan pengingat berulang.

Sebuah tinjauan dapat mengidentifikasi cacat yang nyata, masalah yang belum pasti, dan saran refaktoring opsional secara bersamaan. Menerapkan setiap saran dapat memperluas cakupan perubahan tanpa meningkatkan perilaku yang diminta.

Mintalah bukti dan dampak di balik setiap temuan. Prioritaskan masalah kebenaran dan persyaratan yang belum terpenuhi, selidiki klaim yang tidak pasti, dan hindari memasukkan perbaikan yang tidak terkait ke dalam diff saat ini. Seorang peninjau harus dapat melaporkan tidak ada temuan yang memerlukan tindakan jika bukti mendukung kesimpulan tersebut.

Untuk menyesuaikan templat, ganti placeholder-nya dengan detail dari proyek Anda dan tentukan apa yang harus dilakukan Claude sebelum melakukan perubahan. Gunakan langkah-langkah ini untuk menyiapkan permintaan dan meninjau hasilnya.

Untuk perubahan kecil yang terdefinisi dengan jelas, Anda dapat meminta Claude untuk langsung mengimplementasikannya. Untuk kode yang belum dikenal, perubahan yang melibatkan beberapa berkas, atau persyaratan yang belum jelas, mulailah dengan membuat rencana.

Tekan Shift+Tab hingga mode Plan muncul, atau jalankan Claude Code dengan perintah claude --permission-mode plan. Dalam mode ini, Claude dapat memeriksa berkas dan menjalankan perintah read-only tanpa mengedit kode sumber Anda. Tinjau berkas, dependensi, dan pengujian yang diusulkan sebelum menyetujui implementasinya. Tekan Ctrl+G untuk membuka rencana yang diusulkan di editor Anda.

Berikan Claude bukti yang diperlukan untuk memahami tugas tersebut: referensi berkas, log kesalahan yang telah disaring, tangkapan layar, atau dokumen persyaratan. Gunakan simbol @ diikuti dengan jalur berkas untuk menyertakan isi berkas tersebut.

Pilih kumpulan sumber data terkecil yang berguna. Menyertakan log atau direktori secara utuh dapat menambah materi yang tidak relevan dan menghabiskan konteks. Hapus kredensial dan data sensitif sebelum membagikan log, serta pastikan Claude memiliki alat yang diperlukan untuk mengakses URL dokumentasi yang Anda berikan.

Misalnya, perintah `cat error.log | claude -p "Jelaskan kesalahan ini"` mengirimkan log melalui permintaan non-interaktif. Gunakan perintah ini hanya setelah memeriksa isi berkas tersebut. Inilah nilai praktis dari AI kontekstual: memberikan informasi yang relevan kepada model untuk tugas yang sedang dikerjakan.

Saat menambahkan fitur, identifikasi komponen atau fungsi serupa di repositori. Beritahu Claude konvensi mana yang harus diikuti, seperti klien API, logika validasi, penanganan kesalahan, atau struktur pengujian.

“Ikuti cara @src/widgets/Weather.tsx mengambil dan menyimpan data dalam cache” memberikan referensi konkret kepada Claude. Sebutkan juga perbedaan apa pun yang diperlukan oleh fitur baru tersebut agar Claude tidak meniru perilaku yang sudah tidak sesuai lagi. Konvensi-konvensi ini harus mencerminkan alur kerja pengembangan perangkat lunak tim Anda.

Untuk perubahan kode, tentukan perintah pengujian, build, atau lint yang relevan serta perilaku yang harus diperiksa. Untuk penelitian, minta referensi berkas atau ID commit. Untuk pekerjaan antarmuka pengguna (UI), berikan gambar referensi dan cara yang telah dikonfigurasi untuk menangkap implementasi pada jendela tampilan yang sama.

Minta Claude untuk melaporkan apa yang sebenarnya telah diperiksa, termasuk kegagalan dan pemeriksaan yang dilewati. Tinjau apakah bukti tersebut memenuhi persyaratan; hasil build yang lulus tidak menjamin bahwa setiap perilaku yang diminta berfungsi dengan baik.

Untuk tugas yang lebih panjang, Claude Code juga menyediakan kondisi /goal dan Stop hooks. Penilai tujuan (goal evaluator) mengevaluasi bukti yang muncul dalam percakapan, bukan dengan memeriksa berkas secara terpisah atau menjalankan tes. Stop hook yang telah dikonfigurasi dapat menghentikan penyelesaian, namun terdapat batasan pada pemblokiran berulang. Keduanya tidak menggantikan tes yang tepat dan tinjauan manusia.

Jika perbaikan berulang kali tidak menyelesaikan masalah, hentikan sejenak dan identifikasi apa yang tidak jelas dari permintaan awal. Simpan temuan yang berguna, status Git saat ini, dan pekerjaan yang tersisa sebelum menghapus percakapan.

Panduan praktik terbaik dari Anthropic merekomendasikan untuk memulai dari awal setelah dua kali koreksi yang tidak berhasil pada masalah yang sama. Gunakan perintah /clear, lalu berikan prompt yang telah direvisi yang mencakup hal-hal yang telah Anda pelajari. Menghapus riwayat percakapan tidak akan membatalkan perubahan pada file.

Tekan Esc untuk menghentikan respons yang sedang berjalan. Jika input prompt kosong, tekan Esc dua kali untuk membuka menu rewind dan pilih apa yang ingin dipulihkan. Fitur rewind tidak membatalkan semua efek eksternal, jadi gunakan titik pemeriksaan Git dan prosedur pemulihan terpisah untuk perubahan pada basis data atau layanan jarak jauh.

Simpan panduan untuk seluruh proyek dalam berkas CLAUDE.md, prosedur yang dapat diulang dalam "skills", dan instruksi untuk berkas tertentu dalam aturan yang berlaku pada jalur (path-scoped rules). Gunakan "hooks" untuk tindakan yang terkait dengan peristiwa tertentu, seperti menjalankan formatter setelah pengeditan.

Pilih berdasarkan kapan instruksi tersebut harus diterapkan:

Persyaratan untuk satu fitur biasanya sebaiknya dicantumkan dalam prompt tugas atau spesifikasinya, bukan di berkas CLAUDE.md. Menambahkan instruksi sementara ke berkas yang berlaku untuk seluruh proyek akan membuatnya lebih sulit dibedakan dari konvensi yang seharusnya berlaku di seluruh repositori.

Misalnya, simpan perintah pengujian proyek di berkas CLAUDE.md, letakkan konvensi khusus komponen dalam aturan yang berlaku pada jalur tertentu, dan simpan prosedur tinjauan berulang sebagai keterampilan. Tinjau berkas-berkas ini ketika perintah atau konvensi berubah, sama seperti yang Anda lakukan pada dokumentasi proyek lainnya.

Prompt, berkas CLAUDE.md, dan panduan keterampilan mengatur perilaku Claude; namun, hal-hal tersebut tidak menjamin bahwa suatu instruksi akan diikuti. Hook dapat menjalankan pemeriksaan pada peristiwa yang telah dikonfigurasi, tetapi keandalannya bergantung pada jenis hook dan implementasinya.

Hook perintah menjalankan skrip. Hook prompt atau agen bergantung pada penilaian model. Sebagaimana dijelaskan dalam panduan praktik terbaik Anthropic: “Hook prompt atau agen meminta model lain untuk mengambil keputusan, sehingga hasilnya juga tidak deterministik.” Untuk aturan yang harus ditegakkan, gunakan kontrol izin yang sesuai dan uji hook perintah atau HTTP yang relevan, termasuk cara hook tersebut menangani kegagalan.

Subagen khusus merupakan cara lain untuk mengatur pekerjaan yang berulang. Tentukan spesialis di claude/agents/ jika diperlukan peran tinjauan atau cakupan alat yang berbeda, daripada menambahkan setiap instruksi spesialis ke sesi utama. Panduan mengenai model Claude terbaik untuk pekerjaan dan jenis-jenis agen AI ini memberikan konteks tambahan.

Jika tim Anda mengelola prompt di beberapa produk AI, lihat alat rekayasa prompt ini untuk mengelola pustaka di luar Claude Code.

Jika suatu sesi menghasilkan hasil yang tidak lengkap atau tidak sesuai, periksa apakah permintaan tersebut meninggalkan keputusan penting yang belum diselesaikan. Lima kesalahan ini dapat mempersulit proses diagnosis dan tinjauan.

“Selidiki repositori” memberikan sedikit petunjuk kepada Claude mengenai file mana yang penting atau kapan harus berhenti. Anda mungkin menerima ringkasan yang luas tanpa jawaban atas masalah yang menjadi dasar permintaan tersebut.

Sebutkan perilaku atau keputusan yang perlu Anda pahami, tentukan titik awal, dan tentukan hasil yang diharapkan. Contoh: “Telusuri bagaimana titik akhir ini memeriksa izin dan sebutkan fungsi-fungsi yang relevan.” Jika Anda menggunakan subagen, berikan pertanyaan yang terbatas kepada masing-masing subagen daripada mendelegasikan pencarian yang tidak terbatas yang sama.

Beralih antara fitur, bug yang tidak terkait, dan permintaan dokumentasi membuat percakapan membawa konteks yang mungkin tidak relevan dengan tugas saat ini. Referensi seperti “file itu” atau “pendekatan sebelumnya” menjadi ambigu.

Gunakan sesi terpisah untuk pekerjaan yang tidak terkait. Jika beberapa sesi akan mengedit repositori, gunakan Git worktrees terpisah agar mereka tidak memodifikasi direktori kerja yang sama. Sebagai pertanyaan sampingan singkat, perintah /btw di Claude Code menjaga percakapan tersebut agar tidak masuk ke riwayat percakapan utama.

Sebuah build bisa lulus meskipun suatu fitur berperilaku tidak benar. Suatu rangkaian uji bisa lulus karena tidak pernah menguji input yang menyebabkan kegagalan. Meminta Claude untuk “menjalankan uji” tidak menentukan persyaratan mana yang diverifikasi oleh uji-uji tersebut.

Hubungkan kriteria penerimaan dengan pemeriksaan spesifik. Untuk perbaikan bug, mintalah bukti bahwa uji reproduksi gagal sebelum perubahan dilakukan dan berhasil setelahnya. Tetap tampilkan kriteria yang belum diuji daripada menganggap satu perintah yang berhasil sebagai verifikasi atas seluruh perubahan.

Berkas CLAUDE.md yang terus berkembang dapat berisi perintah yang sudah usang, aturan yang berulang, dan instruksi yang bertentangan dengan persyaratan khusus tugas. Menambahkan kalimat yang lebih tegas tidak akan menyelesaikan konflik-konflik tersebut.

Tinjau berkas tersebut berdasarkan repositori saat ini. Hapus panduan yang sudah tidak berlaku, perjelas aturan yang bertentangan, dan pindahkan instruksi yang berlaku secara terbatas ke dalam aturan atau keterampilan yang memiliki cakupan jalur. Jika suatu persyaratan perlu ditegakkan, konfigurasikan dan uji kontrol yang sesuai daripada mengandalkan pengingat berulang.

Sebuah tinjauan dapat mengidentifikasi cacat yang nyata, masalah yang belum pasti, serta saran refaktoring opsional secara bersamaan. Menerapkan setiap saran dapat memperluas cakupan perubahan tanpa meningkatkan perilaku yang diminta.

Mintalah bukti dan dampak di balik setiap temuan. Prioritaskan masalah kebenaran dan persyaratan yang belum terpenuhi, selidiki klaim yang tidak pasti, dan hindari memasukkan perbaikan yang tidak terkait ke dalam diff saat ini. Seorang peninjau harus dapat melaporkan tidak ada temuan yang memerlukan tindakan jika bukti mendukung kesimpulan tersebut.

Untuk menyesuaikan templat, ganti placeholder-nya dengan detail dari proyek Anda dan tentukan apa yang harus dilakukan Claude sebelum melakukan perubahan. Gunakan langkah-langkah ini untuk menyiapkan permintaan dan meninjau hasilnya.

Untuk perubahan kecil yang terdefinisi dengan jelas, Anda dapat meminta Claude untuk langsung mengimplementasikannya. Untuk kode yang belum dikenal, perubahan yang melibatkan beberapa berkas, atau persyaratan yang belum jelas, mulailah dengan membuat rencana.

Tekan Shift+Tab hingga mode Plan muncul, atau jalankan Claude Code dengan perintah claude --permission-mode plan. Dalam mode ini, Claude dapat memeriksa berkas dan menjalankan perintah read-only tanpa mengedit kode sumber Anda. Tinjau berkas, dependensi, dan pengujian yang diusulkan sebelum menyetujui implementasinya. Tekan Ctrl+G untuk membuka rencana yang diusulkan di editor Anda.

Berikan Claude bukti yang diperlukan untuk memahami tugas tersebut: referensi berkas, log kesalahan yang telah disaring, tangkapan layar, atau dokumen persyaratan. Gunakan simbol @ diikuti dengan jalur berkas untuk menyertakan isi berkas tersebut.

Pilih kumpulan sumber data terkecil yang berguna. Menyertakan log atau direktori secara utuh dapat menambah materi yang tidak relevan dan menghabiskan konteks. Hapus kredensial dan data sensitif sebelum membagikan log, serta pastikan Claude memiliki alat yang diperlukan untuk mengakses URL dokumentasi yang Anda berikan.

Misalnya, perintah `cat error.log | claude -p "Jelaskan kesalahan ini"` mengirimkan log melalui permintaan non-interaktif. Gunakan perintah ini hanya setelah memeriksa isi berkas tersebut. Inilah nilai praktis dari AI kontekstual: memberikan informasi yang relevan kepada model untuk tugas yang sedang dikerjakan.

Saat menambahkan fitur, identifikasi komponen atau fungsi serupa di repositori. Beritahu Claude konvensi mana yang harus diikuti, seperti klien API, logika validasi, penanganan kesalahan, atau struktur pengujian.

“Ikuti cara @src/widgets/Weather.tsx mengambil dan menyimpan data dalam cache” memberikan referensi konkret kepada Claude. Sebutkan juga perbedaan apa pun yang diperlukan oleh fitur baru tersebut agar Claude tidak meniru perilaku yang sudah tidak sesuai lagi. Konvensi-konvensi ini harus mencerminkan alur kerja pengembangan perangkat lunak tim Anda.

Untuk perubahan kode, tentukan perintah pengujian, build, atau lint yang relevan serta perilaku yang harus diperiksa. Untuk penelitian, minta referensi berkas atau ID commit. Untuk pekerjaan antarmuka pengguna (UI), berikan gambar referensi dan cara yang telah dikonfigurasi untuk menangkap implementasi pada jendela tampilan yang sama.

Minta Claude untuk melaporkan apa yang sebenarnya telah diperiksa, termasuk kegagalan dan pemeriksaan yang dilewati. Tinjau apakah bukti tersebut memenuhi persyaratan; hasil build yang lulus tidak menjamin bahwa setiap perilaku yang diminta berfungsi.

Untuk tugas yang lebih panjang, Claude Code juga menyediakan kondisi /goal dan Stop hooks. Penilai tujuan (goal evaluator) mengevaluasi bukti yang muncul dalam percakapan, bukan dengan memeriksa berkas secara terpisah atau menjalankan tes. Stop hook yang telah dikonfigurasi dapat menghentikan penyelesaian, namun terdapat batasan pada pemblokiran berulang. Keduanya tidak menggantikan tes yang tepat dan tinjauan manusia.

Jika perbaikan berulang kali tidak menyelesaikan masalah, hentikan sejenak dan identifikasi apa yang tidak jelas dari permintaan awal. Simpan temuan yang berguna, status Git saat ini, dan pekerjaan yang tersisa sebelum menghapus percakapan.

Panduan praktik terbaik dari Anthropic merekomendasikan untuk memulai dari awal setelah dua kali koreksi yang tidak berhasil pada masalah yang sama. Gunakan perintah /clear, lalu berikan prompt yang telah direvisi yang mencakup hal-hal yang telah Anda pelajari. Menghapus riwayat percakapan tidak akan membatalkan perubahan pada file.

Tekan Esc untuk menghentikan respons yang sedang berjalan. Jika input prompt kosong, tekan Esc dua kali untuk membuka menu rewind dan pilih apa yang ingin dipulihkan. Fitur rewind tidak membatalkan semua efek eksternal, jadi gunakan titik pemeriksaan Git dan prosedur pemulihan terpisah untuk perubahan pada basis data atau layanan jarak jauh.

Simpan panduan untuk seluruh proyek dalam berkas CLAUDE.md, prosedur yang dapat diulang dalam "skills", dan instruksi untuk berkas tertentu dalam aturan yang berlaku pada jalur (path-scoped rules). Gunakan "hooks" untuk tindakan yang terkait dengan peristiwa tertentu, seperti menjalankan formatter setelah pengeditan.

Pilih berdasarkan kapan instruksi tersebut harus diterapkan:

Persyaratan untuk satu fitur biasanya sebaiknya dicantumkan dalam prompt tugas atau spesifikasinya, bukan di berkas CLAUDE.md. Menambahkan instruksi sementara ke berkas yang berlaku untuk seluruh proyek akan membuatnya lebih sulit dibedakan dari konvensi yang seharusnya berlaku di seluruh repositori.

Misalnya, simpan perintah pengujian proyek di berkas CLAUDE.md, letakkan konvensi khusus komponen dalam aturan yang berlaku pada jalur tertentu, dan simpan prosedur tinjauan berulang sebagai keterampilan. Tinjau berkas-berkas ini ketika perintah atau konvensi berubah, sama seperti yang Anda lakukan pada dokumentasi proyek lainnya.

Prompt, berkas CLAUDE.md, dan panduan keterampilan mengatur perilaku Claude; namun, hal-hal tersebut tidak menjamin bahwa suatu instruksi akan diikuti. Hook dapat menjalankan pemeriksaan pada peristiwa yang telah dikonfigurasi, tetapi keandalannya bergantung pada jenis hook dan implementasinya.

Hook perintah menjalankan skrip. Hook prompt atau agen bergantung pada penilaian model. Sebagaimana dijelaskan dalam panduan praktik terbaik Anthropic: “Hook prompt atau agen meminta model lain untuk mengambil keputusan, sehingga hasilnya juga tidak deterministik.” Untuk aturan yang harus ditegakkan, gunakan kontrol izin yang sesuai dan uji hook perintah atau HTTP yang relevan, termasuk cara hook tersebut menangani kegagalan.

Subagen khusus merupakan cara lain untuk mengatur pekerjaan yang berulang. Tentukan spesialis di claude/agents/ jika diperlukan peran tinjauan atau cakupan alat yang berbeda, daripada menambahkan setiap instruksi spesialis ke sesi utama. Panduan mengenai model Claude terbaik untuk pekerjaan dan jenis-jenis agen AI ini memberikan konteks tambahan.

Jika tim Anda mengelola prompt di beberapa produk AI, lihat alat rekayasa prompt ini untuk mengelola pustaka di luar Claude Code.

Jika suatu sesi menghasilkan hasil yang tidak lengkap atau tidak sesuai, periksa apakah permintaan tersebut meninggalkan keputusan penting yang belum diselesaikan. Lima kesalahan ini dapat mempersulit proses diagnosis dan tinjauan.

“Selidiki repositori” memberikan sedikit petunjuk kepada Claude mengenai file mana yang penting atau kapan harus berhenti. Anda mungkin menerima ringkasan yang luas tanpa jawaban atas masalah yang menjadi dasar permintaan tersebut.

Sebutkan perilaku atau keputusan yang perlu Anda pahami, tentukan titik awal, dan tentukan hasil yang diharapkan. Contoh: “Telusuri bagaimana titik akhir ini memeriksa izin dan sebutkan fungsi-fungsi yang relevan.” Jika Anda menggunakan subagen, berikan pertanyaan yang terbatas kepada masing-masing subagen daripada mendelegasikan pencarian yang tidak terbatas yang sama.

Beralih antara fitur, bug yang tidak terkait, dan permintaan dokumentasi membuat percakapan tetap membawa konteks yang mungkin tidak berlaku untuk tugas saat ini. Referensi seperti “file itu” atau “pendekatan sebelumnya” menjadi ambigu.

Gunakan sesi terpisah untuk pekerjaan yang tidak terkait. Jika beberapa sesi akan mengedit repositori, gunakan Git worktrees terpisah agar mereka tidak memodifikasi direktori kerja yang sama. Sebagai pertanyaan sampingan singkat, perintah /btw di Claude Code menjaga percakapan tersebut agar tidak masuk ke riwayat percakapan utama.

Sebuah build bisa lulus meskipun suatu fitur berperilaku tidak benar. Sebuah rangkaian uji bisa lulus karena tidak pernah menguji input yang menyebabkan kegagalan. Meminta Claude untuk “menjalankan uji” tidak menentukan persyaratan mana yang diverifikasi oleh uji-uji tersebut.

Hubungkan kriteria penerimaan dengan pemeriksaan spesifik. Untuk perbaikan bug, mintalah bukti bahwa uji reproduksi gagal sebelum perubahan dilakukan dan berhasil setelahnya. Tetap tampilkan kriteria yang belum diuji daripada menganggap satu perintah yang berhasil sebagai verifikasi atas seluruh perubahan.

Berkas CLAUDE.md yang terus berkembang dapat berisi perintah yang sudah usang, aturan yang berulang, dan instruksi yang bertentangan dengan persyaratan khusus tugas. Menambahkan kalimat yang lebih tegas tidak akan menyelesaikan konflik-konflik tersebut.

Tinjau berkas tersebut berdasarkan repositori terkini. Hapus panduan yang sudah tidak berlaku, perjelas aturan yang bertentangan, dan pindahkan instruksi yang berlaku secara terbatas ke dalam aturan atau keterampilan yang memiliki cakupan jalur. Jika suatu persyaratan perlu ditegakkan, konfigurasikan dan uji kontrol yang sesuai daripada mengandalkan pengingat berulang.

Sebuah tinjauan dapat mengidentifikasi cacat yang nyata, masalah yang belum pasti, serta saran refaktoring opsional secara bersamaan. Menerapkan setiap saran dapat memperluas cakupan perubahan tanpa meningkatkan perilaku yang diminta.

Mintalah bukti dan dampak di balik setiap temuan. Prioritaskan masalah kebenaran dan persyaratan yang belum terpenuhi, selidiki klaim yang tidak pasti, dan hindari memasukkan perbaikan yang tidak terkait ke dalam diff saat ini. Seorang peninjau harus dapat melaporkan tidak ada temuan yang memerlukan tindakan jika bukti mendukung kesimpulan tersebut.

Untuk menyesuaikan templat, ganti placeholder-nya dengan detail dari proyek Anda dan tentukan apa yang harus dilakukan Claude sebelum melakukan perubahan. Gunakan langkah-langkah ini untuk menyiapkan permintaan dan meninjau hasilnya.

Untuk perubahan kecil yang terdefinisi dengan jelas, Anda dapat meminta Claude untuk langsung mengimplementasikannya. Untuk kode yang belum dikenal, perubahan yang melibatkan beberapa berkas, atau persyaratan yang belum jelas, mulailah dengan membuat rencana.

Tekan Shift+Tab hingga mode Plan muncul, atau jalankan Claude Code dengan perintah claude --permission-mode plan. Dalam mode ini, Claude dapat memeriksa berkas dan menjalankan perintah read-only tanpa mengedit kode sumber Anda. Tinjau berkas, dependensi, dan pengujian yang diusulkan sebelum menyetujui implementasinya. Tekan Ctrl+G untuk membuka rencana yang diusulkan di editor Anda.

Berikan Claude bukti yang diperlukan untuk memahami tugas tersebut: referensi berkas, log kesalahan yang telah disaring, tangkapan layar, atau dokumen persyaratan. Gunakan simbol @ diikuti dengan jalur berkas untuk menyertakan isi berkas tersebut.

Pilih kumpulan sumber data terkecil yang berguna. Menyertakan log atau direktori secara utuh dapat menambah materi yang tidak relevan dan menghabiskan konteks. Hapus kredensial dan data sensitif sebelum membagikan log, serta pastikan Claude memiliki alat yang diperlukan untuk mengakses URL dokumentasi yang Anda berikan.

Misalnya, perintah `cat error.log | claude -p "Jelaskan kesalahan ini"` mengirimkan log melalui permintaan non-interaktif. Gunakan perintah ini hanya setelah memeriksa isi berkas tersebut. Inilah nilai praktis dari AI kontekstual: memberikan informasi yang relevan kepada model untuk tugas yang sedang dikerjakan.

Saat menambahkan fitur, identifikasi komponen atau fungsi serupa di repositori. Beritahu Claude konvensi mana yang harus diikuti, seperti klien API, logika validasi, penanganan kesalahan, atau struktur pengujian.

“Ikuti cara @src/widgets/Weather.tsx mengambil dan menyimpan data dalam cache” memberikan referensi konkret kepada Claude. Sebutkan juga perbedaan apa pun yang diperlukan oleh fitur baru tersebut agar Claude tidak meniru perilaku yang sudah tidak sesuai lagi. Konvensi-konvensi ini harus mencerminkan alur kerja pengembangan perangkat lunak tim Anda.

Untuk perubahan kode, tentukan perintah pengujian, build, atau lint yang relevan serta perilaku yang harus diperiksa. Untuk penelitian, minta referensi berkas atau ID commit. Untuk pekerjaan antarmuka pengguna (UI), berikan gambar referensi dan cara yang telah dikonfigurasi untuk menangkap implementasi pada jendela tampilan yang sama.

Minta Claude untuk melaporkan apa yang sebenarnya telah diperiksa, termasuk kegagalan dan pemeriksaan yang dilewati. Tinjau apakah bukti tersebut memenuhi persyaratan; hasil build yang lulus tidak menjamin bahwa setiap perilaku yang diminta berfungsi dengan baik.

Untuk tugas yang lebih panjang, Claude Code juga menyediakan kondisi /goal dan Stop hooks. Penilai tujuan (goal evaluator) mengevaluasi bukti yang muncul dalam percakapan, bukan dengan memeriksa berkas secara terpisah atau menjalankan tes. Stop hook yang telah dikonfigurasi dapat menghentikan penyelesaian, namun terdapat batasan pada pemblokiran berulang. Keduanya tidak menggantikan tes yang tepat dan tinjauan manusia.

Jika perbaikan berulang kali tidak menyelesaikan masalah, hentikan sejenak dan identifikasi apa yang tidak jelas dari permintaan awal. Simpan temuan yang berguna, status Git saat ini, dan pekerjaan yang tersisa sebelum menghapus percakapan.

Panduan praktik terbaik dari Anthropic merekomendasikan untuk memulai dari awal setelah dua kali koreksi yang tidak berhasil pada masalah yang sama. Gunakan perintah /clear, lalu berikan prompt yang telah direvisi yang mencakup hal-hal yang telah Anda pelajari. Menghapus riwayat percakapan tidak akan membatalkan perubahan pada file.

Tekan Esc untuk menghentikan respons yang sedang berjalan. Jika input prompt kosong, tekan Esc dua kali untuk membuka menu rewind dan pilih apa yang ingin dipulihkan. Fitur rewind tidak membatalkan semua efek eksternal, jadi gunakan titik pemeriksaan Git dan prosedur pemulihan terpisah untuk perubahan pada basis data atau layanan jarak jauh.

Simpan panduan untuk seluruh proyek dalam berkas CLAUDE.md, prosedur yang dapat diulang dalam "skills", dan instruksi untuk berkas tertentu dalam aturan yang berlaku pada jalur (path-scoped rules). Gunakan "hooks" untuk tindakan yang terkait dengan peristiwa tertentu, seperti menjalankan formatter setelah pengeditan.

Pilih berdasarkan kapan instruksi tersebut harus diterapkan:

Persyaratan untuk satu fitur biasanya sebaiknya dicantumkan dalam prompt tugas atau spesifikasinya, bukan di berkas CLAUDE.md. Menambahkan instruksi sementara ke berkas yang berlaku untuk seluruh proyek akan membuatnya lebih sulit dibedakan dari konvensi yang seharusnya berlaku di seluruh repositori.

Misalnya, simpan perintah pengujian proyek di berkas CLAUDE.md, letakkan konvensi khusus komponen dalam aturan yang berlaku pada jalur tertentu, dan simpan prosedur tinjauan berulang sebagai keterampilan. Tinjau berkas-berkas ini ketika perintah atau konvensi berubah, sama seperti yang Anda lakukan pada dokumentasi proyek lainnya.

Prompt, berkas CLAUDE.md, dan panduan keterampilan mengatur perilaku Claude; namun, hal-hal tersebut tidak menjamin bahwa suatu instruksi akan diikuti. Hook dapat menjalankan pemeriksaan pada peristiwa yang telah dikonfigurasi, tetapi keandalannya bergantung pada jenis hook dan implementasinya.

Hook perintah menjalankan skrip. Hook prompt atau agen bergantung pada penilaian model. Sebagaimana dijelaskan dalam panduan praktik terbaik Anthropic: “Hook prompt atau agen meminta model lain untuk mengambil keputusan, sehingga hasilnya juga tidak deterministik.” Untuk aturan yang harus ditegakkan, gunakan kontrol izin yang sesuai dan uji hook perintah atau HTTP yang relevan, termasuk cara hook tersebut menangani kegagalan.

Subagen khusus merupakan cara lain untuk mengatur pekerjaan yang berulang. Tentukan spesialis di claude/agents/ jika diperlukan peran tinjauan atau cakupan alat yang berbeda, daripada menambahkan setiap instruksi spesialis ke sesi utama. Panduan mengenai model Claude terbaik untuk pekerjaan dan jenis-jenis agen AI ini memberikan konteks tambahan.

Jika tim Anda mengelola prompt di beberapa produk AI, lihat alat rekayasa prompt ini untuk mengelola pustaka di luar Claude Code.

Jika suatu sesi menghasilkan hasil yang tidak lengkap atau tidak sesuai, periksa apakah permintaan tersebut meninggalkan keputusan penting yang belum diselesaikan. Lima kesalahan ini dapat mempersulit proses diagnosis dan tinjauan.

“Selidiki repositori” memberikan sedikit petunjuk kepada Claude mengenai file mana yang penting atau kapan harus berhenti. Anda mungkin menerima ringkasan yang luas tanpa jawaban atas masalah yang menjadi dasar permintaan tersebut.

Sebutkan perilaku atau keputusan yang perlu Anda pahami, tentukan titik awal, dan tentukan hasil yang diharapkan. Contoh: “Telusuri bagaimana titik akhir ini memeriksa izin dan sebutkan fungsi-fungsi yang relevan.” Jika Anda menggunakan subagen, berikan pertanyaan yang terbatas kepada masing-masing subagen daripada mendelegasikan pencarian yang tidak terbatas yang sama.

Beralih antara fitur, bug yang tidak terkait, dan permintaan dokumentasi membuat percakapan tetap membawa konteks yang mungkin tidak berlaku untuk tugas saat ini. Referensi seperti “file itu” atau “pendekatan sebelumnya” menjadi ambigu.

Gunakan sesi terpisah untuk pekerjaan yang tidak terkait. Jika beberapa sesi akan mengedit repositori, gunakan Git worktrees terpisah agar mereka tidak memodifikasi direktori kerja yang sama. Sebagai pertanyaan sampingan singkat, perintah /btw di Claude Code menjaga percakapan tersebut agar tidak masuk ke riwayat percakapan utama.

Sebuah build bisa lulus meskipun suatu fitur berperilaku tidak benar. Sebuah rangkaian uji bisa lulus karena tidak pernah menguji input yang menyebabkan kegagalan. Meminta Claude untuk “menjalankan uji” tidak menentukan persyaratan mana yang diverifikasi oleh uji-uji tersebut.

Hubungkan kriteria penerimaan dengan pemeriksaan spesifik. Untuk perbaikan bug, mintalah bukti bahwa uji reproduksi gagal sebelum perubahan dilakukan dan berhasil setelahnya. Tetap tampilkan kriteria yang belum diuji daripada menganggap satu perintah yang berhasil sebagai verifikasi atas seluruh perubahan.

Berkas CLAUDE.md yang terus berkembang dapat berisi perintah yang sudah usang, aturan yang berulang, dan instruksi yang bertentangan dengan persyaratan khusus tugas. Menambahkan kalimat yang lebih tegas tidak akan menyelesaikan konflik-konflik tersebut.

Tinjau berkas tersebut berdasarkan repositori saat ini. Hapus panduan yang sudah tidak berlaku, perjelas aturan yang bertentangan, dan pindahkan instruksi yang berlaku secara terbatas ke dalam aturan atau keterampilan yang memiliki cakupan jalur. Jika suatu persyaratan perlu ditegakkan, konfigurasikan dan uji kontrol yang sesuai daripada mengandalkan pengingat berulang.

Sebuah tinjauan dapat mengidentifikasi cacat yang nyata, masalah yang belum pasti, dan saran refaktoring opsional secara bersamaan. Menerapkan setiap saran dapat memperluas cakupan perubahan tanpa meningkatkan perilaku yang diminta.

Mintalah bukti dan dampak di balik setiap temuan. Prioritaskan masalah kebenaran dan persyaratan yang belum terpenuhi, selidiki klaim yang tidak pasti, dan hindari memasukkan perbaikan yang tidak terkait ke dalam diff saat ini. Seorang peninjau harus dapat melaporkan tidak ada temuan yang memerlukan tindakan jika bukti mendukung kesimpulan tersebut.

Untuk menyesuaikan templat, ganti placeholder-nya dengan detail dari proyek Anda dan tentukan apa yang harus dilakukan Claude sebelum melakukan perubahan. Gunakan langkah-langkah ini untuk menyiapkan permintaan dan meninjau hasilnya.

Untuk perubahan kecil yang terdefinisi dengan baik, Anda dapat meminta Claude untuk langsung mengimplementasikannya. Untuk kode yang belum dikenal, perubahan yang melibatkan beberapa berkas, atau persyaratan yang belum jelas, mulailah dengan membuat rencana.

Tekan Shift+Tab hingga mode Plan muncul, atau jalankan Claude Code dengan perintah claude --permission-mode plan. Dalam mode ini, Claude dapat memeriksa berkas dan menjalankan perintah read-only tanpa mengedit kode sumber Anda. Tinjau berkas, dependensi, dan pengujian yang diusulkan sebelum menyetujui implementasinya. Tekan Ctrl+G untuk membuka rencana yang diusulkan di editor Anda.

Berikan Claude bukti yang diperlukan untuk memahami tugas tersebut: referensi berkas, log kesalahan yang telah disaring, tangkapan layar, atau dokumen persyaratan. Gunakan simbol @ diikuti dengan jalur berkas untuk menyertakan isi berkas tersebut.

Pilih kumpulan sumber data terkecil yang berguna. Menyertakan log atau direktori secara utuh dapat menambah materi yang tidak relevan dan menghabiskan konteks. Hapus kredensial dan data sensitif sebelum membagikan log, serta pastikan Claude memiliki alat yang diperlukan untuk mengakses URL dokumentasi yang Anda berikan.

Misalnya, perintah `cat error.log | claude -p "Jelaskan kesalahan ini"` mengirimkan log melalui permintaan non-interaktif. Gunakan perintah ini hanya setelah memeriksa isi berkas tersebut. Inilah nilai praktis dari AI kontekstual: memberikan informasi yang relevan kepada model untuk tugas yang sedang dikerjakan.

Saat menambahkan fitur, identifikasi komponen atau fungsi serupa di repositori. Beritahu Claude konvensi mana yang harus diikuti, seperti klien API, logika validasi, penanganan kesalahan, atau struktur pengujian.

“Ikuti cara @src/widgets/Weather.tsx mengambil dan menyimpan data dalam cache” memberikan referensi konkret kepada Claude. Sebutkan juga perbedaan apa pun yang diperlukan oleh fitur baru tersebut agar Claude tidak meniru perilaku yang sudah tidak sesuai lagi. Konvensi-konvensi ini harus mencerminkan alur kerja pengembangan perangkat lunak tim Anda.

Untuk perubahan kode, tentukan perintah pengujian, build, atau lint yang relevan beserta perilaku yang harus diperiksa. Untuk penelitian, minta referensi berkas atau ID commit. Untuk pekerjaan antarmuka pengguna (UI), berikan gambar referensi dan cara yang telah dikonfigurasi untuk menangkap implementasi pada jendela tampilan yang sama.

Minta Claude untuk melaporkan apa yang sebenarnya telah diperiksa, termasuk kegagalan dan pemeriksaan yang dilewati. Tinjau apakah bukti tersebut memenuhi persyaratan; hasil build yang lulus tidak menjamin bahwa setiap perilaku yang diminta berfungsi.

Untuk tugas yang lebih panjang, Claude Code juga menyediakan kondisi /goal dan Stop hooks. Penilai tujuan (goal evaluator) mengevaluasi bukti yang muncul dalam percakapan, bukan dengan memeriksa berkas secara terpisah atau menjalankan tes. Stop hook yang telah dikonfigurasi dapat menghentikan penyelesaian, namun terdapat batasan pada pemblokiran berulang. Keduanya tidak menggantikan tes yang tepat dan tinjauan manusia.

Jika perbaikan berulang kali tidak menyelesaikan masalah, hentikan sejenak dan identifikasi apa yang tidak jelas dari permintaan awal. Simpan temuan yang berguna, status Git saat ini, dan pekerjaan yang tersisa sebelum menghapus percakapan.

Panduan praktik terbaik dari Anthropic merekomendasikan untuk memulai dari awal setelah dua kali koreksi yang tidak berhasil pada masalah yang sama. Gunakan perintah /clear, lalu berikan prompt yang telah direvisi yang mencakup hal-hal yang telah Anda pelajari. Menghapus riwayat percakapan tidak akan membatalkan perubahan pada file.

Tekan Esc untuk menghentikan respons yang sedang berjalan. Jika input prompt kosong, tekan Esc dua kali untuk membuka menu rewind dan pilih apa yang ingin dipulihkan. Fitur rewind tidak membatalkan semua efek eksternal, jadi gunakan titik pemeriksaan Git dan prosedur pemulihan terpisah untuk perubahan pada basis data atau layanan jarak jauh.

Simpan panduan untuk seluruh proyek dalam berkas CLAUDE.md, prosedur yang dapat diulang dalam "skills", dan instruksi untuk berkas tertentu dalam aturan yang berlaku pada jalur (path-scoped rules). Gunakan "hooks" untuk tindakan yang terkait dengan peristiwa tertentu, seperti menjalankan formatter setelah pengeditan.

Pilih berdasarkan kapan instruksi tersebut harus diterapkan:

Persyaratan untuk satu fitur biasanya sebaiknya dicantumkan dalam prompt tugas atau spesifikasinya, bukan di berkas CLAUDE.md. Menambahkan instruksi sementara ke berkas yang berlaku untuk seluruh proyek akan membuatnya lebih sulit dibedakan dari konvensi yang seharusnya berlaku di seluruh repositori.

Misalnya, simpan perintah pengujian proyek di berkas CLAUDE.md, letakkan konvensi khusus komponen dalam aturan yang berlaku pada jalur tertentu, dan simpan prosedur tinjauan berulang sebagai keterampilan. Tinjau berkas-berkas ini ketika perintah atau konvensi berubah, sama seperti yang Anda lakukan pada dokumentasi proyek lainnya.

Prompt, berkas CLAUDE.md, dan panduan keterampilan mengatur perilaku Claude; namun, hal-hal tersebut tidak menjamin bahwa suatu instruksi akan diikuti. Hook dapat menjalankan pemeriksaan pada peristiwa yang telah dikonfigurasi, tetapi keandalannya bergantung pada jenis hook dan implementasinya.

Hook perintah menjalankan skrip. Hook prompt atau agen bergantung pada penilaian model. Sebagaimana dijelaskan dalam panduan praktik terbaik Anthropic: “Hook prompt atau agen meminta model lain untuk mengambil keputusan, sehingga hasilnya juga tidak deterministik.” Untuk aturan yang harus ditegakkan, gunakan kontrol izin yang sesuai dan uji hook perintah atau HTTP yang relevan, termasuk cara hook tersebut menangani kegagalan.

Subagen khusus merupakan cara lain untuk mengatur pekerjaan yang berulang. Tentukan spesialis di claude/agents/ jika diperlukan peran tinjauan atau cakupan alat yang berbeda, daripada menambahkan setiap instruksi spesialis ke sesi utama. Panduan mengenai model Claude terbaik untuk pekerjaan dan jenis-jenis agen AI ini memberikan konteks tambahan.

Jika tim Anda mengelola prompt di beberapa produk AI, lihat alat rekayasa prompt ini untuk mengelola pustaka di luar Claude Code.

Jika suatu sesi menghasilkan hasil yang tidak lengkap atau tidak sesuai, periksa apakah permintaan tersebut meninggalkan keputusan penting yang belum diselesaikan. Lima kesalahan ini dapat mempersulit proses diagnosis dan tinjauan.

“Selidiki repositori” memberikan sedikit petunjuk kepada Claude mengenai file mana yang penting atau kapan harus berhenti. Anda mungkin menerima ringkasan yang luas tanpa jawaban atas masalah yang menjadi dasar permintaan tersebut.

Sebutkan perilaku atau keputusan yang perlu Anda pahami, tentukan titik awal, dan tentukan hasil yang diharapkan. Contoh: “Telusuri bagaimana titik akhir ini memeriksa izin dan sebutkan fungsi-fungsi yang relevan.” Jika Anda menggunakan subagen, berikan pertanyaan yang terbatas kepada masing-masing subagen daripada mendelegasikan pencarian yang tidak terbatas yang sama.

Beralih antara fitur, bug yang tidak terkait, dan permintaan dokumentasi membuat percakapan membawa konteks yang mungkin tidak relevan dengan tugas saat ini. Referensi seperti “file itu” atau “pendekatan sebelumnya” menjadi ambigu.

Gunakan sesi terpisah untuk pekerjaan yang tidak terkait. Jika beberapa sesi akan mengedit repositori, gunakan Git worktrees terpisah agar mereka tidak memodifikasi direktori kerja yang sama. Sebagai pertanyaan sampingan singkat, perintah /btw di Claude Code menjaga percakapan tersebut agar tidak masuk ke riwayat percakapan utama.

Sebuah build bisa lulus meskipun suatu fitur berperilaku tidak benar. Sebuah rangkaian uji bisa lulus karena tidak pernah menguji input yang menyebabkan kegagalan. Meminta Claude untuk “menjalankan uji” tidak menentukan persyaratan mana yang diverifikasi oleh uji-uji tersebut.

Hubungkan kriteria penerimaan dengan pemeriksaan spesifik. Untuk perbaikan bug, mintalah bukti bahwa uji reproduksi gagal sebelum perubahan dilakukan dan berhasil setelahnya. Tetap tampilkan kriteria yang belum diuji daripada menganggap satu perintah yang berhasil sebagai verifikasi atas seluruh perubahan.

Berkas CLAUDE.md yang terus berkembang dapat berisi perintah yang sudah usang, aturan yang berulang, dan instruksi yang bertentangan dengan persyaratan khusus tugas. Menambahkan kalimat yang lebih tegas tidak akan menyelesaikan konflik-konflik tersebut.

Tinjau berkas tersebut berdasarkan repositori terkini. Hapus panduan yang sudah tidak berlaku, perjelas aturan yang bertentangan, dan pindahkan instruksi yang berlaku secara terbatas ke dalam aturan atau keterampilan yang memiliki cakupan jalur. Jika suatu persyaratan perlu ditegakkan, konfigurasikan dan uji kontrol yang sesuai daripada mengandalkan pengingat berulang.

Sebuah tinjauan dapat mengidentifikasi cacat yang nyata, masalah yang belum pasti, serta saran refaktoring opsional secara bersamaan. Menerapkan setiap saran dapat memperluas cakupan perubahan tanpa meningkatkan perilaku yang diminta.

Mintalah bukti dan dampak di balik setiap temuan. Prioritaskan masalah kebenaran dan persyaratan yang belum terpenuhi, selidiki klaim yang tidak pasti, dan hindari memasukkan perbaikan yang tidak terkait ke dalam diff saat ini. Seorang peninjau harus dapat melaporkan tidak ada temuan yang memerlukan tindakan jika bukti mendukung kesimpulan tersebut.