Mini-projekt: osobní AI tutor (CLAUDE.md + skill + Memory MCP)

⏱ Odhadovaný čas 90 min

📍 Pozice Den 4, blok 6 / 7

🎯 Po tomto bloku budeš umět

• Instaloval(a) jsi Memory MCP a víš, proč je „třetí vrstvou" persistence
• Máš projekt, kde CLAUDE.md + skill + Memory MCP pracují spolu
• V konverzaci si CC pamatuje, co jsi řekl/a minule (nejen během session)

⚠️ Tohle je nejnáročnější blok Dne 4

Neber to jako „dokonalá aplikace”. Cíl: spojit 3 vrstvy personalizace (CLAUDE.md + skill + Memory MCP) a vidět, že fungují dohromady. Pokud se v půlce ztratíš, napiš Miroslavovi — nezasekni se sám/sama 30 min.

---

🧠 Tři vrstvy persistence — než nainstalujeme Memory MCP, musíš rozumět PROČ

Dosud jsi poznal/a 2 vrstvy, jak si CC pamatuje kontext napříč konverzacemi:

#	Vrstva	Typ	Kdo to píše	Co sem patří
1	Global CLAUDE.md (~/.claude/CLAUDE.md)	📌 Statická	Ty, ručně	Trvalá identita, preference — „jsem B1, mluv česky, polopaticky”
2	Project CLAUDE.md (./CLAUDE.md v projektu)	📌 Statická	Ty, ručně	Kontext jednoho projektu — „pravidla pro tenhle projekt, tech stack, omezení”
3	Memory MCP (dynamický storage)	🔄 Dynamická	CC sám, automaticky	Fakta z konverzací — „jméno mého kocoura”, „minule jsem neuměl past perfect”, evolving znalosti

🎯 Pravidlo, kdy co použít

• CLAUDE.md = „Kdo jsem, co preferuji” (měníš jen občas, ručně)
• Memory MCP = „Co si Claude pamatuje z našeho povídání” (roste samo, bez tvé práce)

💡 Konkrétní příklad rozdílu

• V Global CLAUDE.md: „Jsem B1 angličtinářka, mluv česky.” (píšu jednou, platí vždy)
• V Memory MCP si CC časem uloží: „Jana si minule pletla past simple a past perfect. Příště jí to připomeň, pokud narazíme na past tenses.” (CC si to ukládá samo)

Obě dohromady = CC ví kdo jsi + co jsme spolu probrali.

---

🧪 Fáze 1 (0–30 min): Instalace Memory MCP + test

⚠️ 3 warningy než začneš

Memory MCP install má 3 traps, které zamíchá 90 % lidí. Přečti si PŘED instalací.

⚠️ Warning 1 — NPX first-run delay (30–90 s)

Při prvním spuštění npx -y @modelcontextprotocol/server-memory se balíček stahuje. V terminálu to vypadá, jako by to viselo — žádný output, žádná progress bar. Je to normální.

Co dělat: Počkej minimálně 90 s. Neukončuj Ctrl+C, ani zavírej terminál. Až po první instalaci je to rychlé.

⚠️ Warning 2 — Restart CC po přidání MCP

Po claude mcp add MUSÍŠ Claude Code restartovat, jinak nový MCP server neuvidí.

Postup: /exit → claude znovu. Pak zkontroluj, že memory funguje (viz níže).

⚠️ Warning 3 — Permission / path error → fallback

Pokud při prvním běhu dostaneš permission error (typicky Windows), přidej explicitní cestu ke storage přes environment variable MEMORY_FILE_PATH.

Pokud tvé user jméno NEMÁ mezeru ani diakritiku (např. Petr):

claude mcp add memory -s user -e MEMORY_FILE_PATH=C:\Users\%USERNAME%\.claude\memory.json -- npx -y @modelcontextprotocol/server-memory

Pokud MÁ mezeru nebo diakritiku (např. Jana Nováková) — obal hodnotu do uvozovek a použij přesnou cestu z $env:USERPROFILE:

claude mcp add memory -s user -e "MEMORY_FILE_PATH=C:\Users\Jana Nováková\.claude\memory.json" -- npx -y @modelcontextprotocol/server-memory

Nejdřív si přesnou cestu zjisti: echo $env:USERPROFILE. Vlož ji za C:\Users\... + \.claude\memory.json, celý MEMORY_FILE_PATH=... do uvozovek.

Instalační krok

1. V VSCode otevři PowerShell terminál (Ctrl+). **Pozor:** tohle **NENÍ** interaktivní chat v claude— pokud užclaudemáš spuštěný, nejdřív/exit. Jsi v běžném PowerShellu (prompt začíná PS C:…>`).

2. Sanity check — Node + npm funguje?

   node --version
   npm --version

   Oboje musí vypsat verzi (např. v20.11.0 / 10.2.4). Pokud jedno z nich říká „command not recognized”, Node není nainstalován — zastav se, Memory MCP bez Node nespustíš. Zavolej lektora nebo nainstaluj Node LTS.

3. Spusť:

   claude mcp add memory -s user -- npx -y @modelcontextprotocol/server-memory

   Flag -s user = globální scope (Memory funguje napříč všemi projekty — což chceš).

4. Počkej (30–90 s — stahuje balíček).

5. Výstup by měl skončit něčím jako:

   ✓ Added MCP server "memory"

   Pokud chyba → jdi na Warning 3 (fallback s -e MEMORY_FILE_PATH=...).

6. Spusť claude ve složce ai-skoleni-den3 (nebo kdekoli).

7. Zkontroluj, že CC vidí Memory:

   /mcp

   Měl by vypsat memory ve seznamu. ✅

Rychlý test — že Memory opravdu funguje

V právě spuštěném CC pošli zprávu s explicitní žádostí o použití Memory tool (bez ní CC často memorize nezavolá a fakt se neuloží):

Použij nástroj memorize z Memory MCP a ulož tento fakt:
Můj oblíbený předmět je [doplň — dějepis / cestování / cokoliv].

Sleduj odpověď CC. Musíš v UI vidět tool call indikátor — typicky řádek jako:

⏺ memorize(entity: „Oblíbený předmět", ...)

nebo textově „Called memorize tool”. Pokud vidíš jen volný text „dobře, zapamatuji si” bez tool callu, fakt se NEUložil — Memory MCP je instalovaný, ale CC ho nevyužil. V tom případě napiš explicitněji: „Musíš volat tool memorize, ne jen říct ok.”

Potom:

/exit

Spusť claude znovu (claude). A zeptej se:

Co je můj oblíbený předmět? (Najdi v Memory MCP.)

Pokud CC odpoví správně (dějepis / cestování) — 🎉 Memory MCP funguje! Pamatoval si to přes restart.

Pokud NE → zkontroluj /mcp že memory je tam, a že jsi CC opravdu restartoval/a (/exit + claude). Pokud pořád ne, vrať se na test výše a ověř, že v odpovědi byl tool call, ne jen text.

🧪 Checkpoint 30 min

Máš Memory MCP nainstalovaný, otestovaný, CC si pamatuje jednu věc z předchozí session.

---

🚀 Fáze 2 (30–60 min): Postav mini-projekt — 3 vrstvy spolu

Teď vytvoříš nový projekt, kde všechny 3 vrstvy (Global CLAUDE.md, Project CLAUDE.md, skill, Memory MCP) pracují dohromady.

Student A — Studijní asistent pro maturitu

Co stavíš

Osobního tutora pro přípravu na maturitu. Ví, kdo jsi (Global CLAUDE.md), zná tenhle projekt (Project CLAUDE.md), umí test skill (/otestuj-me), pamatuje si, co jsme probrali (Memory MCP).

Fáze 2 kroky

1. Nová složka: VSCode → File → Open Folder → Desktop → New Folder → maturita-tutor → Open.

2. Vytvoř Project CLAUDE.md — pravý klik v Exploreru → New File → CLAUDE.md. Vlož:

   # Projekt: Maturitní tutor
   
   ## Co je tenhle projekt
   Dlouhodobá konverzace s Claude jako studijní tutor na maturitu.
   Témata: [doplň předměty, např. Dějepis, Matematika, ČJ literatura, AJ].
   
   ## Pravidla tohoto projektu
   - Všechny otázky a odpovědi **ukládej** do `zaznamy.md` na konci každé session.
   - Když zkouším novou látku, použij skill `/otestuj-me`.
   - Pokud mi něco jde dobře 3×, přestaň to zkoušet a řekni mi, co procvičit místo toho.
   
   ## Co nikdy / vždy
   - **NIKDY** neprozraď odpověď na test otázku, dokud se nezkusím.
   - **VŽDY** si pamatuj, s čím jsem měl/a problém (aby to Memory uložila).

3. Ulož Ctrl+S.

4. Důležité — otevři terminál PŘÍMO v téhle nové složce + ověř cestu. V VSCode je integrovaný terminál automaticky ve složce, kterou máš otevřenou (maturita-tutor). Ctrl+` → jsi v PowerShellu. Povinný sanity check — napiš:

   pwd

   Výpis MUSÍ končit na \Desktop\maturita-tutor. Pokud končí na ai-skoleni-den3 nebo jiné složce, NEPOKRAČUJ — vrať se na krok 1 a otevři správnou složku přes File → Open Folder. Teprve až pwd vrátí správnou cestu, spusť claude.

5. Úvodní prompt (zkopíruj a pošli):

   Použij nástroj memorize z Memory MCP a ulož tato fakta:
   - Jsem na začátku přípravy na maturitu.
   - Moje silné předměty jsou: [doplň].
   - Slabé/obávané: [doplň].
   - Maturuji [měsíc/rok].
   
   Každý fakt ulož zvlášť. Budeš se k tomu vracet v budoucích session.

   V odpovědi hledej tool call (řádky jako ⏺ memorize(...)) — to je signál, že se fakt skutečně uložil. Pokud tool call nevidíš, napiš: „Volej přímo tool memorize, ne jen text.”

6. Spusť skill:

   /otestuj-me

   CC by měl říct „Z jakého tématu?” — vyber si jedno ze slabých předmětů.

🧪 Checkpoint 60 min

Máš funkční novou složku maturita-tutor s Project CLAUDE.md, CC si uložil tvoje předměty a silné/slabé stránky, a proběhl jeden /otestuj-me test.

Student B — Anglický tutor

Co stavíš

Osobního AJ tutora. Ví, že jsi B1 (Global CLAUDE.md), zná tenhle projekt (Project CLAUDE.md), umí vysvětlit gramatiku (/vysvetli-gramatiku), pamatuje si, co jsme probrali (Memory MCP).

Fáze 2 kroky

1. Nová složka: VSCode → File → Open Folder → Desktop → New Folder → anglicky-tutor → Open.

2. Vytvoř Project CLAUDE.md — pravý klik v Exploreru → New File → CLAUDE.md. Vlož:

   # Projekt: Anglický tutor
   
   ## Co je tenhle projekt
   Dlouhodobá konverzace s Claude jako moje anglická tutorka.
   Navštěvuji kurz AJ, úroveň B1. Chci doplňovat to, co v kurzu neprobereme.
   
   ## Pravidla tohoto projektu
   - Všechny probrané gramatiky a slovíčka ukládej do `zaznamy.md` na konci session.
   - Když se ptám na gramatiku, použij skill `/vysvetli-gramatiku`.
   - Pokud mi nějaký jev nejde 2× po sobě, **přidej do Memory** že „na tomhle se mnou budeš příště víc cvičit".
   
   ## Co nikdy / vždy
   - **NIKDY** IPA fonetiku.
   - **VŽDY** český překlad příkladů.
   - **VŽDY** povzbuzuj, ale nepřeháněj.

3. Ulož Ctrl+S.

4. Důležité — otevři terminál PŘÍMO v téhle nové složce + ověř cestu. V VSCode je integrovaný terminál automaticky ve složce, kterou máš otevřenou (anglicky-tutor). Ctrl+` → jsi v PowerShellu. Povinný sanity check — napiš:

   pwd

   Výpis MUSÍ končit na \Desktop\anglicky-tutor. Pokud končí na ai-skoleni-den3 nebo jiné složce, NEPOKRAČUJ — vrať se na krok 1 a otevři správnou složku přes File → Open Folder. Teprve až pwd vrátí správnou cestu, spusť claude.

5. Úvodní prompt (zkopíruj a pošli):

   Použij nástroj memorize z Memory MCP a ulož tato fakta:
   - Jsem na kurzu AJ, úroveň B1.
   - Co mi jde: [doplň — např. Present Simple, slovíčka, read comprehension].
   - Co mi nejde: [doplň — např. Present Perfect, předložky, poslech].
   - V kurzu teď probíráme: [doplň / "nevím" / vynech].
   
   Každý fakt ulož zvlášť. Budeš se k tomu vracet v budoucích session.

   V odpovědi hledej tool call (řádky jako ⏺ memorize(...)) — to je signál, že se fakt skutečně uložil. Pokud tool call nevidíš, napiš: „Volej přímo tool memorize, ne jen text.”

6. Spusť skill:

   /vysvetli-gramatiku

   CC by měl říct „Kterou gramatiku?” — vyber jednu ze svých slabých.

🧪 Checkpoint 60 min

Máš funkční novou složku anglicky-tutor s Project CLAUDE.md, CC si uložil tvou úroveň a slabá místa, a proběhlo jedno /vysvetli-gramatiku.

---

🔁 Fáze 3 (60–90 min): Test paměti + reflexe

Teď ověříš, že 3 vrstvy opravdu spolupracují — Memory si pamatuje napříč sessiony.

Test 1: Restart session, test paměti (10 min)

1. V CC napiš /exit.

2. Spusť claude znovu (stále v projektové složce).

3. Napiš:

   Student A

   Co si o mně pamatuješ? (Předměty, kdy maturuji, silné/slabé stránky?)

   Student B

   Co si o mně pamatuješ? (Úroveň, co mi jde, co ne?)

4. Sleduj — CC by měl vytáhnout Memory MCP záznamy z předchozí session.

Pokud si CC pamatuje všechno ✅ → 3 vrstvy fungují dohromady. Pokud ne:

• Je Memory MCP aktivní? (/mcp ukáže memory?)
• Uložil CC v Fázi 2 opravdu do Memory? (Pamatuj: v Fázi 2 jsi mohl/a říct „Ulož si to.” — CC to někdy udělá až na výzvu.)

Test 2: Druhá iterace (10 min)

Student A

1. Znovu /otestuj-me s jiným tématem než v Fázi 2.
2. Po 2-3 otázkách odpověz na jednu schválně špatně.
3. Pozoruj: vysvětlí CC chybu podle skillu (pedagogicky, ne „je to X”)?
4. Ukonči test.
5. Další session (/exit + claude) zeptej se: „Na čem jsme naposledy pracovali a kde jsem udělal/a chybu?”
6. CC by měl odpovědět s využitím Memory — konkrétně si ty chyby pamatuje.

Student B

1. Znovu /vysvetli-gramatiku s jinou gramatikou než v Fázi 2.
2. Na procvičovací větu odpověz schválně špatně.
3. Pozoruj: vysvětlí CC chybu podle skillu (česky, polopaticky, bez IPA)?
4. Ukonči test.
5. Další session (/exit + claude) zeptej se: „Kterou gramatiku jsme probírali minule a co mi dělalo problém?”
6. CC by měl odpovědět s využitím Memory.

Test 3: Napiš reflexi do zaznamy.md (10 min)

V projektové složce (maturita-tutor / anglicky-tutor) vytvoř zaznamy.md:

# Mini-projekt reflexe (Den 4, Blok 04)

## Co fungovalo
- [např. Memory si pamatoval mé preference přes restart]
- [např. Skill se choval podle mých instrukcí]

## Co nefungovalo
- [např. Memory občas zapomněl detail, musel jsem mu to říct 2×]

## Co bych na svém setupu zlepšil/a
- [např. doplnit do Project CLAUDE.md konkrétnější téma]
- [např. upravit skill, aby byl ještě stručnější]

## Budu to reálně používat?
- Ano / Ne / Možná
- Proč: ...

🧪 Checkpoint 90 min

• Memory MCP funguje napříč sessiony (test 1 ✅)
• Skill se chová podle instrukcí (test 2 ✅)
• Máš zaznamy.md s reflexí (test 3 ✅)

---

🛟 Nouzový plán (pokud se zasekáváš)

Problém: Memory MCP install selhal

• Zkus Warning 3 fallback (s -e MEMORY_FILE_PATH=... env var).
• Pokud stále ne: přeskoč Memory a dokonči Fáze 2+3 bez něj. Setup se dotáhne v check-inu zítra.

Problém: Skill se nespouští přes /název ani přes přirozenou zmínku

• /exit + claude (restart CC).
• Zkontroluj ~/.claude/skills/<název>/SKILL.md — existuje? Frontmatter má name: a description:?
• Zkontroluj, že uvozovky v description jsou rovné ", ne typografické „" nebo "" (kopírování z webu je občas zamění — v VSCode je ručně přepiš).

Problém: Po 75 min jsi stále ve Fázi 1

• Skoč rovnou do Fáze 2 a použij jen CLAUDE.md + skill, bez Memory.
• Memory MCP dokončíš v check-inu zítra — není to důvod nedokončit projekt.

Alternativní Fáze 3 bez Memory MCP

Pokud Memory nefunguje, Fázi 3 udělej takto (stále zabere 30 min):

1. Test 1 — skill na jiné téma (10 min): Zavolej skill znovu s úplně jiným zadáním než ve Fázi 2. Ověř, že instrukce ze SKILL.md drží.
2. Test 2 — schválně špatná odpověď (10 min): Odpověz CC záměrně špatně. Ověř, že CC vysvětlí chybu pedagogicky (podle pravidel skillu), ne jen „je to X”.
3. Test 3 — napiš zaznamy.md (viz níže) s reflexí, co funguje a co ne. Do Co nefungovalo napiš: „Memory MCP install — doladím zítra s lektorem.”

---

💡 Meta-lekce

1. 3 vrstvy persistence fungují dohromady — nemusíš si vybírat, doplňují se.
2. Memory MCP se učí sám, ale občas mu musíš říct explicitně, aby uložil.
3. Skill + CLAUDE.md + Memory = osobní AI tutor, kterého si nosíš s sebou.
4. Iterace je OK — první verze nejsou perfektní, upravuj je.

---

🎯 Co máš teď mít

• Memory MCP nainstalovaný (/mcp ho ukazuje)
• Projekt (maturita-tutor nebo anglicky-tutor) s Project CLAUDE.md
• CC si pamatuje tvoje preference napříč /exit + claude (test 1 ✅)
• Skill (/otestuj-me nebo /vysvetli-gramatiku) voláš funkčně (test 2 ✅)
• zaznamy.md s reflexí

---

✅ Mini-projekt hotový — 3 vrstvy persistence fungují spolu

Pokračovat na blok 06: Kvíz + reflexe →