Skip to main content
Prompt

Prompt Rencana Sebelum Coding

Prompt perencanaan yang mencakup bisnis, domain, tech design, dan langkah kerja, lalu mendaftar keputusan yang perlu Anda ambil.

Oleh Matthews WongDiperbarui

Poin utama

Tempel prompt ini sebelum perubahan yang tidak sepele. Agent membaca kode yang tersentuh perubahan itu, lalu merencanakannya dari empat sudut pandang: bisnis, domain, tech design yang diverifikasi di kode sungguhan, dan langkah bernomor dengan pemeriksaan untuk tiap langkah. Agent mendaftar setiap asumsi dan setiap keputusan yang menjadi hak Anda, dan tidak menulis kode sampai Anda membalas approved.

1 file

File-nya

Persis isi unduhannya. Baca dulu, lalu salin atau unduh.

plan-before-code-prompt.md
Plan this change with me before any code is written. Do not create or edit files until I reply "approved".

The change: [WHAT I WANT BUILT OR CHANGED]
Who it is for: [THE USERS, OR THE TEAM THAT ASKED FOR IT]
Constraints: [DEADLINE, STACK, THINGS THAT MUST NOT CHANGE, OR "NONE"]

## First, read

Read the code this change touches: the files, their callers, their tests, and one existing feature of the same kind so you can follow its patterns. Read any project instruction file (CLAUDE.md, AGENTS.md, README). Name the files you read.

## Then write the plan from four points of view

Keep each one short. Write only what this task needs.

1. **Business.** Who the users are, the journey they take, what they need at each step, and the screens or outputs they expect. End with acceptance criteria I can check.
2. **Domain.** How this domain works in general, independent of this system: the usual process, roles and terms. For a warehouse that is goods receipt, putaway, picking, packing and goods issue. Mark anything you are unsure about.
3. **Tech design.** The components, data and interfaces this change adds or alters, and how it fits the code that exists. Verify every claim in the real code and cite the file. Name the one alternative you rejected, and why.
4. **Instructions.** Numbered steps. Each step says what to do, where (file path or tool), and how to verify it: the command to run and the result to expect. Order them so each step can be tested and committed on its own.

## Then list what you need from me

- **Assumptions:** every assumption you made, numbered, each with what changes if it is wrong.
- **Decisions:** every decision that is mine to make, each with the options and the one you recommend.
- **Out of scope:** what this plan deliberately leaves out.

## Rules

- When a view is missing and the code cannot answer it, do not guess. Ask whether I have that context or want you to draft it.
- Do not invent requirements, business rules, table names or APIs. If you did not read it, write "not verified".
- Plan only what was asked. No speculative features.
- No code in this reply, beyond a short signature or schema sketch where it makes the design clear.

Stop after the plan and wait. Once I approve, work one step at a time, run each step's check, show the real output, and tell me as soon as the work contradicts the plan.
Cara memakainya

Dari unduh sampai jalan

Pakai saat

  • Perubahan menyentuh lebih dari satu modul, atau data yang sulit dikembalikan.
  • Permintaannya hanya satu kalimat dan Anda sudah melihat tiga cara menafsirkannya.
  • Fitur berada di domain yang punya aturannya sendiri, seperti gudang, keuangan, atau approval.
  • Terakhir kali agent membangun hal yang salah dan Anda menanggungnya saat review.
  1. Isi tiga placeholder

    Tulis perubahan yang Anda inginkan, untuk siapa, dan batasannya: tenggat, stack, atau hal yang tidak boleh berubah. Tempel teks tiket bila ada. Tulis none bila tidak ada batasan.

  2. Periksa apa yang dibacanya

    Rencana diawali dengan nama file yang dibaca agent. Bila daftar itu tidak memuat modul yang Anda tahu terlibat, sampaikan sebelum membaca lebih jauh. Rencana yang dibangun dari file yang salah akan salah di setiap bagiannya.

  3. Jawab asumsi dan keputusannya

    Telusuri asumsi yang bernomor dan koreksi yang keliru. Pilih satu opsi untuk tiap keputusan. Daftar inilah keluaran utamanya: setiap butir adalah hal yang tanpa prompt ini akan diputuskan agent secara diam-diam.

  4. Setujui, lalu bangun selangkah demi selangkah

    Balas approved setelah rencananya benar. Agent lalu mengerjakan langkah bernomor, menjalankan pemeriksaan tiap langkah, dan menampilkan output aslinya. Agent diminta segera memberi tahu bila pekerjaan mulai bertentangan dengan rencana.

Isinya

Kenapa ditulis seperti ini

Empat sudut pandang, masing-masing singkat

Bisnis, domain, tech design, dan instruksi. Kebanyakan rencana buatan agent hanya berisi dua yang terakhir. Tanpa dua yang pertama, agent merancang solusi rapi untuk masalah yang tidak dimiliki siapa pun. Prompt ini hanya meminta apa yang dibutuhkan tugas, jadi rencananya tetap enak dibaca.

Sudut pandang domain terpisah dari sistem

Bagian ini menanyakan cara kerja domain secara umum: proses, peran, dan istilah yang lazim. Fitur yang mengabaikan cara kerja goods receipt atau rantai approval yang sebenarnya tetap bisa di-compile dan lolos test, tetapi ditolak oleh orang yang memakainya.

Tech design diverifikasi di kode sungguhan

Setiap klaim desain merujuk ke sebuah file, dan apa pun yang belum dibaca ditandai not verified. Ini pengaman terhadap rencana yang memanggil fungsi, tabel, atau endpoint yang tidak dimiliki proyek.

Setiap langkah membawa pemeriksaannya sendiri

Sebuah langkah menyebut apa yang dikerjakan, di mana, dan perintah mana yang membuktikan hasilnya. Langkah diurutkan supaya masing-masing bisa dites dan di-commit sendiri, sehingga kegagalan tetap kecil dan mudah dilacak.

Bertanya, bukan menebak

Bila satu sudut pandang kosong dan kode tidak bisa menjawabnya, agent bertanya apakah Anda punya konteks itu atau ingin dibuatkan drafnya. Asumsi, keputusan, dan hal di luar cakupan didaftar terpisah, jadi tidak ada yang diputuskan tanpa Anda lihat.

Perhatikan

Yang sering salah

  • Prompt ini berlebihan untuk perubahan kecil. Untuk fix satu file dengan penyebab yang jelas, rencananya lebih mahal daripada pekerjaannya.
  • Bagian domain berasal dari pengetahuan umum model. Proses di perusahaan Anda bisa berbeda, jadi koreksi dulu sebelum menyetujui.
  • Menyetujui tanpa membaca asumsinya menghilangkan guna prompt ini. Asumsi keliru yang Anda lewati berubah menjadi kode yang harus Anda buang.
  • Di jendela chat tanpa akses ke kode, tech design tidak bisa diverifikasi. Tempel file yang relevan, atau bagian itu akan ditandai not verified.
Pertanyaan

Yang sering ditanyakan

Jawaban singkat sebelum Anda mengunduhnya.

Bagaimana cara membuat AI coding agent merencanakan dulu sebelum menulis kode?

Beri tahu agent apa isi rencananya dan kapan ia boleh mulai. Prompt ini melarang membuat atau mengubah file sampai Anda membalas approved, meminta empat bagian ditambah asumsi dan keputusan, dan diakhiri perintah untuk berhenti dan menunggu.

Apa saja empat sudut pandang dalam rencana ini?

Bisnis: pengguna, perjalanannya, dan kebutuhannya. Domain: cara kerja bidang itu secara umum, terlepas dari sistem ini. Tech design: komponen, data, dan interface, dicek terhadap kode sungguhan. Instruksi: langkah konkret dengan path dan cara memverifikasi tiap langkah.

Apakah prompt ini masih perlu bila agent saya punya plan mode?

Keduanya punya tugas berbeda dan bisa dipakai bersama. Plan mode mengatur boleh tidaknya agent mengubah file. Prompt ini menentukan isi rencananya: sudut pandang bisnis dan domain, klaim desain yang diverifikasi, serta daftar asumsi dan keputusan.

Kapan sebuah rencana tidak perlu ditulis?

Saat perubahannya kecil, lokal, dan mudah dibatalkan: salah ketik, fix satu baris, atau label yang diganti. Pakai prompt ini bila tebakan yang salah mahal akibatnya, misalnya perubahan lintas modul, migrasi data, atau fitur yang punya aturan bisnis.

Pelajari lebih dalam

Pelajari apa yang dikemas file ini

Pelajaran dan artikel gratis di situs ini yang menjelaskan gagasan di baliknya.

Lainnya dari toolkit

Ambil ini juga

PromptGratis

Prompt untuk Memahami Codebase Baru

Prompt read-only yang memetakan repository asing: fungsinya, cara menjalankannya, alur request, dan area yang berisiko.

  • Claude Code
  • Cursor
  • Claude.ai

1 file2.3 KB.md

PromptGratis

Prompt Debugging: Reproduksi Dulu

Prompt debugging yang mewajibkan agent mereproduksi bug dan membuktikan penyebabnya sebelum menyentuh kode.

  • Claude Code
  • Cursor
  • Claude.ai

1 file2.3 KB.md

PromptGratis

Prompt Code Review: Utamakan Kebenaran

Prompt review yang melaporkan bug lengkap dengan file, baris, skenario gagal, severity, dan fix, tanpa komentar soal gaya.

  • Claude Code
  • Cursor
  • Claude.ai

1 file2.3 KB.md

Semua item toolkit