Claude Code Harness Lite: pagar kecil untuk perubahan pemula

Kesalahan pertama saat memakai Claude Code di repository nyata biasanya bukan prompt yang buruk. Kesalahannya adalah membiarkan agent menyentuh terlalu banyak hal sebelum ada batas kerja. Harness Lite adalah pagar kecil: baca dulu, edit setelah itu, simpan bukti, lalu buka URL publik dan periksa CTA revenue.

Ini versi pemula dari Claude Code harness engineering. Untuk repository yang belum dikenal, gabungkan dengan repo map first pass dan permission receipt pattern agar scope mudah dijelaskan.

Tulis batas sebelum tugas

Harness Lite bukan untuk melemahkan Claude Code. Tujuannya membuat perubahan bisa dijelaskan. Sebelum edit, tentukan file yang dibaca, file yang boleh diedit, area yang dikeluarkan dari scope, command bukti, dan halaman publik yang harus dicek.

Di situs konten atau produk, urutan ini penting. Artikel, form PDF gratis, link Gumroad, dan konsultasi sering berdekatan. Perubahan copy kecil bisa memutus jalur dari traffic pencarian ke registrasi, pembelian, atau inquiry.

harness_lite:
  owner: "Masa"
  scope:
    allowed:
      - "read repository"
      - "edit selected files"
      - "run build or test"
    blocked:
      - "delete unrelated files"
      - "touch secrets"
      - "hide failed verification"
  proof:
    - "git diff reviewed"
    - "build command recorded"
    - "public URL opened"
    - "CTA path checked"

Prompt awal siap salin

Saya ingin membuat tepat satu perubahan kecil dan aman di repository ini.
Jangan edit file dulu.
Kembalikan:
1. file yang perlu dibaca
2. file yang aman diedit
3. area yang harus di luar scope
4. command bukti terkecil
5. pengecekan URL publik untuk h1, canonical, hero image, dan CTA
6. catatan untuk menjaga link PDF gratis, Gumroad, dan konsultasi

Langkah pentingnya adalah meminta batas, bukan implementasi. Setelah batas jelas, permintaan berikutnya bisa sempit: satu perubahan, satu command bukti, dan satu receipt.

Ubah bukti menjadi objek kecil

Setelah perubahan, minta Claude Code mengisi proof receipt. JavaScript di bawah sengaja sederhana agar definisi minimum sebelum commit terlihat.

const proof = {
  goal: "change one small thing",
  filesChanged: 2,
  commands: ["npm run build"],
  publicUrlChecked: true,
  ctaChecked: true,
};

export function isReadyToCommit(receipt) {
  return receipt.filesChanged <= 3 &&
    receipt.commands.length > 0 &&
    receipt.publicUrlChecked &&
    receipt.ctaChecked;
}

console.log(isReadyToCommit(proof)); // true berarti gate minimum sebelum commit terpenuhi

Ini menangkap keadaan setengah selesai: build lulus tetapi URL publik belum dibuka; halaman 200 OK tetapi artikel salah; body benar tetapi CTA Gumroad atau konsultasi menuju tempat yang salah.

Tiga contoh nyata

• Untuk edit artikel Astro, batasi scope ke satu MDX, satu hero image, dan satu halaman produk terkait. Setelah deploy, cek h1, awal body, canonical, form PDF, tombol Gumroad, dan link konsultasi.
• Untuk fix React kecil, batasi ke komponen target, test terdekat, dan screenshot atau Storybook. Auth, billing, secrets, dan migration keluar dari pass pertama.
• Untuk adopsi tim, tulis safe command, area terlindungi, format receipt, dan rollback note di CLAUDE.md. Orang berikutnya mulai dari aturan yang sama.

Kegagalan umum

Kegagalan umum adalah memulai dengan “cek dan perbaiki semuanya”. Claude Code akan membantu terlalu luas, diff membesar, dan bukti menjadi kabur. Kegagalan lain adalah menganggap build lokal sama dengan publikasi. Route publik bisa HTTP 200 tetapi masih menampilkan fallback atau artikel lama.

Jalur revenue juga bisa rusak. Body menyarankan PDF gratis tetapi CTA akhir mengirim ke produk lain. Artikel multilingual tidak menjelaskan bahwa Gumroad saat ini jalur self-serve utama dalam bahasa Inggris. Link konsultasi ada, tetapi copy tidak menjelaskan kapan call lebih tepat daripada guide. Harness Lite memasukkan check itu ke dalam tugas.

PDF gratis, Gumroad, dan konsultasi

Gunakan free cheatsheet jika masih belajar command dan kebiasaan aman. Gunakan 50 Prompt Templates jika prompt review, debugging, dan refactor terus berulang. Gunakan Setup Guide jika permission, CLAUDE.md, hooks, MCP, atau CI/CD menjadi bottleneck. Gunakan konsultasi saat workflow, tim, atau revenue path butuh keputusan manusia.

Yang diverifikasi di artikel ini

Artikel ini berisi harness ringan, prompt awal, objek bukti, contoh nyata, failure case, serta jalur PDF gratis, Gumroad, dan konsultasi. Angka berikutnya adalah registrasi PDF, klik Gumroad, dan kunjungan konsultasi dari slug ini.

Catatan operasional setelah publikasi

Saat pola ini dipakai di produksi, jangan berhenti di “file sudah ada”. Pekerjaan selesai ketika URL publik membuat pembaca bisa memilih langkah berikutnya. Pada lebar mobile, cek h1, awal body, hero image, form PDF gratis, link Gumroad, dan link konsultasi. Jika body benar tetapi CTA akhir menuju produk salah, revenue path belum selesai.

Untuk artikel lokal, slug yang sama belum cukup. Cek awal body dan bahasa CTA untuk Jepang, Inggris, China, Korea, Spanyol, Prancis, Jerman, Portugis, Hindi, dan Indonesia. Judul diterjemahkan tetapi body atau CTA tetap Inggris adalah lokalisasi gagal karena pembaca tidak bisa percaya langkah berikutnya.

Untuk perbaikan berikutnya, lihat lebih dari PV. Masukkan PDF signup starts, klik Gumroad, kunjungan Products, kunjungan Training, country mix, dan search source ke brief yang sama. Claude Code membuat keputusan revenue lebih baik ketika angka menunjukkan apakah harus memperkuat aset gratis, Prompt Templates, Setup Guide, atau konsultasi.