Cara Memangkas Waktu Onboarding Engineer Baru dengan Claude Code

Waktu ramp-up engineer baru adalah biaya besar di setiap perusahaan. Codebase raksasa, dokumentasi tersebar, tribal knowledge. Jadikan Claude Code copilot untuk hire baru, dan ramp-up 3 bulan menyusut jadi 2 minggu.

1. Selesaikan Setup Dev Environment dalam Setengah Hari

Setup adalah tembok pertama. Alih-alih menghujani senior di Slack:

# Hire baru menjalankan ini di Mac-nya
claude -p "
Pandu saya melakukan setup dev environment untuk repo ini
(https://github.com/our-org/main-app) di macOS.

Untuk setiap langkah:
1. Tools yang diperlukan (dengan versi)
2. Perintah instalasi
3. Env vars yang perlu dikonfigurasi
4. Cara memverifikasi semuanya jalan
5. Error umum dan cara memperbaikinya

Baca .env.example dan README; berikan jawaban konkret.
"

DM Slack ke senior turun drastis.

2. Memahami Codebase dalam 5 Menit

Repo raksasa jadi mudah dicerna.

claude -p "
Jelaskan struktur keseluruhan repo ini:

1. Layout direktori dan tujuan masing-masing
2. Entry point utama
3. Alur data (bagaimana sebuah request diproses)
4. Integrasi eksternal (DB, API, queue)
5. Lima file yang harus saya baca lebih dulu

Sarankan juga urutan baca agar hire baru
bisa mulai menyentuh kode dalam seminggu.
"

Kombinasikan dengan Navigasi Codebase untuk efek maksimal.

3. Ubah Tribal Knowledge Menjadi Dokumentasi

Ungkap “kenapa begini” yang hanya diketahui veteran.

claude -p "
Untuk src/services/billing/LegacyInvoiceService.ts,
simpulkan dari git log --follow + blame:

1. Kenapa desainnya jadi seperti ini
2. Jebakan saat memodifikasi (pola bug historis)
3. Service terkait
4. Apa yang harus dicek ulang sebelum menyentuhnya

Keluarkan ke docs/onboarding/legacy-notes.md
dalam format yang mudah dianotasi rekan tim.
"

Gunakan output sebagai thread diskusi di GitHub Discussions — itu mendorong dokumentasi berbasis review.

4. Rekomendasikan Kandidat PR Pertama Otomatis

Temukan tugas kecil dan aman untuk hire baru.

claude -p "
Sarankan 5 kandidat first-PR dari repo ini:

Kriteria:
- Perubahan terisolasi (efek samping rendah)
- Test yang ada meng-cover area tersebut
- Bukan business logic inti
- Rentang diff 30-100 baris

Lihat tren good-first-issue,
komentar TODO/FIXME, dan kandidat refactor kecil.
Untuk tiap item, tambahkan estimasi effort dan apa yang diajarkannya.
"

5. Self-Review Sebelum Submit PR

Kurangi bounce-back untuk hire baru.

claude -p "
Periksa git diff origin/main...HEAD.
Lakukan self-review sebagai hire baru sebelum membuka PR:

1. Pelanggaran aturan CLAUDE.md
2. Penamaan yang janggal
3. Test yang hilang
4. Inkonsistensi gaya dengan kode existing
5. Masalah keamanan

Cantumkan hanya poin yang perlu diubah, beserta prioritasnya.
"

Bolak-balik review anjlok. Lihat Code Review dengan Claude.

6. Budaya “Tanya Claude Dulu”

Kodifikasikan dalam CLAUDE.md.

## Panduan Q&A Onboarding

### Tanya Claude Code dulu
- Cara kerja kode
- Arti pesan error
- Alasan desain (via git log + blame)
- Cara pakai tools

### Eskalasi ke Slack #dev-help hanya untuk
- Interpretasi aturan bisnis
- Keputusan prioritas
- Tugas yang butuh akses terbatas

### Saat tanya senior, sertakan
1. Apa yang kamu coba lakukan
2. Apa yang sudah kamu coba (termasuk jawaban Claude)
3. Di mana kamu stuck

Hanya ini saja memangkas gangguan ke senior ~30%.

7. Auto-Generate Retrospektif Mingguan

Untuk 1:1 bersama mentor.

claude -p "
Ringkas aktivitas saya selama seminggu terakhir:

- git log --author='new-hire-name' --since='1 week ago'
- PR yang dibuat + statusnya
- Tren feedback komentar review
- Di mana saya stuck (disimpulkan dari commit message)

Sarankan 3 topik untuk dibahas di 1:1 bersama mentor.
"

Hire baru mendapat meta-view atas pertumbuhannya sendiri.

Anti-Pattern

❌ Menyerahkan semuanya pada Claude

Claude hanya menyimpulkan tribal knowledge. Selalu verifikasi “why” bisnis dengan expert domain manusia.

❌ Menghalangi pertanyaan terlalu keras

Memaksakan “tanya Claude” secara berlebihan mengisolasi hire baru. Jadwalkan 1:1 intensif di 2 minggu pertama.

❌ Mengabaikan pemeliharaan dokumentasi

Catatan tribal knowledge yang digenerate Claude akan membusuk jika dibiarkan. Tinjau bersama tim secara berkala.

Kesimpulan

• Setup env mandiri dalam setengah hari
• Memahami codebase dalam 5 menit
• Ubah tribal knowledge jadi dokumentasi
• Otomatis merekomendasikan kandidat first PR
• Kurangi bounce-back PR dengan self-review
• Kurangi gangguan ke senior lewat budaya “Claude first”
• Auto-generate retro mingguan

Ramp-up lebih cepat = beban mentor berkurang + throughput tim meningkat.

Terkait: Navigasi Codebase / Code Review / Kolaborasi Tim

Dokumentasi resmi: Anthropic Claude Code