CLAUDE.md — 2 úrovně instrukcí + few-shot

⏱ Odhadovaný čas 60 min

📍 Pozice Den 4, blok 2 / 7

🎯 Po tomto bloku budeš umět

• Rozumíš 2 úrovním CLAUDE.md: globální (pro všechno) a project (pro konkrétní složku)
• Máš vytvořený globální CLAUDE.md s personal briefem (4 sekce)
• Umíš přidat few-shot příklady do CLAUDE.md (trvalý formát)

🧠 Co je CLAUDE.md

CLAUDE.md je trvalá instrukce, kterou Claude Code automaticky přečte před každou konverzací.

Pamatuj si z Dne 1 Bloku 04 „5 komponent promptu”: ROLE + KONTEXT + VSTUP + VÝSTUP + OMEZENÍ. CLAUDE.md jsou tyto instrukce napsané jednou — aby se opakovaly pokaždé, bez toho abys je psal/a.

🗂 Dvě úrovně: Global vs Project

Úroveň	Cesta	Platí pro	Typický obsah
Global	~/.claude/CLAUDE.md	Všechny projekty, napříč celým tvým systémem	Kdo jsem, jak se mnou mluvit, preferovaný jazyk, tón
Project	./CLAUDE.md (v projektové složce)	Jen tenhle projekt	Tenhle projekt je X, používej Y, pravidla Z

CC přečte obě úrovně — nejprve global (obecné preference), pak project (specifika). Project override pokud si odporují.

💡 Analogie

• Global CLAUDE.md = tvůj „OSOBNÍ profil” — platí, ať jsi kdekoli
• Project CLAUDE.md = „kontext konkrétní práce” — to, co tě odlišuje TEĎ

Příklad: Global říká „jsem Jana, B1 angličtina”. Project pro kvíz-hra říká „vytvářím HTML+JS kvízové hry”. CC ví obojí.

🧪 Experiment 1: Vytvoř globální CLAUDE.md (20 min)

Kde složka ~/.claude/ je

Na Windows: C:\Users\tvojeJméno\.claude\ — skrytá složka (začíná tečkou). Default ji Průzkumník nevidí.

1. Otevři VSCode — File → Open Folder.

2. V dialogu address bar (nahoře) napiš ručně (nepoužívej levé menu):

   C:\Users\%USERNAME%\.claude

   Stiskni Enter.

   ⚠️ Pokud VSCode ukáže path not found (nebo máš v jméně mezeru/diakritiku)

   Některé verze VSCode nerozpoznají proměnnou %USERNAME% v dialog address baru. Windows navíc u účtů s diakritikou nebo mezerou (např. „Jana Nováková”) složku někdy zkrátí na něco jiného než vidíš v Průzkumníku.

   Nejbezpečnější způsob — otevři PowerShell (Win+R → powershell) a spusť:

   echo $env:USERPROFILE

   Výpis je přesná cesta ke tvé user složce (např. C:\Users\Jana nebo C:\Users\JanaN). Zkopíruj ji a přidej \.claude — tedy např. C:\Users\Jana\.claude. Tuhle cestu použij všude, kde kurz píše C:\Users\%USERNAME%.

3. VSCode se zeptá „Složka neexistuje, vytvořit?” (pokud není) → Ano → Open.

4. V Exploreru je teď prázdná .claude složka. (Pokud už existuje z CC configu, budou tam soubory jako settings.json, .credentials.json — neřeš je.)

5. Vytvoř nový soubor: pravý klik → New File → CLAUDE.md.

6. Teď si napíšeš personal brief.

📝 Personal brief — 4 sekce

⚠️ PRIVACY — co do CLAUDE.md NEPATŘÍ

Cokoli v CLAUDE.md se posílá s každou zprávou Claude AI (Anthropic).

NEPIŠ do toho:

• ❌ Plná jména rodiny (stačí křestní)
• ❌ Telefony, adresy bydliště
• ❌ Rodná čísla, hesla, bankovní údaje
• ❌ Pracovní tajemství, NDA-protected věci

PIŠ (bez obav):

• ✅ Pracovní role obecně („učitelka ZŠ”, „student gymnázia”)
• ✅ Koníčky, preferenční styly komunikace
• ✅ Jazyková úroveň, preference jazyka
• ✅ Styl, jakým chceš aby s tebou CC mluvil

Template — zkopíruj do ~/.claude/CLAUDE.md

Student A (středoškolák)

# Můj CLAUDE.md — globální preference

## Kdo jsi
Jsi můj osobní AI asistent. Trpělivý, konkrétní, s citem pro mladšího člověka.
Nejsi můj učitel — jsi můj parťák na studium.

## Kdo jsem já
Student gymnázia (X. ročník). Připravuji se na maturitu [doplň hlavní předměty].
Baví mě [doplň koníčky — hry, sport, hudba, co chceš].
Mluvím česky, angličtinu B1.

## Jak odpovídat
- Max 250 slov, pokud neřeknu jinak
- Struktura: příklad → pravidlo (přes konkrétno k obecnému)
- Pokud je něco složité, dej to do 3 kroků
- U matematiky a dějepisu: **vždy** ukaž postup, ne jen výsledek

## Co nikdy / vždy
- **NIKDY** nepiš odpověď na úkol za mě — dej mi nápovědu.
- **NIKDY** nevymýšlej historická data. Pokud nevíš, řekni to.
- **VŽDY** se zeptej, když zadání není jasné.
- **VŽDY** mi dej 1 věc k procvičení na konci vysvětlení.

Student B (angličtinářka)

# Můj CLAUDE.md — globální preference

## Kdo jsi
Jsi můj osobní anglický tutor. Přátelský, trpělivý, s citem pro češtinu.
Mluvíš se mnou jako kamarádka, ne jako učitelka ze školy.

## Kdo jsem já
Studentka kurzu angličtiny, úroveň [B1 / doplň].
Mateřská čeština. Nejlépe se učím přes **konkrétní příklady**, pak teprve pravidlo.
Baví mě [doplň — vaření, rodina, cestování…].

## Jak odpovídat
- Max 200 slov, pokud neřeknu jinak
- Gramatiku vysvětluj **polopaticky** — jako bych to slyšela poprvé
- **Vždy** 3 příklady (EN + CZ pod) PŘED pravidlem
- Na konci 1 věta k procvičení, já doplním
- Bez IPA fonetiky (mate mě)

## Co nikdy / vždy
- **NIKDY** bez českého překladu
- **NIKDY** si nevymýšlej idiomy — pokud nevíš, řekni to
- **VŽDY** rozliš British vs American English, když má význam
- **VŽDY** mě povzbuď, ale nepřekombinuj

Ulož Ctrl+S.

---

🧪 Experiment 2: Otestuj globální CLAUDE.md (10 min)

Ověříme, že CC skutečně tyto instrukce čte.

1. Otevři VSCode se včerejší složkou ai-skoleni-den3 (File → Open Folder → Desktop\ai-skoleni-den3).

2. Otevři integrovaný terminál (Ctrl+`), spusť:

   claude

3. Napiš (pro studenta B):

   Vysvětli mi present continuous.

4. Sleduj odpověď:

   • Začíná příklady (EN + CZ)? ✅
   • Až pak vysvětluje pravidlo? ✅
   • Je česky, ne anglicky? ✅
   • Max 200 slov? ✅
   • Žádná IPA (/ˈpɹezənt/)? ✅

5. Pokud ANO všechno → CLAUDE.md funguje. 🎉

6. Pokud ne → zkontroluj:

   • Uložil/a jsi Ctrl+S?
   • Je soubor na správném místě (C:\Users\%USERNAME%\.claude\CLAUDE.md)?
   • Ukončil/a jsi a znovu spustil/a CC? (někdy restart pomůže)

---

🧪 Experiment 3: Project CLAUDE.md (10 min)

Ve složce ai-skoleni-den3 už máš CLAUDE.md ze Dne 3 („Odpovídej česky, piš stručně”). Rozšíříme ji pro kontext tohoto projektu.

1. V VSCode otevři ai-skoleni-den3/CLAUDE.md (klikni v Exploreru).

2. Přepiš nebo přidej:

   # Projekt: AI školení Den 3 + Den 4
   
   ## Kontext projektu
   Složka obsahuje poznámky, CLAUDE.md, reflexe a mini-projekty
   z Dne 3 (první CC konverzace) a Dne 4 (skills + MCP) AI školení.
   
   ## Pravidla pro tenhle projekt
   - Všechny soubory jsou v češtině.
   - Pokud vytváříš Markdown, použij `##` pro sekce (ne `#` — to je jen nadpis souboru).
   - Testovací soubory pojmenuj `den[N]-[popis].[ext]` (např. `den4-test.md`).
   
   ## Co vždy / nikdy (pro tenhle projekt)
   - **NIKDY** needituj `poznamky.md` bez toho, abys se zeptal.
   - **VŽDY** když vytvoříš nový soubor, zeptej se na umístění.

3. Ulož Ctrl+S.

4. Spusť nový chat (/new), zkus:

   Vytvoř mi test soubor.

   CC by se měl zeptat na jméno a dodržet pattern den4-*.md (protože projekt CLAUDE.md to říká).

---

🎨 Experiment 4: Few-shot v CLAUDE.md (20 min)

Vzpomeň si na Den 2 Blok 01: ukaž model příklad, místo abys popisoval formát. Tohle funguje i v CLAUDE.md.

Přidej do svého globálního CLAUDE.md:

Student A

## Formát mých odpovědí — ukázka

Když se tě zeptám „vysvětli mi [něco ze školy]", odpověz takhle:

PŘÍKLAD:
Otázka: Vysvětli mi derivaci funkce.

Odpověď:
1. **Představ si** auto. Jedeš 60 km/h. Derivace = „jak rychle se
   rychlost **mění**" = zrychlení.

2. **Pravidlo:**
   `f(x) = x²` → `f'(x) = 2x`

3. **Otázka pro tebe:** Kolik je derivace `f(x) = x³`?
   (Zkus. Odpověď ti řeknu, až mi pošleš tvůj pokus.)

---

Takto vždy: intuitivní analogie → pravidlo → otázka.

Student B

## Formát mých odpovědí — ukázka

Když se tě zeptám „vysvětli mi [gramatika]", odpověz takhle:

PŘÍKLAD:
Otázka: Vysvětli mi present perfect.

Odpověď:
**Příklady:**
1. I have lived in Prague for 5 years. (Žiju v Praze už 5 let.)
2. She has just finished her homework. (Právě dodělala úkol.)
3. Have you ever been to Paris? (Byl jsi někdy v Paříži?)

**Pravidlo:** Present perfect = **have/has + past participle**.
Používá se když:
- Něco začalo v minulosti a trvá dodnes (příklad 1)
- Právě se něco stalo (příklad 2)
- Zkušenost „někdy v životě" (příklad 3)

**Procvič:** Jak řekneš *„Už jsem ten film viděla dvakrát"*?
(Zkus, opravím ti to.)

---

Takto vždy: 3 příklady (EN+CZ) → pravidlo → procvič.

Ulož. Spusť nový chat. Otestuj:

Vysvětli mi [past perfect / jiný gramatický jev / derivaci / jiný koncept].

CC teď dodrží tvůj formát bez toho, abys ho musel/a pokaždé popisovat. 🎉

---

💡 Co sis dnes osvojil/a

1. 2 úrovně CLAUDE.md — global (osobní) + project (kontext)
2. Automatické čtení — CC si CLAUDE.md pamatuje napříč sessiony, nemusíš ho posílat
3. Privacy — CLAUDE.md se posílá Anthropicu; piš jen veřejně-sdělitelné věci
4. Few-shot v CLAUDE.md — příklad formátu > popis formátu, stejně jako v Dne 2

---

✅ Global CLAUDE.md hotový, otestovaný, rozumím 2 úrovním

Pokračovat na blok 02: Video →