Loop triase error build Claude Code: persempit penyebab dalam 15 menit

Pecah error build sebelum meminta perbaikan

Saat build Node atau Astro gagal, mudah sekali menempel seluruh log dan meminta Claude Code memperbaiki semuanya. Ini sering mencampur baris gagal pertama, dugaan penyebab, dan cleanup yang tidak terkait.

Loop ini menerapkan template bug report dan checklist review ke kegagalan build. Targetnya adalah penyebab yang dipersempit, diagnosis kecil, dan bukti setelah fix.

Ambil bukti dengan urutan sama

Gunakan urutan status, build, lalu test jika perlu.

git status --short
npm.cmd run build
npm.cmd run test -- --runInBand

Run pertama tidak harus lulus. Tujuannya menyimpan baris gagal pertama, yang biasanya lebih dekat ke akar masalah daripada noise stack trace terakhir.

Klasifikasikan log ke empat kelompok

Tidak perlu sempurna. Dependency/import, runtime shape mismatch, test expectation drift, dan permission boundary mencakup banyak kegagalan harian.

const patterns = [
  [/Cannot find module|ERR_MODULE_NOT_FOUND/i, "dependency or import path"],
  [/TypeError:.*undefined|undefined is not/i, "runtime null or shape mismatch"],
  [/Expected.*received|AssertionError/i, "test expectation drift"],
  [/EACCES|permission denied/i, "permission or sandbox boundary"],
];

export function classifyBuildLine(line) {
  const hit = patterns.find(([regex]) => regex.test(line));
  return hit ? hit[1] : "needs manual reading";
}

Dengan pemisahan ini, Anda bisa meminta diagnosis terkecil, bukan perbaikan luas.

Prompt triase yang bisa disalin

Baca log build yang gagal ini.
Jangan usulkan refactor luas.
Kembalikan:
1. baris pertama yang gagal
2. penyebab paling mungkin
3. command diagnosis terkecil
4. perbaikan kode atau konfigurasi terkecil
5. command bukti setelah perbaikan

Baris pentingnya adalah larangan broad refactor. Triage build bekerja paling baik dengan satu hipotesis dan satu command bukti.

Kegagalan umum: terlalu cepat upgrade dependency

Setelah “Cannot find module”, menambah paket bisa menjadi noise jika masalahnya import path. Setelah “undefined”, null check luas bisa menutupi masalah frontmatter atau file generated.

Untuk situs publik, build lokal tidak cukup. Jalur revenue perlu URL publik, h1 benar, canonical, CTA, dan link Gumroad.

Langkah berikutnya

Ambil cheatsheet gratis untuk mengingat command. Beli 50 Prompt Templates untuk prompt debug dan review. Gunakan Setup Guide dan konsultasi untuk CI/CD dan produksi.