# Ako nastaviť Spec Kit v Claude Code v roku 2026: špecifikácie namiesto promptov
> Ako nastaviť GitHub Spec Kit v Claude Code: 4 fázy—Specify, Plan, Tasks, Implement. Tu je návod na postupnú náhradu improvizovaného vibe codingu.
Source: https://ailoot.ai/blog/sk/spec-kit-claude-code-spec-driven-development/
Canonical: https://ailoot.ai/blog/sk/spec-kit-claude-code-spec-driven-development/
Language: sk
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-219
Revision: sha256-c250e1d9021cf408feab4d6a5e6de15e16468e06c8798c7971f5b5ee3238f927
Kľúčové zistenie
Spec Kit je nástroj od GitHubu, ktorý vám umožňuje napísať špecifikáciu úlohy v prirodzenom jazyku. Claude Code potom zostaví plán, rozdelí ho na úlohy a napíše kód. Nie je to teória: 107 000 hviezdičiek na GitHube za 8 mesiacov, AWS použila túto metodiku na vytvorenie projektu objavovania liekov za 3 týždne namiesto niekoľkých mesiacov a tento sprievodca pokrýva inštaláciu, šablóny, 4 fázy pracovného postupu s finálnou kontrolou a prepojenie s vaším súborom CLAUDE.md.
[Dokumentácia Ailoot](https://ailoot.ai/docs/) — referenčné materiály o používaní služby.
## Čo sa stalo s vibe codingom v máji 2026?
Kľúčové zistenie
GitHub Spec Kit za 8 mesiacov získal 107 000 hviezdičiek a AWS zverejnila prípadovú štúdiu, ktorá uvádza úsporu viac ako 80 hodín pri jednej funkcii. Trendom týždňa v máji je špecifikácia ako náhrada improvizácie.
O rok neskôr, 4. februára 2026, zverejnil retrospektívne vlákno:
Vo svojom vystúpení na Sequoia Ascent 2026 to vyjadril ešte presnejšie: „Vibe coding zvyšuje spodnú hranicu—koľko toho každý dokáže v softvéri. Agentic engineering zachováva hornú hranicu—latku kvality profesionálneho vývoja.“ Na tom istom pódiu vyslovil vetu, ktorá sa dostala do slovníka odvetvia: „Nemôžete zavádzať zraniteľnosti s odôvodnením, že ste použili vibe coding. Za svoj softvér stále zodpovedáte, rovnako ako predtým.“
Dve veci sa udiali súbežne. V septembri 2025 GitHub zverejnil nástroj [Spec Kit](https://github.com/github/spec-kit)—za 8 mesiacov získal 107 000 hviezdičiek. Vo februári 2026 AWS zverejnila [podrobnú prípadovú štúdiu o objavovaní liekov](https://aws.amazon.com/blogs/industries/from-spec-to-production-a-three-week-drug-discovery-agent-using-kiro/), ktorá uvádza „95 % obchodnej logiky vygenerovanej zo špecifikácie, čo ušetrilo viac ako 80 hodín“.
Do konca mája 2026 sa v anglicky hovoriacom informačnom priestore vytvoril konsenzus: vibe coding ako pracovná metóda je úroveň pre začiatočníkov. Nasleduje Spec-Driven Development. Tento sprievodca vysvetľuje, ako tento prístup nainštalovať a používať.
## Čo sú Spec Kit a Spec-Driven Development?
Kľúčové zistenie
Spec-Driven Development (SDD) obracia bežný prístup k AI agentovi naruby. Predtým bol zdrojom pravdy kód a špecifikácia bola sprievodná dokumentácia. Teraz je zdrojom pravdy špecifikácia a kód sa stáva jej posledným krokom—implementáciou. Spec Kit je nástroj CLI od GitHubu, ktorý mení 4 fázy (Specify, Plan, Tasks, Implement) a záverečnú kontrolu Converge na príkazy pripravené na použitie v Claude Code, Cursor, Copilot a 30+ ďalších agentoch.
Základnú myšlienku metodiky vystihuje jedna veta z oficiálnej dokumentácie GitHubu:
Spec-Driven Development mení hierarchiu: špecifikácie neslúžia kódu—kód slúži špecifikáciám. Špecifikácia sa stáva primárnym artefaktom a kód je jej vyjadrením v konkrétnom jazyku a frameworku.
— Dokumentácia GitHub Spec Kit, https://github.com/github/spec-kit/blob/main/spec-driven.md
V praxi sa to rozvíja v 4 fázach (Spec Kit pridáva ešte jednu, nulovú fázu—constitution, ktorá je opísaná nižšie):
1. **Specify** - napíšte špecifikáciu toho, čo chcete, v prirodzenom jazyku. ČO treba urobiť a PREČO. Nie AKO.
2. **Plan** - agent vezme špecifikáciu a zostaví technický plán: ktoré technológie, aká architektúra a ktoré komponenty.
3. **Tasks** - agent rozdelí plán na konkrétne, overiteľné úlohy so závislosťami.
4. **Implement** - agent (alebo jeho subagenti) postupne spracuje úlohy a napíše kód.
Po fáze Implement má aktuálna verzia Spec Kit overovací krok s názvom **Converge**: agent skontroluje hotový kód podľa špecifikácie, plánu a úloh a potom pridá do `tasks.md` všetko, čo chýba. Opakujte Implement a Converge v cykle, až kým Converge neodpovie „Converged“.
Každá fáza je samostatný súbor Markdown v repozitári. Každá fáza je v Claude Code samostatný príkaz slash: `/speckit-specify`, `/speckit-plan`, `/speckit-tasks`, `/speckit-implement`, pričom kontrola je `/speckit-converge`. Dokumentácia Spec Kit zapisuje rovnaké príkazy s bodkou (`/speckit.specify`), ale v Claude Code ich Spec Kit inštaluje ako skills a spúšťajú sa s pomlčkou. Ak sa v ktoromkoľvek kroku niečo pokazí, upravte súbor Markdown a zopakujte nasledujúcu fázu.
Spec Kit je konkrétna implementácia SDD. V máji 2026 už mal viac ako 30 integrácií s rôznymi AI agentmi. V rámci jedného repozitára funguje Spec Kit rovnako s Claude Code, Cursor, GitHub Copilot, Codex CLI, Windsurf, Qwen, Tabnine, Amazon Q, Gemini, Goose a ďalšími.
| Fáza Spec Kit | Príkaz slash | Artefakt v repozitári |
|----|----|----|
| Constitution | `/speckit-constitution` | `.specify/memory/constitution.md` |
| Specify | `/speckit-specify` | `specs/###-feature/spec.md` |
| Clarify (voliteľné) | `/speckit-clarify` | úpravy v `spec.md` |
| Plan | `/speckit-plan` | `specs/###-feature/plan.md` |
| Checklist (voliteľné) | `/speckit-checklist` | kontrolný zoznam kvality požiadaviek |
| Tasks | `/speckit-tasks` | `specs/###-feature/tasks.md` |
| Analyze (voliteľné) | `/speckit-analyze` | správa o špecifikácii, pláne a úlohách |
| Implement | `/speckit-implement` | kód v projekte |
| Converge | `/speckit-converge` | verdikt „Converged“ alebo nové úlohy v `tasks.md` |
Po spustení teda váš repozitár obsahuje nielen kód, ale aj jeho špecifikáciu, plán a úlohy. O mesiac sa môžete k projektu vrátiť, prečítať si `spec.md` a pochopiť, čo sa urobilo a prečo. Už nejde o „vibe coding, pri ktorom sa zabudlo, že existuje kód“—je to pracovná pamäť projektu.
## Prečo to potrebuje vibe coder, ktorý nepíše kód?
Kľúčové zistenie
Hlavným problémom vibe codera je nepredvídateľnosť. Dnes vám agent vytvorí funkčnú funkciu za 20 minút; zajtra pri podobnej úlohe vyprodukuje špagetový kód. Spec Kit odstraňuje zdroj tejto nepredvídateľnosti—nejasne formulovanú úlohu. Keď napíšete špecifikáciu pomocou šablóny, agent pracuje konzistentne, pretože má jednoznačný zdroj pravdy. Navyše získate trvalý artefakt v repozitári, ku ktorému sa môžete o mesiac vrátiť.
Spec Kit formalizuje plánovanie v samostatných krokoch pomocou 4 príkazov slash. Logika je rovnaká: oddeliť „premyslenie“ od „implementácie“, aby prebiehali v rôznych kontextových oknách. Každá fáza dostane čistý kontext, ktorý nezaplnila predchádzajúca fáza.
Tri konkrétne výhody pre vibe codera:
- **Predvídateľnosť.** Keď agentovi poviete „vytvor registračný formulár s potvrdením e-mailom“, sám si domyslí 10 detailov—a tri z nich odhadne inak, než ste zamýšľali. Keď máte `spec.md` s User Stories, Acceptance Scenarios a značkami `[NEEDS CLARIFICATION]` pri každom nejasnom bode, nie je čo hádať.
- **Pamäť projektu.** O mesiac si nebudete pamätať, čo ste s agentom preberali v chate. Súbory `spec.md`, `plan.md` a `tasks.md` sú však v repozitári, v priečinku `specs/###-feature/` vedľa kódu. Ukazujú vám nielen čo sa urobilo, ale aj prečo.
- **Rozsah.** Pri funkcii, ktorá sa týka 1-2 súborov, je rozdiel sotva badateľný. Pri funkcii, ktorá sa týka 20 súborov a 5 dátových entít, je rozdiel medzi „po 4 hodinách všetko prepisovať“ a „po 4 hodinách je všetko v hlavnej vetve“. AWS Kiro predviedlo 95 % automatizáciu obchodnej logiky zo špecifikácie v projekte TargetID.
Hlavná ilúzia vibe codingu spočíva v tom, že na začiatku vyzerá rýchlejšie. Za pol hodiny máte prototyp. Po týždni sa však prototyp pokazí a ľahšie je ho zahodiť. Spec-Driven Development trvá na začiatku o trochu dlhšie (hodinu namiesto pol hodiny), ale o týždeň neskôr stále pracujete v tom istom repozitári.
## Ako nainštalovať Spec Kit v Claude Code (4 kroky)
Kľúčové zistenie
Spec Kit sa inštaluje cez uv, správcu balíkov Python od Astral. Samotný príkaz zaberie jeden riadok. Po inštalácii prejdite do svojho repozitára, spustite `specify init` s príznakom `--integration claude` (alebo vyberte Claude Code zo zoznamu agentov) a získate hotovú štruktúru so šablónami constitution, spec, plan a tasks, ako aj súbor príkazov `/speckit-*` priamo v Claude Code. Inštalácia trvá 5 minút, ak už máte uv nainštalované, a 10 minút, ak ho inštalujete od začiatku.
**Krok 1. Nainštalujte uv.** Stačí to urobiť raz; zostane vo vašom systéme.
```bash
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```
Skontrolujte, či sa uv nainštalovalo:
```bash
uv --version
```
**Krok 2. Nainštalujte Spec Kit.** Jeden príkaz:
```bash
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
```
Kontrola:
```bash
specify --version
```
**Krok 3. Inicializujte repozitár.** Prejdite do priečinka projektu (alebo vytvorte nový) a spustite:
```bash
specify init --here --integration claude
```
Príznak `--integration claude` vyberie Claude Code priamo. Bez neho vás Spec Kit požiada, aby ste vybrali agenta z interaktívneho zoznamu, a môže sa opýtať aj na typ skriptu (pre macOS a Linux ponechajte `sh`). Ak priečinok nie je prázdny, Spec Kit vás upozorní, že zlúči svoje súbory s vašimi: najprv uložte svoju prácu pomocou commitu a potom príkaz zopakujte s príznakom `--force`.
Potom sa v repozitári objaví:
```
.specify/
memory/
constitution.md # project rules, filled in by /speckit-constitution
scripts/
templates/
spec-template.md
plan-template.md
tasks-template.md
.claude/
skills/
speckit-constitution/SKILL.md
speckit-specify/SKILL.md
speckit-clarify/SKILL.md
speckit-plan/SKILL.md
speckit-checklist/SKILL.md
speckit-tasks/SKILL.md
speckit-analyze/SKILL.md
speckit-implement/SKILL.md
speckit-converge/SKILL.md
speckit-taskstoissues/SKILL.md
```
**Krok 4. Otvorte Claude Code a skontrolujte príkazy slash.** V tom istom priečinku spustite:
```bash
claude
```
V relácii napíšte `/speckit`—príkazy `speckit-*` by sa mali zobraziť v návrhoch. Ak sa nezobrazia, reštartujte Claude Code, aby znova načítal `.claude/skills/`. Ak už máte v koreňovom priečinku projektu súbor `CLAUDE.md`, Spec Kit ho ponechá nedotknutý—funguje popri ňom v `.specify/memory/constitution.md`.
Spec Kit funguje aj bez Claude Code (podporuje 30+ agentov), ale tento sprievodca sa venuje nastaveniu konkrétne pre Claude. Ak chcete hneď nainštalovať dva nástroje, pozrite si samostatné príručky o [nastavení CLAUDE.md](https://ailoot.ai/blog/sk/claude-md-template/) a [režime Plan Mode v Claude Code](https://ailoot.ai/blog/sk/claude-code-plan-mode/).
Spec Kit je prvým stavebným prvkom „pracovnej zmluvy agenta“. Kompletné nastavenie obsahuje všetky tri časti: AI klon (vašu metodiku vo forme Skills a subagentov), Druhý mozog (štruktúru `business/`, do ktorej sa agent zakaždým vracia) a inžinierstvo kontextu (Spec Kit, Plan Mode, /compact). To sú tri piliere, bez ktorých AI halucinuje.
## Ako napísať svoju prvú špecifikáciu (Specify)
Kľúčové zistenie
Spec Kit vás požiada, aby ste funkciu opísali voľnou formou, a potom tento opis rozšíri do súboru `spec.md` podľa šablóny: User Stories s prioritami P1/P2/P3, Acceptance Scenarios vo formáte Given/When/Then, Functional Requirements (FR-001, FR-002 atď.) a Success Criteria s merateľnými výsledkami. Všade, kde si agent nie je istý, vloží značku `[NEEDS CLARIFICATION: ...]`—a vy na tieto otázky odpoviete pred prechodom k Plan.
V Claude Code napíšte:
```
/speckit-specify
```
Agent potom požiada o opis funkcie. V tomto kroku používajte jednoduchý jazyk bez technického žargónu:
```
Chcem vo svojej aplikácii registračný formulár. Používateľ zadá e-mail
a heslo, dostane potvrdzovací e-mail a po potvrdení
sa dostane na nástenku. Potvrdenie vyprší po 48 hodinách. Ak e-mail
stále nie je potvrdený, účet odstráňte do 5 minút po tomto termíne;
potvrdený účet nikdy nemažte.
```
V ilustračnom príklade bola tolerancia odstránenia vyjasnená na 5 minút po 48-hodinovom termíne. Pri skutočnom produkte ju potvrďte pred Plan; presný 48-hodinový termín potrebuje návrh a testy vynucujúce silnejšiu požiadavku. Agent zostaví súbor `specs/001-registration/spec.md`. Otvorte ho a uvidíte štruktúru, ako je táto:
```markdown
# Špecifikácia funkcie: registrácia používateľa
**Vetva funkcie**: `001-registration`
**Vytvorené**: 2026-05-31
**Stav**: Návrh
**Vstup**: Opis používateľa: "Chcem registračný formulár..."
## Scenáre používateľa a testovanie *(povinné)*
### Primárny príbeh používateľa
Ako nový používateľ sa chcem zaregistrovať pomocou potvrdenia e-mailu,
aby som mohol pristupovať na nástenku s overenou identitou.
### Scenáre prijatia
1. **Given** som na registračnej stránke,
**When** odošlem platný e-mail a heslo,
**Then** dostanem potvrdzovací e-mail do 1 minúty.
2. **Given** som klikol na potvrdzovací odkaz do 48 hodín,
**When** sa dostanem na nástenku,
**Then** v profile vidím, že môj e-mail je potvrdený.
3. **Given** som nepotvrdil účet pri termíne 48 hodín,
**When** čistenie prebehne počas nasledujúcich 5 minút,
**Then** účet sa odstráni a e-mail sa uvoľní na opätovnú registráciu.
4. **Given** účet ešte nemá 48 hodín alebo je potvrdený,
**When** prebehne čistenie,
**Then** účet sa neodstráni.
## Požiadavky *(povinné)*
### Funkčné požiadavky
- **FR-001**: Systém MUSÍ prijímať registráciu cez [NEEDS CLARIFICATION:
iba e-mail/heslo alebo aj SSO/OAuth?]
- **FR-002**: Systém MUSÍ odoslať potvrdzovací e-mail do 60 sekúnd
- **FR-003**: Potvrdenie MUSÍ vypršať pri 48 hodinách; systém MUSÍ
stále nepotvrdené účty odstrániť najneskôr 5 minút po termíne
a NESMIE odstrániť potvrdené účty
- **FR-004**: Systém MUSÍ zaznamenávať všetky pokusy o registráciu počas [NEEDS
CLARIFICATION: ako dlho uchovávame záznamy – 30 dní, 90 dní, navždy?]
### Kľúčové entity
- User: e-mail, password_hash, email_verified_at, created_at, deleted_at
- ConfirmationToken: token, user_id, expires_at, used_at
## Kritériá úspechu *(povinné)*
- **SC-001**: 95 % potvrdzovacích e-mailov doručených do 60 sekúnd (p95)
- **SC-002**: 0 náhodných odstránení potvrdených účtov
- **SC-004**: Žiadne mazanie pred 48 hodinami; každý oprávnený
nepotvrdený účet zmazaný do veku 48 hodín 5 minút pri testovanej záťaži
- **SC-003**: Miera dokončenia registrácie > 60 % (od otvorenia formulára po nástenku)
```
Všímajte si značky `[NEEDS CLARIFICATION: ...]`. Spec Kit ich zámerne vkladá všade, kde agent z vášho textu nedostal jednoznačnú odpoveď. Pred prechodom do fázy Plan na ne musíte buď odpovedať ručne v `spec.md`, alebo spustiť `/speckit-clarify`; agent potom prejde nejasné body a položí vám otázky v dialógu.
V Spec Kit nahrádza vstavaný príkaz `/speckit-clarify` hovorené „pýtaj sa ma“. Výsledok je rovnaký: k Plan nepokračujete, kým v `spec.md` nezostanú žiadne značky `[NEEDS CLARIFICATION]`.
V `spec.md` by nemali byť žiadne technológie. Žiadne zmienky o React, Postgres, Prisma ani Redis. Špecifikácia opisuje, čo systém robí z pohľadu používateľa a firmy. Technologický stack prichádza v ďalšej fáze.
## Čo robí Claude vo fáze Plan?
Kľúčové zistenie
Príkaz `/speckit-plan` vezme hotovú špecifikáciu a zostaví technický plán: ktoré technológie použiť, akú architektúru, ktoré moduly, dátové entity a kontrakty API. Plán sa zapisuje do `specs/###-feature/plan.md`, kontrakty sa exportujú do samostatného priečinka `contracts/` a dátový model sa vloží do `data-model.md`. V tomto kroku Claude už pozná váš stack zo súboru CLAUDE.md a constitution, takže plán zapadne do existujúceho projektu namiesto návrhu „prepíšme všetko v Ruste“.
Keď je `spec.md` pripravený, spustite:
```
/speckit-plan
```
Prípadne môžete do príkazu priamo pridať technologické pokyny:
```
/speckit-plan Next.js App Router, Prisma, PostgreSQL, Resend na e-mail
```
Claude číta tri zdroje: váš `spec.md`, váš `CLAUDE.md` (alebo `memory/constitution.md`) a existujúci kód v repozitári. Výstupom je `plan.md` so štruktúrou približne takouto:
```markdown
# Plán implementácie: registrácia používateľa
## Technický kontext
- Framework: Next.js 14 App Router
- Databáza: PostgreSQL cez Prisma
- E-mail: Resend (jediný transport)
- Validácia: schéma Zod v zdieľanej knižnici
- Auth: NextAuth.js s poskytovateľom credentials
## Architektonické rozhodnutia
### 1. Ukladanie tokenov
Tokeny sa ukladajú v DB (tabuľka ConfirmationToken), nie v JWT.
Dôvod: pri opätovnej registrácii e-mailu je potrebné odvolanie na strane servera.
### 2. Doručovanie e-mailov
Asynchrónne cez cron `/api/cron/send-confirmation`, spustené okamžite
po registrácii. Opakovanie pokusov zabezpečuje Resend.
### 3. Automatické mazanie cez cron
Spúšťajte `/api/cron/cleanup-unconfirmed` každú minútu. Mažte iba riadky, kde
created_at <= NOW() - INTERVAL '48 hours' AND email_verified_at IS NULL.
Vyjasnený príklad povoľuje najviac 5 minút oneskorenia odstránenia.
Overte meškanie plánovača a čas dokončenia voči tejto hranici;
prekročenie hláste ako zlyhanie, nie úspešné denné čistenie.
## Dátový model
Pozrite si data-model.md
## Kontrakty API
Pozrite si contracts/
- POST /api/auth/register
- POST /api/auth/confirm
- GET /api/auth/resend-confirmation
## Fázy implementácie
1. Migrácia databázy (schéma Prisma + súbor migrácie)
2. Trasy API (3 koncové body)
3. UI: registračný formulár + stránka úspešného potvrdenia
4. Úlohy cron (odoslanie + čistenie)
5. Šablóna e-mailu
6. Integračné testy
```
Súbor `data-model.md` opíše entity a ich vzťahy. Priečinok `contracts/` bude obsahovať návrhy kontraktov API (buď OpenAPI YAML, alebo typy požiadaviek/odpovedí TypeScript). Toto nie je kód—je to zámer, ktorý Claude neskôr premení na skutočné trasy.
Hlavnou výhodou fázy Plan je čistý kontext. Claude sa nesnaží držať v hlave špecifikáciu aj implementáciu naraz. Najprv všetko premyslí, rozhodnutie zaznamená do súboru a potom pokračuje.
Nasleduje voliteľný príkaz `/speckit-analyze`. Spúšťa sa po fáze Tasks a pred Implement: kontroluje množinu `spec.md + plan.md + tasks.md`, či neobsahuje rozpory, a overuje, či plán a úlohy pokrývajú všetky požiadavky špecifikácie. Súbory neupravuje; vytvára iba správu. V podstate ide o formálnu kontrolu pred implementáciou.
## Ako rozdeliť prácu na úlohy (Tasks)
Kľúčové zistenie
Príkaz `/speckit-tasks` rozdelí plán na konkrétne úlohy. Každá úloha obsahuje závislosti, odhad a značku „možno vykonať paralelne“ alebo „striktne postupne“. Výstupom je `tasks.md`, kde sa úlohy zapisujú vo formáte kontrolného zoznamu `[ ] T-001: ...`. Potom ich môžete odovzdať na implementáciu pomocou `/speckit-implement` alebo ich previesť na GitHub Issues pomocou `/speckit-taskstoissues`—a rozdeliť medzi tím alebo niekoľko paralelných relácií Claude Code.
Keď máte `spec.md` a `plan.md`, spustite:
```
/speckit-tasks
```
Claude rozpracuje plán do súboru `tasks.md`:
```markdown
# Úlohy: registrácia používateľa
## Fáza 1: Databáza (bez závislostí)
- [ ] T-001: Pridať model User do prisma/schema.prisma (bezpečné paralelne)
- [ ] T-002: Pridať model ConfirmationToken do prisma/schema.prisma (po T-001)
- [ ] T-003: Vygenerovať migráciu `add-user-registration` (po T-002)
## Fáza 2: Kontrakty API (bez závislostí)
- [ ] T-004: Vytvoriť schémy Zod v shared/validation/auth.ts
- [ ] T-005: Definovať typy TypeScript v shared/types/auth.ts (po T-004)
## Fáza 3: Trasy (závisí od fáz 1+2)
- [ ] T-006: Implementovať POST /api/auth/register
- [ ] T-007: Implementovať POST /api/auth/confirm
- [ ] T-008: Implementovať GET /api/auth/resend-confirmation
## Fáza 4: UI (paralelne s fázou 3)
- [ ] T-009: Vytvoriť stránku /register s formulárom
- [ ] T-010: Vytvoriť stránku /register/confirm/[token]
- [ ] T-011: Vytvoriť stránku /register/success
## Fáza 5: Cron + integrácia (závisí od fáz 3+4)
- [ ] T-012: Cron /api/cron/send-confirmation
- [ ] T-013: Cron /api/cron/cleanup-unconfirmed
- [ ] T-014: E-mailová šablóna registration-confirmation.tsx
- [ ] T-015: Integračné testy (Playwright) vrátane čistenia tesne
pred 48h, presne pri 48h, odstránenia do 48h 5m, zlyhania oneskorenej
úlohy a ochrany potvrdených účtov
## Poznámky
- T-001, T-004, T-009-T-011 možno vykonať paralelne (rôzne súbory)
- T-002 je v konflikte s T-001 (rovnaký súbor: schema.prisma) - spúšťať postupne
- T-006 potrebuje T-003 (aplikovanú migráciu) a T-005 (typy)
```
Všímajte si značky `parallel-safe` a `after T-NNN`. Ide o graf závislostí, ktorý neskôr umožňuje vykonávať viacero fáz paralelne. Celé zrýchlenie so Spec Kit stojí na tomto mechanizme: niektoré úlohy možno zveriť piatim rôznym reláciám Claude Code naraz, zatiaľ čo iné sa musia vykonávať striktne postupne.
Spec Kit to robí automaticky jediným príkazom, hneď po nainštalovaní.
Voliteľný príkaz `/speckit-taskstoissues` vezme `tasks.md` a vytvorí zo zoznamu GitHub Issues, z ktorých každý obsahuje odkaz späť na `spec.md`. Je to užitočné, ak pracujete v tíme alebo chcete sledovať pokrok cez GitHub Projects.
## Ako implementovať pomocou subagentov (Implement)
Kľúčové zistenie
Záverečná fáza `/speckit-implement` spúšťa implementáciu. Claude postupuje úlohami v `tasks.md` zhora nadol a po dokončení ich označuje `[x]`. Môžete spustiť niekoľko paralelných relácií Claude Code naraz—jednu fázu na jednu reláciu. V rámci každej relácie Claude spúšťa subagentov pre rôzne druhy práce: kontrolóra kódu, testera na kontroly a autora dokumentácie pre README. To je „1000 parallel subagents“, o ktorých Anthropic písala pri vydaní Opus 4.8—v Spec Kit je to jednoducho pracovný režim, nie samostatný produkt.
```
/speckit-implement
```
Claude začne prvou úlohou v `tasks.md`. Každá úloha prejde krátkym cyklom: prečítať príslušné súbory, pripraviť diff, spustiť testy, skontrolovať `[x]`. Podľa potreby sa automaticky volajú subagenti: samostatný na kontrolu kódu, ďalší na spustenie lintera a ďalší na kontrolu regresií.
A samostatne o pravidlách:
V Spec Kit je tento cyklus formalizovaný. Máte `spec.md` ako zdroj pravdy, `plan.md` pre technické rozhodnutia a `tasks.md` ako kontrolný zoznam. Ak Claude v ktoromkoľvek kroku odbočí, vrátite sa k špecifikácii a poviete: „To nezodpovedá FR-003; urob to znova.“ Žiadne dlhé prompty typu „pamätaj, čo sme preberali...“—celá história je v súboroch.
Ak ste pripojili [Dynamic Workflows v Opus 4.8](https://ailoot.ai/blog/sk/claude-code-dynamic-workflows/), môžete Spec Kit nastaviť do plne automatizovaného režimu: jeden príkaz `/speckit-implement` a Claude rozdelí prácu paralelne, skonsoliduje výsledky a skontroluje ich. Limit je 1000 subagentov naraz. Pri väčšine funkcií stačí 10-30.
Keď sú všetky políčka `[x]` zaškrtnuté a kontrola v nasledujúcej časti vráti „Converged“, skontrolujete PR (alebo sériu PR, ak je úloh veľa) a zlúčite ho. Artefakty—`spec.md`, `plan.md`, `tasks.md`—zostanú v repozitári ako dokumentácia funkcie. O rok nebudete musieť spätne odvodzovať logiku z kódu.
## Ako skontrolovať, či agent na niečo nezabudol (Converge)
Kľúčové zistenie
Po Implement má aktuálna verzia Spec Kit kontrolný krok s názvom `/speckit-converge`. Agent porovná hotový kód so súbormi `spec.md`, `plan.md` a `tasks.md`. Ak sa všetko zhoduje, odpovie „Converged“ a súbory ponechá nedotknuté. Ak nájde opomenutia, pridá ich ako nové úlohy na koniec `tasks.md`. Potom znova spustíte `/speckit-implement` a následne `/speckit-converge`, až kým nedostanete „Converged“.
```
/speckit-converge
```
Najprv agent poskytne súhrn zistení s úrovňami závažnosti a potom jeden z dvoch výsledkov. „Converged“ znamená, že nič nechýba, `tasks.md` zostáva bajt po bajte nezmenený a môžete pokračovať v kontrole. „Tasks appended“ znamená, že sa našli opomenutia, boli pridané do sekcie Convergence v `tasks.md` a agent vám oznámi ich počet.
Converge neupravuje ani nemaže kód; jediným zápisom sú nové úlohy v `tasks.md`. Môžete ho teda spustiť bez obáv, ale až po tom, čo `/speckit-implement` spracovalo aktuálne úlohy v `tasks.md`. Každý ďalší priechod nájde menej opomenutí.
## Ako sa Spec Kit líši od CLAUDE.md a Plan Mode?
Kľúčové zistenie
Pri porovnávaní týchto nástrojov ide o častú otázku. Krátka odpoveď: CLAUDE.md je „pracovná zmluva“ agenta, jediný zdroj pravdy pre celý projekt. Plan Mode je jednorazové plánovanie pred konkrétnou požiadavkou. Spec Kit predstavuje celý životný cyklus jednej funkcie: od opisu po implementáciu, s artefaktmi v repozitári. Navzájom sa nenahrádzajú; spájajú sa do trojvrstvového systému: globálny kontext (CLAUDE.md) → kontext projektu (constitution Spec Kit) → kontext funkcie (spec.md + plan.md + tasks.md).
Porovnajte ich podľa 5 charakteristík:
| Charakteristika | CLAUDE.md | Plan Mode | Spec Kit |
|----|----|----|----|
| Kedy sa spúšťa | Každá relácia | Na požiadanie (Shift+Tab alebo /plan) | Príkazom slash /speckit-\* |
| Životnosť | Celý projekt | Jedna relácia | Jedna funkcia |
| Kde sa nachádza | Koreň repozitára | V kontexte Claude | `specs/###-feature/*` |
| Čo uchováva | Stack, pravidlá, glosár | Aktuálny plán + pozorovania | spec + plan + tasks + contracts |
| Šablóna | Voľná forma (pravidlá repozitára) | Žiadna | Štruktúrovaný Markdown |
| Najvhodnejšia úloha | Pravidlá projektu a stack | Dvojitá kontrola pred veľkou zmenou | Celý cyklus funkcie: od ČO po KÓD |
V terminológii Spec Kit ide o `.specify/memory/constitution.md`. Počas inicializácie môže Spec Kit použiť váš existujúci CLAUDE.md ako základ pre constitution alebo vytvoriť samostatný súbor vedľa neho. Zvyčajne ponechávam CLAUDE.md ako globálnu „zmluvu“ (stack, glosár, protokol nasadenia) a constitution Spec Kit používam na pravidlá špecifické pre funkciu—napríklad „všetky formuláre sa validujú cez Zod; žiadne manuálne kontroly“.
Prepojenie s Plan Mode je jednoduchšie. Plan Mode je rýchly režim „plánovanie pred písaním kódu“ v rámci jednej relácie. Funguje dobre pri malých zmenách (oprava chyby, refaktorovanie funkcie). Pri veľkej funkcii Plan Mode zaostáva, pretože kontextové okno jednej relácie je príliš malé na plán s 3000 riadkami—ako priamo vysvetľujem na živom stretnutí:
Spec Kit je konkrétny nástroj na inžinierstvo kontextu. Presúva „architektonický obrus“ z chatu do súborov. Spec.md zostáva v repozitári a každá nová relácia Claude si ho znovu prečíta—nemusíte sa opakovať.
Nastavenie pre veľký projekt:
1. **CLAUDE.md** - stack, glosár, čo nerobiť. Nachádza sa v koreňovom priečinku.
2. **.specify/memory/constitution.md** pre Spec Kit—pravidlá špecifické pre tento pracovný postup.
3. **specs/001-feature-A/spec.md, plan.md, tasks.md** - prvá funkcia.
4. **specs/002-feature-B/spec.md, plan.md, tasks.md** - druhá funkcia.
5. Pri každodennej práci buď `/speckit-implement` (pre pripravené úlohy), alebo `/plan` (rýchla dvojitá kontrola pred zmenou).
## Ktoré prípady fungujú v reálnom svete?
Kľúčové zistenie
Prístup Spec Kit a SDD priniesol merateľné výsledky vo veľkých spoločnostiach. AWS v projekte objavovania liekov: 95 % obchodnej logiky vygenerovanej zo špecifikácie, úspora viac ako 80 hodín pri jednej funkcii. Rackspace Technology: 52 týždňov práce skrátených na 3 týždne, +90 % efektivita. Samotný Spec Kit získal na GitHube 107 000 hviezdičiek za 8 mesiacov.
Konkrétne prípady:
- **AWS Kiro - agent na objavovanie liekov.** V [príspevku na blogu AWS Industries](https://aws.amazon.com/blogs/industries/from-spec-to-production-a-three-week-drug-discovery-agent-using-kiro/) z 18. februára 2026 tím opisuje projekt TargetID. Traja vývojári, tri týždne, agent na objavovanie liekov. Čísla v článku: Kiro vygenerovalo viac ako 95 % kódu obchodnej logiky a ušetrilo viac ako 80 hodín vývoja. Ďalej: „Dokumentácia README napísaná nástrojom Kiro nám ušetrila odhadom 8 hodín“ a „o 40 % menej opakovaných cyklov promptovania a opráv“.
- **Rackspace Technology.** V tom istom blogu AWS Rackspace uvádza: „dokončili sme odhadovaných 52 týždňov práce za iba 3 týždne“, „zvýšenie efektivity o 90 %“. Už nejde o malú funkciu—je to celý podnikový projekt.
- **Rast GitHub Spec Kit.** K 31. máju 2026 mal repozitár 107 000 hviezdičiek. Toto tempo rastu jasne signalizuje, že prístup získava podiel na trhu.
Pre čitateľa to znamená, že tento prístup nie je teoretický: seriózne tímy ho už používajú v produkcii.
## Kedy Spec Kit NIE JE vhodný?
Kľúčové zistenie
Spec Kit nie je vhodný všade. Má tri jasné oblasti, kde sa nehodí: malé úpravy (oprava chyby, premenovanie premennej), experimenty a prototypy (keď je nevedieť, čo chcete, samo osebe zmyslom vibe codingu) a starší kód so zložitým stavom (kde špecifikácia zastará rýchlejšie, než ju stihnete napísať). Tieto prípady majú vážnych kritikov. Ich argumenty sa oplatí poznať, aby ste nestrácali čas špecifikáciami, ktoré nepomáhajú.
**Nevhodné č. 1 - malé úpravy.** Ak je úlohou „premenovať premennú“, „opraviť preklep v texte“ alebo „pridať log“, postup Specify → Plan → Tasks bude trvať dlhšie než samotná úprava. Pri malých úpravách je rýchlejší Plan Mode alebo jednoducho priamy prompt v Claude Code.
**Nevhodné č. 2 - živé experimenty.** Keď ešte neviete, čo chcete, a potrebujete sa „pohrabať“ v rozhraní alebo rýchlo zostaviť prototyp, aby ste zistili, „či to funguje“, špecifikácia nemá zmysel. Hodnota spočíva práve v improvizácii. Na úrovni „pohrávania sa s nápadom“ funguje práve vibe, nie špecifikácia.
**Nevhodné č. 3 - starší kód so zložitým stavom.** Silný protiargument: realita sa mení rýchlejšie než špecifikácie. Ako príklad možno uviesť fakturáciu predplatného: tím opísal fakturačné cykly a daňové pravidlá, no o týždeň neskôr finančné oddelenie požiadalo o európsku DPH—špecifikácia zastarala ešte pred vydaním. Keď sa obchodná logika rýchlo vyvíja, udržiavanie špecifikácií sa stáva záťažou.
Ďalším rizikom je falošný pocit kontroly. Článok Martina Fowlera sa tým zaoberá: štruktúry sú elegantné, no agenti často ignorujú pokyny alebo, naopak, nasledujú šablóny príliš doslovne. Výsledkom je kód, ktorý je štrukturálne správny, no nehodí sa do vášho konkrétneho repozitára—špecifikácia nezaručuje, že ju agent pochopil tak, ako ste zamýšľali.
Priemyselní analytici varovali pred waterfall prístupom: napísať rozsiahlu špecifikáciu pred kódom je cesta, ktorá už raz potopila celé odvetvie, ešte v časoch 200-stranových požiadaviek. Inžinieri sú odvtedy voči tomuto prístupu opatrní a ich opatrnosť je odôvodnená.
**Čo s tým.** Navrhujem jednoduché pravidlo: porovnajte veľkosť funkcie s časom potrebným na napísanie špecifikácie. Ak implementácia funkcie potrvá menej ako 2 hodiny, špecifikáciu nepíšte—Plan Mode je rýchlejší. Ak bude funkcia trvať týždeň, určite použite Spec Kit; úspora času vám hodinovú špecifikáciu vráti päťnásobne. V rozmedzí od 2 hodín do týždňa sa rozhodnite podľa vlastného úsudku, hoci ja osobne píšem špecifikáciu aj pre funkcie na pol dňa, pretože artefakt v repozitári má väčšiu hodnotu než ušetrených 30 minút.
## Čo ďalej: ako integrovať Spec Kit do projektu?
Kľúčové zistenie
Najjednoduchším prvým krokom je vyskúšať Spec Kit na novej malej funkcii, nie na celom existujúcom projekte. Nainštalujte ho, inicializujte v repozitári, spustite `/speckit-specify` pre jednu funkciu a prezrite si artefakty. Za týždeň alebo dva získate cit pre to, kedy ho použiť a kedy zostať pri rýchlych promptoch. Kompletná metodika spája CLAUDE.md + Spec Kit + Skills + subagentov.
Konkrétny plán na nasledujúcich 7 dní:
- **Deň 1.** Nainštalujte uv a Spec Kit (5-10 minút). Skontrolujte, či sa v Claude Code objavili príkazy `/speckit-*`. Nepokúšajte sa ich použiť na existujúci projekt—začnite novým.
- **Deň 2.** Vyberte skutočnú funkciu, ktorú plánujete vytvoriť. Spustite `/speckit-specify` s voľným opisom. Otvorte `spec.md`, prečítajte si ho a odpovedzte na každú položku `[NEEDS CLARIFICATION]`. Neponáhľajte sa do fázy Plan.
- **Deň 3.** Spustite `/speckit-plan` s pokynmi o svojom stacku. Prečítajte si `plan.md`, najmä časť Architecture Decisions. Ak vám niečo nevyhovuje, upravte to ručne.
- **Deň 4-5.** Spustite `/speckit-tasks` a potom `/speckit-analyze`, aby ste ešte raz skontrolovali súbor so špecifikáciou, plánom a úlohami, a následne `/speckit-implement`. Sledujte, ako Claude označuje `[x]` v `tasks.md`. Niekde sa môže zaseknúť—to je normálne. Vráťte sa k `spec.md`, spresnite požiadavku a znovu spustite `/speckit-implement` s konkrétnou úlohou. Po dokončení úloh spustite `/speckit-converge` a opakujte postup Implement a Converge, až kým neodpovie „Converged“.
- **Deň 6-7.** Skontrolujte PR (alebo sériu PR). Zlúčte ho. Prečítajte si svoje `spec.md` a `plan.md`—budú dokumentáciou funkcie na nasledujúci rok.
Čo by som odporučil prečítať súbežne:
- [Ako nastaviť CLAUDE.md v roku 2026](https://ailoot.ai/blog/sk/claude-md-template/) - základ pre constitution Spec Kit.
- [Plan Mode v Claude Code](https://ailoot.ai/blog/sk/claude-code-plan-mode/) - rýchla alternatíva pre malé úlohy.
- [Inžinierstvo kontextu v roku 2026](https://ailoot.ai/blog/sk/context-engineering/) - prečo Spec Kit vôbec funguje.
- [Skills, Subagents, MCP alebo Plugins](https://ailoot.ai/blog/sk/skills-subagents-mcp-plugins-claude-code/) - čo pridať k Spec Kit pre váš pracovný postup.
- [Dynamic Workflows v Claude Code](https://ailoot.ai/blog/sk/claude-code-dynamic-workflows/) - ako spustiť veľa subagentov naraz počas fázy Implement.
### Zdroje
- [GitHub Spec Kit - repozitár](https://github.com/github/spec-kit)
- [GitHub Spec Kit - oficiálna dokumentácia](https://github.github.com/spec-kit/)
- [Spec-Driven Development - oficiálny text metodiky](https://github.com/github/spec-kit/blob/main/spec-driven.md)
- [Šablóna špecifikácie - GitHub](https://github.com/github/spec-kit/blob/main/templates/spec-template.md)
- [Blog AWS Industries - Od špecifikácie po produkciu: agent Kiro na objavovanie liekov (18. februára 2026)](https://aws.amazon.com/blogs/industries/from-spec-to-production-a-three-week-drug-discovery-agent-using-kiro/)
- [Dokumentácia Claude Code - Subagents](https://code.claude.com/docs/en/sub-agents)
- [Dokumentácia Claude Code - Skills](https://code.claude.com/docs/en/skills)
- [Dokumentácia Claude Code - Commands](https://code.claude.com/docs/en/commands)
Kompletný pracovný postup s kontextom: AI klon + Druhý mozog + Inžinierstvo kontextu.
Ďalšie materiály nájdete na [Ailoot](https://ailoot.ai/).
## Otázky a odpovede: Ako nastaviť Spec Kit v Claude Code v roku 2026: špecifikácie namiesto promptov
### Prečo denné čistenie nestačí pri 48-hodinovom termíne odstránenia?
Účet dosahujúci termín tesne po dennom behu môže čakať takmer ďalší deň. V špecifikácii vyjasnite prijateľné meškanie, zvoľte vhodný plán a testujte hranicu 48 hodín aj maximálne oneskorenie.
### Čo robiť pri rozpore plan.md a spec.md?
Pred implementáciou sa vráťte k požiadavke a rozpor vyriešte. Špecifikáciu, plán, úlohy a kontroly prijatia aktualizujte spolu a cez Analyze aj implementačné kontroly overte rovnaké dohodnuté správanie.
## Ailoot · Spoločnosť a jej portfólio projektov
Ailoot stavia na dlhodobých prevádzkových skúsenostiach, širokej klientskej základni, stabilných službách a priebežnom sledovaní KPI.
Spoločnosť a jej portfólio projektov: milióny zákazníkov; mesačné tržby v miliardách.
Ailoot využíva tieto prevádzkové skúsenosti na poskytovanie prístupu cez API k funkciám AI v produktoch zákazníkov, agentoch, aplikáciách a automatizáciách.