Brief prompt produktif Claude Code: info pertama yang perlu diberikan pemula

Mengapa workflow ini penting

Pemula jarang gagal karena kalimat prompt kurang indah. Mereka gagal karena goal, file yang dilindungi, link revenue, dan kriteria selesai tidak jelas. Task brief pendek mengurangi tebakan dan menjaga patch pertama tetap kecil.

Workflow praktis

Tulis goal dalam satu kalimat, lalu file target, pembaca, dan alasan bisnis. Tambahkan area yang tidak boleh disentuh, link Gumroad yang harus tetap hidup, dan proof command.

Starter kit yang bisa disalin

# Claude Code task brief

## Goal
Change one clear thing:

## Context
- user or reader:
- current file/page:
- business reason:

## Constraints
- do not touch:
- keep these links working:
- proof command:

## Definition of done
- small diff
- public URL checked
- CTA path still works
- handoff note written

Use this brief before editing.
Ask up to three clarifying questions only if the goal, protected files, or proof command is missing.
Then propose the smallest safe patch and the verification receipt.

rg --files | Select-Object -First 80
git diff --name-only
cd site
npm.cmd run build

Contoh brief permintaan yang baik

Brief yang baik tidak hanya menyebut apa yang ingin diubah. Ia juga menjelaskan alasan perubahan dan batas yang tidak boleh dilanggar. Untuk edit artikel, permintaan bisa ditulis seperti ini:

Perbaiki hanya bagian pembuka dan area CTA di site/src/content/blog-id/claude-code-productive-prompt-brief.mdx. Pembacanya adalah solo developer yang baru mulai memakai Claude Code. Tujuannya adalah membantu pembaca memahami kapan cukup memakai PDF gratis, lalu kapan Prompt Templates, Setup Guide, atau konsultasi menjadi pilihan yang masuk akal. Jangan ubah frontmatter, slug, link Gumroad yang sudah ada, internal link, atau code block. Setelah selesai, jalankan node scripts/check-updated-article-quality.mjs dan laporkan apakah error untuk slug ini sudah hilang.

Contoh ini kuat karena ruang kerjanya sempit. “Hanya bagian pembuka dan area CTA” mencegah rewrite penuh. Pembaca dan tujuan bisnis juga jelas, jadi Claude Code tidak sekadar memperindah kalimat, tetapi menyesuaikan tulisan dengan langkah berikutnya yang perlu diambil pembaca.

Item yang dilindungi juga spesifik. Frontmatter memengaruhi tanggal, kategori, dan heroImage. Link Gumroad adalah jalur revenue. Internal link menjaga pembaca tetap bergerak ke artikel terkait. Code block adalah materi yang mungkin langsung disalin. Menulis batas ini di awal membuat review lebih mudah.

Contoh permintaan yang buruk

Permintaan buruk biasanya terdengar wajar tetapi terlalu terbuka:

Buat artikel ini lebih bagus untuk SEO dan konversi.

SEO bisa berarti mengganti judul, menambah keyword, memperbaiki description, menambah internal link, atau memperpanjang isi. Konversi bisa berarti CTA lebih kuat, link Gumroad lebih banyak, tabel perbandingan, atau pengalaman penulis. Tanpa batas, Claude Code dapat menghasilkan diff besar yang sulit diperiksa.

Contoh lain:

Buat lebih mudah untuk pemula dan kabari kalau selesai.

Niatnya benar, tetapi definisi selesai tidak ada. Versi yang lebih baik meminta contoh brief yang baik, contoh permintaan buruk, template pemula, serta jalur alami ke PDF gratis, materi Gumroad, dan konsultasi. Perintah verifikasi juga harus disebut agar pekerjaan tidak berhenti di riset.

Template pertama untuk pemula

Tidak perlu menulis prompt sempurna. Isi lima baris sederhana ini dulu:

Perubahan: satu hal utama yang ingin diubah
Target: file, URL, command, atau layar
Pembaca atau pengguna: siapa yang dibantu
Proteksi: file, link, perilaku, atau aturan yang tidak boleh berubah
Bukti: command atau hasil yang harus dicek

Jika ingin memperbaiki CTA halaman produk, batasi perubahan pada teks dan posisi CTA. Targetnya file MDX halaman produk. Pembacanya orang yang sudah memahami PDF gratis tetapi masih ragu apakah perlu template atau bantuan setup. Proteksinya adalah link PDF gratis, Prompt Templates, dan Setup Guide. Buktinya adalah build, cek URL publik, dan klik link.

Template ini sengaja kecil. Tujuannya membuat patch pertama mudah direview, mudah dibatalkan, dan terhubung dengan satu hasil. Setelah terbiasa, tambahkan aturan lokal seperti menjaga semua terjemahan tetap sinkron, tidak mengubah harga tanpa persetujuan, mempertahankan screenshot, atau tidak mengubah hierarki heading.

Jalur alami ke materi dan konsultasi

Brief juga membantu menentukan penawaran berikutnya. Jika pembaca masih ragu dengan command dasar, PDF gratis sudah cukup. Jika ia menulis request yang mirip berulang kali, Prompt Templates menghemat waktu. Jika ada rollout tim, izin akses, aturan review, atau link revenue, konsultasi bisa lebih murah daripada belajar lewat kesalahan produksi.

Urutannya sebaiknya jelas: berikan resource gratis yang bisa dipakai hari ini, tawarkan template saat pekerjaan mulai berulang, lalu arahkan konsultasi untuk situasi berisiko tinggi. Dengan begitu artikel terasa membantu, bukan memaksa pembelian.

Tiga contoh penggunaan nyata

Saat hanya memperbaiki CTA artikel, larang rewrite penuh dan wajibkan cek URL publik.
Saat mengedit CLAUDE.md, berikan forbidden command dan build command lebih dulu.
Saat update halaman produk, lindungi link PDF gratis, Prompt Templates, dan Setup Guide.

Kegagalan umum dan cara menghindarinya

Meminta ‘buat lebih bagus’. Biasanya diff menjadi terlalu luas.
Tidak menulis link yang dilindungi. Jalur revenue bisa hilang diam-diam.
Tidak ada definisi selesai. Claude Code bisa berhenti di riset.

Jalur PDF gratis, Gumroad, dan konsultasi

Gunakan PDF gratis sebelum menulis brief. Gunakan Prompt Templates untuk request berulang. Gunakan Setup Guide saat CLAUDE.md, hooks, dan asumsi proyek perlu stabil.

Mulai dari PDF gratis untuk membangun kebiasaan perintah dan keamanan. Gunakan Gumroad saat workflow mulai berulang, lalu konsultasi jika rollout, risiko tim, atau jalur revenue terlalu mahal untuk ditebak.

Yang saya verifikasi untuk artikel ini

Saya memisahkan brief Markdown, instruksi pendek, dan proof command. Targetnya satu perubahan, satu bukti, dan satu cek jalur revenue.