Subagent Claude Code: panduan praktis untuk delegasi artikel dan kode

Saat pekerjaan Claude Code membesar, yang biasanya gagal lebih dulu bukan modelnya. Yang gagal adalah cara kita membagi pekerjaan. Satu percakapan yang dipakai untuk riset, menulis, menerjemahkan, mengedit kode, menjalankan pemeriksaan, dan mereview sepuluh file lokal akan cepat penuh. Agent membaca file yang sama berkali-kali, log memenuhi context, dan hasil akhir tidak menjelaskan file mana yang berubah dan kenapa.

Subagent membantu karena pekerjaan yang jelas batasnya bisa didelegasikan ke context terpisah. Delegasi di sini bukan berarti “biarkan agent lain mengurus semuanya”. Delegasi berarti memberi kontrak kecil: tujuan, file yang boleh diedit, file yang dilarang, kriteria selesai, dan format hasil. Kontrak ini yang membuat kerja paralel tidak berubah menjadi kerja duplikat.

Panduan ini memakai alur produksi ClaudeCodeLab: menulis artikel canonical dalam bahasa Jepang, melokalkan ke sepuluh bahasa, memeriksa template prompt, dan melakukan review sebelum publikasi. Pola yang sama juga berguna untuk perubahan kode, dokumentasi, migrasi, dan persiapan release.

Apa itu subagent

Subagent adalah pekerja khusus yang berjalan di luar context percakapan utama. Context adalah memori kerja yang sedang dilihat Claude: chat, file yang dibaca, output command, aturan proyek, dan ringkasan sementara. Jika sebuah tugas menghasilkan banyak hasil pencarian atau log, subagent bisa melakukan pembacaan berat lalu mengembalikan ringkasan yang benar-benar berguna.

Untuk referensi resmi, lihat dokumentasi Claude Code tentang subagents, memory, dan slash commands. Dalam praktik, ingat tiga hal: subagent mulai dengan context terisolasi, agent proyek bisa disimpan di .claude/agents/, dan respons subagent yang terlalu panjang tetap mengonsumsi context utama saat dikembalikan.

Istilah	Arti praktis
subagent	Pekerja khusus untuk riset, implementasi, terjemahan, atau review
context	Memori kerja yang saat ini terlihat oleh Claude
disjoint write set	Kumpulan file yang boleh diedit tanpa tumpang tindih dengan worker lain
explorer	Agent riset read-only yang memetakan scope sebelum edit
worker	Agent yang hanya mengedit file yang ditugaskan
handoff contract	Kontrak berisi scope, batasan, kriteria selesai, dan format laporan

Kapan perlu delegasi

Subagent tidak perlu dipakai untuk semua hal. Perubahan kecil bisa menjadi lebih lambat karena setiap agent harus membangun context sendiri. Pertanyaan yang tepat: apakah memisahkan context memberi nilai, dan apakah area edit bisa dibagi tanpa tumpang tindih?

Pekerjaan	Delegasikan?	Alasan
Melokalkan satu artikel ke sepuluh bahasa	Ya	Tiap bahasa punya file sendiri dan kriteria jelas
Mencari pola di codebase besar	Ya	Thread utama hanya perlu peta, bukan semua hasil grep
Memperbaiki typo di satu file	Tidak	Biaya koordinasi lebih besar dari pekerjaannya
Refactor auth lintas modul	Mungkin	Mulai dengan explorer untuk memetakan dampak
Fitur baru yang syaratnya belum jelas	Belum	Klarifikasi requirement dulu di thread utama

Aturan praktis saya: delegasikan jika tugas menghasilkan banyak output antara, setiap worker bisa dibatasi ke file eksplisit, dan hasil akhirnya bisa kembali sebagai tabel, checklist, atau receipt singkat.

Pola inti: explorer, worker, reviewer

Untuk pekerjaan besar, jangan mulai dengan banyak agent yang langsung mengedit. Mulai dengan explorer. Ia membaca dalam mode read-only, menemukan file penting, pola yang sudah ada, risiko, dan saran write set. Setelah itu worker mengedit file yang terpisah. Di akhir, reviewer atau verification agent memeriksa hasil dalam mode read-only.

flowchart TD
  A["Main: goal and constraints"] --> B["Explorer: read only, map scope"]
  B --> C["Main: decide disjoint write sets"]
  C --> D["Worker: canonical article or code module"]
  C --> E["Worker: localized files or separate module"]
  D --> F["Reviewer: quality, metadata, verification"]
  E --> F
  F --> G["Main: final checks and handoff"]

Urutan ini mencegah kegagalan paling umum: beberapa agent membaca dan mengedit file yang sama karena instruksi awal terlalu luas.

Contoh 1: produksi artikel multibahasa

Dalam ClaudeCodeLab, alur aman adalah menyelesaikan artikel canonical bahasa Jepang terlebih dahulu, lalu melokalkan panduan penuh. Canonical adalah naskah dasar. Jika naskah dasar tipis, semua terjemahan ikut tipis. Jika naskah dasar memiliki contoh, pitfalls, template, dan CTA, setiap bahasa dapat mempertahankan isi yang kuat tanpa terasa seperti terjemahan mesin.

Peran	File yang boleh diedit	Tugas
ja-worker	site/src/content/blog/claude-code-subagent-patterns.mdx	Membuat struktur, contoh, prompt, dan CTA
western-locale-worker	blog-en, blog-es, blog-fr, blog-de, blog-pt	Melokalkan secara natural tanpa meringkas
asia-locale-worker	blog-zh, blog-ko, blog-hi, blog-id	Menyesuaikan istilah untuk pembaca lokal
review-agent	semua 10 file slug, read-only	Memeriksa frontmatter, mojibake, link, code fence, dan risiko publikasi

Prompt yang bisa langsung dipakai:

Use a translation subagent for the assigned locale files only.

Source:
- Japanese canonical file: site/src/content/blog/claude-code-subagent-patterns.mdx

Allowed write set:
- site/src/content/blog-en/claude-code-subagent-patterns.mdx
- site/src/content/blog-es/claude-code-subagent-patterns.mdx

Rules:
- Do not summarize. Localize the full guide.
- Keep frontmatter valid and preserve heroImage.
- Use natural SEO terms for each language.
- Keep prompt templates copy-pasteable.
- Do not edit Japanese or other locale files.

Return:
- Files changed
- Localization choices
- Any terms that may need human review
- Checks performed

Contoh 2: memverifikasi contoh kode dalam artikel

Penulis artikel dan verification agent sebaiknya tidak punya tugas yang sama. Penulis fokus pada penjelasan dan nilai pembaca. Verification agent mengekstrak code fence, memeriksa syntax, memvalidasi path, dan menyatakan bagian mana yang benar-benar bisa dicopy.

---
name: article-reviewer
description: Reviews ClaudeCodeLab articles for originality, implementation detail, SEO, and publication risk.
tools: Read, Grep, Glob
---

You review article drafts critically.
Check whether the draft has concrete examples, pitfalls, working prompts,
official links, internal links, and a clear CTA.
Return findings first, then a short pass/fail recommendation.

Definisi ini bisa diletakkan di .claude/agents/article-reviewer.md. name harus unik, dan description harus menjelaskan kapan agent dipakai. Jangan menjadikan prompt sebagai dokumen kebijakan yang terlalu panjang; aturan jangka panjang lebih mudah dirawat di CLAUDE.md atau checklist tim. Lihat juga panduan context management dan praktik terbaik CLAUDE.md.

Contoh 3: perubahan kode dengan write set yang tidak tumpang tindih

Pola yang sama berlaku untuk kode. Misalnya situs blog perlu mengubah article card, OGP image generation, dan related posts logic. Area ini berhubungan, tetapi file bisa dipisahkan.

We will use three workers with disjoint write sets.

Worker A:
- May edit: site/src/components/BlogCard.astro
- Must not edit: layouts, pages, content files
- Goal: improve card metadata rendering only

Worker B:
- May edit: site/src/pages/og/[...slug].png.ts
- Must not edit: components or article files
- Goal: verify OGP title and hero behavior

Worker C:
- May edit: site/src/lib/relatedPosts.ts
- Must not edit: components, pages, content files
- Goal: improve related-post selection without changing routes

All workers return a handoff receipt with changed files, reasoning, tests, and risks.

“Perbaiki UI secara paralel” adalah prompt yang lemah. Prompt yang kuat menyebutkan file yang boleh diedit, file yang dilarang, dan bukti yang harus dikembalikan.

Contoh 4: review dan verification read-only

Agent terakhir sering kali sebaiknya read-only. Reviewer mencari nilai pembaca, celah SEO, konten duplikat, dan pitfalls yang hilang. Verification agent memeriksa metadata, link, command, code fence, dan risiko build.

Use a review subagent in read-only mode.

Scope:
- Read only these 10 localized files for slug claude-code-subagent-patterns.
- Do not edit anything.

Review checklist:
- description is 120 characters or fewer
- updatedDate is 2026-06-02
- heroImage is retained
- each locale is a full localized article, not a thin summary
- at least 3 concrete use cases are present
- pitfalls and failure modes are concrete
- code fences are balanced
- official external links and internal links are present
- CTA is natural and relevant

Return findings by severity with file paths and line numbers where possible.

Ini sangat berguna untuk publikasi multibahasa. Satu bahasa bisa terdengar natural tetapi tanggalnya lama, code fence belum tertutup, atau CTA hilang. Untuk pekerjaan kode, kombinasikan dengan checklist code review Claude Code.

Template delegasi

Prompt orkestrasi:

You are the orchestrator. Before using subagents, create a delegation plan.

Goal:
- [one sentence goal]

Hard constraints:
- Work only on: [exact files or directories]
- Do not edit: [out of scope]
- Preserve: [metadata, public API, routes, screenshots, etc.]
- Verification required: [commands or manual checks]

Ask explorer agents to read first. Do not start workers until write sets are disjoint.
For every worker, define:
- allowed write set
- forbidden files
- expected output
- done condition

Final response must include:
- changed files
- checks run
- remaining risks

Prompt untuk eksplorasi read-only:

Use an explorer subagent in read-only mode.

Task:
- Map the current state of [feature/article/slug].
- Find existing conventions, related files, internal links, and quality gaps.

Rules:
- Do not edit files.
- Prefer search and targeted reads over full-directory dumps.
- Return only the useful summary, not raw command output.

Return:
- Files that matter
- Existing patterns to follow
- Risks or unclear requirements
- Suggested write sets for workers

Prompt untuk worker implementasi:

Use a worker subagent for this isolated edit.

Allowed write set:
- [file 1]
- [file 2]

Forbidden:
- Do not edit files outside the allowed write set.
- Do not stage, commit, push, deploy, or rewrite unrelated changes.
- If the task requires another file, stop and report why.

Implementation goal:
- [specific behavior or article quality outcome]

Return a handoff receipt:
- Files changed
- Summary of changes
- Commands or checks run
- Evidence of success
- Remaining risk

Kegagalan yang sering terjadi

Kegagalan pertama adalah memparalelkan pekerjaan sebelum batasnya jelas. Jika tiga worker diberi instruksi “perbaiki artikel”, semuanya akan mengubah judul, pembuka, contoh, dan CTA. Diff bertambah, tetapi kontrol berkurang.

Kegagalan kedua adalah mengembalikan terlalu banyak output. Subagent melindungi context saat bekerja, tetapi hasil finalnya tetap masuk ke thread utama. Minta keputusan, tabel, dan receipt, bukan log penuh.

Kegagalan ketiga adalah handoff contract yang lemah. “Terjemahkan secara natural” belum cukup. Tulis “jangan diringkas”, “pertahankan frontmatter”, “pertahankan pitfalls”, “gunakan istilah SEO lokal”, dan “tandai frasa yang perlu review manusia”.

Kegagalan keempat adalah meminta implementer memvalidasi asumsi sendiri. Reviewer harus membaca dengan skeptis, membandingkan hasil dengan constraint, dan memulai dari risiko.

Kegagalan kelima adalah lupa cara agent definition dimuat. File di .claude/agents/ mungkin perlu sesi baru agar tersedia dengan stabil. Untuk agent reusable, definisi file yang ringkas biasanya lebih mudah dirawat daripada prompt CLI yang sangat panjang.

Aturan budget context

Subagent hanya menghemat context jika hasil yang kembali dibatasi.

Context budget rule:
- Explorer returns at most 20 bullets and 1 table.
- Worker returns changed files, decisions, and checks only.
- Reviewer returns findings by severity, no full rewritten article.
- Logs longer than 80 lines must be summarized.
- If uncertainty remains, ask one focused question instead of dumping raw output.

Deliverable boleh panjang. Handoff harus singkat. Jika keduanya dicampur, percakapan utama cepat dipenuhi draft, catatan terjemahan, dan log verifikasi.

Reviewer read-only siap salin

Subagent pertama yang paling aman adalah reviewer read-only. Skrip ini membuat .claude/agents/article-reviewer.md; ia boleh membaca draft dan menunjukkan risiko, tetapi tidak boleh mengedit file. Ini cara rendah risiko untuk menambah review kritis sebelum publikasi.

mkdir -p .claude/agents
cat > .claude/agents/article-reviewer.md <<'EOF'
---
name: article-reviewer
description: Reviews ClaudeCodeLab articles for originality, implementation detail, SEO, and publication risk.
tools: Read, Grep, Glob
---

Review the assigned files only. Do not edit.

Checklist:
- title and description match the search intent
- intro gives a concrete reader problem in the first three lines
- examples, pitfalls, official links, internal links, and CTA are present
- code fences are balanced and labeled
- the article is not a thin summary or duplicated from another page

Return:
- findings by severity
- pass/fail recommendation
- one highest-leverage fix
EOF

Checklist delegasi

# Subagent Delegation Checklist

## Before delegation
- [ ] Goal is one sentence.
- [ ] In-scope files are listed explicitly.
- [ ] Out-of-scope files and actions are listed explicitly.
- [ ] Explorer runs before worker when scope is unclear.
- [ ] Write sets do not overlap.

## During work
- [ ] Each worker edits only allowed files.
- [ ] Large outputs are summarized.
- [ ] Any need to expand scope is reported before editing.
- [ ] Prompts include done conditions.

## Review
- [ ] Reviewer runs in read-only mode.
- [ ] Metadata and links are checked.
- [ ] Code fences and commands are checked.
- [ ] Localization is full, not summarized.
- [ ] Remaining risks are written in the handoff.

Hasil saat dicoba

Dalam pekerjaan artikel ClaudeCodeLab, peningkatan terbesar bukan berasal dari terjemahan yang lebih cepat. Peningkatan terbesar datang dari pemisahan canonical draft, locale workers, dan reviewer read-only. Sebelumnya mudah sekali berakhir dengan satu bahasa yang kuat dan sembilan versi yang tipis. Dengan aturan “jangan ringkas”, write set tetap, dan receipt verifikasi, review akhir menjadi jauh lebih konkret.

Jika tim Anda mulai memakai Claude Code, ajarkan subagent sebagai pola desain kerja, bukan tombol otomatisasi ajaib. ClaudeCodeLab merapikan delegation contract, review rubric, dan kebiasaan context ini dalam training dan product templates untuk tim.