Podagenti Claude Code: struktura, pet vlog in orkestracija

Kaj je podagent v Claude Code in zakaj ni »samo še ena veščina«?#

Dokumentacija Claude Code ga opredeljuje takole:

Povedano tako, da bi razumel podjetnik: predstavljajte si nepremičninsko agencijo. V njej so direktor, tržnik, pravnik in prodajni vodje. Če en zaposleni izmenično prevzema vse te vloge, to ni ekipa, temveč preobremenjena oseba. Ekipa nastane, ko ima vsak član svoj kontekst in področje odgovornosti, direktor pa samo dodeljuje naloge in združuje rezultate.

Podagenti v Claude Code delujejo enako. Glavni klepet je direktor. Podagent je strokovnjak z ozko zastavljeno nalogo, lastnim kontekstom in naborom orodij. Ko se naloga ujema z opisom strokovnjaka, mu direktor dodeli delo – in se ne zapleta v podrobnosti.

5 ciljev, za katere je Anthropic zasnoval podagente

Dokumentacija Anthropic navaja natanko pet razlogov za ustvarjanje lastnega podagenta:

Za nekoga, ki ne programira, je najbolj praktična točka na seznamu nadzor stroškov. Zahtevno raziskovalno nalogo lahko pošljete poceni modelu Haiku, medtem ko glavni pogovor nadaljujete z modelom Sonnet ali Opus. Prihranek žetonov je neposredno sorazmeren.

Preverite podporo gnezdenja v nameščeni različici

Predloge tega vodnika uporabljajo eno glavno sejo, ki neposredno delegira izvajalcem. Starejšega navodila »podagenti ne morejo zagnati drugih podagentov« ne obravnavajte kot večnega pravila: gnezdenje je odvisno od nameščene različice in dovoljenih orodij. Ločen vodnik po ugnezdenih podagentih obravnava recept za določeno različico. Pred načrtovanjem globlje predaje preverite podporo svoje namestitve.

Kako se podagent razlikuje od veščine, poševnega ukaza in kljuke?#

Prejšnji vodnik o veščinah pojasnjuje, da sta se veščine in poševni ukazi v Claude Code dejansko združili v en format. Podagent pa je drugačen – ni preprosto »večja veščina«.

Povzetek štirih mehanizmov v tabeli:

V angleškojezičnem vodniku bi to lahko povedali takole: veščine so recepti; podagenti so specializirani sodelavci.

Veščine so kot recepti, podagenti pa kot specializirani sodelavci.

V praksi deluje tako: veščine se samodejno aktivirajo, ko se njihov opis ujema z nalogo, podagente pa prikličete izrecno – bodisi se glavni klepet odloči, da bo nalogo dodelil podagentu, bodisi ga pokličete po imenu.

Odločitveno drevo: »Kaj naj izberem?«

Ko pomislite »Želim, da Claude naredi X«, si zastavite ta štiri vprašanja:

1. Gre za znanje, ki bi moralo biti vedno na voljo? Na primer »lokaliziramo v jezik, ki ga ima uporabnik najraje« ali »ne uporabljamo pomišljajev em«. Zapišite ga v CLAUDE.md.
2. Gre za sproženo metodologijo, ki jo zdaj izvajate ročno? Na primer »vsak ponedeljek napišem prodajno poročilo«. Ustvarite veščino.
3. Gre za nalogo, ki bo porabila kontekst glavnega klepeta, ali jo je mogoče izvesti vzporedno? Na primer »poglobljena raziskava 30 virov« ali »varnostni pregled, medtem ko pišem novo funkcijo«. Ustvarite podagenta.
4. Potrebujete samodejni odziv na dogodek v Claude Code? Na primer »zaženi linter po vsakem Edit«. Napišite kljuko.

90 % nalog podjetnika spada v prvi dve kategoriji. Podagenti so naprednejše orodje za prehod od »ena naloga naenkrat« k orkestraciji.

Kje so podagenti shranjeni in kateri ima prednost?#

Hierarhija podagentov ima pet ravni, razvrščenih od najvišje do najnižje prednosti:

Logika prednosti je enaka kot pri veščinah in CLAUDE.md: organizacija preglasi CLI, CLI preglasi projekt, projekt preglasi osebne nastavitve, osebne nastavitve pa preglasijo vtičnik.

Kaj morate vedeti o nalaganju

Podagenti se naložijo ob začetku seje Claude Code. Če ročno uredite datoteko agenta na disku, spremembe ne bodo upoštevane, dokler se seja ne zažene znova. Urejanje prek interaktivnega uporabniškega vmesnika /agents začne veljati takoj.

Za vsako področje uporabe velja eno ime podagenta in ena datoteka. Če mapa .claude/agents/ vsebuje code-reviewer.md in še eno istoimensko datoteko poleg nje (na primer iz stare varnostne kopije), bo Claude Code eno od njiju tiho prezrl. O tem ne boste prejeli obvestila.

Podagenti vtičnikov so nekaj drugega. Zanje veljajo varnostne omejitve: ne podpirajo polj hooks, mcpServers in permissionMode. Tako je preprečeno, da bi namestitev vtičnika tretje osebe temu vtičniku dovolila izvajanje poljubne kode na vašem računalniku.

Struktura datoteke podagenta: glava in telo#

Minimalni primer iz uradne dokumentacije – samo 9 vrstic:

---
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 zadostuje. Če uporabnik v glavnem klepetu reče »preglej moj PR«, Claude primerja izraze »pregledovalec / koda / kakovost« z opisom in dodeli nalogo podagentu. Podagent prebere razlike, pripravi komentarje in glavnemu klepetu vrne povzetek. Glavni klepet se ne napolni z dnevniki in vmesnimi analizami.

Celotna shema glave

Polje model: haiku je natanko tisti »nadzor stroškov« s seznama petih ciljev. Če imate raziskovalnega agenta, ki prebere 50 strani dokumentacije, ga zaženite z modelom Haiku in prihranite od 5- do 7-krat v primerjavi z Opusom.

Polje isolation: worktree rešuje pomembno težavo: podagent izvaja potencialno nevarne spremembe (refaktoriranje, migracijo), vendar ne želite, da posega v vašo delovno kopijo. Nastavite isolation: worktree in Claude Code ustvari začasno kopijo projekta v git. Podagent dela v njej in vrne razlike v pregled.

Telo datoteke je sistemski poziv

Za glavo sledi navadna Markdownova vsebina – sistemski poziv podagenta. Posebna struktura ni potrebna, vendar se je izkazal naslednji vzorec:

1. Kdo ste – en stavek: »ste pregledovalec kode«, »ste varnostni presojevalec«, »ste skrbnik dokumentacije«.
2. Kdaj ste priklicani in kaj naredite najprej – prva 2–3 dejanja po prejemu naloge.
3. Kontrolni seznam preverjanj ali korakov – 5–10 točk, ki jim podagent sledi.
4. Kaj vrnete – oblika končnega poročila. To je ključno: če oblike ne določite, bo podagent pripravil »esej« namesto strukturiranega povzetka.
5. Česa NE počnete – izrecne omejitve. Brez tega razdelka začne podagent improvizirati.

Telo datoteke naj obsega od 200 do 500 vrstic. Če je daljše, obsežna navodila prestavite v ločene bližnje datoteke in jih povežite v pozivu.

Kako napisati opis, da Claude zagotovo prikliče podagenta#

Pogosta težava je, da nekdo nastavi podagenta za pregled kode, Claude pa vse opravi sam in agenta ne uporabi. Običajno je razlog samo eden: opis je zapisan kot »Pomočnik za pregled kode«. Claude ne razume, kdaj naj ga sproži.

Formula za učinkovit opis (3 deli)

1. del – kaj počne. En stavek o rezultatu, ne o postopku. Ne »analizira kodo«, temveč »v kodi najde ranljivosti in vrne seznam z resnostjo in rešitvijo«.

2. del – kdaj ga sprožiti. 3–5 fraz v narekovajih, kot jih uporabniki dejansko uporabljajo v svojih zahtevah. Ne ugibajte – preglejte zgodovino klepeta in resnične formulacije.

3. del – kdaj ga NE sprožiti. 1–2 frazi o podobnih nalogah, na katere se ta podagent ne bi smel odzvati. Brez tega razdelka si dva podobna agenta nenehno nasprotujeta.

Čarobna fraza »Use Proactively«

Uradna dokumentacija Anthropic podaja neposredno priporočilo:

Z drugimi besedami, če opis ne vsebuje jasnih signalov, Claude privzeto ni nagnjen k temu, da bi priklical podagenta. Dodajte »use proactively« ali »use immediately after writing code«, pa se aktivacija močno poveča.

Takole je videti dober opis

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.

Kaj deluje tukaj:

• Glagola »reviews« + »returns« določata konkreten rezultat, ne postopka.
• »Proactively« in »immediately after« sta izrecna sprožilca.
• »Do not invoke for...« preprečuje konflikt s podobnim podagentom.
• Angleščina v opisu je standardna. Claude jo bolje prepoznava.

5 vlog podagentov za takojšnjo uporabo, ki delujejo v 10 minutah#

Vsaka spodnja vloga je ena datoteka, .claude/agents/<name>.md. Ko ustvarite datoteko, znova zaženite Claude Code, odprite /agents in preverite, ali se novi agent pojavi na seznamu. Nato ga lahko prikličete z @agent-name.

1. code-reviewer – pregled kode po vsaki spremembi

To je uradni primer iz dokumentacije Anthropic, prilagojen delovnemu procesu:

---
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. Read the diff and changed-file list supplied by the main session. If missing, ask the main session to provide them.
2. Use Read, Grep, and Glob to inspect the relevant files.
3. Return findings without changing files or running shell commands.

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.

Ključno je tools: Read, Grep, Glob: pregledovalec ima orodja za branje in iskanje datotek, brez dostopa Bash, Write ali Edit. Glavna seja pripravi diff in ga preda pregledovalcu. Samo navodilo, naj agent izvaja le git diff, ne omeji v celoti dodeljenega orodja Bash.

2. security-auditor – iskanje ranljivosti in uhajanja podatkov

Ta vloga uporablja opus za poglobljeno sklepanje in isto omejitev orodij Read, Grep ter Glob. Trajni pomnilnik je v predlogi samo za branje izpuščen, saj vklop agentovega pomnilnika omogoči tudi pisanje vanj:

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

Orodja so samo za branje, model: opus pa je namenjen zapletenim preverjanjem, kot so verige ranljivosti.

3. research-agent – poglobljena raziskava 8+ virov

Ta vzorec je opisan v članku Anthropic o večagentnem raziskovalnem sistemu. Ključna sta izrecna oblika izhoda in prepoved izpisovanja surovih rezultatov:

---
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 je zaščita pred neskončnim ponavljanjem raziskave. Anthropic to številko navaja v svojem večagentnem sistemu:

Devetdeset odstotkov se nanaša na naloge iz raziskovalnega merila. V poslovnih nalogah je izboljšanje v praksi manjše, vendar je splošno razmerje podobno.

4. doc-maintainer – usklajevanje dokumentacije s kodo

Ta vloga uporablja model: haiku – tipičen primer »nadzora stroškov«. Dokumentacija ne potrebuje modela Opus; Haiku opravi delo za tretjino cene:

---
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 – varno refaktoriranje prek delovnega drevesa

Ta vloga uporablja isolation: worktree – podagent dela v ločeni kopiji repozitorija, vi pa združite spremembe samo, če so ustrezne:

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

S to vlogo izgine najbolj mučna težava pri refaktoriranju – »nekaj sem pokvaril in ne vem, kako to razveljaviti«: izvirna kopija ostane nedotaknjena, podagent pa dela v izoliranem delovnem drevesu.

Želite sestaviti še več kot le kopirati pripravljene podagente, da bi Claude postal stabilno orodje? Podagenti so del vašega klona umetne inteligence: način, kako Claudeu dodeliti specializirano ekipo, ki dela po vaši logiki. Trije stebri metodologije so: klon umetne inteligence (veščine + podagenti) + Drugi možgani + inženiring konteksta. Ta kombinacija Claudea spremeni iz pomočnika, ki ugiba, v orodje, ki razmišlja po vaši logiki.

Zagon 5 podagentov vzporedno: orkestrator + izvajalci#

Vzporedna orkestracija deluje po načelu »dirigent + orkester«. Dirigent ima načrt, ne piše not in preverja, kaj igrajo glasbeniki. Če kdo zaigra napačno noto, od njega zahteva, naj jo zaigra znova, namesto da bi poskušal dokončati delo namesto njega.

Za podjetnika je bližja primerjava marketinška agencija, ki pripravlja strategijo za novo stranko. En analitik pripravi SWOT, drugi izvede analizo konkurentov, tretji oblikuje profil občinstva, višji analitik izloči hipoteze, ki ne ustrezajo proračunu, vodja projekta pa sestavi končno predstavitev. V Claude Code se ta proces začne z enim stavkom – kritik pa je vgrajen v postopek, namesto da bi se pridružil šele po koncu.

Minimalni poziv za orkestracijo

Zadostuje en stavek v glavnem klepetu:

Zaženi pet podagentov vzporedno: tri research-agents za različne vire
(dokumentacija Anthropic, repozitoriji GitHub, avtorji blogov o UI), enega critic-agenta za izločanje
šibkih sklepov in enega summary-agenta za končni dokument.

Kontekst: pišem vodnik o X. Ciljna dolžina: 2,000 besed z viri.
Pred začetkom naj vsak prebere CLAUDE.md.

Claude nato dodeli naloge petim agentom. Vsak dela v svojem kontekstu: raziskovalni agenti uporabljajo svoje vire, kritik izloča šibke ugotovitve, agent za povzetek pa jih sestavi. V glavni klepet se vrnejo samo končni povzetki.

Kje se vzporednost izplača

Ne povsod. Vzporedno izvajanje je smiselno samo, kadar:

1. So naloge neodvisne. Če research-agent #2 čaka na rezultat research-agenta #1, vzporednosti ne bo – dejansko bosta delala zaporedno.
2. Naloge trajajo dolgo. Vzporedno izvajanje »odstranjevanja zaključnih presledkov« je nesmiselno; čas, potreben za zagon podagentov, bo izničil prihranek.
3. Imate dovolj omejitev. Več o tem v ločenem razdelku spodaj – vzporedni podagenti hitro porabijo žetone.

Večagentni sistem Anthropic v2: naslednji korak

Maja 2026 je Anthropic predstavil Multi-Agent Orchestration v2 s tremi pomembnimi razlikami v primerjavi s klasičnim pristopom zagona vzporednih podagentov. Več o tem v naslednjem razdelku.

Novosti v Multi-Agent v2: orkestracija, rezultati, sanjanje#

Multi-Agent Orchestration: skupni datotečni sistem + sprotne kontrolne točke

Anthropic funkcijo opisuje takole:

Ključna razlika v primerjavi s klasičnimi podagenti je skupni datotečni sistem. Prej je vsak podagent delal popolnoma izolirano, izmenjava pa je potekala samo prek vrnjenega povzetka. Zdaj lahko strokovnjaki pišejo v skupno mapo, vodilni agent pa rezultate bere med potekom dela, ne šele na koncu. To rešuje težavo »vsi so delali ves dan, na koncu pa se je izkazalo, da sta imela dva človeka nezdružljiva pristopa«.

Druga novost so sprotne kontrolne točke med potekom dela. Vodilni agent se lahko ustavi in katerega koli strokovnjaka vpraša »kako gre?«, nato pa prilagodi celoten načrt. To je podobno delu pravega vodje ekipe.

Outcomes: merila namesto navodil po korakih

Pri Outcomes zapišete merila uspeha, agent pa poišče način, kako jih izpolniti. Ločen ocenjevalni agent preveri rezultat v svojem kontekstu, da ga ne bi »onesnažilo« sklepanje glavnega agenta.

Deset odstotkov pri zahtevnih nalogah je velik napredek. Še posebej, ko je naloga zastavljena kot »sestavi obsežen članek, ki izpolnjuje ta merila kakovosti«, namesto »sledi korakom od 1 do 7«.

Dreaming: agenti si nabirajo izkušnje med sejami

To je konceptualno najbolj nova funkcija. Agent pregleda pretekle seje, poišče vzorce uspehov in napak ter posodobi shrambo pomnilnika. Pred uporabo sprememb lahko nastavite ročni pregled ali pa pustite agentu, da sam uredi pomnilnik.

Anthropic poroča, da je podjetje Harvey, ki deluje na področju pravne tehnologije, po uvedbi Dreaming zabeležilo približno šestkratno povečanje uspešnosti pri nalogah priprave pravnih dokumentov. To že deluje v produkciji in ni le predstavitveni prikaz.

Kaj to pomeni za podjetnike, ki ne programirajo

Multi-Agent Orchestration je trenutno na voljo prek Claude Agent SDK, ne neposredno v CLI Claude Code. Smer razvoja pa je jasna: orkestracija se premika od »ročno zaženeš N podagentov« k »opišeš nalogo, vodilni agent pa sam odloči, komu in kako jo dodeliti«. Če šele začenjate s podagenti, se vam za zdaj ni treba ukvarjati z v2. Naučite se klasičnega vzorca »1 glavni klepet + 3–5 podagentov z različnimi vlogami«, čez 3–6 mesecev pa lahko naravno preidete na Managed Agents.

7 napak, zaradi katerih podagenti ne pridejo nikamor#

Napaka 1. Opisi »Pomočnik za X« ne sprožijo delovanja

Simptom: napisali ste podagenta, preverili njegovo strukturo in vse je veljavno, vendar ga Claude ne prikliče na uporabnikove zahteve. Razlog je skoraj vedno enak: opis je abstrakten, na primer »Pomočnik za pregled kode«. Rešitev: neposredno v opisu napišite 3–5 resničnih uporabniških fraz v narekovajih in dodajte »use proactively« / »use immediately after«.

Napaka 2. Ustvarjanje podagenta, kadar potrebujete veščino

Podagent stane več kot veščina – ustvari svoj kontekst, naloži svoj sistemski poziv in uporabi več žetonov. Če je naloga kratka, ne bo porabila konteksta glavnega klepeta in jo je mogoče opraviti v enem prehodu, naj bo to veščina, ne podagent. Primer napačnega vzorca: podagent format-validator, ki preveri shemo JSON glede na 20 pravil. To bi morala biti veščina: en model, brez potrebe po izolaciji in brez dodatnega naloženega konteksta.

Napaka 3. Začetek s »60 vzporednimi agenti«

To je najbolj razširjena iluzija. Vidite objavo, da ima nekdo »1,500 agentov, ki delajo«, in pomislite: »Tudi jaz bi moral tako.« V praksi 60 agentov v eni uri porabi omejitve paketa Pro, ustvari kup nasprotujočih si rezultatov, na koncu dneva pa nimate ničesar dokončanega.

Praktik na Mediumu to pove takole:

Rešitev: začnite z enim podagentom za eno nalogo. Ko ga obvladate, dodajte drugega z drugačno vlogo. Ko obvladate orkestracijo dveh, preidite na ekipo s 3–5 člani. Preskok od »včeraj sem namestil Claude Code« do »danes jih imam 20 vzporedno« zagotovo pokvari kodo in hitro izčrpa omejitve.

Napaka 4. Dodelitev vseh orodij vsakemu agentu

Če ima vaš pregledovalec kode dostop do orodij Bash, Write in WebFetch, je to velika varnostna in stroškovna vrzel. Pregledovalec ne bi smel imeti dovoljenja za pisanje datotek, še manj pa dostopa do interneta.

Rešitev: strogo omejite tools. Pregledovalec kode dobi samo Read, Grep, Glob. Varnostni presojevalec dobi ista orodja za branje in iskanje ter diff od glavne seje. Dodajanje Bash dodeli lupino; agenta samodejno ne omeji na git diff. Raziskovalni agent dobi WebFetch, WebSearch, Read, Write. Podagentu ne dodelite več dovoljenj, kot jih potrebuje za eno določeno nalogo.

Napaka 5. Podagent v glavni kontekst vrne surove rezultate

Če raziskovalni agent glavnemu klepetu vrne »tukaj je vseh 30 strani, ki sem jih našel; znajdi se sam«, ste izgubili glavno prednost podagentov: izolacijo šuma. Rešitev: v sistemskem pozivu podagenta izrecno zahtevajte obliko izhoda. »Vrni SAMO: TL;DR v 3 alinejah + seznam 5 virov. BREZ izpisov kode, BREZ surovih rezultatov iskanja.« Ta oblika mora biti stroga – podagent ne sme smeti »spremeniti vsebine v esej«.

Napaka 6. Nejasna navodila za dodelitev naloge

Podagent ne more videti zgodovine glavnega pogovora. Začne s čistim kontekstom + CLAUDE.md + vsem, kar ste mu izrecno napisali. Če napišete »popravi preverjanje pristnosti«, si bo podagent stvari izmislil. Namesto tega napišite: »Popravi zanko pri preusmeritvi OAuth, pri kateri je uporabnik po uspešni prijavi preusmerjen na /login namesto na /dashboard. Datoteka: src/lib/auth.ts.«

Jasno pravilo: ko nalogo dodeljujete, podagentu podajte toliko konteksta, kot bi ga podali novemu izvajalcu, ki se je pravkar pridružil projektu.

Napaka 7. Agenti po vlogah namesto po nalogah

Mamljiv vzorec je: »ustvarimo frontend-developerja, backend-developerja in qa-engineerja ter naj delajo kot ekipa.« Ne deluje. Vsaka »vloga« izgubi kontekst celotnega projekta, člani pa se ne morejo dogovoriti o podrobnostih, ker se ne vidijo.

Rešitev: podagent naj opravlja ponavljajočo se nalogo z jasnim rezultatom, ne vloge. Ne »frontend-developer«, temveč »explore-ui-tree«, »refactor-component« ali »audit-accessibility«. Vsak podagent, vezan na nalogo, opravi eno določeno delo in vrne en določen rezultat.

Koliko stanejo vzporedni podagenti in kdaj se izplačajo?#

Paket Pro bo v eni uri porabljen, če zaženete pet vzporednih podagentov za zahtevne naloge. Max 5x ($100) je realistični minimum za redno vzporedno delo. Pri ekipah in paketih Enterprise je vprašanje stroškov že rešeno na ravni proračuna za orodja.

Več o varčevanju z žetoni v Claude Code preberite v ločenem vodniku o omejitvah. Za podagente velja ključno pravilo, da se izplačajo pri nalogi, ki zahteva vsaj 10 minut osredotočenega dela. Če je naloga krajša, ne ustvarjajte podagenta; opravite jo v glavnem klepetu ali z veščino.

Kako vključite podagente v svoj klon umetne inteligence in Druge možgane?#

Preden ustvarite svojega prvega strokovnjaka, mora projekt imeti tri stvari, od katerih je odvisen podagent:

1. Ustrezno datoteko CLAUDE.md. Podagent pred začetkom prebere CLAUDE.md – to je njegova »pogodba o zaposlitvi«. Brez nje ne pozna konteksta projekta, njegovih omejitev ali tona. Stvari si bo izmislil.

2. Osnovne veščine. Veščina je zapakirana metodologija. Podagent naloži samo veščine, ki jih potrebuje, ne pa vsega hkrati. Brez veščin vsakič znova ponavlja isto delo.

3. Drugi možgani: struktura znanja. Mapa business/ (ali njena ustreznica na vašem področju) je knjižnica, v katero pogledajo vsi podagenti. Brez nje podagent poda povprečen odgovor ChatGPT, ki se ne razlikuje od odgovorov drugih.

Če vrstni red obrnete, dobite navdušenje brez rezultatov. »Imam 60 vzporednih podagentov« ob prazni mapi business/ pomeni 60 povprečnih sej ChatGPT z enakim pristopom.

Celotna kombinacija – klon umetne inteligence + Drugi možgani + inženiring konteksta – so trije stebri, ki omogočajo dosledno delovanje Claudea. Podagenti so del klona umetne inteligence: način, kako Claudeu dodeliti specializirano ekipo, ki dela po vaši logiki.

Najhitrejši začetek je, da iz prvega primera zgoraj kopirate code-reviewer v .claude/agents/code-reviewer.md, znova zaženete Claude Code in ob naslednji objavi sprememb prikličete @agent-code-reviewer. V 5 minutah boste vedeli, ali potrebujete podagente ali zadostuje glavni klepet.