====== Claude Code – tahák ======

//Vytvořeno: **5.5.2026** | Aktualizováno: **~~LASTMOD~~**//

Claude Code tahák shrnuje základní postup vývoje s AI pomocí Claude Code. Podklad pochází z taháku „Claude Code – tahák“ od Patricka Zandla z [[https://vibecoding.cz|vibecoding.cz]], duben 2026.

===== Postup: od nápadu k aplikaci =====

==== 1. Vytvořte PRD (zadání) ====

Popište nápad, nechte Claude klást otázky.

<code>
$ claude
> Mám nápad: [popis]. Potřebuji PRD. Začni otázkami. Ptej se postupně.
</code>

==== 2. Vygenerujte PRD do souboru ====

Po zodpovězení otázek nechte Claude napsat dokument.

<code>
> Vygeneruj PRD do docs/PRD.md Použij Gherkin formát pro user stories.
</code>

==== 3. Plan mode – nejdřív plán ====

Claude navrhne kroky, vy schvalujete. Použijte slovo ''ultraplan'' místo ''plán'' pro interaktivní verzi.

<code bash>
$ claude --plan
> Přečti docs/PRD.md a navrhni implementační plán.
</code>

==== 4. Vytvoření CLAUDE.md ====

Nyní je čas vytvořit ''CLAUDE.md''. Nechte ho vygenerovat automaticky, ale procházejte jej pravidelně.

<code>
> Přečti docs/PRD.md a vytvoř CLAUDE.md s pravidly projektu.
</code>

==== 5. Implementace ====

Claude vytvoří soubory, nainstaluje závislosti, napíše kód.

<code>
> Přečti docs/PRD.md a implementuj. Postupuj krok po kroku podle plánu.
</code>

==== 6. Nasazení ====

Commit, push, deploy – Claude zvládne za vás.

<code>
> Commitni, pushni na GitHub a nasaď na Vercel/Cloudflare.
</code>

==== 7. Rozšíření a iterace ====

Databáze, auth, API – vždy s kontextem.

<code>
> Přidej Supabase databázi místo JSON. Zachovej stávající funkce.
</code>

===== Jak hlásit chyby =====

  * **Syntaktická:** zkopírujte chybovou hlášku přímo.
  * **Runtime:** jen relevantní výsek logu, ne celý.
  * **Logická (nejhorší):** co čekáte vs. co dostáváte.

<code>
> Test UserAuth padá. Expected: 200 OK Actual: 401 Unauthorized
</code>

Pozor: Celý log = Claude se ztratí v šumu.

===== Klíčové příkazy =====

  * ''/usage'' – kolik kontextu zbývá + cena session
  * ''/compact'' – reset kontextu, proaktivně kolem 60 %
  * ''/compact [instrukce]'' – reset + co zachovat
  * ''/model'' – volba jiného modelu LLM
  * ''/clear'' – uvolnění paměti kontextu
  * ''claude --plan'' – plan mode, jen navrhuje
  * ''claude --resume'' – pokračuje v session
  * ''Shift+Tab'' – přepnutí plan / act mode
  * ''Esc'' – přerušení operace
  * ''Esc Esc'' – vymazání prompt okna

Tip: ''/compact'' používat proaktivně s instrukcí, co zachovat. Auto-compact ztrácí víc.

===== CLAUDE.md – paměť projektu =====

Soubor v kořeni projektu. Claude ho čte automaticky.

<code markdown>
# CLAUDE.md

## Projekt Katalog receptů
- Vite + React + TS

## Pravidla
- Vždy TypeScript strict mode
- Testy: vitest, spouštěj npm test
- Styl: Tailwind, žádné inline styly

## Struktura
src/components/ - React komponenty
src/lib/ - utility a API volání
docs/PRD.md - zadání projektu

## Dokumentace
Před prací si přečti relevantní soubory z docs/
</code>

===== Zlatá pravidla =====

  - **PRD první, kód druhý.** 15 min na zadání ušetří hodiny oprav.
  - **Plan mode před implementací.** Nechte Claude navrhnout, pak schvalte.
  - **Jeden úkol = jeden prompt.** Nepište „udělej vše“. Po krocích.
  - **CLAUDE.md udržujte aktuální.** Paměť mezi sessions. Přežije ''/compact''.
  - **Compact proaktivně kolem 60 %.** Nečekejte na auto-compact.
  - **Expected vs. actual u chyb.** Vždy řekněte, co čekáte a co dostáváte.


===== Zdroje =====

  * [[https://vibecoding.cz|vibecoding.cz]] – zdroj taháku „Claude Code – tahák“, Patrick Zandl, duben 2026