CLAUDE.md a projektové instrukce
Přejít na sekci
Co je CLAUDE.md a proč ho potřebujete
CLAUDE.md je soubor s instrukcemi, který se automaticky načte do kontextu každé konverzace s Claude Code. Je to váš způsob, jak modelu říct: 'takhle pracujeme v tomhle projektu'. Bez něj každá konverzace začíná od nuly. S ním má model kontext ještě před vaším prvním promptem.
Hierarchie CLAUDE.md souborů
Můžete mít několik úrovní: globální (~/.claude/CLAUDE.md) pro vaše osobní preference, projektový (v kořeni repozitáře) pro týmové konvence, a lokální (.claude/CLAUDE.md) pro věci, které nechcete commitovat. Model je všechny spojuje — specifickější má přednost.
Globální CLAUDE.md je ideální pro věci jako 'komunikuj česky', 'používej funkcionální styl'. Projektový CLAUDE.md pro 'používáme Next.js 16, Tailwind 4, testy v Playwright'.
Anatomie efektivního CLAUDE.md
# Můj Projekt
## Quick Start
npm run dev # Dev server
npm run test # Vitest
npm run lint # ESLint + Prettier
## Stack
- Next.js 16 (App Router), React 19, TypeScript 5.7
- Tailwind CSS 4, class-based dark mode
- Drizzle ORM + PostgreSQL
- Vitest + Playwright
## Conventions
- Functional components, no class components
- Server Components by default, 'use client' only when needed
- Collocate tests: `foo.ts` -> `foo.test.ts`
- Prefer named exports over default exports
- Error boundaries at route level, not component levelCo do CLAUDE.md nepatří
Nejčastější chyba: příliš dlouhý CLAUDE.md. Každý token v něm zabere místo v kontextovém okně. Nepatří tam: celé API dokumentace (odkazujte na soubory), historie změn (to je git), detailní tutoriály, ani věci, které model může odvodit z kódu.
Zásadní pravidlo: CLAUDE.md by měl obsahovat jen informace, které model nemůže zjistit z kódu nebo git historie. 'Používáme React' — to vidí z package.json. 'Server Components preferujeme před Client Components kvůli performance budgetům' — to musíte říct.
Direktivy vs. informace
Rozlišujte dva typy obsahu. Direktivy jsou pokyny: 'Nikdy nepoužívej any v TypeScriptu', 'Každý commit musí projít lint'. Informace jsou fakta: 'API běží na portu 3001', 'Env proměnné jsou v .env.local'. Direktivy pište imperativně a jasně — model je bere jako instrukce.
Reference a sdílení
CLAUDE.md podporuje @file reference pro načtení dalších souborů — místo kopírování celé dokumentace napište '@docs/architecture.md'. Projektový CLAUDE.md commitujte do gitu jako týmový dokument. Osobní preference dejte do globálního CLAUDE.md. Pro jiné nástroje existují ekvivalenty: .cursorrules (Cursor), .github/copilot-instructions.md (Copilot), .windsurfrules (Windsurf).
Přidejte do CLAUDE.md sekci 'What NOT to do' — explicitní zákazy jsou silnější než obecné instrukce. 'Nikdy nepoužívej any' je efektivnější než 'používej explicitní typy'.
Vyberte svůj aktuální projekt a vytvořte CLAUDE.md s těmito sekcemi: 1. Quick Start (3-5 příkazů pro běh projektu) 2. Stack (technologie + verze) 3. Conventions (5-10 pravidel, která model nemůže odvodit z kódu) 4. Architecture (1-2 odstavce o klíčových rozhodnutích) Pak si otevřete novou konverzaci a zadejte jednoduchý prompt. Porovnejte výstup s a bez CLAUDE.md.
Nápověda
Dobrý test: zadejte 'přidej novou API route' a srovnejte výstup. S CLAUDE.md by model měl použít správný framework, správné konvence pojmenování a správný pattern pro error handling.
Vyberte open-source projekt, ke kterému přispíváte (nebo chcete). Naklonujte repo a vytvořte CLAUDE.md, který by pomohl AI asistentovi porozumět projektu. Zahrňte: účel projektu, jak spustit testy, coding style, PR konvence, klíčové abstrakce. Otestujte: požádejte AI o implementaci malé feature s vaším CLAUDE.md jako kontextem.
Nápověda
Zdokumentujte svůj postup a výsledky — poslouží jako reference pro budoucí podobné úkoly.
Vytvořte dvě verze CLAUDE.md pro váš projekt — minimální (stack + 3 konvence) a detailní (stack + 10 konvencí + architektura + anti-patterny). Zadejte stejný úkol s oběma verzemi 5x. Porovnejte: 1) Kolikrát byl výstup okamžitě použitelný? 2) Kolik manuálních oprav bylo potřeba? 3) Která verze produkuje konzistentnější výstup? Na základě dat zvolte optimální verzi.
Nápověda
Detailní CLAUDE.md obvykle vyhrává u složitých úkolů (multi-file, architektura), minimální u jednoduchých (utility funkce, formátování).
- CLAUDE.md se načítá automaticky do každé konverzace — nejsilnější kontextový nástroj
- Hierarchie: globální > projektový > lokální, specifickější má přednost
- Pište jen to, co model nemůže odvodit z kódu
- Direktivy (pokyny) a informace (fakta) jsou dva různé typy obsahu
- Commitujte projektový CLAUDE.md do gitu — je to týmový dokument
V příští lekci se ponoříme do Šablony pro generování kódu — technika, která vám dá jasnou převahu. Odemkněte celý kurz a pokračujte hned.
2/7 hotovo — pokračujte!