Subagenti Claude Code: štruktúra, päť rolí a orchestrácia

Čo je subagent v Claude Code a prečo to nie je „len ďalší Skill“?#

Dokumentácia Claude Code ho definuje takto:

Povedané tak, aby tomu rozumel podnikateľ: predstavte si realitnú kanceláriu. Je tam riaditeľ, marketér, právnik a obchodní manažéri. Jeden zamestnanec, ktorý strieda všetky tieto roly, netvorí tím; je to preťažený človek. Tím vzniká vtedy, keď má každý vlastný kontext a oblasť zodpovednosti, zatiaľ čo riaditeľ iba prideľuje úlohy a spája výsledky.

Subagenti v Claude Code fungujú rovnako. Hlavný chat je riaditeľ. Subagent je špecialista s úzko vymedzenou úlohou, vlastným kontextom a súborom nástrojov. Keď sa úloha zhoduje s opisom špecialistu, riaditeľ mu ju deleguje — a nezaoberá sa podrobnosťami.

5 cieľov, pre ktoré Anthropic vytvoril subagentov

Dokumentácia Anthropic uvádza presne päť dôvodov na vytvorenie vlastného subagenta:

Najpraktickejšou položkou v tomto zozname pre neprogramátora je kontrola nákladov. Náročnú výskumnú úlohu môžete poslať lacnému modelu Haiku a pokračovať v hlavnej konverzácii na Sonnete alebo Opuse. Úspora tokenov je priamo úmerná.

Overte podporu vnárania nainštalovanej verzie

Šablóny v tomto sprievodcovi používajú jednu hlavnú reláciu delegujúcu priamo vykonávateľom. Staršiu dokumentáciu hovoriacu „subagenti nemôžu vytvárať ďalších subagentov“ nepovažujte za nadčasové pravidlo: vnáranie závisí od nainštalovanej verzie a povolených nástrojov. Samostatný sprievodca vnorenými subagentmi opisuje verziovo konkrétny postup. Pred hlbším delegovaním overte podporu vlastnej inštalácie.

Čím sa subagent líši od Skillu, slash commandu a hooku?#

Predchádzajúci sprievodca o Skills vysvetľuje, že skills a slash commands v Claude Code sa v podstate zlúčili do jedného formátu. Subagent je však iný druh nástroja — nie je to len „väčší skill“.

Súhrnná tabuľka štyroch mechanizmov:

V anglicky písanom sprievodcovi sa to dá dobre vyjadriť takto: skills sú recepty; subagenti sú špecializovaní kolegovia.

Uveďme to jednoducho: skills sú recepty; subagenti sú špecializovaní kolegovia.

V praxi to funguje takto: skills sa aktivujú automaticky, keď ich opis zodpovedá úlohe, zatiaľ čo subagenti sa spúšťajú explicitne — buď sa hlavný chat rozhodne úlohu delegovať, alebo jedného zavoláte podľa mena.

Rozhodovací strom: „Ktorý si mám vybrať?“

Keď si poviete „potrebujem, aby Claude urobil X“, prejdite si tieto štyri otázky:

1. Je to informácia, ktorá má byť vždy dostupná? Napríklad: „lokalizujeme do jazyka preferovaného používateľom“ alebo „nepoužívame dlhé pomlčky“. Vložte ju do CLAUDE.md.
2. Je to metodika, ktorú teraz vykonávate manuálne a spúšťa sa na základe podnetu? Napríklad: „každý pondelok píšem správu o predaji“. Vytvorte skill.
3. Spotrebuje úloha kontext hlavného chatu, alebo ju možno spustiť paralelne? Napríklad „dôkladný výskum naprieč 30 zdrojmi“ alebo „bezpečnostný audit, kým píšem novú funkciu“. Vytvorte subagenta.
4. Potrebujete automatickú reakciu na udalosť v Claude Code? Napríklad: „spusti linter po každom Edit“. Napíšte hook.

90 % úloh podnikateľa patrí do prvých dvoch kategórií. Subagenti sú nástroj vyššej úrovne, keď prechádzate od „jednej úlohy naraz“ k orchestrácii.

Kde sa subagenti nachádzajú a ktorý má prednosť?#

Hierarchia subagentov má päť úrovní, zoradených od najvyššej po najnižšiu prioritu:

Logika priority je rovnaká ako pri Skills a CLAUDE.md: organizácia má prednosť pred CLI, CLI pred projektom, projekt pred osobnými nastaveniami a osobné nastavenia pred pluginom.

Čo treba vedieť o načítaní

Subagenti sa načítajú pri spustení relácie Claude Code. Ak súbor agenta upravíte ručne na disku, zmeny sa prejavia až po reštartovaní relácie. Úpravy cez interaktívne rozhranie /agents sa prejavia okamžite.

Jeden subagent na rozsah znamená jeden súbor. Ak .claude/agents/ obsahuje code-reviewer.md a vedľa neho ďalší súbor code-reviewer.md (napríklad zo starej zálohy), Claude Code jeden z nich potichu ignoruje. Nezobrazí sa žiadne upozornenie.

Subagenti pluginov sú samostatný prípad. Majú bezpečnostné obmedzenia: nepodporujú polia hooks, mcpServers a permissionMode. Tým sa zabraňuje tomu, aby inštalácia pluginu tretej strany umožnila jeho tvorcovi spúšťať na vašom počítači ľubovoľný kód.

Ako je štruktúrovaný súbor subagenta: frontmatter a telo#

Minimálny príklad z oficiálnej dokumentácie — iba 9 riadkov:

---
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.

To stačí. Ak používateľ v hlavnom chate povie „skontroluj moje PR“, Claude porovná výrazy „reviewer / code / quality“ s opisom a deleguje úlohu subagentovi. Subagent prečíta diff, vytvorí komentáre a vráti hlavnej konverzácii zhrnutie. Hlavný chat sa nezahltí záznamami ani priebežnou analýzou.

Úplná schéma frontmatteru

Pole model: haiku predstavuje práve tú „kontrolu nákladov“ zo zoznamu piatich cieľov. Ak máte research agenta, ktorý číta 50 strán dokumentácie, spustite ho na Haiku a ušetrite 5–7-násobok nákladov oproti Opusu.

Pole isolation: worktree rieši dôležitý problém: subagent vykonáva potenciálne nebezpečné zmeny (refaktoring, migráciu), no nechcete, aby zasiahol do vašej pracovnej kópie. Nastavte isolation: worktree a Claude Code vytvorí dočasnú git kópiu projektu; subagent bude pracovať v nej a vráti vám diff na kontrolu.

Telo súboru je system prompt

Za frontmatterom nasleduje bežný Markdown — system prompt subagenta. Špeciálna štruktúra nie je potrebná, no osvedčil sa tento vzor:

1. Kto si — jedna veta: „si kontrolór kódu“, „si bezpečnostný audítor“, „si správca dokumentácie“.
2. Kedy ťa spustia a čo urobíš ako prvé — prvé 2–3 kroky po prijatí úlohy.
3. Kontrolný zoznam krokov alebo kontrol — 5–10 bodov, ktorými sa subagent riadi.
4. Čo vrátiš — formát záverečnej správy. Je to dôležité: ak neurčíte formát, subagent vytvorí „esej“ namiesto štruktúrovaného zhrnutia.
5. Čo NEROBÍŠ — výslovné obmedzenia. Bez tejto časti sa subagent pustí do improvizácie.

Telo súboru udržujte v rozsahu 200–500 riadkov. Ak sa predĺži, presuňte rozsiahle referencie do samostatných blízkych súborov a odkážte na ne v prompte.

Ako napísať opis, aby Claude určite spúšťal vášho subagenta#

Častým problémom pri využívaní subagentov na kontrolu kódu je, že Claude vykoná kontrolu samo a subagenta nepoužije. Zvyčajne je dôvod jediný: opis znie „Pomocník na kontrolu kódu“. Claude nerozumie, kedy ho má spustiť.

Vzorec efektívneho opisu (3 časti)

Časť 1 — čo robí. Jedna veta o výsledku, nie o procese. Nie „analyzuje kód“, ale „vyhľadáva v kóde zraniteľnosti a vracia zoznam ich závažnosti a spôsobov opravy“.

Časť 2 — kedy ho spustiť. 3–5 fráz v úvodzovkách, ktoré zodpovedajú skutočným požiadavkám používateľov. Nehádajte — pozrite si históriu chatu a reálne formulácie.

Časť 3 — kedy ho NESPUŠŤAŤ. 1–2 frázy o podobných úlohách, na ktoré tento subagent nemá reagovať. Bez tejto časti sa dva podobné agenti neustále dostávajú do konfliktu.

Magická fráza „Používaj proaktívne“

Oficiálna dokumentácia Anthropic dáva priame odporúčanie:

Inými slovami, ak opis neobsahuje jasné signály, Claude má predvolene skôr tendenciu subagenta nespustiť. Pridajte „používaj proaktívne“ alebo „použi ihneď po napísaní kódu“ a aktivácia sa výrazne zvýši.

Takto vyzerá kvalitný opis

description: |
  Špecialista na kontrolu kódu. Proaktívne kontroluje kvalitu,
  bezpečnosť a udržiavateľnosť kódu. Použi ho ihneď po napísaní alebo
  úprave kódu. Vráti zoradený zoznam problémov so závažnosťou
  a odporúčaniami na opravu.
  Nespúšťaj ho pri zmenách dokumentácie, úpravách README ani prepisovaní
  správ commitov – o tie sa stará doc-maintainer.

Čo tu funguje:

• Slovesá „kontroluje“ + „vracia“ označujú konkrétny výsledok, nie proces.
• „Proaktívne“ a „ihneď po“ sú explicitné spúšťače.
• „Nespúšťaj ho pri...“ vylučuje konflikt s podobným subagentom.
• Opisy v angličtine sú bežné. Claude ich v angličtine priraďuje presnejšie.

5 pripravených rolí subagentov, ktoré fungujú za 10 minút#

Každá rola nižšie je jediný súbor, .claude/agents/<name>.md. Po jeho vytvorení reštartujte Claude Code, otvorte /agents a skontrolujte, či sa nový agent zobrazuje v zozname. Potom ho môžete zavolať pomocou @agent-name.

1. code-reviewer — kontrola kódu po každej zmene

Toto je oficiálny príklad z dokumentácie Anthropic, upravený pre pracovný proces:

---
name: code-reviewer
description: |
  Špecialista na kontrolu kódu. Proaktívne kontroluje kvalitu,
  bezpečnosť a udržiavateľnosť kódu. Použi ho ihneď po napísaní alebo
  úprave kódu.
tools: Read, Grep, Glob
model: inherit
color: blue
---

Si seniorný kontrolór kódu, ktorý dbá na vysokú úroveň kvality kódu.

Po spustení:
1. Prečítaj diff a zoznam zmenených súborov dodané hlavnou reláciou. Ak chýbajú, vyžiadaj ich od hlavnej relácie.
2. Pomocou Read, Grep a Glob preskúmaj relevantné súbory.
3. Vráť zistenia bez úprav súborov a spúšťania príkazov shellu.

Kontrolný zoznam:
- Kód je zrozumiteľný a čitateľný
- Funkcie a premenné majú výstižné názvy
- Neobsahuje duplicitný kód
- Správne spracúva chyby
- Neobsahuje odhalené tajomstvá ani kľúče API
- Je implementovaná validácia vstupu
- Testovacie pokrytie je dostatočné
- Zohľadňujú sa požiadavky na výkon

Spätnú väzbu usporiadaj podľa priority:
- Kritické problémy (musia sa opraviť pred zlúčením)
- Upozornenia (mali by sa opraviť)
- Návrhy (zváž zlepšenie)

Formát: ku každému problému uveď súbor:riadok + 1 vetu vysvetľujúcu problém + konkrétnu opravu.

Kľúčové je tools: Read, Grep, Glob: kontrolór má nástroje na čítanie a hľadanie bez prístupu k Bash, Write či Edit. Diff pripraví a odovzdá hlavná relácia. Samotný pokyn používať iba git diff by plne udelený nástroj Bash neobmedzil.

2. security-auditor — hľadanie zraniteľností a únikov

Táto rola používa opus na hlbšie uvažovanie a rovnaké obmedzenie nástrojov Read, Grep a Glob. Trvalá pamäť je zo šablóny iba na čítanie vynechaná, pretože zapnutie pamäte agenta pridáva aj možnosť zapisovať do nej:

---
name: security-auditor
description: |
  Špecialista na bezpečnostný audit. Používaj proaktívne na vyhľadávanie zraniteľností OWASP Top 10,
  odhalených tajomstiev, rizík injection a zlyhaní autentifikácie.
  Spúšťaj ho pred každým nasadením alebo zlúčením do main.
tools: Read, Grep, Glob
model: opus
color: red
---

Si bezpečnostný audítor. Hľadaj zneužiteľné zraniteľnosti, nie štylistické problémy.

Kontrolný zoznam:
- SQL / NoSQL injection
- XSS (uložené, reflektované, DOM-based)
- Riziká CSRF / SSRF
- Natvrdo zadané tajomstvá (kľúče API, tokeny, heslá)
- Nedostatky v autentifikácii / správe relácií
- Nezabezpečená deserializácia
- Chýbajúca validácia vstupu
- Path traversal
- Otvorené presmerovania
- Nezabezpečené priame referencie na objekty (IDOR)

Pri každom náleze uveď:
- Závažnosť: Critical / High / Medium / Low
- Súbor:riadok
- Scenár útoku v 1–2 vetách
- Odporúčanie na opravu s príkladom kódu

Vynechaj šum z lintera a štylistické pripomienky. Hlás iba zneužiteľné problémy.

Nástroje sú obmedzené na čítanie; model: opus sa používa na zložité kontroly, napríklad reťazce zraniteľností.

3. research-agent — dôkladný výskum naprieč 8+ zdrojmi

Tento vzor opisuje samotná Anthropic vo svojom článku o systéme multi-agentového výskumu. Kľúčový je explicitný výstupný formát a zákaz vypisovať surové výsledky:

---
name: research-agent
description: |
  Špecialista na dôkladný webový výskum. Používaj proaktívne na zisťovanie faktov,
  konkurenčnú analýzu, zhromažďovanie externej dokumentácie a porovnávanie
  prístupov z viacerých zdrojov.
tools: WebFetch, WebSearch, Read, Write
model: sonnet
maxTurns: 30
color: purple
---

Si výskumný analytik. Cieľ: syntetizovaný prehľad, nie surové výpisy z vyhľadávania.

Postup:
1. Rozdeľ otázku na 3–5 čiastkových otázok
2. Pre každú čiastkovú otázku použi WebSearch a načítaj 3–5 najlepších zdrojov
3. Over tvrdenia aspoň v 2 nezávislých zdrojoch
4. Odmietni SEO farmy a agregátory; uprednostni primárne zdroje
5. Pri konkrétnych tvrdeniach cituj doslova a uveď URL
6. Vráť: TL;DR (3 odrážky) + Zistenia + Zdroje (minimálne 8 domén)

Antivzory, ktorým sa treba vyhnúť:
- Necituj fakt iba z jedného zdroja
- Neparafrázuj citácie tak, akoby boli doslovné
- Nevracaj nadradenému agentovi surové výpisy výsledkov vyhľadávania
- Nepridávaj prázdny úvod / záver ("Dúfam, že to pomôže")

maxTurns: 30 chráni pred tým, aby sa výskum ťahal do nekonečna. Anthropic uvádza túto hodnotu vo svojom multi-agentovom systéme:

Deväťdesiat percent sa týka výskumných benchmarkových úloh. V praxi je prínos pri podnikových úlohách menší, no jeho všeobecný rozsah je podobný.

4. doc-maintainer — udržiavanie dokumentácie v súlade s kódom

Táto rola používa model: haiku — typický príklad „kontroly nákladov“. Dokumentácia nevyžaduje Opus; Haiku ju zvládne za tretinovú cenu:

---
name: doc-maintainer
description: |
  Špecialista na synchronizáciu dokumentácie. Použi ho po zlúčení funkcií na aktualizáciu
  README, dokumentácie API a CHANGELOG. Číta nedávne commity, identifikuje
  nezdokumentované zmeny a proaktívne aktualizuje dokumentáciu.
tools: Read, Write, Edit, Glob, Grep, Bash
model: haiku
memory: project
color: green
---

Udržiavaš dokumentáciu v súlade s kódom.

Po spustení:
1. Spusti `git log --since="last release"` a prezri si nedávne zmeny
2. Prečítaj README.md, docs/, CHANGELOG.md
3. Identifikuj nedostatky: nové funkcie bez dokumentácie, odstránené API, ktoré sa stále dokumentujú, nesúlad verzií

Výstup:
- Aktualizované súbory (použi Edit, nie Write — zachovaj existujúcu štruktúru)
- Záznam v CHANGELOG.md vo formáte Keep-A-Changelog
- Zoznam vykonaných zmien (skutočné zhrnutie diffu, nie parafráza)

Pravidlá štýlu:
- Činný rod, prítomný čas
- Príklady kódu musia byť pripravené na skopírovanie a vloženie
- Bez marketingových výrazov ("výkonný", "robustný", "plynulý")
- Bez prázdnych fráz ("Tento sprievodca vám pomôže...")

5. refactor-agent — bezpečný refaktoring cez worktree

Táto rola používa isolation: worktree — subagent pracuje v samostatnej kópii repozitára a zlúčite zmeny iba vtedy, ak sú v poriadku:

---
name: refactor-agent
description: |
  Špecialista na bezpečný refaktoring. Použi ho na premenovania, vyčlenenia a vloženia,
  ktoré by sa nemali dotknúť tvojej pracovnej kópie, kým ich neskontroluješ. Spúšťa sa v
  dočasnom git worktree.
tools: Read, Edit, Write, Bash, Grep, Glob
model: sonnet
isolation: worktree
permissionMode: acceptEdits
color: yellow
---

Refaktoruješ kód bez zmeny jeho správania.

Prísne pravidlá:
1. Testy musia prejsť PRED refaktoringom aj PO ňom.
   Ak testy pred refaktoringom zlyhajú, ZASTAV a oznám to.
2. Jeden atómový refaktoring na commit (vyčlenenie, premenovanie, vloženie).
3. Nikdy nemeň verejné API bez výslovného pokynu.
4. Neupravuj testy, pokiaľ priamo netestujú refaktorovanú implementáciu.

Postup:
- Spusti testovaciu sadu -> východiskový stav
- Vykonaj atómový refaktoring
- Spusti testovaciu sadu -> overenie
- Vytvor commit s konvenčnou správou: refactor(scope): what

Vráť: zhrnutie zmien + cestu k worktree, aby používateľ mohol zmeny porovnať a zlúčiť.

Táto rola rieši najnepríjemnejší problém refaktoringu — „pokazil som to a neviem, ako to vrátiť“: pôvodná kópia zostáva nedotknutá a subagent pracuje v izolovanom worktree.

Spustenie 5 subagentov paralelne: orchestrátor + pracovníci#

Paralelná orchestrácia funguje ako „dirigent + orchester“. Dirigent drží plán, nepíše noty a kontroluje, čo hudobníci hrajú. Ak niekto zahrá nesprávnu notu, dirigent ho požiada, aby ju zahral znova, namiesto toho, aby sa pokúšal dokončiť prácu zaňho.

Pre podnikateľa je bližším prirovnaním marketingová agentúra, ktorá pripravuje stratégiu pre nového klienta. Jeden analytik spracuje SWOT, ďalší analyzuje konkurenciu, tretí vytvorí profil publika, seniorný analytik vyradí hypotézy, ktoré sa nehodia do rozpočtu, a projektový manažér zostaví záverečnú prezentáciu. V Claude Code sa tento postup začína jednou vetou — a kritik je súčasťou procesu, namiesto toho, aby sa pridal až dodatočne.

Minimálny orchestračný prompt

V hlavnom chate stačí jedna veta:

Spusti päť subagentov paralelne: troch research-agents pre rôzne zdroje
(dokumentácia Anthropic, repozitáre GitHub, autori o AI), jedného critic-agenta na filtrovanie
slabých záverov a jedného summary-agenta na vytvorenie záverečného dokumentu.

Kontext: píšem sprievodcu o X. Cieľový rozsah: 2,000 slov so zdrojmi.
Každý si pred začiatkom prečíta CLAUDE.md.

Claude potom deleguje úlohy piatim agentom. Každý pracuje vo vlastnom kontexte: výskumní agenti používajú svoje zdroje, kritik filtruje a summary agent zostaví výsledok. Do hlavného chatu sa vracajú iba záverečné zhrnutia.

Kde sa paralelizmus oplatí

Nie všade. Paralelné vykonávanie má zmysel iba vtedy, keď:

1. Úlohy sú nezávislé. Ak research-agent #2 čaká na výsledok research-agent #1, paralelizmus sa nekoná — v skutočnosti budú pracovať sekvenčne.
2. Úlohy trvajú dlho. Paralelizovať „odstráň koncové medzery“ nemá zmysel; réžia spojená so spustením subagentov pohltí všetok prínos.
3. Máte dostatočné limity. Viac sa tomu venuje samostatná časť nižšie — paralelné subagenty rýchlo míňajú tokeny.

Multi-Agent v2 od Anthropic: ďalší krok

V máji 2026 Anthropic vydala Multi-Agent Orchestration v2, ktoré sa od klasického prístupu spúšťania paralelných subagentov líši tromi dôležitými vlastnosťami. Viac v nasledujúcej časti.

Novinky v Multi-Agent v2: orchestrácia, výsledky, Dreaming#

Multi-Agent Orchestration: zdieľaný súborový systém + priebežné kontroly

Anthropic opisuje túto funkciu takto:

Kľúčovým rozdielom oproti klasickým subagentom je zdieľaný súborový systém. Predtým každý subagent pracoval v úplnej izolácii a výmena prebiehala iba prostredníctvom vráteného zhrnutia. Teraz môžu špecialisti zapisovať do zdieľaného priečinka a vedúci agent číta výsledky počas práce, nielen na jej konci. Tým sa rieši problém „všetci celý deň pracovali a nakoniec sa ukázalo, že dvaja ľudia používali nekompatibilné postupy“.

Druhou novinkou sú priebežné kontroly počas pracovného postupu. Vedúci agent môže prácu pozastaviť a opýtať sa ktoréhokoľvek špecialistu „ako to ide?“, potom upraviť celkový plán. Je to podobné tomu, ako pracuje skutočný vedúci tímu.

Outcomes: hodnotiace kritériá namiesto pokynov krok za krokom

V Outcomes napíšete kritériá úspechu a agent nájde spôsob, ako ich splniť. Výsledok vo vlastnom kontexte skontroluje samostatný grader, aby ho „nekontaminovalo“ uvažovanie hlavného agenta.

Desať percent pri náročných úlohách je výrazné zlepšenie. Najmä keď úlohu formulujete ako „zostav rozsiahly článok, ktorý spĺňa tieto kritériá kvality“, namiesto „postupuj podľa krokov 1–7“.

Dreaming: agenti zbierajú skúsenosti medzi reláciami

Ide o koncepčne najnovšiu funkciu. Agent prechádza minulé relácie, hľadá vzory úspechov a chýb a aktualizuje úložisko pamäte. Pred uplatnením zmien môžete nastaviť manuálnu kontrolu alebo nechať agenta upravovať pamäť samostatne.

Anthropic uvádza, že Harvey (spoločnosť pôsobiaca v oblasti právnych technológií) zaznamenala po zavedení Dreaming približne šesťnásobné zvýšenie úspešnosti pri úlohách tvorby právnych dokumentov. Funkcia už funguje v produkcii, nejde iba o ukážku.

Čo to znamená pre podnikateľov, ktorí neprogramujú

Multi-Agent Orchestration je momentálne dostupný cez Claude Agent SDK, nie priamo v CLI Claude Code. Smerovanie je však jasné: orchestrácia sa posúva od „ručne spúšťate N subagentov“ k „opíšete úlohu a vedúci agent rozhodne, komu ju delegovať a ako“. Ak so subagentmi len začínate, zatiaľ si s v2 nerobte starosti. Naučte sa klasický vzor „1 hlavný chat + 3–5 subagentov s rôznymi rolami“ a o 3–6 mesiacov môžete prirodzene prejsť na Managed Agents.

7 chýb, ktoré subagentov pripravia o úspech#

Chyba 1. Opisy „Pomocník pre X“ nespúšťajú agenta

Príznak: napísali ste subagenta, skontrolovali štruktúru a všetko je platné, no Claude ho pri požiadavkách používateľa nespúšťa. Dôvod je takmer vždy rovnaký: opis je abstraktný, napríklad „Pomocník na kontrolu kódu“. Riešenie: priamo do opisu napíšte 3–5 skutočných používateľských fráz v úvodzovkách a pridajte „používaj proaktívne“ / „použi ihneď po“.

Chyba 2. Vytvorenie subagenta namiesto Skillu

Subagent stojí viac než Skill — vytvára vlastný kontext, načíta vlastný system prompt a používa viac tokenov. Ak je úloha krátka, nespotrebuje hlavný kontext a dá sa zvládnuť na jeden raz, mal by ju vykonať Skill, nie subagent. Príklad antivzoru: subagent format-validator, ktorý kontroluje JSON schema podľa 20 pravidiel. Má to byť Skill: jeden model, bez potreby izolácie či načítania ďalšieho kontextu.

Chyba 3. Spustenie „60 paralelných agentov“ hneď na začiatku

Ide o najrozšírenejšiu ilúziu. Vidíte tweet „mám v prevádzke 1,500 agentov“ a pomyslíte si: „mal by som to robiť tiež“. V skutočnosti 60 agentov vyčerpá limity programu Pro za hodinu, vytvorí množstvo protichodných výsledkov a na konci dňa nemáte nič dokončené.

Jeden odborník na Medium to vyjadruje takto:

Riešenie: začnite s jedným subagentom na jednu úlohu. Keď to zvládnete, pridajte druhého s odlišnou rolou. Keď sa naučíte koordinovať dvoch, prejdite na tím 3–5. Skok od „včera som nainštaloval Claude Code“ k „dnes mám 20 agentov paralelne“ zaručene pokazí kód a vyčerpá limity.

Chyba 4. Poskytnutie všetkých nástrojov každému agentovi

Ak má váš kontrolór kódu prístup k Bash, Write a WebFetch, ide o obrovskú bezpečnostnú a nákladovú dieru. Kontrolór by nemal mať povolenie zapisovať súbory, nieto ešte prístup na internet.

Riešenie: prísne obmedzte tools. Kontrolór kódu potrebuje iba Read, Grep, Glob. Bezpečnostný audítor dostáva rovnaké nástroje na čítanie a hľadanie a diff z hlavnej relácie. Pridanie Bash udeľuje schopnosť pracovať so shellom; automaticky ho neobmedzuje na git diff. Research agent potrebuje WebFetch, WebSearch, Read, Write. Nedávajte subagentovi viac oprávnení, než potrebuje na konkrétnu úlohu.

Chyba 5. Subagent vypisuje surové výsledky do hlavného kontextu

Ak research agent vráti do hlavného chatu „tu je všetkých 30 stránok, ktoré som našiel; poraďte si“, prišli ste o hlavnú výhodu subagentov: izoláciu šumu. Riešenie: výslovne stanovte výstupný formát v system prompte subagenta. „Vráť IBA: TL;DR s 3 odrážkami + zoznam 5 zdrojov. BEZ výpisov kódu, BEZ surových výsledkov vyhľadávania.“ Formát musí byť prísny — subagent nesmie mať voľnosť „prepracovať ho na esej“.

Chyba 6. Neurčité zadania: nejasné požiadavky na delegovanie

Subagent nevidí históriu hlavného dialógu. Začína s čistým kontextom + CLAUDE.md + všetkým, čo ste mu výslovne napísali. Ak napíšete „oprav autentifikáciu“, subagent si veci vymyslí. Namiesto toho napíšte: „Oprav slučku presmerovania OAuth, pri ktorej sa používateľ po úspešnom prihlásení presmeruje na /login namiesto /dashboard. Súbor: src/lib/auth.ts.“

Jasné pravidlo: pri delegovaní poskytnite subagentovi toľko kontextu, koľko by ste dali novému dodávateľovi, ktorý práve nastúpil do projektu.

Chyba 7. Agenti založení na rolách namiesto úloh

Lákavým vzorom je: „vytvorme frontend-developer, backend-developer a qa-engineer a nech pracujú ako tím“. Nefunguje to. Každá „rola“ stráca kontext celého projektu a agenti sa nevedia dohodnúť na detailoch, pretože sa navzájom nevidia.

Riešenie: subagent má zvládať opakujúcu sa úlohu s jasným výstupom, nie zastávať rolu. Nie „frontend-developer“, ale „explore-ui-tree“, „refactor-component“, „audit-accessibility“. Každý subagent založený na úlohe vykoná jednu konkrétnu prácu a vráti jeden konkrétny výsledok.

Koľko stoja paralelné subagenty a kedy sa oplatia?#

Program Pro sa vyčerpá za hodinu, ak spustíte 5 paralelných subagentov na zložité úlohy. Max 5x ($100) je realistické minimum na pravidelnú paralelnú prácu. V prípade tímov a Enterprise sa otázka nákladov rieši už na úrovni rozpočtu na nástroje.

Viac o šetrení tokenov v Claude Code nájdete v samostatnom sprievodcovi o limitoch. Pri subagentoch platí základné pravidlo: oplatia sa pri úlohe vyžadujúcej aspoň 10 minút sústredenej práce. Ak je úloha kratšia, nevytvárajte subagenta; urobte ju v hlavnom chate alebo pomocou Skillu.

Ako začleniť subagentov do CLAUDE.md, Skills a Second Brain?#

Subagent závisí od troch vecí, ktoré by mali byť vo vašom projekte skôr, než vytvoríte prvého špecialistu:

1. Správny CLAUDE.md. Subagent si pred začiatkom prečíta CLAUDE.md — je to jeho „pracovná zmluva“. Bez neho nepozná kontext projektu, jeho obmedzenia ani tón. Bude si veci vymýšľať.

2. Základné Skills. Skill je zabalená metodika. Subagent načíta iba Skills, ktoré potrebuje, nie všetky naraz. Bez Skills zakaždým opakuje tú istú prácu od začiatku.

3. Second Brain: štruktúra znalostí. Priečinok business/ (alebo jeho ekvivalent vo vašom odbore) je knižnica, ktorú využívajú všetci subagenti. Bez nej subagent poskytne priemernú odpoveď ChatGPT, ktorá sa nijako nelíši od odpovede kohokoľvek iného.

Obrátenie poradia prináša nadšenie bez výsledkov. „Mám 60 paralelných subagentov“ a prázdny priečinok business/ znamená 60 priemerných relácií ChatGPT používajúcich rovnaký prístup.

Najrýchlejšie začnete tak, že skopírujete code-reviewer z prvého príkladu vyššie do .claude/agents/code-reviewer.md, reštartujete Claude Code a pri ďalšom commite zavoláte @agent-code-reviewer. Za 5 minút zistíte, či potrebujete subagentov, alebo stačí hlavný chat.