Merawat library prompt Claude Code agar menjadi aset tim

Prompt bagus jangan hanya tersimpan di chat

Tim biasanya mulai memakai Claude Code dengan cara santai. Prompt yang bagus ada di Slack, komentar PR, catatan pribadi, atau Notion. Beberapa hari pertama terasa cukup. Setelah itu muncul banyak versi, tidak jelas mana yang terbaru, siapa owner-nya, dan prompt mana yang dipakai untuk mengecek CTA produk.

Library prompt bukan kumpulan kalimat bagus. Ia adalah aset operasional. Perlu versioning, owner, review gate, aturan deprecation, dan metrics. Claude Code Prompt library resmi memberi pola awal; tim perlu menghubungkannya ke repo, halaman produk, pricing, CTA, support, dan training. Dokumentasi CLAUDE.md dan memory, Skills, Subagents, dan Hooks juga relevan.

Artikel ini melanjutkan checklist review Claude Code dan checklist 30 menit pertama. Fokusnya adalah membuat prompt yang bisa dipakai ulang, dijual sebagai template, dan diajarkan dalam training tim.

Mulai dari registry

Versioning berarti riwayat perubahan prompt bisa dilacak. Owner adalah orang atau fungsi yang bertanggung jawab. Review gate adalah pemeriksaan sebelum prompt menjadi active. Deprecation adalah cara memensiunkan versi lama dengan pengganti. Metrics menunjukkan apakah prompt mengurangi risiko, menaikkan konversi, atau menghemat waktu.

Simpan contoh ini sebagai prompt-library.json.

[
  {
    "id": "review-risk-finder",
    "version": "1.2.0",
    "owner": "platform",
    "status": "active",
    "useWhen": "A pull request changes behavior, data flow, pricing, or CTA routing.",
    "inputs": ["goal", "diff", "riskAreas", "expectedTests"],
    "output": "Findings ordered by severity with evidence and smallest fix.",
    "reviewGate": "Owner approval plus one successful run on a known risky diff.",
    "deprecates": ["review-risk-finder@1.1.0"],
    "metrics": ["reuse_count", "accepted_findings", "false_positive_rate"],
    "officialDocs": [
      "https://code.claude.com/docs/en/prompt-library",
      "https://code.claude.com/docs/en/memory"
    ]
  }
]

Registry tidak otomatis membuat prompt bagus, tetapi membuatnya bisa dikelola. Jika output terlalu berisik, owner memperbaiki. Jika halaman produk berubah, tim memutuskan apakah prompt review CTA perlu versi minor. Jika prompt masuk materi training, instruktur tahu versi active yang dipakai.

Satu template, satu hasil

Kesalahan mahal adalah meminta review, test, dokumentasi, refactor, dan perbaikan CTA dalam satu prompt. Terlihat efisien, tetapi mencampur tanggung jawab dan membuat kegagalan sulit dibaca. Dalam library tim, satu prompt harus menghasilkan satu artefak yang jelas.

# review-risk-finder

You are reviewing a production change for business and user risk.

Context:
- Goal: {{goal}}
- Diff or changed files: {{diff}}
- Risk areas: {{riskAreas}}
- Expected tests: {{expectedTests}}

Return findings first. For each finding include:
1. Severity
2. Evidence from the diff
3. User or revenue impact
4. Smallest safe fix
5. Verification command

If there are no findings, list what you checked and what remains unverified.

Format ini memberi tahu Claude Code apa yang dihitung sebagai risiko dan bukti apa yang harus dikembalikan. Engineer menilai verification command. Product lead menilai revenue impact. Trainer bisa memakai struktur yang sama sebagai latihan workshop.

Use case: alur yang dekat dengan pendapatan

Use case 1 adalah PR review. Jangan hanya berkata “cari masalah”. Berikan goal, diff, expected tests, dan riskAreas seperti billing, auth, permission, data deletion, atau CTA routing. Output menjadi finding yang bisa diperbaiki.

Use case 2 adalah maintenance halaman produk. Untuk products, prompt perlu mengecek janji produk, target pembaca, hasil setelah membeli, bahasa harga, proof, dan link. Owner biasanya product atau marketing, bukan engineering saja.

Use case 3 adalah training dan consultation. Untuk training, prompt perlu membaca masalah tim, maturity workflow saat ini, risiko adopsi Claude Code, dan artefak yang harus tersisa setelah workshop. Metric bukan hanya traffic, tetapi inquiry berkualitas dan pertanyaan onboarding yang berkurang.

Use case 4 adalah update artikel lama. Dokumentasi resmi, command, internal link, dan contoh bisa berubah. Prompt refresh artikel mengecek official links, updatedDate, contoh yang bisa dijalankan, visual, dan bagian pengalaman nyata.

Review gate sebelum active

Tiga status cukup: draft, active, dan deprecated. Draft boleh diuji. Active boleh masuk dokumentasi, produk, dan training. Deprecated tetap terlihat dengan jalur migrasi.

Gunakan semantic versioning secara praktis. Perubahan output yang breaking menaikkan major. Input baru menaikkan minor. Koreksi kata atau contoh menaikkan patch. Tujuannya agar orang tidak memakai perilaku lama sambil mengira itu versi terbaru.

flowchart LR
  Draft["draft prompt"] --> Owner["owner review"]
  Owner --> Gate["known-risk gate"]
  Gate --> Active["active library"]
  Active --> Metrics["monthly metrics"]
  Metrics --> Deprecate["deprecate or improve"]

Known-risk gate memakai kegagalan nyata: diff berisiko yang dulu lolos, checkout CTA yang rusak, build log dengan error pertama yang tersembunyi, atau artikel yang menyimpan URL resmi lama. Jika prompt gagal di contoh itu, belum layak active.

Agent harus punya batas

Agent berguna saat tugasnya sempit dan hasilnya bisa diringkas. Subagents resmi bekerja di konteks sendiri; karena itu delegasinya harus jelas. Untuk library prompt, pisahkan librarian untuk metadata, reviewer untuk mencoba known failures, dan owner untuk approval.

Contoh .claude/agents/prompt-librarian.md:

---
name: prompt-librarian
description: Maintains prompt library metadata, ownership, versions, metrics, and deprecation notes.
tools: Read, Grep
---

You audit prompt library entries. Do not rewrite product copy.
Check that each prompt has id, version, owner, status, useWhen, inputs, output,
reviewGate, deprecation note, and metrics. Report missing fields first.

Agent ini sebaiknya membaca dan mengaudit. Jangan biarkan ia mengubah copy produk atau CTA diam-diam. Aturan yang harus memblokir tindakan sebaiknya ada di Hooks, permission, atau CI. Prompt memberi kerangka penilaian; gate memaksa proses.

Pitfall: titik library mulai rusak

Pitfall 1 adalah nama terlalu umum. good-review, debug-helper, dan marketing-check sulit dicari setelah sebulan. Pakai nama seperti checkout-cta-risk-review, build-log-first-failure, atau training-page-objection-check.

Pitfall 2 adalah menyimpan hanya contoh sukses. Contoh sukses membuat prompt terlihat lebih kuat dari kenyataan. Simpan minimal satu input gagal: “melewatkan link harga lama” atau “hanya melihat nama test, bukan implementasi”.

Pitfall 3 adalah memasukkan semuanya ke CLAUDE.md. CLAUDE.md berguna sebagai konteks, tetapi bukan policy engine. Untuk memblokir tindakan, gunakan Hooks, permission, atau CI.

Pitfall 4 adalah menambahkan CTA di akhir. Jalur gratis, produk, dan training harus dirancang sejak awal. Pembaca yang ingin mencoba, membeli template, dan membawa timnya punya kebutuhan berbeda.

Script audit kecil

Setelah lebih dari sepuluh entry, otomatisasi pemeriksaan dasar.

import fs from "node:fs";

const file = process.argv[2] ?? "prompt-library.json";
const entries = JSON.parse(fs.readFileSync(file, "utf8"));
const required = [
  "id",
  "version",
  "owner",
  "status",
  "useWhen",
  "inputs",
  "output",
  "reviewGate",
  "metrics"
];

let failed = false;
for (const entry of entries) {
  const missing = required.filter((key) => !entry[key]);
  if (!/^\\d+\\.\\d+\\.\\d+$/.test(entry.version ?? "")) {
    missing.push("version must be semver");
  }
  if (!["draft", "active", "deprecated"].includes(entry.status)) {
    missing.push("status must be draft, active, or deprecated");
  }
  if (missing.length > 0) {
    failed = true;
    console.error(`${entry.id ?? "(missing id)"}: ${missing.join(", ")}`);
  }
}

if (failed) process.exit(1);
console.log(`OK: ${entries.length} prompt entries checked`);

Script ini tidak menilai gaya tulisan, tetapi mencegah prompt tanpa owner, version, atau reviewGate masuk ke materi berbayar.

Metric sedikit, keputusan jelas

Metric	Alasan	Aksi
reuse_count	Tim bisa menemukan prompt atau tidak	Ganti nama atau lokasi
accepted_findings	Output menjadi perbaikan nyata atau tidak	Perketat format output
false_positive_rate	Reviewer membuang waktu atau tidak	Buat riskAreas lebih spesifik
time_to_fix_minutes	Perbaikan makin cepat atau tidak	Wajibkan smallest safe fix
cta_click_rate	Jalur produk/training membaik atau tidak	Ubah konteks dan posisi CTA

Review bulanan sudah cukup. Prompt yang tidak dipakai, tidak dipercaya, atau tidak membantu keputusan sebaiknya deprecated.

Hubungkan ke products dan training

Library yang dirawat membuat tangga monetisasi lebih jelas. Artikel gratis mengajarkan cara berpikir. ClaudeCodeLab products memberi template siap pakai untuk individu. Claude Code training and consultation membantu tim menyesuaikan owner, gate, hooks, metrics, dan rollout ke repository nyata.

Masa awalnya menyimpan lebih dari tiga puluh prompt. Hasilnya justru lambat karena terlalu banyak pilihan. Setelah dibagi menjadi review, debug, product page, dan training page, masing-masing maksimal tiga prompt active, tim lebih cepat memilih. Contoh kegagalan yang disimpan menjadi bahan paling berguna untuk memperbaiki versi berikutnya.