Agent Development Kit je komplexní framework pro vývoj inteligentních agentů na bázi Claude. Infografika vytvořená Brij Kishore Pandey představuje 5 klíčových vrstev architektury, které zajišťují efektivní fungování AI agentů od paměti po distribuci.
Tento průvodce ukazuje, jak strukturovat agenty pomocí CLAUDE.md, Skills, Hooks, Subagentů a Plugins pro maximální produktivitu a bezpečnost.
Agent Development Kit – 5 vrstev architektury Claude Code
Vrstva 1 – CLAUDE.md: Paměťová vrstva
CLAUDE.md je „ústava“ agenta“ – vždy načtený a aktivní. Jedná se o kořenový soubor, který obsahuje:
- Architecture rules – pravidla pro architekturu agenta
- Naming conventions – konvence pojmenování
- Test expectations – očekávání testů
- Repo map – mapa repositáře
CLAUDE.md existuje na dvou úrovních:
- Global (~/.claude/CLAUDE.md) – pro všechny projekty
- Project (.claude/CLAUDE.md) – pro konkrétní projekt
Vrstva 2 – SKILLS: Znalostní vrstva
Skills jsou modulárními znalostními chunky – na vyžádání, ne vždy aktivní. Architektura funguje následovně:
- Description matching – popis pro vyhledání správného Skill
- Auto-invoked – automatické vyvolání relevantního Skillu
- Task-specific context – kontext specifický pro daný úkol
Skill.md obsahuje:
- Reference documentation
- Scripts
- Templates
Klíčová funkce: Context fork spouští Skill v izolovaném Subagentu
Vrstva 3 – HOOKS: Vrstva ostrahy
Hooks jsou deterministické, ne AI-driven – mysleme na ně jako na Git hooks pro agenty. Zahrnují:
- PreToolUse – spustí se před použitím nástroje
- PostToolUse – spustí se po použití nástroje
- SessionStart – aktivace na začátku relace
- Stop – zastavení agenta
- SubagentStop – zastavení Subagentu
Příklad workflow: Auto-lint on Write → block rm -rf → Slack notification on Stop
Event fires → Matcher checks → Command runs
Vrstva 4 – SUBAGENTS: Vrstva delegace
Subagenti udržují čistotu hlavního kontextu bez nekonečné rekurze. Architektura delegace:
- Delegate only – hlavní agent deleguje pouze požadované
- Results only – Subagent vrací pouze výsledky
Tři typy Subagentů:
- Code-reviewer – vlastní okno kontextu, custom model, nástroje, permise
- Test-runner – vlastní okno kontextu, custom model, nástroje, permise
- Explorer – vlastní okno kontextu, custom model, nástroje, permise
Kritické omezení: Subagenti nemohou vytvářet další Subagenty!
Vrstva 5 – PLUGINS: Distribuční vrstva
Pluginy fungují jako npm balíčky pro agenty – umožňují distribuci a instalaci do týmů. Obsah Pluginu:
- Skills
- Agents
- Hooks
- Commands
Pluginy mohou být sdíleny přes Marketplace/Team install a umožňují týmům snadno přidávat nové schopnosti agentů.
Interakce s externími systémy
MCP Servers (vlevo):
- External tools
- GitHub
- Databases
- APIs
- Custom integrations
Agent Teams (vpravo):
- Parallel execution
- Message passing
- Lead orchestration
- Shared permissions
Celkový workflow
CLAUDE.md nastavuje pravidla → Skills poskytují odbornost → Hooks prosazují kvalitu → Subagenti delegují práci → Plugins distribuují schopnosti
