Mengubah catatan Obsidian menjadi brief implementasi Claude Code

Jika vault Obsidian berisi jawabannya tetapi setiap sesi Claude Code masih dimulai dengan penjelasan yang sama, masalahnya bukan catatan. Masalahnya bentuk handoff.

Artikel ini membuat format issue brief kecil untuk Claude Code. Alih-alih menempelkan seluruh note, kirim fakta, keputusan, unknowns, next action, dan kebutuhan proof.

Bacaan terkait: claude-code-obsidian-integration, claude-code-claude-md-templates, claude-code-session-handoff-template. Baseline instalasi resmi ada di Anthropic Claude Code getting started.

Mengapa ini perlu sebelum command pertama

Pusat topik ini adalah mengubah knowledge Obsidian menjadi brief implementasi. 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 orang dengan catatan berguna tetapi handoff Claude Code terasa berat, 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. Pisahkan note menjadi fakta, keputusan, unknowns, dan next action
2. Jangan masukkan hipotesis lama ke brief implementasi
3. Sertakan keputusan CTA dan product routing saat konten berubah
4. Minta build dan screenshot mobile sebagai proof akhir

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
Perbaikan artikel	Kirim search intent dan kebijakan CTA tanpa mengundang rewrite total	build, diff, URL
Bug fix	Pisahkan fakta yang sudah direproduksi dari penyebab yang belum pasti	build, diff, URL
Persiapan konsultasi	Ubah catatan customer menjadi scope, area terlarang, dan pertanyaan berikutnya	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

Ubah catatan Obsidian ini menjadi brief implementasi Claude Code. Pisahkan fakta, keputusan, unknowns, next action, area terlarang, dan proof. Letakkan hipotesis lama di bagian terpisah dan jangan campur ke instruksi.

const note = {
  title: "Checkout CTA wraps on mobile",
  facts: ["375px screenshot shows two-line button", "Gumroad URL is correct"],
  decision: "keep free PDF before paid guide",
  unknowns: ["which component owns the button spacing"],
  nextAction: "find component, make smallest CSS change, verify mobile",
};

function toClaudeBrief(item) {
  return [
    `Goal: ${item.nextAction}`,
    `Facts: ${item.facts.join("; ")}`,
    `Decision: ${item.decision}`,
    `Do not assume: ${item.unknowns.join("; ")}`,
    "Proof: build plus mobile screenshot",
  ].join("\n");
}

console.log(toClaudeBrief(note));

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
Perbaikan artikel	Kirim search intent dan kebijakan CTA tanpa mengundang rewrite total	build, diff, URL
Bug fix	Pisahkan fakta yang sudah direproduksi dari penyebab yang belum pasti	build, diff, URL
Persiapan konsultasi	Ubah catatan customer menjadi scope, area terlarang, dan pertanyaan berikutnya	build, diff, URL

• Menempelkan seluruh vault mencampur keputusan lama dengan constraint saat ini.
• Menempelkan hanya keputusan menyembunyikan alasan pekerjaan.
• Melewatkan CTA policy bisa memperbaiki teks tetapi melemahkan revenue path.

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 dari artikel Obsidian ke Prompt Templates dan Setup Guide.

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.