modul 1 — az első éles projekt
a jó PRD: mit építsen az agent?
A specifikáció az agentic munka legnagyobb tőkeáttétele: ami a PRD-ből hiányzik, azt az agent kitalálja – és nem úgy, ahogy te akartad.
12 perc · v1.1 · ellenőrizve: 2026-07-15
miért a PRD az első lecke?
A PRD (Product Requirements Document – a termék-specifikáció: mit építünk, kinek, és mi számít késznek) a kezdők által leggyakrabban átugrott lépés – és a leggyakoribb oka annak, hogy egy agent-build szétcsúszik. Az agent mindent megépít, amit kérsz. A baj ott kezdődik, amit nem kérsz: azt is megépíti, csak a saját defaultjai szerint.
Ennek az oldalnak a PRD-je nyilvános – a leckében végig abból dolgozunk, éles példákkal.
a PRD három kötelező rétege
Egy agent-barát PRD nem hosszú dokumentum, hanem három éles határvonal:
- Mit építünk és miért – egy bekezdés, számokkal. Nem „modern webshopot”, hanem „egyoldalas rendelési űrlapot, ami e-mailben küldi a rendelést, 0 Ft havi infrastruktúra-költséggel”.
- Mi van kifejezetten KIZÁRVA – ez a réteg hiányzik a legtöbb specifikációból, pedig agentnél ez ér a legtöbbet. Amit nem zársz ki, azt az agent egyszer meg fogja építeni – Addy Osmani keretrendszere ugyanezt háromszintű határként írja le: mindig / kérdezz rá / soha.
- Mi a kész definíciója – ellenőrizhető állítások (az O'Reilly elemzése szerint a jól strukturált elfogadási kritérium a költséggörbe minimuma – nem a nulla spec, és nem a 40 oldalas dokumentum): „a build hibátlanul lefut”, „mobilon 375px-en nem törik”, „a űrlap üres mezővel nem küldhető el”.
döntés-napló: a PRD élő része
A specifikáció nem egyszer íródik. Minden menet közbeni döntést (D1, D2, …) sorszámmal vezetünk a PRD-ben – az agent következő munkamenete így nem nyitja újra a már eldöntött kérdéseket. Ez a minta ennek az oldalnak a PRD-jében is él: minden D-sorszám egy lezárt vita.
így néz ki élesben
Ez az oldal pontosan ezzel a munkamóddal épült. Az alábbi visszajátszás a lecke-motor építésének valós munkamenete (2026-07-14): figyeld meg, hogy az agent első lépése nem a kódírás, hanem a specifikáció elolvasása.
- építsd meg a /tanulas lecke-oldalt a PRD 8.6 szerint
- először a specifikációt olvassa el — mit és miértread PRD.md
- aztán a design-szabálykönyvet — hogyan nézzen kiread DESIGN.md
- megírja a lecke-oldalt a spec szerintwrite tanulas/[slug]/page.tsx
- lefuttatja a linter-t a saját munkájárapnpm lint
- típus-ellenőrzés: nulla hiba — a kész-definíció teljesülttsc --noEmit ✓
valós munkamenet ebből a buildből: ❯ a begépelt kérés, → az agent lépései, ✓ az ellenőrzés.
gyakorlat
gyakorlat — az első saját PRD
Írd meg a saját első éles projekted PRD-jét a három réteggel, maximum egy oldalban. A következő leckében ezt a PRD-t adjuk oda az agentnek.
0/4 · lépj be, hogy mentsük a haladásod
változásnapló
- 2026-07-15 · állítások külső forrásokkal validálva és linkelve (Anthropic memory-doksi, agents.md szabvány, Osmani, O'Reilly)
- 2026-07-15 · a modul ingyenes preview-leckéje (D9 modul-preview szabály)
- 2026-07-14 · első publikálás