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
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.
Persis isi unduhannya. Baca dulu, lalu salin atau unduh.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Jawaban singkat sebelum Anda mengunduhnya.
Pelajaran dan artikel gratis di situs ini yang menjelaskan gagasan di baliknya.
Prompt read-only yang memetakan repository asing: fungsinya, cara menjalankannya, alur request, dan area yang berisiko.
1 file2.3 KB.md
Prompt debugging yang mewajibkan agent mereproduksi bug dan membuktikan penyebabnya sebelum menyentuh kode.
1 file2.3 KB.md
Prompt review yang melaporkan bug lengkap dengan file, baris, skenario gagal, severity, dan fix, tanpa komentar soal gaya.
1 file2.3 KB.md