Claude Code Repo Map First Pass: membaca codebase lama tanpa membuang konteks

Di repository yang belum dikenal, kesalahan pertama bukan selalu kode yang buruk. Kesalahannya adalah meminta implementasi sebelum entry point, command, area risiko, dan bukti minimum jelas.

Mengapa pola ini penting

Repo map bukan hanya trik menghemat konteks. Ia menjadi catatan operasi agar developer, reviewer, dan orang berikutnya berbicara dari asumsi yang sama. Pembaca pemula sering berhenti setelah install karena belum tahu task aman pertama. Di sinilah PDF gratis, Setup Guide, dan konsultasi bisa disambungkan.

Baca juga: Baca juga 1, Baca juga 2, Baca juga 3.

Alur kerja praktis

Pada prompt pertama, larang edit. Minta Claude Code membaca README, package, route, test, dan deploy setting. Sebelum command jalan, pisahkan command aman dari area berisiko. Lalu pilih task kecil dengan proof cepat dan tanpa menyentuh auth atau billing.

Kit kecil yang bisa disalin

Read this repository for orientation only.
Do not edit files yet.
Return:
1. the main app entry points
2. the commands that appear safe to run
3. the files that define content, routes, and tests
4. three small first tasks ranked by verification cost
5. one risk that should block a larger change

repo_map:
  entry_points:
    - package.json
    - src/main.ts
  safe_commands:
    - npm run build
    - npm test
  first_task_rule:
    max_files: 3
    proof_required: true
    avoid_auth_and_billing: true

export function rankFirstTask(task) {
  const risk = task.touchesAuth || task.touchesBilling ? 10 : 0;
  const scope = task.filesChanged * 2;
  const proof = task.hasFastProof ? -3 : 4;
  return risk + scope + proof;
}

Contoh nyata

Untuk situs Astro, petakan src/content, src/pages, BlogPostLayout, dan build command sebelum mengubah copy.
Untuk SaaS, tandai auth, billing, dan migration sebagai area risiko, lalu mulai dari README atau test.
Untuk tim, ringkas repo map ke CLAUDE.md supaya orang berikutnya tidak mengulang eksplorasi.

Checklist operasional

Pola ini untuk dipakai berulang dalam kerja nyata dengan Claude Code. Saat mengubah artikel, halaman produk, atau jalur inquiry, gunakan daftar ini sebagai kontrol ringkas.

Tulis tujuan dalam satu kalimat dan sebutkan file atau fitur di luar scope.
Pisahkan file yang harus dibaca Claude Code dari file yang harus dihindari.
Sisakan minimal satu command bukti. Untuk konten, cek URL publik selain build.
Pastikan link PDF gratis, Gumroad, dan konsultasi konsisten di body dan CTA akhir.
Untuk post lokal, cek title, h1, pembuka body, dan bahasa CTA.
Jangan stage dirty file yang tidak terkait. Pecah diff lagi sebelum commit bila perlu.
Catat risiko tersisa dan metrik berikutnya agar sesi selanjutnya mulai bersih.

Ke penawaran mana pembaca diarahkan

Jika pembaca belum lancar command, pintu pertama adalah cheatsheet gratis. Jika workflow berulang tiap minggu, Prompt Templates membantu menstandarkan review, debugging, dan instruksi update artikel. Jika hambatannya permissions, CLAUDE.md, hooks, MCP, atau CI/CD, Setup Guide lebih tepat. Jika tim perlu desain ownership, verifikasi publik, dan jalur revenue, arahkan ke konsultasi.

Yang harus ditinggalkan di handoff

Kerja Claude Code belum selesai saat patch terlihat jadi. Kerja itu berguna saat orang berikutnya memahami keputusan tanpa mengulang sesi. Handoff harus berisi scope yang berubah, alasan scope, command bukti, URL publik, tujuan CTA, dan risiko tersisa. Untuk konten, tambahkan heroImage, link internal, link eksternal, cek bahasa, serta apakah PDF gratis, Gumroad, dan konsultasi masih ada di body. Untuk halaman dekat produk, pisahkan pembaca yang cukup dengan gratis, yang perlu membeli guide, dan yang perlu bantuan.

Angka yang perlu dilihat berikutnya

PV saja bukan metrik sukses. Setelah publish, lihat indexing, negara, klik dekat CTA akhir, klik Gumroad, dan kunjungan form konsultasi. Untuk artikel populer yang sudah ada, bandingkan bounce rate dan perpindahan ke halaman berikutnya sebelum dan sesudah rewrite. Jika sesi Claude Code berikutnya menerima angka ini dulu, ia bisa mengambil keputusan jalur revenue, bukan hanya menambah teks.

Kegagalan umum

Memulai dari feature membuat perubahan menyebar sebelum batas modul jelas.
Tanpa command aman, proof akhir menjadi kabur.
Tanpa map yang disimpan, sesi berikutnya membuang token untuk menemukan struktur yang sama.

Jalur PDF gratis, Gumroad, dan konsultasi

Mulai dari PDF gratis untuk membangun kebiasaan command. Gunakan Gumroad saat workflow berulang, dan konsultasi saat tim, permission, atau jalur revenue perlu dirancang.

Catatan verifikasi

Artikel ini menautkan codebase map, context management, dan first task runbook, lalu menaruh CTA PDF gratis, Gumroad, dan konsultasi di dalam body.