Claude Code Harness Smoke Test: loop bukti 15 menit sebelum mempercayai agen

Tugas Claude Code yang mendekati produksi tidak perlu dimulai dari otomasi besar. Mulailah dengan smoke test kecil. Tentukan file yang boleh dibaca, file yang boleh diedit, area yang tidak boleh disentuh, dan bukti selesai.

Artikel ini untuk pengguna awal yang ingin tahu seberapa jauh pekerjaan boleh diberikan kepada agen. Pada situs pendapatan, bukti harus mencakup PDF gratis, Gumroad, dan konsultasi, bukan hanya build lokal.

Bacaan terkait: Claude Code harness engineering, first repo audit checklist, permission safety ladder.

Mengapa pola ini berhasil

Harness smoke test tidak membuktikan model selalu aman. Ia membuktikan lingkungan kerja punya batas. Perubahan artikel kecil pun bisa merusak form PDF, link produk, atau jalur konsultasi.

Lima belas menit cukup pendek untuk diulang harian. Lewati scope baca, edit terbatas, build, URL publik, dan screenshot sebelum memperbesar tugas.

Alur kerja praktis

1. Tulis tujuan dalam satu kalimat dan batasi file edit maksimal tiga
2. Catat secret, pembayaran, data pelanggan, dan deploy sebagai area terlarang
3. Tentukan build, diff, URL publik, dan screenshot sebelum mengedit
4. Untuk artikel dan landing page, masukkan cek PDF gratis, Gumroad, dan konsultasi
5. Simpan run card agar pekerjaan besok mulai dari bukti

Situasi	Langkah aman	Bukti
Artikel baru	Izinkan hanya body dan frontmatter; layout dan API tetap read-only	build dan URL publik
Halaman produk	Ubah copy dan urutan kartu; cocokkan setiap URL checkout	cek link Gumroad
Rollout tim	Mulai read-only lalu izinkan satu edit rendah risiko	diff dan screenshot

Prompt dan kode siap salin

Jalankan harness smoke test 15 menit untuk repository ini. Jangan lakukan edit besar dulu. Kembalikan goal, file yang boleh diedit, area terlarang, command bukti, cek URL publik, dan cek CTA PDF gratis/Gumroad/konsultasi.

const runCard = {
  slug: "claude-code-harness-smoke-test-loop",
  goal: "publish one safe content change",
  allowedFiles: ["site/src/content/blog-en/example.mdx"],
  blockedAreas: [".env", "billing/", "cloudflare/"],
  proof: ["npm.cmd run build", "public URL screenshot"],
  ctas: ["free PDF", "Setup Guide", "consultation"]
};

function readyForAgent(card) {
  return card.allowedFiles.length > 0 &&
    card.blockedAreas.length > 0 &&
    card.proof.some((item) => item.includes("build")) &&
    card.ctas.length >= 3;
}

console.log(readyForAgent(runCard) ? "ready" : "tighten scope");

Kode ini mengubah permintaan agen yang kabur menjadi run card. Bentuk yang sama bisa dipakai untuk PR, checklist publikasi, atau catatan sebelum konsultasi.

Tiga contoh nyata

Publikasi artikel Astro

Batasi edit pada body, heroImage, dan CTA. Build hijau belum cukup jika h1 atau CTA produksi milik halaman lain.

Perubahan UI kecil

Untuk teks tombol pun, cek wrapping mobile dan area tap. Jika tombol menuju produk, cek URL juga.

Adopsi tim pertama

Jangan mulai dari menulis kode. Petakan README, permission, test, dan area terlarang. Artefak itu menjadi agenda konsultasi.

Kegagalan yang perlu dihindari

• Meminta Claude Code memperbaiki semuanya membuat scope meledak.
• Berhenti di build lokal melewatkan fallback produksi dan CTA lama.
• Melewatkan Gumroad bisa mengirim traffic pemula ke penawaran yang salah.

Pada situs multibahasa, slug bisa benar tetapi body dan CTA lama. Periksa halaman publik, bukan hanya frontmatter.

Menghubungkan PDF gratis, Gumroad, dan konsultasi

Pembaca yang masih belajar command mulai dari cheatsheet gratis. Untuk permissions, CLAUDE.md, hooks, MCP, atau CI, gunakan Setup Guide.

Untuk prompt review dan debug yang berulang, gunakan 50 Prompt Templates. Untuk desain rollout tim, lanjut ke konsultasi. Bandingkan opsi di products.

Yang diperiksa sebelum dan sesudah terbit

Sebelum terbit, cek frontmatter, heroImage, link internal, dan Gumroad. Setelah terbit, pada lebar mobile lihat h1, awal body, dan area CTA. HTTP 200 belum cukup jika fallback.

Angka yang perlu dipantau

Pantau search traffic, PDF starts, Gumroad clicks, kunjungan produk, dan kunjungan konsultasi. Jika PV naik tanpa klik produk, tahap CTA tidak cocok.

Review operasi 30 menit

Saat harness smoke test masuk ke pekerjaan nyata, review paling berguna terjadi keesokan hari. Baca run log dan tulis scope yang diizinkan, file yang berubah, proof commands, dan halaman publik yang diperiksa. Jangan hanya menulis “sudah dicek”; simpan receipt: h1 mobile, paragraf awal, area CTA, link Gumroad, dan jalur konsultasi.

Pisahkan keyakinan operator dari perilaku pembaca. Sisi operator berarti area terlarang tidak disentuh, build punya bukti, URL publik memakai slug yang sama, dan halaman terjemahan tidak menyimpan body bahasa Inggris. Sisi pembaca berarti langkah berikut jelas: PDF gratis untuk command, Gumroad untuk bottleneck berulang, konsultasi untuk desain workflow.

Ubah review menjadi satu aturan masa depan. Jangan tambah sepuluh aturan untuk satu masalah. Tambah satu saja: bertanya sebelum mengedit layout, klik setiap URL Gumroad di produksi, atau screenshot opening body per locale. Aturan kecil yang dipakai harian lebih kuat daripada policy panjang.