Cara Memvisualisasikan dan Mengurangi Tech Debt Secara Sistematis dengan Claude Code

“Kami ingin refactor tapi tidak pernah punya waktu.” “Mulai dari mana?” Tech debt menumpuk diam-diam. Dengan Claude Code, Anda dapat memunculkan, memprioritaskan, dan melunasi debt secara sistematis dengan biaya yang jauh lebih kecil dari biasanya.

1. Deteksi Code Smells di Seluruh Codebase

Mulai dengan penyisiran lengkap.

claude -p "
Scan src/ untuk mencari code smells. Periksa:

- Fungsi lebih dari 50 baris
- Nesting dalam (4+ level)
- Logika yang duplikat
- God Classes (tanggung jawab berlebihan)
- Magic number
- Export yang tidak digunakan
- Penggunaan tipe any
- Komentar TODO / FIXME

Output ke docs/tech-debt/smells.md dalam format:
| File | Line | Smell | Severity(1-5) | Suggested fix |
"

Inventaris yang diurutkan berdasarkan severity menjadi titik awal Anda.

2. Ukur Dependency Debt

Library usang dan kerentanan juga termasuk debt.

claude -p "
Analisis package.json beserta npm audit dan npm outdated:

1. Library yang butuh major update
2. Kerentanan yang diketahui
3. Paket yang tidak lagi dimaintain
4. Duplikat (misalnya moment + date-fns bercampur)

Output ke docs/tech-debt/dependencies.md dengan versi saat ini, versi terbaru, breaking change, prioritas update — sebagai tabel.
"

3. Prioritaskan dengan ICE Score

Anda tidak bisa memperbaiki semuanya. Peringkat berdasarkan Impact × Confidence × Ease.

claude -p "
Gunakan docs/tech-debt/smells.md dan dependencies.md, beri skor setiap item:

- Impact (I): efek terhadap bisnis/velocity dev (1-10)
- Confidence (C): kepastian dampak (1-10)
- Ease (E): upaya untuk memperbaiki (1-10)

Urutkan Score = I × C × E secara menurun.
Output sebagai docs/tech-debt/backlog.md.
Sertakan estimasi person-days untuk 10 teratas.
"

Skor numerik membuat argumen jelas bagi product manager.

4. Auto-Generate PR Pelunasan Kecil

Pecah pelunasan menjadi PR yang bisa direview.

claude -p "
Untuk item #1 di docs/tech-debt/backlog.md:

1. Buat branch: refactor/tech-debt-001
2. Perbaiki hanya masalah itu (tanpa perubahan perilaku)
3. Verifikasi test yang ada lolos
4. Pecah menjadi beberapa commit jika besar
5. Jalankan gh pr create

Body PR harus mencakup:
- Apa debt-nya
- Mengapa dilunasi sekarang
- Skor ICE
- Radius dampak pada kode lain
"

5. Identifikasi Hot Spot yang Belum Diuji

Area dengan coverage rendah menjadi debt masa depan.

npm test -- --coverage --coverageReporters=json

claude -p "
Analisis coverage/coverage-summary.json:

- File dengan coverage di bawah 50%
- Dari file tersebut, mana yang berisi business logic
- Prioritas untuk menambahkan test

Output ke docs/tech-debt/coverage-gaps.md.
Usulkan test case untuk 3 file teratas.
"

Gabungkan dengan Generasi Test Otomatis untuk dampak berlipat ganda.

6. Buat Pelunasan Terlihat dengan Laporan Mingguan

Tanpa visibilitas, tim menyerah.

claude -p "
Laporan tentang pelunasan tech debt minggu lalu:

- Item yang diselesaikan (cek docs/tech-debt/backlog.md)
- Debt baru yang ditemukan
- Item severity-5 yang masih terbuka
- Progres update dependency

Output ke docs/tech-debt/weekly-report-$(date +%Y-%m-%d).md.
Disesuaikan untuk pembacaan standup 5 menit.
"

Jadwalkan dengan cron Senin pagi untuk melembagakan pelunasan.

7. Hentikan Debt Baru di Gerbang

Pelunasan sia-sia jika arus masuk berlanjut. Kodifikasi aturan di CLAUDE.md.

## Aturan untuk Mencegah Tech Debt Baru

### Dilarang
- Nilai bertipe any baru (gunakan // @ts-expect-error dengan alasan jika tidak bisa dihindari)
- Logika sementara tanpa TODO
- Business logic tanpa test

### Checklist PR
- [ ] Coverage kode baru ≥ 80%
- [ ] Nol error ESLint
- [ ] Penambahan dependency dijustifikasi di PR

### Pengecualian yang Dapat Diterima
- Hotfix (dengan tiket follow-up)
- Kode POC (harus ditulis ulang sebelum produksi)

Paksa melalui pre-commit hook. Lihat Panduan Hooks.

Anti-Pattern

❌ Satu PR Refactor Raksasa

PR “perbaiki semuanya” tidak bisa direview. Satu smell = satu PR.

❌ Mencampur Perubahan Perilaku

Jangan pernah menggabungkan pekerjaan fitur dengan refactoring di PR yang sama. Beban review berlipat dua.

❌ Refactoring Tanpa Test

Jika coverage rendah, tulis test dulu, lalu refactor. Tanpa jaring pengaman berarti bug baru.

Kesimpulan

• Gunakan Claude Code untuk memunculkan smell, dependency debt, dan coverage gap
• Kuantifikasi prioritas dengan ICE scoring
• Pecah pelunasan menjadi PR kecil
• Publikasikan laporan progres mingguan
• Cegah debt baru lewat aturan CLAUDE.md
• Satu smell = satu PR

Tech debt bukan sesuatu yang diperbaiki “suatu hari nanti”. Itu sesuatu yang dilunasi sedikit setiap minggu. Claude Code menekan biaya ritme itu.

Terkait: Otomatisasi Refactoring / Modernisasi Kode Legacy / Checklist Code Review

Dokumentasi resmi: Anthropic Claude Code