Šablona PRD pro aplikaci s AI: zadání před promptem

1. Co je PRD a proč ho vytvořit

PRD popisuje, co má aplikace dělat, pro koho je určená a podle čeho poznáte, že je hotová. Dokument neřeší, jak se má aplikace naprogramovat, ani jakou má mít architekturu. To je rozdíl oproti konkrétnímu promptu, který AI říká, co má právě teď udělat.

Když začnete rovnou promptem, může se stát, že AI si vymyslí i to, co jste neřekli, a i když ji budete postupně usměrňovat, tak vaše rozhodnutí zůstanou v historii chatu. Ta je dlouhá, obsahuje slepé uličky a při přechodu do jiného nástroje asi zůstane v tom původním, jak popisuje článek Jak postavit aplikaci s AI. PRD je naopak samostatný dokument, který si přečtete vy, další člověk nebo i jiný AI nástroj.

2. Jak rozsáhlý dokument to má být

Pro AI nástroj stačí na jednu až dvě strany A4. Pro člověka má být dokument takový, aby ho zvládl rychle přečíst a pochopit. Pokud něco ještě nevíte, napište to do dokumentu jako otevřenou otázku. Dokument pro vývojový tým toho bude obsahovat více, protože bude sloužit i pro vyjasnění komunikace mezi lidmi.

3. Šablona ke zkopírování

Šablona má jedenáct částí, pokud některé nepoužijete, smažte je.

# <Název aplikace>: Požadavky na produkt

## 1. Shrnutí
Jedna věta: co aplikace dělá a pro koho.

## 2. Problém
Co uživatele dnes trápí a jak si bez aplikace poradí.

## 3. Uživatelé a role
- Kdo aplikaci používá:
- Kdo ji spravuje:
- Co smí jednotlivé role:

## 4. Hlavní scénáře
1. Uživatel <udělá něco> a <co se stane>.
2.
3.

## 5. Funkce první verze
-

## 6. Co v první verzi nebude
-

## 7. Data
- Co aplikace ukládá:
- Osobní údaje:

## 8. Služby a technologie
- Přihlášení, databáze, platby, e-maily:
- Technologie: <konkrétní, nebo ať vybere AI>

## 9. Vzhled
- Zařízení:
- Jazyky:
- Styl:

## 10. Hotovo je, když
- [ ]
- [ ]

## 11. Pravidla pro AI
- Před větší změnou AI navrhne plán a počká na souhlas.
- AI nepřidává knihovny ani služby bez souhlasu a kontroly licence.
- Tajné klíče nepatří do kódu ani do tohoto dokumentu.
- Po každé změně chování aplikace AI upraví tento dokument.

4. Příklad vyplněné šablony

Příklad níže popisuje jednoduchou aplikaci pro rezervaci zasedaček ve firmě. Všimněte si, že část 6 vylučuje i věci, které by AI jinak mohla přidat sama, třeba platby nebo mobilní aplikaci.

# Rezervace zasedaček: Požadavky na produkt

## 1. Shrnutí
Webová aplikace, ve které si zaměstnanci firmy rezervují zasedačky.

## 2. Problém
Rezervace se dnes domlouvají e-mailem a udržují se v excelovské tabulce, takže se rezervace občas překrývají.

## 3. Uživatelé a role
- Kdo aplikaci používá: zaměstnanci, kolem 50 lidí
- Kdo ji spravuje: kancelář
- Co smí jednotlivé role: zaměstnanec spravuje své rezervace, kancelář všechny rezervace a seznam zasedaček

## 4. Hlavní scénáře
1. Zaměstnanec vybere den a uvidí volné časy všech zasedaček.
2. Zaměstnanec zarezervuje volný čas a dostane potvrzení e-mailem.
3. Zaměstnanec zruší svou rezervaci a čas se znovu uvolní.

## 5. Funkce první verze
- Přihlášení firemním e-mailem
- Denní přehled zasedaček
- Vytvoření a zrušení rezervace
- Správa seznamu zasedaček

## 6. Co v první verzi nebude
- Platby
- Mobilní aplikace
- Opakované rezervace
- Napojení na firemní kalendář

## 7. Data
- Co aplikace ukládá: zasedačky, rezervace, uživatele
- Osobní údaje: jméno a firemní e-mail

## 8. Služby a technologie
- Přihlášení, databáze, e-maily: podle nabídky nástroje
- Technologie: ať vybere AI

## 9. Vzhled
- Zařízení: počítač i telefon v prohlížeči
- Jazyky: čeština
- Styl: jednoduchý a světlý

## 10. Hotovo je, když
- [ ] Dvě rezervace téže zasedačky se nepřekryjí ani při současném odeslání.
- [ ] Zaměstnanec nemůže zrušit cizí rezervaci.
- [ ] Potvrzovací e-mail dorazí do minuty.

## 11. Pravidla pro AI
- Před větší změnou AI navrhne plán a počká na souhlas.
- AI nepřidává knihovny ani služby bez souhlasu a kontroly licence.
- Tajné klíče nepatří do kódu ani do tohoto dokumentu.
- Po každé změně chování aplikace AI upraví tento dokument.

5. Jak předat dokument nástroji Lovable, Cursor a dalším

Specifikaci požadavků uložte AI nástroji tak, aby ji měl k dispozici v každém sezení, ne jen v první zprávě. Umístění se v jednotlivých nástrojích liší, zároveň si uložte i zálohu dokumentu mimo AI nástroj.

1. 1

   Uložte dokument tam, kde ho nástroj čte

   V Lovable ho vložte do Project settings → Instructions, kde podle dokumentace Lovable platí limit 10 000 znaků a text se použije v každé zprávě. V Cursoru ho uložte do projektu jako docs/PRD.md a v souboru AGENTS.md v kořeni projektu napište, ať ho agent čte. Dokumentace Cursoru popisuje i podrobnější pravidla ve složce .cursor/rules.

2. 2

   Nechte si zadání zkontrolovat

   Prvním promptem nechejte AI, ať dokument zkontroluje. AI vypíše nejasnosti a navrhne plán, po krocích, které vy zkontrolujete a dle potřeby dokument opravíte. Ukázku promptu najdete níže.

3. 3

   Vytvářejte po scénářích

   Požádejte o první scénář z části 4, vyzkoušejte ho a teprve potom pokračujte dalším. Chybu najdete snáz v jednom scénáři než v celé aplikaci.

4. 4

   Kontrolujte podle části "Hotovo je, když"

   Po každém kroku projděte podmínky z části 10. Než změny pustíte k uživatelům, vyzkoušejte je na staging prostředí, pokud ho máte.

Přečti si PRD.md. Zatím nic neprogramuj.
Napiš mi, co je v zadání nejasné nebo v rozporu
a navrhni plán první verze, rozepiš jednotlivé kroky.

6. Jak udržet dokument aktuální

Dokument udržíte aktuální tak, že ho upravíte při každé změně chování aplikace. Když v chatu rozhodnete, že se rezervace dají zrušit jen den předem, a do dokumentu to nezapíšete, další sezení nebo jiný nástroj o tom nebude vědět. Pravidlo v části 11 to přenáší na AI, změnu ale vždy zkontrolujte.

Samotná specifikace popisuje, jak má aplikace fungovat dnes, ale neobsahuje historii, kdy se co změnilo. Historii změn proto veďte zvlášť: každou vydanou úpravu označte číslem verze a popište ji v poznámkách k vydání. Podle nich pak zjistíte, od které verze se aplikace chová jinak.

7. Odkaz u aplikace v AboutTheApp

Specifikace požadavků má být k nalezení i bez přístupu do AI nástroje, proto na ni v AboutTheApp odkažte přímo z vaší aplikace. V editoru produktu klikněte na Přidat odkaz, vyberte kategorii Analýza a plánování a vložte adresu vašeho dokumentu. Můžete si uložit i odkaz na projekt v Lovable nebo Cursoru do kategorie AI a Vibecoding.

U odkazu zvolte Soukromý, pokud zadání není veřejně dostupné. Soukromé odkazy uvidí přihlášení členové týmu a ten, kdo zná kód pro odemknutí. Změny zapisujte k jednotlivým verzím přes ikonu historie verzí na kartě aplikace nebo pomocí CI/CD. Nová verze je soukromá, dokud ji nezveřejníte. Na About page tak máte zadání, projekt v AI nástroji, repozitář i historii verzí pohromadě, jak popisuje článek Odkazy projektu.

Časté otázky