Claude Code subagentlari: tuzilma, beshta rol va orkestratsiya

Claude Code’da subagent nima va nega u “shunchaki yana bir Skill” emas?#

Claude Code hujjatlarida bu quyidagicha ta’riflanadi:

Tadbirkor tushunadigan tilda aytganda, ko‘chmas mulk agentligini tasavvur qiling. Unda direktor, marketolog, yurist va savdo menejerlari bor. Bitta xodimning bu rollarning barchasi orasida almashib ishlashi jamoa emas; bu — haddan tashqari yuklangan bir kishi. Har bir xodim o‘z konteksti va mas’uliyat sohasiga ega bo‘lib, direktor faqat vazifalarni taqsimlab, natijalarni birlashtirganda jamoa shakllanadi.

Claude Code’dagi subagentlar ham xuddi shunday ishlaydi. Asosiy chat — direktor. Subagent esa tor doiradagi vazifa, o‘z konteksti va vositalar to‘plamiga ega mutaxassis. Vazifa mutaxassis tavsifiga mos kelsa, direktor uni topshiradi va tafsilotlarga botib qolmaydi.

Anthropic subagentlarni yaratgan 5 ta maqsad

Anthropic hujjatlarida o‘zingizning subagentingizni yaratish uchun aynan beshta sabab keltirilgan:

Dasturchi bo‘lmaganlar uchun bu ro‘yxatdagi eng amaliy jihat — xarajatlarni boshqarish. Katta tadqiqot vazifasini arzon Haiku modeliga topshirib, asosiy suhbatni Sonnet yoki Opus’da davom ettirishingiz mumkin. Tokenlar tejalishi to‘g‘ridan-to‘g‘ri mutanosib bo‘ladi.

O‘rnatilgan versiyada ichma-ichlikni tekshiring

Bu shablonlarda asosiy seans bevosita ijrochilarga topshiradi. Eski «subagent boshqasini chaqirolmaydi» hujjatini doimiy qoida demang: xulq o‘rnatilgan versiya va ruxsatli vositalarga bog‘liq. Alohida ichma-ich agentlar qo‘llanmasi versiyaga xos retseptni ko‘radi. Chuqur delegatsiyadan oldin o‘z o‘rnatishingizda qo‘llanishini tekshiring.

Subagent Skill, Slash Command va Hook’dan nimasi bilan farq qiladi?#

Skills haqidagi avvalgi qo‘llanmada Claude Code’dagi skills va slash command’lar amalda bitta formatga birlashgani tushuntirilgan. Ammo subagent boshqa narsa — u shunchaki “kattaroq skill” emas.

To‘rtta mexanizmning qisqa taqqoslash jadvali:

Ingliz tilidagi qo‘llanmada buni shunday ifodalash mumkin: skills — retseptlar, subagentlar esa ixtisoslashgan hamkasblardir.

Put simply: skills retseptlarga, subagentlar esa ixtisoslashgan hamkasblarga o‘xshaydi.

Amalda bu shunday ishlaydi: skills tavsifi vazifaga mos kelganda avtomatik faollashadi, subagentlar esa aniq chaqiriladi — asosiy chat vazifani topshirishga qaror qiladi yoki siz uni nomi bilan chaqirasiz.

Qaror daraxti: “Qaysi birini tanlashim kerak?”

“Claude’dan X’ni bajarishni so‘rashim kerak”, deb o‘ylaganingizda, quyidagi to‘rtta savolni bering:

1. Bu doim mavjud bo‘lishi kerak bo‘lgan bilimmi? Masalan, “foydalanuvchi afzal ko‘rgan tilga mahalliylashtiramiz” yoki “uzun tire ishlatmaymiz”. Buni CLAUDE.mdga yozing.
2. Bu hozir qo‘lda bajaradigan, ishga tushiriladigan metodologiyami? Masalan, “har dushanba savdo hisobotini yozaman”. Skill yarating.
3. Bu asosiy chat kontekstini egallaydigan vazifami yoki parallel bajarish mumkinmi? Masalan, “30 ta manba bo‘yicha chuqur tadqiqot” yoki “men yangi xususiyat yozayotganimda xavfsizlik auditi”. Subagent yarating.
4. Claude Code’da biror hodisaga avtomatik javob kerakmi? Masalan, “har bir Edit’dan keyin linter’ni ishga tushir”. Hook yozing.

Tadbirkor vazifalarining 90% birinchi ikki toifaga kiradi. Subagentlar — keyingi bosqich vositasi; u “bir vaqtning o‘zida bitta vazifa”dan orkestratsiyaga o‘tayotganda kerak bo‘ladi.

Subagentlar qayerda joylashadi va qaysi biri ustun turadi?#

Subagentlar iyerarxiyasi ustuvorligi yuqoridan pastga qarab tartiblangan besh darajaga ega:

Ustuvorlik qoidasi Skills va CLAUDE.md uchun ham bir xil: tashkilot CLI’dan, CLI loyihadan, loyiha shaxsiy sozlamadan, shaxsiy sozlama esa plugindan ustun turadi.

Yuklash haqida nimalarni bilish kerak

Subagentlar Claude Code sessiyasi boshlanganda yuklanadi. Agent faylini diskda qo‘lda tahrir qilsangiz, sessiyani qayta boshlamaguningizcha o‘zgarishlar kuchga kirmaydi. Interaktiv /agents interfeysida kiritilgan tahrirlar esa darhol qo‘llanadi.

Har bir qamrov doirasi uchun bitta subagent — bitta fayl. Agar .claude/agents/ ichida code-reviewer.md va uning yonida yana bir code-reviewer.md bo‘lsa (masalan, eski zaxira nusxadan), Claude Code ulardan birini indamay e’tiborsiz qoldiradi. Hech qanday bildirishnoma chiqmaydi.

Plagin subagentlari alohida masala. Ularda xavfsizlik cheklovlari bor: ular hooks, mcpServers va permissionMode maydonlarini qo‘llab-quvvatlamaydi. Bu uchinchi tomon plaginini o‘rnatish unga kompyuteringizda ixtiyoriy kodni ishga tushirish huquqini berishining oldini oladi.

Subagent faylining tuzilishi: Frontmatter va asosiy qism#

Rasmiy hujjatlardan olingan minimal misol — bor-yo‘g‘i 9 qator:

---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---

You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.

Shu yetarli. Foydalanuvchi asosiy chatda “PR’imni ko‘rib chiq” desa, Claude “reviewer / code / quality” so‘zlarini tavsif bilan moslashtirib, vazifani subagentga topshiradi. Subagent diff’ni o‘qib, izohlar yozadi va asosiy chatga xulosa qaytaradi. Asosiy chat jurnallar va oraliq tahlillar bilan to‘lib ketmaydi.

Frontmatter’ning to‘liq sxemasi

model: haiku maydoni yuqoridagi beshta maqsaddagi “xarajatlarni boshqarish”ning ayni o‘zi. Agar 50 sahifa hujjatni o‘qiydigan tadqiqot agentingiz bo‘lsa, Opus bilan taqqoslaganda 5–7 baravar tejash uchun uni Haiku’da ishlating.

isolation: worktree maydoni muhim muammoni hal qiladi: subagent ehtimoliy xavfli o‘zgarishlar kiritadi (refaktoring, migratsiya), ammo siz uning ish nusxangizga tegishini istamaysiz. isolation: worktreeni belgilang, shunda Claude Code loyihaning vaqtinchalik git nusxasini yaratadi; subagent shu nusxada ishlaydi va ko‘rib chiqishingiz uchun diff qaytaradi.

Faylning asosiy qismi — tizim so‘rov matni

Frontmatter’dan keyin oddiy Markdown keladi — bu subagentning tizim so‘rov matnidir. Maxsus tuzilma shart emas, ammo quyidagi andaza sinalgan:

1. Siz kimsiz — bitta jumla: “siz kod tekshiruvchisisiz”, “siz xavfsizlik auditorisiz”, “siz hujjatlar mas’ulisisiz”.
2. Qachon chaqirilasiz va avval nima qilasiz — vazifani olgandan keyingi dastlabki 2–3 harakat.
3. Tekshiruvlar yoki qadamlardan iborat ro‘yxat — subagent bajaradigan 5–10 band.
4. Nima qaytarasiz — yakuniy hisobot formati. Bu juda muhim: formatni belgilamasangiz, subagent tuzilgan xulosa o‘rniga “insho” yozadi.
5. NIMA QILMAYSIZ — aniq cheklovlar. Bu bo‘lim bo‘lmasa, subagent o‘zicha ish tutishga o‘tadi.

Faylning asosiy qismini 200–500 qator bilan cheklang. Uzunroq bo‘lsa, batafsil manbalarni yon-atrofdagi alohida fayllarga ko‘chiring va so‘rov matnida ularga havola bering.

Claude subagentingizni albatta chaqirishi uchun tavsifni qanday yozish kerak#

Kod ko‘rib chiqish uchun subagent sozlab, Claude undan foydalanmay, hammasini o‘zi bajarishini ko‘rish — tez-tez uchraydigan muammo. Bunga odatda bitta sabab bo‘ladi: tavsif “Kod tekshiruvi uchun yordamchi” deb yozilgan. Claude uni qachon ishga tushirishni tushunmaydi.

Samarali tavsif formulasi (3 qism)

1-qism — nima qiladi. Jarayonni emas, natijani ifodalovchi bitta jumla. “Kodni tahlil qiladi” emas, balki “koddagi zaifliklarni topadi va jiddiyligi hamda tuzatish usuli ko‘rsatilgan ro‘yxatni qaytaradi”.

2-qism — qachon ishga tushirish kerak. Foydalanuvchilar amalda so‘rov yuboradigan 3–5 ta iborani qo‘shtirnoq ichida yozing. Taxmin qilmang — chat tarixingiz va haqiqiy iboralarga qarang.

3-qism — qachon ISHGA TUSHIRMASLIK kerak. Shu subagent javob bermasligi kerak bo‘lgan o‘xshash vazifalarga doir 1–2 ta ibora. Bu bo‘limsiz ikki o‘xshash agent doim bir-biriga xalaqit beradi.

“Use Proactively” sehrli iborasi

Anthropic’ning rasmiy hujjatlarida bevosita shunday tavsiya berilgan:

Boshqacha aytganda, tavsifda aniq signallar bo‘lmasa, Claude sukut bo‘yicha subagentni chaqirishga moyil emas. “Use proactively” yoki “kod yozilgandan keyin darhol ishlat” iboralarini qo‘shing — faollashish ehtimoli keskin oshadi.

Kuchli tavsif shunday ko‘rinadi

description: |
  Expert code review specialist. Proactively reviews code for quality,
  security, and maintainability. Use immediately after writing or
  modifying code. Returns prioritized list of issues with severity
  and fix recommendations.
  Do not invoke for documentation changes, README edits, or commit
  message rewrites - these are handled by doc-maintainer.

Bu yerda nima ish beradi:

• “reviews” + “returns” fe’llari jarayonni emas, aniq natijani bildiradi.
• “Proactively” va “immediately after” aniq triggerlardir.
• “Do not invoke for...” o‘xshash subagentlar bilan to‘qnashuvning oldini oladi.
• Tavsifni ingliz tilida yozish odatiy hol. Claude ingliz tilida yaxshiroq moslashtiradi.

10 daqiqada foydalanishga tayyor 5 ta subagent roli#

Quyidagi har bir rol bitta .claude/agents/<name>.md faylidan iborat. Faylni yaratgach, Claude Code’ni qayta ishga tushiring, /agentsni oching va yangi agent ro‘yxatda paydo bo‘lganini tekshiring. Keyin uni @agent-name bilan chaqirishingiz mumkin.

1. code-reviewer — har bir o‘zgarishdan keyin kodni ko‘rib chiqish

Bu — Anthropic hujjatlaridagi rasmiy misol, ish jarayoniga moslashtirilgan:

---
name: code-reviewer
description: |
  Expert code review specialist. Proactively reviews code for quality,
  security, and maintainability. Use immediately after writing or
  modifying code.
tools: Read, Grep, Glob
model: inherit
color: blue
---

You are a senior code reviewer ensuring high standards of code quality.

When invoked:
1. Asosiy seans bergan diff va o‘zgargan fayllar ro‘yxatini o‘qing. Yo‘q bo‘lsa, ulardan so‘rang.
2. Tegishli fayllarni Read, Grep va Glob bilan tekshiring.
3. Faylni o‘zgartirmay va shell bajarmay topilmalarni qaytaring.

Review checklist:
- Code is clear and readable
- Functions and variables are well-named
- No duplicated code
- Proper error handling
- No exposed secrets or API keys
- Input validation implemented
- Test coverage adequate
- Performance considerations addressed

Provide feedback organized by priority:
- Critical issues (must fix before merge)
- Warnings (should fix)
- Suggestions (consider improving)

Format: for each issue - file:line + 1 sentence why it's a problem + concrete fix.

Asosiy jihat — tools: Read, Grep, Glob: faqat fayl o‘qish va qidirish; Bash, Write va Edit yo‘q. Asosiy seans diff’ni tayyorlab beradi. To‘liq Bash berib, faqat git diff ishlat deyish uni cheklamaydi.

2. security-auditor — zaifliklar va sizib chiqishlarni topish

Bu rol chuqur fikrlash uchun opus, o‘sha Read, Grep va Glob cheklovini ishlatadi. Read-only shablonda doimiy memory yo‘q: uni yoqish xotiraga yozish imkonini ham beradi:

---
name: security-auditor
description: |
  Security audit specialist. Use proactively to find OWASP Top 10
  vulnerabilities, exposed secrets, injection risks, broken auth.
  Run before any deploy or merge to main.
tools: Read, Grep, Glob
model: opus
color: red
---

You are a security auditor. Find exploitable vulnerabilities, not style issues.

Audit checklist:
- SQL / NoSQL injection
- XSS (stored, reflected, DOM-based)
- CSRF / SSRF risks
- Hardcoded secrets (API keys, tokens, passwords)
- Broken auth / session management
- Insecure deserialization
- Missing input validation
- Path traversal
- Open redirects
- Insecure direct object references (IDOR)

For each finding:
- Severity: Critical / High / Medium / Low
- File:line
- Attack scenario in 1–2 sentences
- Fix recommendation with code example

Skip linter or style noise. Report only exploitable issues.

Vositalar nuqtayi nazaridan faqat o‘qish rejimi, murakkab zaiflik zanjirlari kabi tekshiruvlar uchun esa model: opus ishlatiladi.

3. research-agent — 8+ manba bo‘yicha chuqur tadqiqot

Bu andaza Anthropic’ning ko‘p agentli tadqiqot tizimi haqidagi maqolasida bayon qilingan. Undagi muhim jihat — aniq chiqish formati va xom natijalarni to‘kishni taqiqlash:

---
name: research-agent
description: |
  Deep web research specialist. Use proactively for fact-finding,
  competitive analysis, gathering external documentation, comparing
  approaches across multiple sources.
tools: WebFetch, WebSearch, Read, Write
model: sonnet
maxTurns: 30
color: purple
---

You are a research analyst. Goal: synthesized brief, not raw search dumps.

Process:
1. Decompose the question into 3–5 sub-queries
2. WebSearch each sub-query, fetch top 3–5 sources per query
3. Cross-verify claims across at least 2 independent sources
4. Reject SEO-farm and aggregator content; prefer primary sources
5. Quote verbatim with URL attribution for any specific claim
6. Return: TL;DR (3 bullets) + Findings + Sources (8+ domains minimum)

Anti-patterns to avoid:
- Don't cite a fact from a single source
- Don't paraphrase quotes as if they were verbatim
- Don't return raw search result dumps to the parent
- Don't include filler intro / outro ("Hope this helps")

maxTurns: 30 — cheksiz takroriy izlanishlarning oldini oluvchi himoya. Anthropic bu raqamni o‘zining ko‘p agentli tizimida keltirgan:

90 foizlik ko‘rsatkich tadqiqot mezonlariga oid vazifalarni anglatadi. Amaliy biznes vazifalarida o‘sish kichikroq, ammo umumiy miqyosi shunga yaqin.

4. doc-maintainer — hujjatlarni kod bilan muvofiq saqlash

Bu rolda model: haiku ishlatiladi — “xarajatni boshqarish”ning odatiy misoli. Hujjatlar uchun Opus shart emas; Haiku ishni narxning uchdan biriga bajaradi:

---
name: doc-maintainer
description: |
  Documentation sync specialist. Use after merging features to update
  README, API docs, CHANGELOG. Reads recent commits, identifies
  undocumented changes, updates docs proactively.
tools: Read, Write, Edit, Glob, Grep, Bash
model: haiku
memory: project
color: green
---

You maintain documentation in sync with code.

When invoked:
1. Run `git log --since="last release"` to see recent changes
2. Read README.md, docs/, CHANGELOG.md
3. Identify gaps: new features without docs, removed APIs still
   documented, version mismatches

Output:
- Updated files (use Edit, not Write - preserve existing structure)
- CHANGELOG.md entry in Keep-A-Changelog format
- List of changes you made (actual diff summary, not paraphrase)

Style rules:
- Active voice, present tense
- Code examples must be copy-pasteable
- No marketing language ("powerful", "robust", "seamless")
- No filler ("This guide will help you...")

5. refactor-agent — worktree orqali xavfsiz refaktoring

Bu rolda isolation: worktree ishlatiladi — subagent omborning alohida nusxasida ishlaydi, siz esa faqat hammasi joyida bo‘lsa, o‘zgarishlarni birlashtirasiz:

---
name: refactor-agent
description: |
  Safe refactor specialist. Use for renames, extracts, inlines that
  shouldn't touch your working copy until reviewed. Runs in a
  temporary git worktree.
tools: Read, Edit, Write, Bash, Grep, Glob
model: sonnet
isolation: worktree
permissionMode: acceptEdits
color: yellow
---

You refactor code without changing behavior.

Strict rules:
1. Tests must pass BEFORE and AFTER the refactor.
   If pre-refactor tests fail, STOP and report.
2. One atomic refactor per commit (extract, rename, inline).
3. Never change public APIs without explicit instruction.
4. Never modify tests unless they test the refactored implementation
   directly.

Process:
- Run test suite -> baseline
- Make atomic refactor
- Run test suite -> verify
- Commit with conventional message: refactor(scope): what

Return: summary of changes + worktree path so user can diff and merge.

Bu rol eng og‘riqli refaktoring muammosini — “nimanidir buzib qo‘ydim, endi orqaga qanday qaytarishni bilmayapman” holatini — bartaraf qiladi: asl nusxa o‘zgarishsiz qoladi, subagent esa alohida worktree’da ishlaydi.

Shunchaki tayyor subagentlarni nusxalash emas, balki Claude’ni barqaror vositaga aylantiradigan uyg‘unlikni yig‘moqchimisiz? Subagentlar — AI kloningizning bir qismi: Claude’ga sizning mantiqingiz asosida ishlaydigan ixtisoslashgan jamoa berish usuli. Metodologiyaning uch ustuni: AI klon (Skills + Subagents) + Ikkinchi miya + Kontekst muhandisligi. Bu uyg‘unlik Claude’ni taxmin qiladigan yordamchidan sizning mantiqingiz asosida fikrlaydigan vositaga aylantiradi.

5 ta subagentni parallel ishga tushirish: orkestrator + ijrochilar#

Parallel orkestratsiya — “dirijyor + orkestr” usulidir. Dirijyor rejani ushlab turadi, notalarni yozmaydi va sozandalar ijrosini tekshiradi. Kimdir noto‘g‘ri nota chalsa, dirijyor uning o‘rniga ishni yakunlashga urinish o‘rniga, qayta chalishni so‘raydi.

Tadbirkorga yaqinroq o‘xshatish — yangi mijoz uchun strategiya tayyorlayotgan marketing agentligi. Bir tahlilchi SWOT tahlilini qiladi, boshqasi raqobatchilarni tahlil qiladi, uchinchisi auditoriya profilini yaratadi, katta tahlilchi budjetga mos kelmaydigan farazlarni chiqarib tashlaydi, loyiha menejeri esa yakuniy taqdimotni yig‘adi. Claude Code’da bu jarayon bitta jumladan boshlanadi va tanqidchi keyinroq qo‘shilmaydi, balki boshidan jarayonning bir qismi bo‘ladi.

Minimal orkestratsiya so‘rov matni

Asosiy chatdagi bitta jumla yetarli:

Beshta subagentni parallel ishga tushir: turli manbalarni o‘rganuvchi uchta research-agent
(Anthropic hujjatlari, GitHub repozitoriylari, AI blogerlari), zaif xulosalarni
saralovchi bitta critic-agent va yakuniy hujjat uchun bitta summary-agent.

Kontekst: X haqida qo‘llanma yozyapman. Maqsadli uzunlik: manbalari bilan 2,000 so‘z.
Boshlashdan oldin ularning har biri CLAUDE.md faylini o‘qisin.

Keyin Claude vazifani beshta agentga topshiradi. Har biri o‘z kontekstida ishlaydi: tadqiqot agentlari tegishli manbalarni o‘rganadi, tanqidchi saralaydi, xulosa agenti esa hammasini yig‘adi. Asosiy chatga faqat yakuniy xulosalar qaytadi.

Parallel ishlash qayerda samara beradi

Hamma joyda emas. Parallel bajarish faqat quyidagi hollarda ma’qul:

1. Vazifalar mustaqil bo‘lsa. Agar research-agent #2 research-agent #1 natijasini kutayotgan bo‘lsa, parallel ishlash bo‘lmaydi — ular amalda ketma-ket ishlaydi.
2. Vazifalar uzoq vaqt olsa. “Oxiridagi bo‘sh joylarni olib tashlash”ni parallel bajarish befoyda; subagentlarni ishga tushirish xarajati yutuqni yo‘qqa chiqaradi.
3. Sizda yetarli limitlar bo‘lsa. Bu haqda quyidagi alohida bo‘limda batafsil yozilgan — parallel subagentlar tokenlarni tez sarflaydi.

Anthropic’ning Multi-Agent v2’si: keyingi bosqich

2026-yil may oyida Anthropic Multi-Agent Orchestration v2’ni chiqardi. U parallel subagentlarni ishga tushirishning klassik usulidan uchta muhim jihati bilan farq qiladi. Batafsil keyingi bo‘limda.

Multi-Agent v2’dagi yangiliklar: Orchestration, Outcomes, Dreaming#

Multi-Agent Orchestration: umumiy fayl tizimi + ish jarayoni davomida tekshiruvlar

Anthropic bu xususiyatni shunday ta’riflaydi:

Klassik subagentlardan asosiy farqi — umumiy fayl tizimi. Avval har bir subagent to‘liq alohida ishlardi va ma’lumot almashish faqat qaytarilgan xulosa orqali bo‘lardi. Endi mutaxassislar umumiy papkaga yozishi, yetakchi agent esa natijalarni faqat oxirida emas, ish davomida ham o‘qishi mumkin. Bu “hamma kun bo‘yi ishladi-yu, oxirida ikki kishining yondashuvlari mos kelmasligi ma’lum bo‘ldi” degan muammoni hal qiladi.

Ikkinchisi — ish jarayoni davomidagi tekshiruvlar. Yetakchi agent istalgan mutaxassisdan “ishlar qanday ketyapti?” deb so‘rab, keyin umumiy rejani o‘zgartirishi mumkin. Bu haqiqiy jamoa menejerining ishiga yaqin.

Outcomes: bosqichma-bosqich ko‘rsatmalar o‘rniga mezonlar

Outcomes’da siz muvaffaqiyat mezonlarini yozasiz, agent esa ularga erishish yo‘lini topadi. Natijani alohida baholovchi agent o‘z kontekstida tekshiradi, shuning uchun u asosiy agentning mulohazalari bilan “ifloslanmaydi”.

Murakkab vazifalarda 10 foizlik o‘sish jiddiy natija. Ayniqsa, vazifa “1–7-qadamlarga amal qil” emas, balki “mana shu sifat mezonlariga javob beradigan katta hajmli maqola tuz” tarzida berilsa.

Dreaming: agentlar sessiyalar orasida tajriba to‘playdi

Bu g‘oya jihatidan eng yangi xususiyat. Agent oldingi sessiyalarni ko‘rib chiqadi, muvaffaqiyat va xatolardagi andazalarni topadi va xotira omborini yangilaydi. O‘zgarishlarni qo‘llashdan oldin qo‘lda ko‘rib chiqishni sozlashingiz yoki agentga xotirani o‘zi tahrirlashga ruxsat berishingiz mumkin.

Anthropic’ning xabar berishicha, Harvey (yuridik texnologiyalar kompaniyasi) Dreaming’ni joriy qilgach, yuridik hujjatlar tayyorlash vazifalaridagi muvaffaqiyat qariyb olti baravar oshgan. Bu faqat namoyishdagi emas, ishlab chiqarishda ishlayotgan xususiyat.

Dasturlamaydigan tadbirkorlar uchun bu nimani anglatadi

Multi-Agent Orchestration hozirda Claude Code CLI’da bevosita emas, Claude Agent SDK orqali mavjud. Ammo yo‘nalish aniq: orkestratsiya “N ta subagentni qo‘lda ishga tushirish”dan “vazifani tasvirlaysiz, yetakchi agent kimga va qanday topshirishni o‘zi hal qiladi”ga o‘tmoqda. Subagentlardan endi foydalanishni boshlayotgan bo‘lsangiz, hozircha v2’dan xavotir olmang. “1 ta asosiy chat + turli rollardagi 3–5 ta subagent” klassik usulini o‘rganing, 3–6 oy ichida Managed Agents’ga tabiiy ravishda o‘ta olasiz.

Subagentlarni samarasiz qiladigan 7 ta xato#

1-xato. “X uchun yordamchi” tavsiflari trigger bo‘lmaydi

Alomat: subagent yozildi, tuzilmasi tekshirildi, hammasi yaroqli, ammo Claude foydalanuvchi so‘rovlarida uni chaqirmaydi. Sababi deyarli har doim bir xil: tavsif mavhum, masalan, “Kod tekshiruvi uchun yordamchi”. Yechim: tavsifning o‘zida qo‘shtirnoq ichida foydalanuvchilarning 3–5 ta haqiqiy iborasini yozing va ustiga “use proactively” / “use immediately after” iboralarini qo‘shing.

2-xato. Skill kerak bo‘lgan joyda subagent yaratish

Subagent Skill’dan qimmatroq: u o‘z kontekstini yaratadi, o‘z tizim so‘rov matnini yuklaydi va ko‘proq token ishlatadi. Vazifa qisqa bo‘lsa, asosiy kontekstni egallamasa va uni bir urinishda bajarish mumkin bo‘lsa, subagent emas, Skill kerak. Noto‘g‘ri yondashuvga misol: JSON sxemasini 20 ta qoida bo‘yicha tekshiradigan format-validator subagenti. Bunga Skill mos: bitta model, ajratish shart emas, qo‘shimcha kontekst ham yuklanmaydi.

3-xato. Boshidan “60 ta parallel agent” ishga tushirish

Bu eng keng tarqalgan xayol. “Menda 1,500 ta agent ishlayapti” degan tvitni ko‘rib, “men ham shunday qilishim kerak” deb o‘ylaysiz. Amalda 60 ta agent Pro rejasining limitlarini bir soatda sarflaydi, bir-biriga zid natijalarni uyib qo‘yadi, kun oxirida esa tugallangan ish bo‘lmaydi.

Medium’dagi amaliyotchi buni shunday ta’riflaydi:

Yechim: bitta vazifa uchun bitta subagentdan boshlang. Buni o‘zlashtirgach, boshqa rolga ega ikkinchi agentni qo‘shing. Ikki agentni muvofiqlashtirishni o‘zlashtirgach, 3–5 kishilik jamoaga o‘ting. “Kecha Claude Code’ni o‘rnatdim”dan “bugun 20 tasini parallel ishlatyapman”ga o‘tish kodni buzishi va limitlarni sarflashi aniq.

4-xato. Har bir agentga barcha vositalarni berish

Kod tekshiruvchingiz Bash, Write va WebFetch’dan foydalana olsa, bu xavfsizlik va xarajatlar uchun katta teshik. Tekshiruvchiga fayl yozish, qolaversa, internetga chiqish huquqi kerak emas.

Yechim: toolsni qat’iy cheklang. Kod tekshiruvchiga faqat Read, Grep, Glob bering. Xavfsizlik auditoriga o‘sha o‘qish/qidirish vositalari va asosiy seans tayyorlagan diff’ni bering. Bash shell imkonini beradi, o‘z-o‘zidan faqat git diff bilan cheklanmaydi. Tadqiqot agentiga WebFetch, WebSearch, Read, Write bering. Bitta muayyan vazifa uchun subagentga zaruridan ortiq ruxsat bermang.

5-xato. Subagent xom natijalarni asosiy kontekstga to‘kadi

Tadqiqot agenti asosiy chatga “mana topgan 30 sahifam, o‘zing tushunib ol” desa, subagentlarning asosiy afzalligi — shovqinni ajratish — yo‘qqa chiqadi. Yechim: subagentning tizim so‘rov matnida chiqish formatini aniq talab qiling. “FAQAT quyidagilarni qaytar: 3 bandli qisqa xulosa + 5 manba ro‘yxati. Kodni yoki xom qidiruv natijalarini chiqarma.” Format qat’iy bo‘lishi kerak — subagentga “inshoga aylantirish” erkinligini bermang.

6-xato. Noaniq chaqiruvlar: topshiriq tushunarsiz

Subagent asosiy suhbat tarixini ko‘ra olmaydi. U toza kontekst + CLAUDE.md + siz unga aniq yozgan narsalar bilan boshlaydi. “Autentifikatsiyani tuzat” deb yozsangiz, subagent tafsilotlarni o‘ylab topadi. Buning o‘rniga: “OAuth yo‘naltirish siklini tuzat: muvaffaqiyatli kirishdan so‘ng foydalanuvchi /dashboard o‘rniga /login sahifasiga yo‘naltirilmoqda. Fayl: src/lib/auth.ts.”

Aniq qoida: vazifani topshirayotganda, loyihaga endigina qo‘shilgan pudratchiga bergan bo‘lardingiz, shuncha kontekst bering.

7-xato. Vazifaga emas, rolga asoslangan agentlar

Jozibali ko‘rinadigan andaza: “frontend-developer, backend-developer va qa-engineer yaratib, ularni jamoa qilib ishlataylik”. Bu ishlamaydi. Har bir “rol” butun loyiha kontekstini yo‘qotadi, bir-birini ko‘ra olmagani uchun tafsilotlarda kelisha olmaydi.

Yechim: subagent aniq natijaga ega takrorlanuvchi vazifani bajarishi kerak, rolni emas. “frontend-developer” emas, balki “explore-ui-tree”, “refactor-component”, “audit-accessibility”. Vazifaga asoslangan har bir subagent bitta aniq ishni bajaradi va bitta aniq natija qaytaradi.

Parallel subagentlar qancha turadi va qachon foyda keltiradi?#

Murakkab vazifalarda 5 ta parallel subagentni ishga tushirsangiz, Pro rejasi bir soat ichida tugaydi. Max 5x ($100) muntazam parallel ish uchun realistik eng kam variant. Jamoalar va Enterprise’da xarajat masalasi allaqachon vositalar budjeti darajasida hal qilingan.

Claude Code’da tokenlarni tejash haqida batafsil ma’lumot uchun limitlar haqidagi alohida qo‘llanmani ko‘ring. Subagentlardan foydalanishning asosiy qoidasi — ular kamida 10 daqiqa diqqat talab qiladigan vazifalarda o‘zini oqlaydi. Vazifa qisqaroq bo‘lsa, subagent yaratmang; uni asosiy chatda yoki Skill yordamida bajaring.

Subagentlarni AI kloningiz va Ikkinchi miyangizga qanday qo‘shasiz?#

Birinchi mutaxassisni yaratishdan oldin loyihangizda subagent tayanadigan uchta narsa bo‘lishi kerak:

1. To‘g‘ri CLAUDE.md. Subagent ish boshlashdan oldin CLAUDE.md’ni o‘qiydi — bu uning “mehnat shartnomasi”. Busiz subagent loyiha konteksti, cheklovlari yoki uslubini bilmaydi. U tafsilotlarni o‘ylab topadi.

2. Asosiy Skills. Skill — qadoqlangan metodologiya. Subagent hammasini birdaniga emas, faqat o‘ziga kerakli Skills’ni yuklaydi. Skills’siz har safar ishni boshidan takrorlaydi.

3. Ikkinchi miya: bilimlar tuzilmasi. business/ papkasi (yoki sohangizdagi muqobili) barcha subagentlar murojaat qiladigan kutubxonadir. Busiz subagent boshqa har qanday javobdan farq qilmaydigan o‘rtacha ChatGPT javobini beradi.

Bu tartibni teskarisiga o‘zgartirsangiz, natijasiz shov-shuvga erishasiz. Bo‘sh business/ papkasi bilan “menda 60 ta parallel subagent bor” deyish — bir xil yondashuvdagi 60 ta o‘rtacha ChatGPT sessiyasini anglatadi.

To‘liq uyg‘unlik — AI klon + Ikkinchi miya + Kontekst muhandisligi — Claude’ni izchil ishlatadigan uchta ustundir. Subagentlar AI klonning bir qismi: Claude’ga sizning mantiqingiz bo‘yicha ishlaydigan ixtisoslashgan jamoa berish usuli.

Boshlashning eng tez yo‘li — yuqoridagi birinchi misoldagi code-reviewerni .claude/agents/code-reviewer.md fayliga nusxalash, Claude Code’ni qayta ishga tushirish va keyingi commit’ingizda @agent-code-reviewer deb chaqirish. 5 daqiqada subagentlar kerakmi yoki asosiy chatning o‘zi yetarlimi, bilib olasiz.