Workflow Obsidian ke CLAUDE.md untuk Claude Code

Jika vault Obsidian berisi catatan kerja tetapi setiap sesi Claude Code masih dimulai dengan penjelasan yang sama, ada jarak antara knowledge management dan implementasi. Workflow ini mengubah catatan bebas menjadi konteks operasional CLAUDE.md yang ringkas.

Pembaca dari topik Obsidian tidak hanya mencari integrasi. Mereka ingin catatan meningkatkan kualitas implementasi. Jawabannya bukan memberi seluruh vault ke Claude Code, melainkan mengekstrak decision, constraint, dan proof command yang masih berlaku.

Bacaan terkait: claude-code-obsidian-integration, claude-code-claude-md-starter-template, claude-md-best-practices.

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. Di Obsidian, pisahkan fakta, keputusan, pertanyaan terbuka, dan next action
2. Seminggu sekali, ekstrak hanya konteks yang perlu dilihat Claude Code
3. Aturan stabil masuk CLAUDE.md; state sementara masuk handoff note
4. Untuk content work, masukkan keputusan CTA dan aturan product routing
5. Hapus keputusan lama agar konteks yang selalu dibaca tetap ringan

Situasi	Langkah aman	Bukti
Content operations	Gunakan Obsidian untuk memikirkan search intent, product fit, dan CTA. CLAUDE.md hanya menyimpan aturan revenue-routing yang berulang.	build, diff, URL
Team engineering	Riwayat desain lengkap tetap di Obsidian, Claude Code hanya menerima aturan sekarang dan area terlarang.	screenshot, test
Debugging	Riwayat hipotesis tetap di catatan; sesi berikutnya menerima fakta terverifikasi dan command berikutnya.	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

Baca catatan Obsidian ini dan pisahkan menjadi operating rules untuk CLAUDE.md, temporary handoff state, dan stale information yang tidak perlu disalin.

const note = {
  title: "Checkout copy bug",
  facts: ["mobile CTA wraps", "Gumroad link still works"],
  decisions: ["keep paid CTA after free PDF"],
  commands: ["npm.cmd run build"],
};

export function toClaudeMdBlock(item) {
  return [
    "## Current operating note",
    `- Topic: ${item.title}`,
    `- Facts: ${item.facts.join("; ")}`,
    `- Decisions: ${item.decisions.join("; ")}`,
    `- Proof command: ${item.commands[0]}`,
  ].join("\n");
}

console.log(toClaudeMdBlock(note));

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

Content operations

Gunakan Obsidian untuk memikirkan search intent, product fit, dan CTA. CLAUDE.md hanya menyimpan aturan revenue-routing yang berulang.

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

Team engineering

Riwayat desain lengkap tetap di Obsidian, Claude Code hanya menerima aturan sekarang dan area terlarang.

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

Debugging

Riwayat hipotesis tetap di catatan; sesi berikutnya menerima fakta terverifikasi dan command berikutnya.

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

• Memberi seluruh vault mencampur keputusan lama dengan constraint saat ini.
• Menjadikan CLAUDE.md seperti diary menyembunyikan aturan penting.
• Menyimpan keputusan CTA hanya di notes membuat body artikel dan product route melenceng.

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.