📖 Den 4 — Reference: CLAUDE.md + Skills + MCP

Reference — Den 4 (CLAUDE.md + Skills + MCP)

🗂 3 vrstvy persistence — tabulka

#	Vrstva	Cesta	Typ	Kdo to píše	Co sem patří
1	Global CLAUDE.md	~/.claude/CLAUDE.md	📌 Statická	Ty, ručně	Trvalá identita, preference (B1, jazyk, styl)
2	Project CLAUDE.md	./CLAUDE.md v projektu	📌 Statická	Ty, ručně	Kontext jednoho projektu (tech stack, pravidla)
3	Memory MCP	Storage v interním úložišti MCP serveru (typicky ~/.claude/memory.json při fallbacku s MEMORY_FILE_PATH)	🔄 Dynamická	CC sám, automaticky	Fakta z konverzací (evolving znalosti)

Pravidlo: CLAUDE.md = „kdo jsem / co preferuji”. Memory MCP = „co si pamatuje z našeho povídání”.

---

📝 Global CLAUDE.md — template (4 sekce)

Cesta: C:\Users\%USERNAME%\.claude\CLAUDE.md (Win) / ~/.claude/CLAUDE.md (Mac/Linux)

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

## Kdo jsi
(Role CC ve vztahu ke mně — tutor / parťák / asistent. Tón: přátelský / věcný.)

## Kdo jsem já
(Role, úroveň, co dělám. Jazyk. Oblasti zájmu.)

## Jak odpovídat
- Max X slov (pokud neřeknu jinak)
- Struktura: (příklad → pravidlo) / (shrnutí → detail)
- Co má vždy být součástí odpovědi

## Co nikdy / vždy
- **NIKDY** ...
- **VŽDY** ...

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

• ❌ Plná jména rodiny, telefony, adresy
• ❌ Rodná čísla, hesla, bankovní údaje
• ❌ Pracovní NDA-protected věci

✅ PIŠ bez obav

• ✅ Pracovní role obecně („učitelka ZŠ”)
• ✅ Koníčky, styl komunikace
• ✅ Jazyková úroveň, preferovaný jazyk

---

📝 Project CLAUDE.md — template

Cesta: ./CLAUDE.md v kořeni projektové složky.

# Projekt: [Název]

## Co je tenhle projekt
(1-2 věty popis.)

## Pravidla tohoto projektu
- Jazyk: [čeština / angličtina / oba]
- Naming konvence: [snake_case / kebab-case]
- Kam ukládat artefakty: [cesta]

## Co nikdy / vždy (pro tenhle projekt)
- **NIKDY** needituj [soubor] bez toho, abys se zeptal.
- **VŽDY** po dokončení aktualizuj [soubor].

---

🔧 Skill — template (custom workflow)

Cesta: C:\Users\%USERNAME%\.claude\skills\<název>\SKILL.md

---
name: <název>
description: Kdy mě zavolat (klíčová slova). Čím konkrétnější, tím lépe.
---

# Instrukce pro Claude

(Přesné chování, které se má stát, když se skill spustí.)

## Postup
1. ...
2. ...

## Pravidla
- **NIKDY** ...
- **VŽDY** ...

Invokace: zkus nejdřív /<název> v Claude Code. Pokud CC neví, napiš přirozenou větou s jménem skillu („použij skill vysvetli-gramatiku, vysvětli mi present perfect”) — CC matchuje přes description.

---

🌐 Memory MCP — install + test

Install (doporučená varianta)

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

• -s user = global scope (funguje ve všech projektech)
• První run trvá 30-90 s (stahuje balíček) — trpělivost

Install s fallback (pokud permission error)

Nastav env var MEMORY_FILE_PATH přes -e flag.

Bez mezery/diakritiky v user jméně:

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

S mezerou/diakritikou (např. Jana Nováková) — celou hodnotu v uvozovkách, použij přesnou cestu z echo $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

Ověření

/mcp

v Claude Code — ukáže seznam aktivních MCP serverů. memory tam musí být.

Project scope varianta (jen pro konkrétní projekt)

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

Test funkčnosti

1. V CC: „Zapamatuj si: můj oblíbený jazyk je čeština.”
2. /exit
3. claude (restart)
4. V novém CC: „Co je můj oblíbený jazyk?”
5. Pokud odpoví správně → ✅ Memory MCP funguje

---

⚡ Built-in slash commands (Blok 03)

Příkaz	Co dělá	Kdy použít
/help	Seznam všech příkazů	Když si nevzpomínáš
/model	Ukáže / přepne aktuální model	Sonnet vs Opus vs Haiku
/cost	Kolik jsi zaplatil v session	Sledování spotřeby
/clear	Vyčistí historii session (zachová CLAUDE.md)	Zamotaná konverzace
/new	Nová session (jako restart)	Chci úplně čistý start
/mcp	Seznam aktivních MCP serverů	Ověření že Memory funguje
/exit	Ukončí CC	Standardní ukončení

⛔ Proč NEPOUŽÍVÁME /init

Generuje CLAUDE.md zaměřený na dev projekty (tech stack, dependencies, tests). Pro non-dev use case (osobní tutor) je to balast. Píšeme CLAUDE.md ručně.

---

🛠 Troubleshooting

Symptom	Pravděpodobná příčina	Řešení
Skill se nespouští na /název	CC neviděl změnu v ~/.claude/skills/	/exit + claude
/mcp neukazuje memory	CC spuštěný PŘED claude mcp add	/exit + claude
MCP install visí 60+ s	NPX stahuje balíček poprvé	Počkej, neukončuj Ctrl+C
MCP permission error (Win)	Default storage cesta není zapisovatelná	Fallback s env var: -e MEMORY_FILE_PATH=C:\Users\%USERNAME%\.claude\memory.json při mcp add
Global CLAUDE.md se neuplatňuje	Soubor uložený se špatným jménem / cestou	Zkontroluj ~/.claude/CLAUDE.md — přesně tak, velkými písmeny
Frontmatter v skillu ignorován	Chybí --- na začátku nebo konci	Musí být PŘESNĚ ---\nname: ...\ndescription: ...\n---
CC si nic nepamatuje přes restart	Memory MCP není načtený	/mcp pro ověření, pak restart CC

---

📚 Externí zdroje

Zdroj	URL	Co tam je
Claude Code Docs	docs.anthropic.com/en/docs/claude-code	Oficiální reference
MCP spec	modelcontextprotocol.io	MCP protocol + seznam serverů
Memory MCP	github.com/modelcontextprotocol/servers/tree/main/src/memory	Zdrojáky + docs Memory serveru
Tech With Tim video	youtube.com/watch?v=uogzSxOw4LU	Video z Bloku 02
Anthropic best practices	youtube.com/watch?v=gv0WHhKelSE	Backup video přímo od Anthropic

---

💡 Jedna věta k zapamatování pro Den 4

CLAUDE.md (Global + Project) říká CC, KDO JSI. Skill říká, CO MÁ UDĚLAT, když ho zavoláš. Memory MCP si pamatuje, CO JSME SPOLU UDĚLALI. Tři vrstvy = osobní AI asistent.