Prompt Claude Code/Codex untuk Pemula: 5 Pola Praktis

Mulai dari sini: prompt yang baik adalah brief kerja yang jelas

Saat Claude Code atau Codex memberi hasil berantakan, masalahnya sering bukan karena agent “tidak bisa coding”. Prompt-nya belum memberi batas kerja yang cukup. Prompt bukan kalimat ajaib. Prompt adalah brief kerja untuk AI coding agent: apa yang harus diubah, apa yang tidak boleh disentuh, apa definisi selesai, bukti verifikasi apa yang harus dikumpulkan, dan apa yang perlu diketahui orang berikutnya.

Panduan pemula ini mengubah ide itu menjadi 5 pola praktis: scope, konteks repository, acceptance criteria, bukti verifikasi, dan handoff. Pola ini bisa dipakai untuk bug fix, fitur kecil, pembuatan artikel, audit repository, dan review kode. Tujuannya bukan membuat wording AI yang keren. Tujuannya mengurangi tebakan.

Karena perilaku produk bisa berubah, gunakan dokumentasi resmi sebagai dasar. Mulai dari Claude Code overview, Claude Code memory, dan Claude Code settings. Untuk Codex dan workflow coding OpenAI, baca OpenAI code generation guide. Jika kamu baru mengenal tool-nya, baca juga panduan mulai Claude Code dan praktik terbaik CLAUDE.md.

Ringkasan 5 pola

Pola	Arti sederhana	Jika tidak ada
Scope	Batas tugas	Agent mengubah file yang tidak terkait
Konteks repo	Aturan dan contoh project	Output tidak mengikuti pola lokal
Acceptance criteria	Definisi selesai	“Selesai” berbeda antara kamu dan agent
Bukti verifikasi	Bukti bahwa pengecekan dilakukan	Pekerjaan berhenti di “sudah diimplementasi”
Handoff	Catatan singkat untuk sesi berikutnya	Nanti tidak jelas kenapa sesuatu diubah

Acceptance criteria adalah kondisi konkret yang harus terpenuhi sebelum perubahan diterima. Bukti verifikasi adalah tanda terima: command yang dijalankan, layar yang dicek, alur manual yang diuji, atau hal yang belum bisa diverifikasi. Handoff membantu kamu besok, rekan tim, atau agent lain melanjutkan tanpa membaca ulang seluruh percakapan.

Pola 1: buat scope yang sempit

Prompt lemah biasanya terlalu luas.

Tolong improve app ini supaya lebih bagus.

Prompt itu tidak memberi tahu apakah agent boleh menyentuh UI, API, test, copy, database schema, dependency, atau deployment. Claude Code/Codex bisa menebak, tetapi setiap tebakan menambah risiko.

Gunakan format seperti ini:

Edit hanya site/src/content/blog-id/5-tips-for-better-prompts.mdx.
Goal: membuat artikel lebih praktis untuk pemula Claude Code/Codex.

Boleh diubah:
- title, description, updatedDate, tags di frontmatter
- isi artikel

Jangan ubah:
- heroImage
- slug
- artikel lain
- konfigurasi build

Ini penting untuk situs yang punya monetization path. Rewrite yang terlalu luas bisa menghapus internal link, CTA produk, atau atribut analytics. Scope yang jelas membuat agent bebas bekerja tanpa mengubah satu update artikel menjadi refactor seluruh situs.

Untuk tugas eksplorasi, batasnya harus lebih tegas:

Baca file terkait dan berikan rencana edit saja. Jangan edit dulu.
List file yang akan diubah, alasannya, dan command verifikasi untuk setiap perubahan.

Kegagalan umum adalah berkata “cek dulu” tetapi sekaligus memberi izin edit. Jika repository belum familiar, pisahkan discovery dan implementation.

Pola 2: berikan konteks repository

Claude Code/Codex bisa membaca file, tetapi tidak otomatis tahu prioritas bisnis, keputusan style, atau kegagalan lama. Konteks repository menjelaskan “cara kerja project ini”.

Situs ini memakai Astro content collections untuk artikel MDX lokal.
Gunakan site/src/content/blog-id/claude-code-productivity-tips.mdx sebagai referensi kualitas.

Konteks project:
- Artikel harus berupa tutorial evergreen yang praktis, bukan ringkasan AI yang tipis.
- Sertakan 3 atau lebih use case konkret.
- Sertakan link resmi eksternal dan internal link.
- Pertahankan conversion path: /id/thanks/, /en/products/, /en/training/.
- Frontmatter harus valid.

Tanpa konteks ini, kamu mungkin mendapat artikel yang rapi tetapi tidak cocok untuk ClaudeCodeLab. Di sini pembaca membutuhkan prompt yang bisa disalin, contoh kegagalan, kebiasaan verifikasi, dan langkah berikutnya menuju cheatsheet, produk, atau training.

Jika konteks yang sama sering diulang, pindahkan bagian stabil ke CLAUDE.md. Tips produktivitas Claude Code menunjukkan bagaimana aturan project, command aman, dan verifikasi mengurangi penjelasan berulang.

Pola 3: tulis acceptance criteria sebelum mulai

Acceptance criteria mencegah loop “buat lebih bagus”. Prompt lemah:

Buat artikel ini lebih mudah dibaca dan lebih kuat untuk SEO.

Mudah dibaca dan SEO memang penting, tetapi belum cukup bisa dicek. Pecah menjadi kondisi:

Acceptance criteria:
- Hanya file target yang berubah.
- Description 120 karakter atau kurang.
- Setiap dari 5 pola punya contoh prompt Before/After.
- Ada template untuk bugfix, fitur baru, dan pembuatan artikel.
- Ada pitfall konkret dan cara menghindarinya.
- Ada link resmi, internal link, dan CTA yang jelas.
- Di akhir ada hasil verifikasi dan risiko tersisa.

Untuk fitur, kriterianya lebih teknis:

Acceptance criteria:
- Layout UI yang ada tetap terjaga.
- Tidak ada TypeScript type error.
- Validasi dan user-facing error state ditambahkan.
- Minimal satu test relevan ditambah atau diperbarui.
- Hasil npm test dan npm run build dilaporkan.

Kuncinya: setiap item harus bisa dicek. Jika agent tidak bisa membuktikan, ia harus bilang belum terverifikasi, bukan berpura-pura selesai.

Pola 4: minta bukti verifikasi

“Sudah diimplementasi” tidak cukup. Minta verification receipt.

Di akhir, kembalikan verification receipt:

- File yang berubah:
- Command yang dijalankan:
- Hasil:
- Cek manual:
- Belum dicek:
- Risiko tersisa:

Kebiasaan ini menangkap banyak kesalahan pemula. Ini juga membuat agent jujur saat command tidak bisa dijalankan karena dependency belum ada, test suite terlalu lambat, atau service lokal tidak tersedia. Setelah itu kamu bisa menilai apakah risikonya bisa diterima.

Jangan terlalu merangkum error. Ini lemah:

Build gagal. Perbaiki.

Ini berguna:

Command:
npm run build

Error:
Type error: Property 'name' does not exist on type 'User | undefined'.
File: src/components/Profile.tsx:15:22

Request:
Jelaskan kemungkinan penyebab, buat fix aman paling kecil, lalu jalankan ulang npm run build.

Untuk workflow yang lebih lengkap, baca verification receipt workflow. Format boleh berubah, tetapi prinsipnya tetap: jangan tutup pekerjaan tanpa bukti.

Pola 5: minta handoff note

Pekerjaan dengan agent sering melewati lebih dari satu sesi. Handoff note mencegah sesi berikutnya mengulang investigasi.

Di akhir, tulis handoff note berisi:
- Goal
- Apa yang berubah
- Apa yang tidak berubah
- Hasil verifikasi
- File yang perlu dicek berikutnya
- Risiko atau keputusan yang masih terbuka

Ini berguna untuk artikel, SEO, checkout flow, dan repository tim. Diff menunjukkan apa yang berubah, tetapi jarang menjelaskan kenapa CTA ditempatkan di bagian tertentu atau kenapa fix kecil dipilih daripada refactor besar.

Untuk tim, hubungkan ini dengan aturan handoff Claude Code. Format yang konsisten membuat sesi AI lebih mudah direview.

Template siap salin

Template bugfix

Goal:
  Memperbaiki bug dengan diff aman paling kecil.

Symptom:
  Apa yang terjadi:
  Expected behavior:
  Actual behavior:

Reproduction steps:
  1.
  2.
  3.

Scope:
  File yang boleh diedit:
  File yang tidak boleh diedit:

Repository context:
  Implementasi mirip yang harus diikuti:
  Aturan lokal yang harus dijaga:

Acceptance criteria:
  Jelaskan kemungkinan penyebab sebelum edit.
  Perbaiki root cause, bukan hanya menyembunyikan symptom.
  Tambah atau update test relevan jika memungkinkan.
  Kembalikan bukti verifikasi dan risiko tersisa.

Template fitur baru

Goal:
  Menambahkan satu fitur kecil dengan aman.

Feature:
  Perubahan yang terlihat oleh user:
  Perubahan API/database/config:

Constraints:
  Pertahankan style UI yang ada.
  Ikuti naming dan pola file saat ini.
  Jika perlu perubahan desain besar, jelaskan sebelum implementasi.

Acceptance criteria:
  Sertakan implementasi, types, error state, test, dan verification receipt.

Template artikel

Goal:
  Meningkatkan ini menjadi artikel evergreen untuk pemula.

Reader:
  Solo developer atau tim kecil yang mulai memakai Claude Code/Codex.

Required elements:
  3 atau lebih use case konkret.
  Contoh prompt Before/After.
  Pitfall spesifik dan cara memperbaiki.
  Template siap salin.
  Link resmi, internal link, dan CTA.

Acceptance criteria:
  Description 120 karakter atau kurang.
  Frontmatter valid.
  Code fences seimbang.
  Akhiri dengan self-review singkat.

Tiga use case praktis

Use case pertama adalah layar putih setelah login. Jangan hanya menulis “perbaiki dashboard”. Berikan langkah reproduksi, hasil yang diharapkan, error console sebenarnya, file yang boleh diedit, dan command verifikasi. Agent akan lebih mudah mencari root cause, bukan hanya menutup symptom.

Use case kedua adalah menambahkan field “jenis konsultasi” ke lead form. Prompt yang baik menyebut pilihan seperti training, consulting, other; rule validasi; kontrak API; event analytics; dan ekspektasi test. Ini menjaga monetization path sambil membuat diff tetap kecil.

Use case ketiga adalah pembuatan artikel. Untuk ClaudeCodeLab, prompt harus menyebut kedalaman isi, contoh konkret, failure mode, link resmi, internal link, CTA, dan paragraf akhir tentang hasil ketika workflow benar-benar dicoba. Dengan begitu artikel tidak menjadi ringkasan AI generik.

Rubrik QA prompt kecil

Sebelum mengirim prompt, beri skor dari 10.

Poin	Area	Pertanyaan
0-2	Scope	File yang boleh diedit dan dilindungi sudah jelas?
0-2	Context	Ada contoh lokal, pembaca, dan tujuan bisnis?
0-2	Acceptance	Agent tahu kapan task selesai?
0-2	Verification	Command atau cek manual disebutkan?
0-2	Handoff	Laporan akhir sudah didefinisikan?

Skor 8 atau lebih biasanya siap dikirim. Skor 5 atau kurang berarti kamu meminta agent menebak konteks manusia yang belum diberikan.

Generator brief yang bisa dijalankan

Daripada menulis “tolong baguskan”, buat bentuk brief yang sama setiap kali. Skrip ini membuat prompt-brief.md; ubah path file dan kriteria selesai sebelum memberikannya ke Claude Code atau Codex agar scope, batasan, dan verifikasi jelas sejak giliran pertama.

cat > prompt-brief.md <<'EOF'
# Task brief for Claude Code / Codex

Goal:
- Improve one article or feature without changing unrelated files.

Scope:
- May edit: site/src/content/blog/example.mdx
- Do not edit: hero images, routes, unrelated articles, billing code.

Context to read first:
- AGENTS.md
- A similar high-quality article
- The target file

Acceptance criteria:
- The intro explains who the reader is and why this matters.
- The draft includes at least three concrete examples.
- Code or prompt templates are copy-pasteable.
- Pitfalls and verification steps are explicit.
- Internal links and a natural CTA are included.

Verification:
- npm run build
- node scripts/check-code-fences.mjs
- Read the changed file once as a reviewer.

Return:
- What changed
- Checks run
- Remaining risks
EOF

CTA: jadikan pola ini workflow pribadi

Kamu tidak perlu menulis ulang pola ini dari nol setiap hari. Mulai dari cheatsheet Claude Code gratis untuk command harian dan kebiasaan aman. Jika butuh prompt pack dan material setup siap pakai, lihat ClaudeCodeLab products. Jika tim perlu merapikan CLAUDE.md, permission, review policy, verification receipt, dan rollout training, gunakan Claude Code training and consultation.

Setelah workflow ini dicoba pada artikel dan tugas situs ClaudeCodeLab, peningkatan terbesar datang dari menulis scope, acceptance criteria, dan bukti verifikasi sebelum meminta edit. Handoff note juga memangkas waktu review keesokan harinya, karena alasan di balik setiap CTA dan link masih terlihat.