Jak jsem vytvořil kompletní specifikaci pro Aimee kurzy
Měl jsem stručnou 220řádkovou koncepční specifikaci kurzové funkcionality pro vzdělávací platformu Aimee. Dokument obsahoval základní architekturu, ale chyběly konkrétní UI texty, emailové šablony a detailní user flows.
Cílem bylo transformovat koncept na implementation-ready dokumentaci ve stylu existujících firemních specifikací – s přesnou copy pro každý stav, modal a email. Plus vytvořit prezentační verzi pro rychlé představení týmu.
Problém, který jsem řešil
Potřeba rozložit koncept do všech detailů. Klíčové bylo referenční zadání: "Zpracuj to stejně jako `ai_assessment_flow.md`." Tím jsem dal AI přesný benchmark kvality a formátu.
Jak jsem ho vyřešil
Analyzoval jsem oba vstupní dokumenty paralelně – originální koncept i referenční specifikaci. Identifikoval jsem klíčové rozdíly: reference měla konkrétní UI copy (headlines, subheadlines, CTAs) a emailové šablony s přesným zněním.
Vygeneroval jsem kompletní specifikaci zachovávající strukturu originálu, ale rozšířenou o všechny chybějící vrstvy: 3 stavy kurzu, strukturu modulu, 8 typů emailů, in-app bannery, upsell mechanismus.
Po první iteraci jsem aktivně editoval výstup – odstranil jsem přebytečné detaily (progress bary, filtry), zjednodušil jsem některé sekce. To signalizovalo, že MVP má být lean.
Výsledek: dva komplementární dokumenty – detailní specifikace (implementation-ready s přesnou UI copy) a executive summary (prezentační formát s checklisty podle týmů). Z ~240 řádků vzniklo 993 řádků detailní specifikace + ~150 řádků executive summary.
Jak to funguje v praxi
Odhadovaná úspora 4–6 hodin manuální práce na psaní copy a strukturování dokumentace. Jeden vstup, více výstupů – z jednoho konceptu vznikly dva úplně odlišné dokumenty pro různé publikum.
Co jsem se naučil
Referenční dokument je nejlepší prompt. Místo popisování požadovaného formátu stačilo ukázat existující dokument. AI okamžitě pochopila styl, hloubku detailu i strukturu. To je efektivnější než psaní dlouhých instrukcí.
Iterace odhaluje skutečné priority. Když jsem začal mazat části výstupu, ukázalo se, co je skutečně důležité. AI má tendenci generovat "kompletní" řešení – lidská zpětná vazba filtruje na MVP.
Jeden vstup, více výstupů. Z jednoho konceptu vznikly dva úplně odlišné dokumenty pro různé publikum. To je síla AI – rychlá transformace obsahu do různých formátů bez ztráty konzistence.
Proč to stojí za to
Když máš koncepční specifikaci a chceš z ní vytvořit implementation-ready dokumentaci, nemusíš to dělat manuálně. Můžeš použít AI na transformaci konceptu do detailní specifikace.
Aimee kurzy specifikace je teď součástí mého workflow. Šetří mi čas, protože nemusím manuálně psát copy pro každý stav. A zároveň mám kontrolu nad tím, jak specifikace vypadá, protože všechno je v Markdown formátu.
Pokud máš podobný problém – potřebu vytvořit detailní specifikaci – zkus to. Možná zjistíš, že je to jednodušší, než sis myslel.
Časté otázky
Proč použít referenční dokument místo detailního promptu?
Referenční dokument je nejlepší prompt. Místo psaní dlouhých instrukcí o formátu, stylu a hloubce detailu stačí ukázat existující dokument. AI okamžitě pochopí, co chceš – a ty ušetříš čas na vysvětlování.
Kolik času reálně ušetřím při tvorbě specifikace s AI?
V tomto případě odhadem 4–6 hodin manuální práce. Z ~240 řádků konceptu vzniklo 993 řádků detailní specifikace + ~150 řádků executive summary. To je práce, kterou bys jinak dělal ručně – psaní UI copy, emailových šablon, definování stavů.
Jak zajistit, že AI negeneruje zbytečné detaily?
Iterace. AI má tendenci generovat "kompletní" řešení – progress bary, filtry, všechno. Po první iteraci aktivně edituj výstup. Když začneš mazat, ukáže se, co je skutečně důležité pro MVP. Lidská zpětná vazba filtruje na to podstatné.
Můžu z jednoho vstupu vytvořit více typů dokumentů?
Přesně tak. Z jednoho konceptu vznikly dva úplně odlišné dokumenty – detailní specifikace pro implementaci a executive summary pro prezentaci týmu. To je síla AI: rychlá transformace obsahu do různých formátů bez ztráty konzistence.
Co všechno by měla obsahovat implementation-ready specifikace?
Konkrétní UI copy pro každý stav (headlines, subheadlines, CTAs), emailové šablony s přesným zněním, definované user flows. V případě Aimee kurzů: 3 stavy kurzu, struktura modulu, 8 typů emailů, in-app bannery, upsell mechanismus. Všechno, co vývojář potřebuje, aby nemusel hádat.
Tom