Pertanyaan setup yang sama dari setiap engineer baru

Setiap engineer baru menanyakan hal yang sama di minggu pertama: bagaimana menjalankan proyek di laptop, variabel lingkungan apa yang dibutuhkan, kenapa tes gagal di CI tapi lolos lokal, siapa yang harus dihubungi kalau deploy staging macet. Senior menjawab di chat. Jawabannya tenggelam. Orang baru berikutnya bertanya lagi.

README seharusnya menjawab semua itu. Masalahnya, README diperbarui saat ada yang sempat, dan yang sempat biasanya bukan yang tahu jawabannya.

Onboarding sebagai program, bukan dokumen

Bedanya sederhana: dokumen dibaca kalau ingat, program dijalankan sampai selesai. Program onboarding engineer punya urutan yang jelas: peta sistem, setup lokal, alur kerja tim, runbook insiden, lalu satu tugas nyata, mengirim perubahan kecil sampai di-review. Engineering manager melihat modul mana yang selesai dan apakah tugasnya sudah dikirim.

Isi modulnya tidak perlu ditulis ulang. README dan runbook yang ada dimasukkan sebagai bacaan. Peta sistem cukup rekaman 20 menit dari tech lead, dan transkripnya otomatis bisa dicari.

README yang bisa ditanya

Bagian yang paling mengurangi beban senior bukan modulnya, tapi ini: README, runbook, dan ADR yang sama diindeks ke Knowledge Studio. Engineer baru bertanya “bagaimana cara menjalankan migrasi di staging” dan mendapat jawaban yang menunjuk ke bagian runbook yang relevan. Kalau dia bekerja dari Claude atau Cursor, pertanyaannya bisa langsung dari sana lewat LMS MCP, dengan hak akses yang mengikuti akunnya.

Kalau jawabannya salah atau tidak ada, itu sinyal dokumennya yang perlu diperbaiki, dan kali ini ada bukti dokumen mana yang kurang.

Perubahan proses tidak disampaikan di stand-up saja

Tools baru, aturan review baru, alur deploy baru: yang tidak hadir stand-up tidak tahu. Modul lima menit berisi apa yang berubah, mulai kapan, kenapa, plus tiga soal skenario, memastikan semua orang membaca versi yang sama sebelum tanggal berlaku. Tech lead melihat siapa yang belum.

Ukur yang benar

Ukurannya bukan berapa modul yang dibuat, tapi berapa pertanyaan setup yang masih sampai ke senior. Kalau angkanya tidak turun setelah dua batch orang baru, modul atau dokumennya yang salah, bukan orang barunya.

Program onboarding engineer dan modul perubahan proses ada di pustaka use case, lengkap dengan soal skenarionya.