Mendekode Pesan Error Samar dalam Hitungan Detik dengan Claude Code

Berjibaku dengan pesan error adalah ritual harian developer. Error inferensi generik TypeScript dan stack trace sistem terdistribusi bisa menghabiskan berjam-jam. Serahkan ke Claude Code dan akar masalah plus perbaikan tiba dalam hitungan detik.

1. Ringkas stack trace yang masif

Langkah pertama: memahami “apa yang terjadi” dalam satu kalimat.

npm test 2>&1 | claude -p "
Ringkas output error ini menjadi:
- Ringkasan 1 baris
- Akar masalah (tebakan terbaik)
- Arah perbaikan
- Tempat-tempat yang perlu diperiksa untuk pola serupa
"

Stack trace 200 baris menjadi “Promise rejection tak tertangani. await hilang di baris 42.”

2. Terjemahkan error type TypeScript ke bahasa biasa

Error TS terlalu padat informasi sehingga tidak berguna.

claude -p "
Jelaskan error TypeScript ini dalam bahasa yang bisa dimengerti orang awam.
Lalu sebutkan 3 pola kesalahan yang kemungkinan terjadi beserta contoh perbaikan.

---
$(npx tsc --noEmit 2>&1 | head -50)
---
"

Error generik berlapis ‘Type X is not assignable to Y’ menjadi “objek User kehilangan field id.”

3. Jinakkan error borrow checker Rust

Borrow checker berhenti menjadi musuh.

cargo build 2>&1 | claude -p "
Untuk error borrow Rust ini:

1. Mengapa ini error (dalam istilah lifetime)
2. Tiga pola perbaikan:
   - Clone nilainya
   - Sesuaikan lifetime referensi
   - Rancang ulang ownership
3. Trade-off masing-masing
"

4. Misteri log Docker / Kubernetes

Pod bisa crash karena banyak alasan.

kubectl logs pod-name --previous | claude -p "
Identifikasi penyebab crash dari log ini.

Periksa:
- OOMKilled atau error aplikasi?
- Kegagalan init container?
- Env vars yang hilang?
- Kegagalan Readiness probe?

Untuk setiap kemungkinan, sarankan perintah kubectl berikutnya untuk memastikan.
"

Ia memberi tahu apa yang harus dijalankan berikutnya — bukan sekadar apa yang salah.

5. Klasifikasikan error build

Error Webpack / Vite / esbuild mencakup banyak kategori.

npm run build 2>&1 | claude -p "
Klasifikasikan error build ini ke:

A. Ketidakcocokan definisi tipe
B. Kegagalan resolusi modul
C. Error sintaks
D. Kesalahan file konfigurasi
E. Konflik versi dependensi

Lalu berikan pola penyelesaian tipikal untuk kategori tersebut.
"

6. Ekstrak pola pencegahan

Jangan hanya memperbaiki — cegah terulang.

claude -p "
Mengenai bug yang baru saja kita perbaiki (signature check yang hilang di src/payments/webhook.ts):

1. Mengapa bug ini terjadi (analisis akar masalah)?
2. Mengapa code review melewatkannya?
3. Tiga lapis pencegahan:
   - Test otomatis untuk mendeteksinya
   - Aturan lint yang melarang pola tersebut
   - Pengkodean tipe yang membuatnya mustahil
4. Apa yang perlu ditambahkan ke CLAUDE.md sebagai item checklist
"

Satu perbaikan menghasilkan tiga lapis pertahanan.

7. Deteksi error berulang di log produksi

Prioritaskan berdasarkan frekuensi dan dampak.

claude -p "
Analisis logs/error-2026-04.log:

1. 10 pola error teratas berdasarkan frekuensi
2. Frekuensi dan pengguna terdampak per pola
3. Akar masalah yang kemungkinan besar
4. Peringkat prioritas (frekuensi × dampak)

Keluarkan ke docs/error-analysis.md.
"

Waktu engineer satu jam menjadi 2 menit.

Otomasi analisis error dengan hooks

Jalankan analisis error otomatis saat test gagal.

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Bash(npm test*)",
        "hooks": [
          {
            "type": "command",
            "command": "if [ $? -ne 0 ]; then echo 'Test failed. Ask Claude to analyze.'; fi"
          }
        ]
      }
    ]
  }
}

Lihat Panduan Hooks.

Anti-Pattern

❌ Memotong stack trace

“Saya hanya menempelkan 3 baris terakhir” — penyebab sebenarnya sering terkubur di tengah. Kirim semuanya.

❌ Teks error tanpa konteks

Lewatkan apa yang sedang Anda coba lakukan, dan Anda akan dapat saran yang salah.

❌ Menerapkan perbaikan tanpa membacanya

Terutama waspadai escape as any pada saran TS. Selalu tinjau sebelum menerima.

Kesimpulan

• Biarkan Claude Code meringkas stack trace yang masif
• Terjemahkan error TS / Rust ke bahasa yang jelas
• Ekstrak penyebab + perintah berikutnya dari log K8s / Docker
• Klasifikasikan error build ke kategori yang dikenal
• Ubah setiap perbaikan menjadi 3 lapis pencegahan
• Gali log produksi untuk pola berulang

Waktu bertarung dengan error turun sekitar 10 kali lipat.

Terkait: Diagnosis error / Debugging / Logging & monitoring

Dokumentasi resmi: Anthropic Claude Code