Claude Code Repo Onboarding Map: memilih tugas aman pertama tanpa menebak

Hari pertama di repo yang sudah ada menentukan apakah Claude Code membantu atau menambah noise. Meminta “lihat semua dan perbaiki” terasa cepat, tetapi menyembunyikan scope, risiko, dan definisi selesai.

Panduan ini mengubah 30 menit pertama menjadi repo onboarding map. Ini bukan dokumen arsitektur besar, melainkan peta minimum agar Claude Code memilih satu tugas pertama yang aman.

Bacaan terkait: claude-code-getting-started-complete, claude-code-existing-codebase-map, claude-code-first-30-minutes-checklist. Baseline instalasi resmi ada di Anthropic Claude Code getting started.

Mengapa ini perlu sebelum command pertama

Pusat topik ini adalah urutan baca, area terlindungi, edit pertama, dan proof command. Claude Code bisa bergerak cepat, tetapi jika input pertama terlalu luas, diff bernilai rendah, hipotesis lama, dan formatting yang tidak terkait revenue bisa dianggap sama pentingnya dengan pekerjaan utama.

Untuk developer beginner sampai intermediate yang masuk ke codebase lama, tujuannya bukan membuat pekerjaan terlihat besar. Tujuannya adalah menyatakan apa yang dibaca, apa yang tidak disentuh, apa yang dicoba dulu, dan ke mana kembali saat gagal. Ini berlaku untuk content operations maupun product engineering.

Workflow praktis

1. Baca dulu README, package.json, dan satu route utama
2. Tulis area terlindungi sebelum menyarankan edit
3. Pilih tugas yang mudah dibalik seperti copy, CTA, atau nama test
4. Tetapkan bukti lewat build, diff, dan URL publik

Urutan ini mengubah permintaan dari “pikirkan bebas” menjadi “bekerja dalam batas ini dan tinggalkan proof”. Claude Code tetap bisa bernalar, tetapi area berbahaya sudah ditutup sebelum edit pertama.

Situasi	Langkah aman	Bukti yang disimpan
Content site	Perbaiki hanya CTA bawah artikel populer dan cek link Gumroad	build, diff, URL
SaaS	Jelaskan copy settings tanpa menyentuh billing	build, diff, URL
Internal tool	Ganti nama satu kolom CSV lalu cek dengan sample data	build, diff, URL

Dengan bukti ini, Claude Code dinilai dari pekerjaan yang terlihat, bukan dari kalimat yang percaya diri.

Prompt dan kode yang bisa disalin

Buat onboarding map untuk tugas Claude Code pertama di repo ini. Baca hanya README, package.json, dan file route utama. Kembalikan tabel area terlindungi, tugas kecil paling berguna, dan proof command. Jangan edit dulu.

const repoMap = {
  goal: "find one safe first task",
  readFirst: ["README.md", "package.json", "src/routes/"],
  protectedAreas: [".env", "billing/", "migrations/", "wrangler.toml"],
  firstTask: "improve one article CTA without touching payment code",
  proofCommands: ["npm.cmd run build", "git diff --stat"],
};

function readyForClaudeCode(map) {
  return map.readFirst.length >= 2 &&
    map.protectedAreas.length > 0 &&
    map.proofCommands.some((command) => command.includes("build"));
}

console.log({ ready: readyForClaudeCode(repoMap), firstTask: repoMap.firstTask });

Kode ini hanya sanity check kecil. Dalam proyek nyata, tempel output ke CLAUDE.md, issue, atau handoff note agar sesi berikutnya memakai judgment yang sama.

Contoh nyata dan kegagalan

Situasi	Langkah aman	Bukti yang disimpan
Content site	Perbaiki hanya CTA bawah artikel populer dan cek link Gumroad	build, diff, URL
SaaS	Jelaskan copy settings tanpa menyentuh billing	build, diff, URL
Internal tool	Ganti nama satu kolom CSV lalu cek dengan sample data	build, diff, URL

• Membaca semua file di awal menghabiskan waktu pada format yang lemah sinyal.
• Tanpa area terlindungi, billing, auth, dan deploy terlihat seperti target edit biasa.
• Tanpa proof command, manusia harus menebak apakah laporan selesai benar.

Kegagalan bersama bukan karena Claude Code kurang mampu. Batas input terlalu tipis. Saat batas tipis, asisten memperluas tugas untuk membantu. Untuk artikel yang dimonetisasi, pilihan antara free PDF, Gumroad, dan konsultasi juga bagian dari batas itu.

Arahkan pembaca ke PDF, Gumroad, dan konsultasi

Jika command dasar masih terasa kabur, mulai dari cheatsheet gratis. Jika hambatannya setup, permission, CLAUDE.md, MCP, atau CI, Setup Guide adalah langkah berbayar berikutnya. Jika prompt review, debugging, atau refactor terus ditulis ulang, gunakan 50 Prompt Templates. Untuk rollout tim atau desain jalur revenue, lanjut ke konsultasi. Perbandingan produk dimulai dari products.

CTA tidak harus hanya muncul sekali di bawah. Di dekat pembuka, free PDF menurunkan friksi. Setelah contoh implementasi, Gumroad guide cocok. Saat masuk risiko tim atau produksi, konsultasi menjadi langkah berikutnya yang natural.

Metrik setelah publikasi

Berikutnya lihat klik free PDF, klik Setup Guide, dan kunjungan /en/training/ dari slug ini.

Setelah publikasi, pisahkan PV, pembacaan awal isi, klik internal, pendaftaran free PDF, klik Gumroad, dan kunjungan konsultasi. HTTP 200 saja belum sukses. h1, canonical, heroImage, CTA, dan body lokal harus menunjuk ke next action yang sama.