Claude Code Subabents and Agent Teams: A Practical Guide

Anda telah melihat kata-kata "subagen", "Agent Teams", "orkestra", dan Anda bertanya-tanya apakah Anda kehilangan sesuatu. Jawaban singkat: untuk sebagian besar tugas Anda, tidak. Tapi pada pekerjaan besar, ya, dan itu layak dipahami.

Mari kita lepaskan tanpa jargon.

Apa seorang agen pengganti sebenarnya

Seorang agen pengganti adalah asisten khusus dengan konteksnya sendiri, prompt sendiri, dan perizinan alat sendiri.

Ketika agen utama mencapai subtask yang didefinisikan dengan baik, itu delegasi ke subagen. Subagen itu bekerja di jendela konteksnya sendiri, melakukan tugasnya, dan mengembalikan hasilnya. Agen utama tidak mendapatkan sejarah penuh mencemari konteksnya, ia mendapat kesimpulan.

Itulah intinya: menjaga konteks agen utama tetap bersih. Alih-alih satu agen tenggelam dalam 50.000 token pencarian file, Anda memiliki subagent yang melakukan pencarian dan laporan kembali tiga baris yang berguna.

Anda mendeklarasikan subagen Anda dalam folder .claude/agents/ proyek Anda. Masing-masing memiliki nama, deskripsi yang mengatakan kapan menggunakannya, dan sistem prompt.

---
name: test-writer
description: Use when tests need to be written or fixed
---
You write tests. You aim for edge-case coverage,
not the happy path. You never touch production code.

Agent Teams, langkah berikutnya

Agent Teams adalah pengelola multi- agen yang dibangun di Claude Code. Masih percobaan, dinonaktifkan oleh default, tapi titik entri padat.

Idenya: seorang agen utama membagi tugas besar, mengirimkan setiap bagian ke agen spesialis (dengan modelnya sendiri, prompt, alat), spesialis bekerja secara paralel pada sistem berkas bersama, dan hasilnya mengalir kembali ke memimpin.

Jika "mendelegasikan spesialis" terdengar seperti subagen, itu normal. Agent Teams adalah ide yang mendorong semua jalan untuk menjalankan beberapa agen benar-benar dalam paralel, tidak hanya satu demi satu.

Di luar bangunan-dalam satu, ada ketiga rombongannya seperti Multiclaude dan Gas Town. Mereka opinionated, yang adalah apa yang membuat mereka titik awal yang baik ketika Anda mulai: mereka memutuskan untuk Anda sampai Anda telah membangun kebiasaan Anda sendiri.

Ketika Anda membutuhkannya (dan ketika Anda tidak)

Mari kita perjelas: multi- agen orkestra sia-sia untuk 95% dari agen - membantu tugas. Untuk sebagian besar pekerjaan harian Anda, seorang agen tunggal lebih cepat dan sederhana.

Sekarang, multi- agen masih sebuah cara yang mahal dan eksperimental untuk menyerang proyek-proyek besar.

Anda membutuhkannya ketika:

• Proyek ini terbagi menjadi potongan-potongan yang benar-benar independen yang menyentuh file yang berbeda.
• Sebuah jendela konteks tunggal tidak dapat menahan semuanya.
• Anda ingin menyamakan refactor yang luas atau repo- migrasi lebar.

Anda tidak membutuhkannya untuk memperbaiki bug, fitur terfokus, atau apa pun yang cocok dalam satu kepala.

Perangkap ini berputar up sepuluh agen "tim" untuk sesuatu yang satu agen akan lakukan dalam lima menit. Anda membayar dengan token dan kompleksitas untuk paralel tugas yang tidak pernah diminta.

Masalah sebenarnya: visibilitas

Inilah yang tidak bisa dibicarakan cukup. Saat kau menjalankan beberapa subagen atau tim agen, kau kehilangan benang.

Seorang delegasi utama untuk lima spesialis. Yang mana yang bekerja? Yang selesai? Yang menunggu keputusan? Dalam terminal Anda melihat dinding gulungan teks, dan Anda tidak bisa mengatakan siapa yang melakukan apa.

Di sinilah dashboard visual mengubah segalanya. AgentsRoom menunjukkan setiap agen dan setiap subagen sebagai ubin sendiri, dengan status yang dieja. Anda menonton delegasi terjadi, Anda melihat siapa yang menunggu jawaban Anda, Anda melihat siapa yang jatuh. Dinding teks menjadi peta yang dapat dibaca.

Tanpa pandangan itu, multi- agen orkestra tetap demo mengesankan yang unmandable hari ke hari. Dengan itu, menjadi alat yang benar-benar Anda gunakan.

Mana untuk memulai

Jangan langsung melompat ke tim agen delapan.

Mulailah dengan satu atau dua subagen untuk tugas yang tepat dan berulang: satu yang menulis tes, satu yang mencari codebase. Anda akan segera merasakan keuntungan pada konteks agen utama Anda.

Setelah mekanik itu merasa alami, nyalakan Agent Teams untuk pekerjaan yang terbagi bersih. Mengawasi siapa yang melakukan apa, menyetujui rencana sebelum eksekusi, dan menghentikan tinjauan sesaat menjadi bottleneck Anda.

Multi- agen pahala orang-orang yang struktur sebelum mereka meluncurkan. Bukan orang-orang yang meluncurkan agen yang paling.