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ěť" — 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.