Jak jsem vytvořil Task Guide Generator
Projekt FAIL (Future AI Leader) disponoval bohatými strukturovanými znalostními dokumenty z workshopů, ale chyběl systematický způsob jejich transformace na praktické úlohy pro účastníky. Existující workshop-extractor dokázal přeměnit přepisy na strukturované znalosti, ale další krok – vytvoření akčních návodů v konzistentním formátu – vyžadoval manuální práci.
Cílem bylo vytvořit reusable agenta, který automatizuje transformaci znalostních dokumentů na praktické task guides, a demonstrovat jeho funkčnost na reálném modulu.
Problém, který jsem řešil
Potřeba zpracovat strukturované poznámky z modulu Symbiosis stejným způsobem jako existující task guides v FAIL-01-mindset. Kritickým rozhodnutím bylo zvolit cestu vytvoření reusable agenta místo jednorázového generování – investice do budoucnosti.
Jak jsem ho vyřešil
Analyzoval jsem existující strukturu projektu, identifikoval vzor v FAIL-01-mindset souborech a navrhl komplexní agent prompt. Následně jsem zpracoval 804řádkový znalostní dokument, identifikoval jsem 8 potenciálních témat a vygeneroval jsem 6 prioritních guides s konzistentní strukturou.
Vytvořil jsem 1 nového agenta (`task-guide-generator.md`) – 411 řádků, plně dokumentovaný. Vygeneroval jsem 6 praktických task guides pro FAIL-03-symbiosis (1 763 řádků celkem). Aktualizoval jsem dokumentaci v AGENTS.md a content-agent.md.
Čas vytvoření 6 guides: ~15 minut (vs. odhadovaných 3–4 hodin manuálně). Konzistence formátu: 100 %. Pokrytí klíčových témat z modulu: 6/6.
Jak to funguje v praxi
Kompletní content pipeline: Přepisy → strukturované znalosti → Praktické návody. Čas zpracování dalšího modulu: odhadovaných 20–30 minut (vs. hodiny). Konzistentní formát napříč všemi moduly.
Co jsem se naučil
Investice do agenta se vyplatí. Vytvoření reusable agenta trvalo o 10 minut déle než přímé generování, ale ROI se projeví už při druhém použití. Agent obsahuje validační checklist, příklady a pravidla, které zabezpečují konzistenci i bez původního kontextu.
Formát je polovina úspěchu. Analýza existujících FAIL-01-mindset souborů odhalila vzor: ⚡ Rychlý postup + 🚀 Podrobný postup. Tato dualita (pro pokročilé i začátečníky) byla klíčová pro adoption – každý si najde svou cestu.
Strukturovaná dokumentace umožňuje automatizaci. Předchozí práce na workshop-extractor a strukturovaných zápisech vytvořila ideální vstup. Bez kvalitního fail-03-symbiosis.md by generování guides bylo nemožné. Garbage in = garbage out platí i pro AI.
Proč to stojí za to
Když máš strukturované znalostní dokumenty a chceš z nich vytvořit praktické návody, nemusíš to dělat manuálně. Můžeš vytvořit reusable agenta, který automatizuje celý proces.
Task Guide Generator je teď součástí mého workflow. Šetří mi čas, protože nemusím manuálně transformovat znalostní dokumenty na praktické návody. A zároveň mám kontrolu nad tím, jak guides vypadají, protože všechno je v agentovi.
Pokud máš podobný problém – strukturované znalostní dokumenty – zkus to. Možná zjistíš, že je to jednodušší, než sis myslel.
Časté otázky
Proč vytvářet reusable agenta místo jednorázového generování?
Vytvoření agenta trvalo o 10 minut déle, ale ROI se projeví už při druhém použití. Agent obsahuje validační checklist, příklady a pravidla – konzistence je zaručená i bez původního kontextu. Při zpracování dalšího modulu ušetříš hodiny.
Jaký je rozdíl mezi manuálním a automatizovaným generováním guides?
Čísla mluví jasně: 6 guides za ~15 minut vs. odhadovaných 3–4 hodin manuálně. Konzistence formátu: 100 %. Další modul zpracuješ za 20–30 minut. Manuálně bys strávil hodiny kopírováním struktury a přepisováním obsahu.
Co je vzor ⚡ Rychlý postup + 🚀 Podrobný postup?
Dualita pro různé typy uživatelů. Pokročilí chtějí rychlý přehled kroků, začátečníci potřebují detailní vysvětlení. Tenhle vzor jsem identifikoval v existujících FAIL-01-mindset souborech a zabudoval ho do agenta. Každý si najde svou cestu.
Jak důležitá je kvalita vstupních dokumentů?
Kritická. Garbage in = garbage out platí i pro AI. Bez kvalitního strukturovaného znalostního dokumentu (v mém případě 804řádkový fail-03-symbiosis.md) by generování guides bylo nemožné. Předchozí práce na workshop-extractor vytvořila ideální vstup.
Můžu použít podobný přístup pro svůj projekt?
Pokud máš strukturované znalostní dokumenty a chceš z nich vytvořit praktické návody – ano. Analyzuj existující formát, identifikuj vzory, vytvoř agenta s validačním checklistem. Možná zjistíš, že je to jednodušší, než sis myslel.
Tom