Orkestra: orchestrace AI agentů ve velkém měřítku

Čísla v tomto příspěvku odrážejí stav systému v době zveřejnění (leden 2026). Aktuální čísla najdete na naší stránce týmu.

Když jsme začali stavět s Claude Code, narazili jsme na problém, na který dřív nebo později narazí každý tým používající AI kódovací asistenty: jeden agent nedokáže dělat všechno dobře.

Můžete agenta napromptovat, aby byl databázový specialista. Nebo bezpečnostní auditor. Nebo frontend inženýr. Ale v momentě, kdy ho požádáte, aby byl všechny tři najednou, kvalita utrpí. Kontext se rozřídí. Instrukce si odporují. Z agenta se stane generalista, který je ve všem průměrný.

Postavili jsme si tedy Orkestru.

Co je Orkestra?

Orkestra je systém pro orchestraci agentů pro Claude Code a podobné AI kódovací nástroje. Koordinuje více specializovaných agentů, každý s odlišnou expertízou, pod jedním orchestrátorem, který směruje práci na správného specialistu.

Představte si ji jako personální agenturu pro AI agenty. Orchestrátor přijme úkol, identifikuje, který specialista by ho měl řešit, a deleguje ho se správným kontextem. Když je práce hotová, výsledky tečou zpátky k orchestrátorovi na syntézu.

Čísla mluví sama za sebe:

Komponenta	Počet
Specializovaní agenti	46
Znovupoužitelné skilly	466
Archetypy identity	27
Mindsety	11
Komunikační styly	10
Znalostní domény	21

Systém charakterů: D&D pro agenty

Klíčový postřeh za Orkestrou je, že chování agenta vzniká ze tří skládatelných primitiv:

Identita definuje, čím agent je. Architekt navrhuje strukturu systémů. Debugger sleduje selhání k jejich kořenové příčině. Guardian vynucuje compliance a bezpečnostní hranice. Máme 27 archetypů identity, které lze míchat.

Mindset definuje, jak agent přemýšlí. Analytický mindset ukotvuje tvrzení v důkazech a kvantifikuje nejistotu. Skeptický mindset zpochybňuje předpoklady a hledá vyvracející důkazy. Explorativní mindset přijímá nejednoznačnost a zkouší více přístupů.

Styl definuje, jak agent komunikuje. Technický styl obsahuje přesné hodnoty a odkazuje na konkrétní soubory. Stručný styl seká balast a vede odpovědí. Diplomatický styl vyvažuje upřímnost s taktem.

Agent tato primitiva kombinuje:

# architecture-advisor.yaml
identity:
  - knowledge-architect
  - architect
  - strategist
mindset: analytical
style: concise

Tato kompozice vytváří agenta, který navrhuje systémy (architect), propojuje znalosti napříč doménami (knowledge-architect), stanovuje strategický směr (strategist), přemýšlí v důkazech a datech (analytical) a komunikuje bez balastu (concise).

Síla je v kombinatorické explozi. 27 identit krát 11 mindsetů krát 10 stylů dává skoro 3 000 možných osobností agenta. Definujete si ale jen ty kombinace, na kterých pro vaši práci záleží.

Skilly: znovupoužitelné moduly schopností

Skilly jsou znalosti a workflow, které agenti mohou vyvolat. Řídí se vrstveným systémem podle rozsahu:

Vrstva	Název	Rozsah	Příklad
K0	Foundations	Univerzální metodologie	Test-first disciplína, dokončování založené na důkazech
K1	Identities	Workflow podle role	Standardy CLI rozhraní, playbook výkonu
K2	Domains	Znalosti specifické pro doménu	Vzorce migrace databáze, validace autentizace
K3	Stacks	Specifické pro technologii	Nasazení na Cloudflare, operace v Supabase
K4	Project	Jen tato kódová základna	Workflow a konvence specifické pro projekt

Skilly se načítají líně. Agent při startu vidí názvy a popisy skillů, ale plný obsah skillu se načte, až je vyvolán. Díky tomu zůstává kontext útlý, zatímco stovky skillů zůstávají objevitelné.

Každý skill obsahuje:

• Jasné spouštěcí podmínky („Použij při migraci databázových schémat“)
• Krok za krokem vedení
• Povolené nástroje pro daný workflow
• Kritéria úspěchu a cesty zotavení z chyby

Našich 466 skillů v registru pokrývá všechno od izolace v git worktree přes workflow webového výzkumu po validaci zdraví nasazení.

Proč na orchestraci záleží

Architektury s jedním agentem rychle narazí na zeď:

Ředění kontextu. Kontextové okno o 200 tisících tokenech zní velkoryse, dokud do něj nenaložíte databázová schémata, dokumentaci API, testovací fixtures a doménové znalosti. Specialisté umí pracovat s cíleným kontextem.

Konflikty instrukcí. Říct agentovi, aby byl „důkladný, ale rychlý“ a „všechno ověřoval, ale neover-engineeroval“, vytváří napětí. Specialisté to řeší tím, že mají jasný rozsah.

Hloubka expertízy. Generalistický agent ví trochu o všem. Specializovaný agent, poskládaný ze správné identity a skillů, zná svou doménu do hloubky.

Orkestra implementuje plochou orchestraci: jeden orchestrátor koordinuje více specialistů. Specialisté nemohou spouštět dalšího sub-specialistu. Tím se předchází explozi složitosti a zároveň to umožňuje paralelní práci.

Orchestrátor má přístup k 2,2 milionům tokenů efektivní kapacity: svému vlastnímu 200k oknu plus 10 souběžným subagentům po 200k. Práce, která by vyčerpala jednoho agenta, běží pohodlně napříč celou flotilou.

Vykreslovací pipeline

Definice agentů žijí v YAML. Claude Code čte Markdown. Orkestra tuhle mezeru přemosťuje deterministickou vykreslovací pipeline:

YAML Registries → Jinja Templates → .claude/agents/*.md

Operátoři editují YAML zdroj. Spustí orkestra sync. Vykreslený Markdown se objeví v .claude/agents/. Claude Code změny vyzvedne.

Tohle oddělení slouží různým publikům:

• YAML zdroj obsahuje metadata životního cyklu, tagy, validační pravidla a poznámky o zastarávání pro tooling
• Vykreslený Markdown obsahuje jen to, co model potřebuje: popis, nástroje, skilly a vodítko chování

Pipeline skládá identity, mindsety, styly a skilly do jednoho koherentního promptu. Agent architect-analytical-concise dostane úplně jiný systémový prompt než agent debugger-skeptical-technical, i když sdílejí některé podkladové skilly.

Doménové znalosti: vzorec čtyř souborů

Každá znalostní doména se drží konzistentní struktury:

domain-name/
  decisions.md      # Key choices, rationale, consequences
  patterns.md       # Step-by-step guidance and examples
  anti-patterns.md  # Failure modes and remediation
  evolution.md      # Dated log of changes

Tahle struktura slouží k načítání kontextu agenta. Agent pracující na autentizaci si načte authentication/patterns.md pro vedení a authentication/anti-patterns.md, aby se vyhnul známým úskalím. Soubory jsou dimenzované pro efektivní načítání kontextu: dostatečně zaměřené na to, aby byly užitečné, dostatečně obsáhlé na to, aby byly autoritativní.

Udržujeme 21 doménových vrstev na nejvyšší úrovni včetně analytiky, autentizace, datové vědy, infrastruktury, strojového učení, výkonu, bezpečnosti a dalších. Každá doména může mít poddomény pro jemnější granularitu.

Hodnoty: operační systém

Všichni agenti sdílejí základní vrstvu hodnot, která definuje, jak fungují:

Jednoduchost na prvním místě. Používejte nejjednodušší řešení, které funguje. Složitost přidávejte jen tehdy, když je oprávněná.

Řešte kořenové příčiny. Nikdy nezalepujte selhání. Pokud selže pipeline, ladíte pipeline. Pokud selže test, opravíte kód nebo test.

Na základě důkazů. Tvrzení označujte jako „ověřené“ (s benchmarky) nebo „odhadované“ (s předpoklady). Detekovaný vzorec neznamená potvrzený problém.

Ekonomika kontextu. MCP nástroje stojí 0,1 % kontextu. Čtení souboru stojí 2 % za každé. Doménovou expertízu aplikujte dřív, než začnete kód prozkoumávat.

Tyto hodnoty se šíří ke každému specialistovi přes vykreslovací pipeline. Agent je nemůže kompozicí obejít.

CLI: řídicí rovina

Orkestra se dodává s CLI pro správu agentního ekosystému:

# Discovery
orkestra agents search "database"
orkestra agents info database-architect

# Validation
orkestra validate --show-warnings

# Rendering
orkestra sync --dry-run
orkestra sync

# Skills
orkestra skills list
orkestra skills info schema-migration-workflow

# Decisions
orkestra decisions search "authentication"

CLI je zdroj pravdy o tom, jací agenti existují, jaké skilly mají a jestli je systém zdravý. Před synchronizací spouští validaci, aby zachytila problémy včas.

Úvahy o open source

Orkestru jsme postavili, abychom vyřešili náš vlastní problém: koordinaci AI agentů ve velkém měřítku pro komplexní kódovou základnu. Vzorce, které jsme objevili, nejsou specifické pro naši doménu.

Systém kompozice charakteru (identita + mindset + styl) se hodí pro jakýkoliv tým, který definuje osobnosti agentů.

Systém vrstev skillů (K0–K4) poskytuje mentální model pro organizaci znovupoužitelných schopností podle rozsahu.

Vzorec vykreslovací pipeline (YAML zdroj + šablony + generované artefakty) odděluje starosti tooligu od spotřeby modelem.

Model ploché orchestrace (jeden koordinátor, mnoho specialistů) se vyhýbá explozi složitosti a přitom umožňuje paralelismus.

Jestli se Orkestra stane open source, závisí na tom, zda tyto vzorce mají hodnotu pro ostatní, kdo staví s Claude Code. Pokud narážíte na zdi, které jsme popsali, tahle architektura by mohla pomoct.

Co jsme se naučili

Stavba Orkestry nás naučila, že orchestrace není o tom, dělat agenty chytřejšími. Je o tom, dělat je zaměřenějšími.

Jeden agent s dokonalými instrukcemi pořád dojde kontext. Jeden agent se všemi skilly se pořád spletě, který z nich použít. Jeden agent, který se snaží být vším, produkuje průměrné výsledky ve všem.

Čtyřicet specialistů, každý excelentní ve své doméně, koordinovaných orchestrátorem, který ví, kdy delegovat: takhle dodáváme.

Na číslech záleží míň než na architektuře. Můžete potřebovat pět agentů, nebo padesát. Princip zůstává: kompozice před schopností, specializace před generalizací, koordinace před individuálním hrdinstvím.

---

Orkestra pohání agentní ekosystém za Maguyva, naší platformou pro code intelligence. Chcete se dozvědět víc? Ozvěte se týmu.