Mode Perencanaan vs Eksekusi Langsung

Dalam Claude Code, Anda terus-menerus membuat satu keputusan: merencanakan terlebih dahulu atau langsung menjalankan?

Mode Rencana memungkinkan Claude menjelajah, membaca file, dan mengusulkan rencana tertulis yang Anda setujui sebelum perubahan apa pun diterapkan. Eksekusi langsung langsung membuat perubahan.

Skill tidak memilih salah satunya untuk selamanya. Skill menyesuaikan mode dengan ukuran dan kejelasan tugas. Besar atau ambigu? Rencanakan. Kecil dan jelas? Jalankan.

Mode Rencana memberi Anda empat manfaat konkret:

• Penjelajahan aman — Claude membaca dan menyelidiki tanpa menyentuh file.
• Gerbang persetujuan — Anda meninjau rencana yang diusulkan sebelum perubahan dilakukan.
• Perbandingan pendekatan — ketika ada beberapa solusi, Anda dapat melihat semuanya secara berdampingan.
• Kerangka arsitektur — keputusan desain muncul sejak awal, bukan di tengah perubahan.

Gunakan mode ini untuk perubahan besar, beberapa pendekatan yang mungkin, dan keputusan arsitektur yang sulit dibatalkan jika salah langkah.

Mode Rencana memiliki biaya tambahan: Anda membaca rencana lalu menyetujuinya. Untuk pekerjaan sepele, biaya tambahan itu hanya menjadi hambatan.

Langsung gunakan eksekusi langsung ketika perubahannya:

• Perbaikan satu file dengan perubahan yang sudah jelas.
• Dipandu oleh pelacakan tumpukan yang jelas yang menunjuk ke baris tertentu.
• Kecil, cakupannya jelas, dan risikonya rendah jika terjadi kesalahan.

Jika Anda sudah mengetahui file, baris, dan perbaikannya, perencanaan hanya akan memperlambat Anda.

Ringkas keputusan ini menjadi dua pertanyaan:

• Apakah perubahannya besar? Banyak file, modul baru, refaktor, migrasi.
• Apakah perubahannya ambigu? Persyaratan yang tidak jelas, beberapa desain yang valid, dampak yang belum diketahui.

Jika salah satunya benar, rencanakan terlebih dahulu. Jika keduanya salah — kecil dan jelas — jalankan secara langsung.

Ini mencerminkan prinsip ujian: gunakan proses yang lebih berat untuk situasi dengan ketidakpastian dan dampak tinggi; pertahankan jalur ringan tetap ringan.

Di sini, pelacakan tumpukan menyebutkan file dan penyebabnya. Hanya ada satu perbaikan yang benar dan tidak ada pilihan desain. Perencanaan tidak menambahkan apa pun.

Anda cukup meminta Claude menerapkan perbaikan tersebut, membiarkannya menggunakan Read pada file dan melakukan Edit yang tepat pada satu-satunya baris yang cocok.

Sekarang bandingkan dengan permintaan seperti "menambahkan dukungan multi-penyewa ke API". Perubahan itu menyentuh autentikasi, lapisan data, perutean, dan migrasi. Ada beberapa desain yang valid dan dampaknya luas.

Ini adalah situasi yang tepat untuk Mode Rencana: biarkan Claude menjelajahi basis kode dalam mode hanya-baca, lalu mengusulkan rencana yang Anda setujui sebelum satu pun perubahan diterapkan.

Merencanakan perubahan besar berarti membaca banyak file, dan output penemuan tersebut panjang. Menumpahkan semuanya ke konteks utama menyebabkan hilangnya perhatian akibat informasi yang hilang di tengah dan menghabiskan token.

Gunakan subagen Explore untuk memisahkan proses penemuan. Subagen ini menyelidiki dan mengembalikan ringkasan yang padat; konteks perencanaan tetap rapi. Skill dapat melakukan hal yang sama dengan context: fork untuk memisahkan output panjang.

Langkah persetujuan adalah inti dari semuanya. Rencana yang dapat Anda baca memungkinkan Anda menemukan asumsi yang keliru sebelum asumsi itu berubah menjadi 15 file yang diedit.

Ini adalah kendali deterministik dengan manusia dalam lingkaran. Pendekatan ini selaras dengan pola pikir arsitek: ketika dampaknya besar, Anda menginginkan titik pemeriksaan yang tegas, bukan harapan bahwa model telah menebak maksud Anda dengan benar. Perintah bersifat probabilistik sekitar 90%; gerbang persetujuan sepenuhnya berada dalam kendali Anda.

Terkadang Anda tidak dapat mengetahui apakah suatu tugas kecil sebelum melihatnya. Jangan menebak — selidiki secara bertahap, lalu pilih modenya.

Pola bawaan: gunakan Grep pada titik masuk, Read pada file utama, Grep pada penggunaan, lalu Read pada pemanggilnya. Jika dampaknya ternyata besar, beralihlah ke Mode Rencana; jika hanya satu bagian yang terisolasi, langsung perbaiki.

Mode Rencana tidak bekerja sendirian — mode ini berada di dalam alur kerja Claude Code Anda.

• ./CLAUDE.md bersama (dalam VCS) memberikan standar dan konvensi Anda kepada rencana sejak awal.
• TDD: minta rencana menulis pengujian yang gagal terlebih dahulu, lalu lakukan implementasi hingga semua pengujian berhasil.
• Perintah garis miring / skill di .claude/ dapat memuat alur "rencanakan fitur ini" yang dapat diulang dan dibagikan kepada tim.

Rencana menjadi kontrak; pengujian membuktikan bahwa kontrak tersebut terpenuhi.

Kedua ekstrem tersebut merugikan Anda:

• Perencanaan berlebihan untuk perbaikan satu baris yang sudah jelas dari pelacakan tumpukan membuang waktu dan menambahkan langkah persetujuan yang tidak diperlukan.
• Perencanaan yang kurang untuk refaktor besar berarti perubahan diterapkan sebelum siapa pun memvalidasi pendekatannya — tepat kesalahan mahal yang ingin dicegah oleh gerbang persetujuan.

Sesuaikan dengan ukuran dan kejelasan. Saat benar-benar ragu, condonglah pada perencanaan untuk pekerjaan besar atau ambigu, dan pada eksekusi untuk pekerjaan kecil yang jelas setelah pemeriksaan singkat.

Hal-hal penting:

• Mode Rencana untuk pekerjaan besar atau ambigu: perubahan besar, beberapa pendekatan, keputusan arsitektur, serta penjelajahan aman dengan persetujuan sebelum perubahan.
• Eksekusi langsung untuk pekerjaan kecil yang jelas: perbaikan satu file dan pelacakan tumpukan yang jelas.
• Aturan keputusan: jika perubahannya besar ATAU ambigu, rencanakan; jika kecil DAN jelas, jalankan.
• Selidiki secara bertahap (Grep -> Read -> Grep -> Read) ketika Anda belum dapat memperkirakan ukurannya sejak awal, lalu pilih.
• Pisahkan penemuan yang menghasilkan banyak output dengan subagen Explore (atau skill dengan context: fork) untuk melindungi konteks perencanaan.
• Gerbang persetujuan adalah kendali manusia yang deterministik — jangan mengabaikannya pada perubahan berdampak tinggi.