Co do něj patří a co ne

Nejčastější chyba je napsat do CLAUDE.md popis projektu. To je hezké, ale k ničemu – Claude si projekt umí přečíst sám. Do CLAUDE.md patří to, co si přečíst nemůže: tvoje rozhodnutí.

Šest sekcí

1. Co to je

   Dvě až tři věty. Co projekt dělá a pro koho. Ne marketing, jen fakta.

2. Jak se to spouští

   Přesné příkazy. npm run dev, port, co je potřeba mít nainstalované. Tohle ušetří spoustu tápání.

3. Struktura

   Kde co leží. Ne výpis všech souborů – jen orientace: „stránky v src/app, sdílené komponenty v src/components, texty v content/.“

4. Konvence

   Jak se tu píše. Jazyk textů, styl pojmenování, jaké komponenty se používají místo vlastních.

5. Pravidla

   Co dělat a co nedělat. Nejcennější sekce. Sem jde všechno, co jsi musel říct víc než jednou.

6. Na co si dát pozor

   Pasti konkrétního projektu. „Soubor X se generuje, needituj ho.“ „Změny v Y musí jít i do Z.“

Ukázka

# Rezervace pro kadeřnictví

Jednoduchá webová aplikace, kde si zákazník vybere termín a zaměstnanec
vidí obsazenost dne. Zákazník se nemusí registrovat.

## Spuštění

- `npm run dev` – vývojový server na portu 3000
- `npm run build` – produkční build, musí projít bez chyb
- Databáze běží lokálně, nastavení v `.env.local` (vzor v `.env.example`)

## Struktura

- `src/app` – stránky a routy
- `src/components` – sdílené komponenty
- `src/lib/db` – práce s databází, nic jiného s ní nemluví
- `content/` – texty, které mění zadavatel

## Konvence

- Všechny texty pro uživatele jsou česky, včetně chybových hlášek.
- Data se čtou jen přes funkce v `src/lib/db`. Nikde jinde SQL.
- Tlačítka a formulářové prvky jsou v `src/components/ui`. Nová se
  nevytvářejí, dokud se ta stávající nedají použít.
- Datum se zobrazuje ve tvaru 14. 3. 2026.

## Pravidla

- Neinstaluj nové balíčky bez zeptání. Napiš, co chceš přidat a proč.
- Před koncem větší změny spusť `npm run build` a oprav chyby.
- Neměň soubory v `src/generated/` – generují se automaticky.
- Když si nejsi jistý zadáním, zeptej se dřív, než začneš psát kód.

## Na co si dát pozor

- Časy se ukládají v UTC, zobrazují v evropském čase. Nemíchat.
- Otevírací doba je v databázi, ne v kódu.

Padesát řádků. Nic víc není potřeba.

Pravidlo versus popis

Tohle je rozdíl, který dělá CLAUDE.md užitečným.

Levý sloupec si Claude přečte z projektu za deset vteřin. Pravý ne odnikud.

Co tam nepatří

Jak dlouhý má být

Krátký. Padesát až sto padesát řádků je zdravé rozpětí.

Když nabobtná na pět set řádků, ztrácí sílu ze dvou důvodů. Zaprvé zabírá kontext, který mohl patřit skutečné práci. Zadruhé se v šumu ztratí to, na čem záleží.