Lekce 06.4: Rozdělení funkcí napříč kontextovými okny pomocí ticketů (Split Features Across Context Windows With Tickets)

⏱️ 2 min čtení • Lekce 06.4

🧠 Mentální model & teoretický rozbor

Jak vzít velkou specifikaci z předchozí lekce a přeložit ji do série sezení? Technika Krájení kontextových oken (Context Window Slicing):

VELKÁ SPECIFIKACE: specs/user-onboarding.md (10 stran textu)
       │
       ├── Řez 1: Ticket 01 ➔ Databáze a migrace           (Sezení 1: 15k tokenů)
       ├── Řez 2: Ticket 02 ➔ E-mailový verifikační token   (Sezení 2: 25k tokenů)
       ├── Řez 3: Ticket 03 ➔ API endpoint pro registraci  (Sezení 3: 30k tokenů)
       └── Řez 4: Ticket 04 ➔ React onboarding formulář     (Sezení 4: 35k tokenů)

Každý řez je autonomní. Každé sezení načte pouze relevantní část specifikace a skončí v maximální Smart Zone.

🏢 Realistický scénář z praxe

Pokud byste zkusili naimplementovat celý onboarding najednou: V tahu 18 by agent zapomněl, jaké sloupce vytvořil v databázi v tahu 2, a vygeneroval by kód, který se odkazuje na neexistující pole. Při rozřezání do 4 ticketů se každé sezení soustředí pouze na svůj úsek a databázový model čte z reálného vygenerovaného Prisma klienta na disku.

💻 Konkrétní ukázky kódu & promptů

Příklad promptu pro spuštění sezení nad konkrétním řezem:

Kontext: Pracujeme na implementaci onboardingu podle specifikace docs/specs/onboarding.md.
Tvůj úkol pro TOTO sezení je výhradně Ticket 02: E-mailový verifikační token.

Předpoklady:
- Databázový model z Ticketu 01 je již hotov v prisma/schema.prisma.

Instrukce:
1. Implementuj generování a ověření tokenu v src/server/services/verification.ts.
2. Napiš unit testy v src/server/services/__tests__/verification.test.ts.
3. Neupravuj žádné UI komponenty ani API routy (to bude předmětem dalších ticketů).
4. Spusť testy a po jejich projití skonči.

⚠️ Analýza selhání & Anti-patterns

Chyba: Úkoly s cyklickou závislostí

Ticket 01 závisí na Ticketu 02 a Ticket 02 závisí na Ticketu 01.

Repozitář nelze v žádném mezikroku zkompilovat.
Pravidlo: Závislosti musí tvořit orientovaný acyklický graf (DAG). Každý commit musí zanechat projekt v plně kompilovatelném a otestovaném stavu!

🛠️ Inženýrský postup krok za krokem (Playbook)

Vezměte schválenou specifikaci.
Vytvořte soubory ticketů ve složce .tickets/ očíslované 01-, 02-, 03-.
Odbavujte tickety sekvenčně.

🧪 Praktické cvičení (Hands-on Lab)

Úkol:

Rozřežte specifikaci na 3 sekvenční tickety a ověřte, že každý zanechá projekt v zeleném stavu.