Lekce 5 / 7 · ~10 minut

Kontext: CLAUDE.md
a paměť projektu

Nepříjemné překvapení druhého dne: otevřeš nový rozhovor a Claude si nepamatuje nic ze včerejška. Není to chyba, každá session začíná s čistou hlavou. Řešením je soubor jménem CLAUDE.md.

CLAUDE.md: sešit, který si přečte sám

Pokud v adresáři projektu existuje soubor CLAUDE.md, Claude Code si ho automaticky přečte na začátku každé session. Je to vzkaz, který včerejší session nechává té dnešní. Patří do něj:

  • Co projekt je: jedna dvě věty.
  • Jak se spouští a nasazuje: kde se klikne, co se napíše.
  • Pravidla: čeho se nedotýkat, v jakém jazyce psát texty.
  • Aktuální stav: co je hotové, na čem se pracuje.

A nejlepší na tom: nemusíš ho psát sám. Na konci session řekni: „Zapiš do CLAUDE.md, co jsme dnes udělali a co je rozdělané.“ Claude si vede vlastní sešit, ty ho jen občas zkontroluješ.

Dlouhé sessions: kdy začít znovu

Rozhovor má omezenou „pracovní paměť“, tedy kontext. Když je session moc dlouhá, odpovědi se zpomalují a Claude začne zapomínat, co bylo na začátku. Zlaté pravidlo:

Hotová věc → commit → zápis do CLAUDE.md → klidně nová session. Nová session s dobrým CLAUDE.md ví o projektu všechno podstatné a myslí svižně.

Skládačka: co patří do CLAUDE.md?

Osm bloků pro fiktivní web kavárny. Klikni na čtyři, které do CLAUDE.md patří, a vyhodnoť.

„Projekt: web kavárny Amora. Statické HTML, stránky v adresáři web/, styly v assets/style.css.“

Patří: co projekt je a kde co leží. První věc, kterou nová session potřebuje.

„Heslo k hostingu: kavaAmora2026!“

Nepatří: hesla do CLAUDE.md nikdy (lekce 4). Soubor putuje s projektem všude.

„Spuštění: otevři web/index.html v prohlížeči. Nasazení: řekni Claudovi ‚nasaď web‘. Ví, jak na to.“

Patří: jak se projekt spouští a nasazuje. Přesně to, co bys jinak každý den vysvětloval znovu.

„3. 6. jsme zkoušeli modré pozadí, pak zelené, pak světle modré, pak zase modré, Katka chtěla béžové…“

Nepatří. Deník pokusů zabírá místo a nepomáhá. Historie je v gitu, v CLAUDE.md drž jen aktuální stav a platná rozhodnutí.

„Pravidla: texty piš česky s diakritikou. Neměň nic v adresáři fotky-original/.“

Patří: pravidla a zákazy. Claude je bude respektovat v každé session bez připomínání.

„Claude, buď prosím maximálně kreativní, důsledný a mysli jako světový designér.“

Nepatří. Prázdná zaklínadla nic nezlepšují. Místo v kontextu utrácej za fakta o projektu.

„Stav: hotová úvodní stránka a menu. Rozdělané: rezervační formulář, chybí odesílání.“

Patří: aktuální stav a rozdělané věci. Nová session přesně ví, kde pokračovat.

Celý HTML kód úvodní stránky, překopírovaný do CLAUDE.md „pro jistotu“.

Nepatří. Kód žije v souborech, Claude si ho přečte sám. Kopie v CLAUDE.md jen zastarává a zabírá kontext.

Shrnutí

  • CLAUDE.md = paměť projektu. Claude si ho čte automaticky na začátku session.
  • Patří do něj: co projekt je, jak se spouští, pravidla, aktuální stav. Nepatří: hesla, kód, deníky.
  • Psaní deleguj: „zapiš do CLAUDE.md, co jsme dnes udělali“.
  • Dlouhá session slábne: hotová věc, commit, zápis, nová session.