Checklist audit repo pertama Claude Code sebelum edit pertama

Sesi Claude Code pertama di repository yang sudah ada sebaiknya tidak dimulai dengan edit. Mulailah dengan peta. Agent bisa membaca cepat, tetapi kecepatan hanya aman jika entry point, area terlindungi, command bukti, dan jalur bisnis sudah jelas.

Intent pembaca sederhana: ingin memakai Claude Code di codebase nyata tanpa kehilangan kontrol. Tujuannya belum membuat fitur, tetapi membuat scope, risiko, verifikasi, dan CTA revenue terlihat dalam 20 menit.

Bacaan terkait: claude-code-getting-started-complete, claude-code-existing-codebase-map, claude-code-harness-lite-workflow.

Mengapa pola ini perlu ada sebelum edit pertama

Claude Code paling kuat saat task punya batas yang jelas. Batas yang baik menyebut file yang boleh dibaca, file yang boleh diedit, operasi yang tidak boleh dijalankan, dan bukti yang menutup pekerjaan. Tanpa batas ini, prompt pemula bisa berubah menjadi rewrite besar, dan perubahan konten bisa merusak jalur PDF gratis, Gumroad, atau konsultasi.

Pola ini juga membantu revenue karena menghubungkan bukti teknis dengan bukti untuk pembaca. Halaman yang build lokal tetapi mengirim pembaca ke produk salah belum selesai. Dengan mencatat scope, command, URL publik, dan CTA, besok Anda memperbaiki dari bukti, bukan ingatan.

Workflow praktis

1. Baca README, package.json, dan entry routing lebih dulu
2. Tandai generated, billing, auth, migrations, dan .env sebagai area terlindungi
3. Batasi permukaan edit pertama ke tiga file atau kurang
4. Pilih satu command bukti sebelum patch
5. Untuk konten atau landing page, audit juga link PDF gratis, Gumroad, dan konsultasi

Situasi	Langkah aman	Bukti
Situs konten Astro	Sebelum membuat artikel, cek content collection, aturan slug, heroImage, dan pola CTA. Body dan jalur berbayar sama-sama bagian audit.	build, diff, URL
Dashboard React	Untuk layout kecil, batasi ke komponen, CSS, dan screenshot. Auth dan billing tetap terlindungi.	screenshot, test
Repository API	Mulai dari route path dan command test. Migration database dan secret tidak masuk task pertama.	log, command, handoff

Pass pertama harus singkat. Audit harus menghasilkan keputusan, bukan laporan besar. Jika setelah 20 menit keputusan masih kabur, langkah aman adalah membaca satu file lagi, bukan mulai mengedit.

Prompt dan kode yang bisa disalin

Audit repository ini sebelum edit pertama. Jangan edit dulu. Kembalikan entry file, area terlindungi, file yang aman diedit, command bukti terkecil, serta cek URL publik dan CTA.

const audit = {
  repo: "customer-portal",
  intent: "first safe Claude Code session",
  scope: ["README.md", "package.json", "src/routes"],
  protected: [".env", "billing/", "migrations/"],
  proof: ["npm.cmd run build", "git diff --stat"],
};

export function readyForFirstEdit(report) {
  return report.scope.length > 0 &&
    report.protected.length > 0 &&
    report.proof.some((command) => command.includes("build"));
}

console.log(readyForFirstEdit(audit));

Kode ini sengaja kecil. Ia mengubah ide operasi menjadi object yang bisa dicek: ada scope, ada area terlindungi, dan ada proof command. Bentuknya bisa diadaptasi untuk publikasi artikel, app development, debugging, atau handoff tim.

Tiga contoh nyata

Situs konten Astro

Sebelum membuat artikel, cek content collection, aturan slug, heroImage, dan pola CTA. Body dan jalur berbayar sama-sama bagian audit.

Bagian pentingnya adalah bukti. Simpan satu command, satu halaman yang terlihat, atau satu catatan yang menunjukkan pekerjaan benar-benar sampai ke pembaca.

Dashboard React

Untuk layout kecil, batasi ke komponen, CSS, dan screenshot. Auth dan billing tetap terlindungi.

Bagian pentingnya adalah bukti. Simpan satu command, satu halaman yang terlihat, atau satu catatan yang menunjukkan pekerjaan benar-benar sampai ke pembaca.

Repository API

Mulai dari route path dan command test. Migration database dan secret tidak masuk task pertama.

Bagian pentingnya adalah bukti. Simpan satu command, satu halaman yang terlihat, atau satu catatan yang menunjukkan pekerjaan benar-benar sampai ke pembaca.

Kegagalan yang perlu dihindari

• Meminta memperbaiki semuanya mencampur audit dan implementasi.
• Build lokal belum cukup jika URL publik atau CTA mengarah ke halaman salah.
• Tanpa area terlindungi, edit yang membantu bisa menjadi insiden.

Kegagalan lain adalah drift lokalisasi. Artikel Inggris mungkin menjelaskan jalur produk benar, sementara locale lain masih memakai CTA lama. Karena itu public check harus melihat h1, awal body, dan bahasa CTA untuk tiap locale, bukan hanya frontmatter lang.

Menghubungkan pembaca ke PDF, Gumroad, dan konsultasi

Jika pembaca masih perlu lancar dengan command, arahkan ke cheatsheet gratis. Jika hambatannya adalah setup, permission, CLAUDE.md, hooks, MCP, atau CI/CD, Setup Guide adalah produk berbayar yang paling cocok. Jika mereka sering menulis prompt review, debugging, dan refactor, arahkan ke 50 Prompt Templates. Untuk rollout tim, desain workflow, atau jalur revenue, gunakan konsultasi. Untuk membandingkan pilihan, buka products.

Jangan langsung memaksa semua pembaca ke produk berbayar. Pemula biasanya perlu PDF yang ringan dulu. Pembaca yang mengulang prompt lebih dekat ke template. Pembaca yang tersangkut permission, CLAUDE.md, hooks, MCP, atau CI/CD lebih dekat ke Setup Guide. Tim dengan pertanyaan proses lebih dekat ke konsultasi.

Yang diverifikasi sebelum dan sesudah publikasi

Verifikasi artikel ini bukan hanya HTTP 200. h1, awal isi, heroImage, link internal, link Gumroad, dan jalur konsultasi harus mendukung intent pembaca yang sama.

Untuk publikasi multilingual, verifikasi Jepang, Inggris, China, Korea, Spanyol, Prancis, Jerman, Portugis, Hindi, dan Indonesia secara terpisah. Slug bisa sama sementara body masih lama. Screenshot mobile lebih cepat menangkap ini karena opening paragraph dan CTA terlihat bersama.

Angka yang perlu dilihat berikutnya

Angka berikutnya adalah PDF starts, klik Gumroad, kunjungan products, kunjungan training, search source, country mix, dan article-to-CTA click rate. Jika PV naik tetapi klik Gumroad datar, product match perlu diperkuat. Jika kunjungan konsultasi naik dari artikel teknis, pembaca mungkin butuh workflow design.