Druhý mozek v Claude Code: Jak vytvořit strukturu za hodinu

Referenční dokumentace Ailoot: ailoot.ai/docs/.

Proč Claude Code potřebuje druhý mozek a co je nezbytné?#

V úterý otevřete Claude Code. Vysvětlíte mu: tohle je projekt, tohle je cílová skupina, tohle nedělej. Pracujete spolu. Ve čtvrtek otevřete nový chat a musíte vše vysvětlovat znovu.

Pokud máte CLAUDE.md, vyřešili jste první zdroj frustrace. Základní pravidla a popis projektu jsou v jednom souboru, který se načte při každé relaci. Vysvětlil jsem, jak tento soubor funguje, v průvodci CLAUDE.md – můžete si ho nejdřív přečíst a vytvořit si tak potřebný základ.

Jenže CLAUDE.md je příručka pro nového zaměstnance. Jak se oblékat, jakým tónem mluvit s klienty, jaké příkazy použít při publikování. To nestačí k dobrému rozhodování o projektu. Rozhodnutí vyžadují znalosti: co je produkt, kdo je cílová skupina, jak funguje ekonomika, co jste zkoušeli a co nefungovalo.

Podle zkušeností autora popsaných v tomto článku bývaly tyto znalosti na čtyřech místech: v jeho hlavě, v chatech na Telegramu, v dokumentech Google a v hlavách zaměstnanců. Měsíc po rozhodnutí si nikdo nepamatoval, proč padlo. Nový člověk strávil hodinu vyptáváním týmu, aby se zorientoval. Claude do tohoto kontextu vůbec nepatřil.

Před vytvořením druhého mozku znamenala podle popsaných zkušeností autora každá relace nové vysvětlování, kdo je klient, jak je sestavená nabídka a který poskytovatel zpracovává platby. S business/ otevřu chat a řeknu: „aktualizuj nabídku podle nového cenového plánu“ – Claude sám otevře business/company/legal.md, přečte si požadavky, pak přejde do business/products/pricing.md, najde nový cenový plán a jedním krokem navrhne úpravu. Úvodní vysvětlování odpadá; kontext se načte automaticky.

Anthropic na svém technickém blogu tento problém nazývá degradací kontextu:

Jinými slovy: čím víc toho do okna nahustíte, tím hůře agent pracuje s podrobnostmi. Řešením je struktura externích souborů, do kterých Claude může podle konkrétního požadavku sám nahlížet. To je druhý mozek.

Co znamená druhý mozek v Claude Code?#

Obvykle se druhý mozek používá obecně pro produktivitu: lidé si vytvoří trezor v Obsidianu a přidávají do něj úryvky z knih, poznámky z hovorů a nápady k projektům.

Když autor tuto myšlenku použil při práci s Claude Code, přestala se týkat produktivity a začala se týkat architektury agentů.

V klasickém přístupu je druhý mozek váš a přistupujete k němu ručně. Při práci s Claude Code se z něj stává obousměrný systém: přistupujete k němu vy i agent. To mění požadavky na jeho formát.

Protože k němu agent přistupuje sám, soubory musí být ve formátu, kterému rozumí bez samostatné integrace. Markdown je ideální: text, hierarchie nadpisů a odkazy mezi soubory. Notion ani Google Docs se nehodí. Lze je propojit přes MCP, ale přidává to další vrstvu, další token při každém požadavku a další místo, kde může něco selhat.

Protože jsou soubory v souborovém systému vedle projektu, Claude Code k nim má automaticky přístup. Není potřeba nic nastavovat. Spusťte agenta ve složce projektu a uvidí všechny soubory uvnitř. Je to zdarma a funguje to ihned po instalaci.

Jakou hierarchii paměti má Claude Code už v základu?#

Než přidáme cokoli vlastního, podívejme se, co si Claude dokáže zapamatovat bez vaší pomoci. Anthropic v oficiální dokumentaci popisuje dva mechanismy: CLAUDE.md (pravidla, která napíšete) a automatickou paměť (poznatky, které zapisuje Claude). Oba se načtou na začátku každé relace.

CLAUDE.md se vyhledává současně na čtyřech místech:

Všechny čtyři soubory se načtou do kontextu. Čím konkrétnější úroveň, tím vyšší prioritu má. Místní soubor se čte jako poslední, takže jeho pravidla mají přednost před všemi ostatními.

Soubor CLAUDE.md může být také v libovolné složce uvnitř projektu. Když Claude čte soubor z podsložky, načte podle potřeby i CLAUDE.md této podsložky. To se hodí v monorepu: pravidla pro frontend jsou ve frontend/CLAUDE.md, pravidla pro backend v backend/CLAUDE.md a načtou se až při práci na příslušné části.

Automatická paměť se objevila v Claude Code 2.1.59. Jde o soubory, které Claude zapisuje o vás:

~/.claude/projects/<project-name>/memory/
├── MEMORY.md          # Index, loaded in every session (200 lines or 25KB)
├── debugging.md       # Detailed notes (loaded on demand)
├── api-conventions.md
└── ...

Anthropic ji v oficiální dokumentaci popisuje takto:

Automatická paměť se zapíná příznakem autoMemoryEnabled v ~/.claude/settings.json. Claude rozhoduje, co do ní zapíše. MEMORY.md můžete číst a upravovat ručně – je to obyčejný markdown.

CLAUDE.md, nebo druhý mozek – kde vést hranici?#

Na přednáškách používám toto přirovnání: představte si, že jste najali nového zaměstnance. Co mu dáte první den?

Příručku: jak se oblékat, kdy přijít, jakým tónem mluvit s klienty, přes jaký systém publikovat. Je to krátký dokument. Nevysvětluje, co děláte ani proč. Říká jen, jak se chovat.

A zvlášť mu dáte přístup k firemní wiki. Ta vysvětluje, co je produkt, pro koho je určený, kdo je cílová skupina, kolik stojí a proč, kdo jsou konkurenti a jakých chyb jste se dopustili. Je to rozsáhlý archiv. Nikdo ho nečte celý – chodíte do něj hledat odpověď na konkrétní otázku.

CLAUDE.md = příručka. Druhý mozek = wiki. Potřebujete obojí.

Rozdíl je jednoduchý. Do CLAUDE.md patří vše, co je relevantní pro každý úkol:

• Kdo je agent v tomto projektu (pomocník, vedoucí, asistent)
• V jakém jazyce má odpovídat
• Sada nástrojů
• Příkazy pro publikování
• Zákazy (nepoužívat dlouhé pomlčky, nespouštět git push --force)
• Směrování: kam jít pro obchodní kontext a kam pro zásady

Do druhého mozku patří vše, co je potřeba podle situace:

• Produkt, cílová skupina, ekonomika a cíle
• Konkurenti a trh
• Minulá rozhodnutí a jejich důvody
• Příklady od klientů a recenze
• Zásady a metodika

Anthropic ve své dokumentaci rozlišuje totéž:

Skills jsou jedním ze způsobů, jak ukládat epizodické znalosti. Dalším je složka business/ vedle projektu. Používám obojí a níže je podrobněji vysvětlím.

Z čeho se skládá mozek projektu – 5 částí a stroj času#

Příklad architektury z popsaných zkušeností autora:

Klíčovým metodickým bodem je oddělit ai-clone/ a business/.

business/ odpovídá na otázku „co děláme?“. Produkt, cílová skupina, ceny, konkurenti. Týká se projektu. Když zítra projekt předáte partnerovi, tato složka půjde s ním.

ai-clone/ odpovídá na otázku „jak se rozhoduji?“. Moje zásady, tón, řemeslo a zakázaná slova. Týká se mě. Když zítra začnu nový projekt, tato složka půjde se mnou.

Chcete nejen nastavit druhou složku, ale také vytvořit systém, díky kterému bude Claude odpovídat konzistentně? To samo nestačí. Bez ai-clone/ agent odpovídá za všechny, ne za vás. Bez context engineeringu bloudí po celé složce a plýtvá tokeny. Vyplatí se propojit všechny tři prvky: druhý mozek + AI klon + context engineering. To jsou tři pilíře, bez nichž AI halucinuje.

Co patří do business/ a co tam nepatří?#

Struktura nejvyšší úrovně složky business/ v popisovaném projektu autora:

business/
├── INDEX.md              ← mapa složky, přečtěte jako první
├── company/              ← poslání, právní subjekt, hodnoty, právní zásady
├── products/             ← produkty, programy, ceny
├── audience/             ← profil klienta, segmenty, námitky
├── goals/                ← roční, čtvrtletní a měsíční cíle, metriky
├── economics/            ← jednotková ekonomika, příjmy, výdaje, prognóza
├── marketing/             ← kanály, prodejní trychtýř, materiály, konkurenti
├── execution/            ← týdenní plánování, nevyřízené úkoly
└── assets/               ← designový systém, recenze, banka textů

Jde o příklad z popisovaného projektu autora, ne o dogma. Složky vytvářím podle potřeby. Začal jsem se třemi (products/, audience/, goals/); ostatní přibyly po 2-3 měsících, když už nebylo jasné, kam ukládat nové věci.

Hlavním souborem složky je INDEX.md. Je to mapa. Obsahuje tabulku „otázka → soubor“, podle které Claude pozná, kam zamířit. Bez ní agent plýtvá tokeny čtením každého souboru v pořadí.

Ukázka z INDEX.md:

### Kde co najít

| Co potřebujete | Kam se podívat |
|---|---|
| Kdo je náš klient a co ho trápí | `business/audience/avatar.md` |
| Produkty, plány a ceny | `business/products/` |
| Cíle a metriky | `business/goals/` |
| Ekonomika (příjmy, výdaje, jednotková ekonomika) | `business/economics/` |
| Propagační kanály a materiály | `business/marketing/` |

Pak stačí jeden řádek v CLAUDE.md: „V případě obchodních otázek si přečti business/INDEX.md a postupuj podle mapy.“ Agent nenačítá celou složku do kontextu. Načte mapu, vybere správný soubor a přečte jen ten.

Kontrolní seznam toho, co do business/ neukládat:

• Nezpracovanou korespondenci z chatů. Pokud obsahuje poznatek, zpracujte ho a zapište. Pokud ne, vynechte ho.
• Informace zdvojené v kódu. Není potřeba psát, že „platby zpracovává CloudPayments“; agent to najde v kódu.
• Snímky obrazovky a obrázky. Zvětšují složku a textový model je bez dalšího kroku nezpracuje.
• Proměnlivá čísla. „Dnes máme 423 plateb za produkt“ bude za týden zastaralé. Použijte značku LIVE a odkaz na databázový dotaz.
• Citlivé nebo pochybné informace. Kdyby byl repozitář zítra zveřejněn na YouTube před 100 tisíci cizích lidí, nechte v něm jen to, co jste ochotni ukázat. Do složky nahlížejí zaměstnanci, agenti a někdy i externí dodavatelé.

Proč mít samostatnou složku ai-clone a proč ji nesměšovat s business?#

Myšlenka je jednoduchá: firma ví, co děláme. Klon ví, jak se rozhoduji.

Struktura ai-clone/ v popisovaném projektu autora:

ai-clone/
├── INDEX.md           ← mapa složky
├── role.md            ← kdo jsem, mé zázemí a na čem záleží
├── identity/          ← hodnoty, vize, poslání
├── thinking/          ← mentální modely z přednášek
├── voice/             ← tón, slovník, styl
├── principles/        ← přesvědčení o produktu, kódu a podnikání
├── feedback/          ← pravidla získaná z chyb ← hlavní složka
├── style/             ← zakázaná slova, formát Telegramu
└── reference/         ← nástroje, prostředí

Nejužitečnější je složka feedback/. Uchovává konkrétní pravidla, která jsem si osvojil díky chybám agentů. Každé pravidlo je v samostatném souboru v tomto formátu:

---
name: short-name
description: one line - what’s in the file and when to apply it
type: feedback
---

Krátké pravidlo v jedné větě.

**Proč:** proč toto pravidlo existuje. Kontext, incident, pozorování.

**Jak použít:** konkrétní situace, kdy se pravidlo uplatní.

Bez části „Proč“ je pravidlo mrtvé – agent ho nepřenese do podobné situace. Bez části „Jak použít“ není jasné, kdy ho uplatnit.

Příklad z mé složky: pravidlo „spojovník, ne dlouhá pomlčka“. Vzniklo proto, že dlouhá pomlčka — je výrazným vizuálním znakem generovaného textu. Platí pro jakýkoli text určený veřejnosti. Soubor se nachází v ai-clone/feedback/no-em-dashes.md.

Já to dělám trochu jinak: pravidla píšu do ai-clone/feedback/, ne do CLAUDE.md. CLAUDE.md je soubor projektu, ale pravidla pro tón a styl jsou osobní. Přejdou se mnou do dalšího projektu. CLAUDE.md zůstává u projektu.

Co jsou živé metriky a proč čísla nezapisovat napevno do souborů?#

Jednou z hlavních nástrah při vytváření druhého mozku je zaplnit ho zastaralými čísly. Napíšete „máme 320 klientů“ a za dva týdny už jich je 410. Napíšete „měsíční příjem je 4.7 million“, ale za měsíc ztratí toto číslo kontext: jde o cíl, skutečnost, nebo prognózu?

V autorově příkladu to funguje takto. V souboru business/products/practicum.md je místo čísla značka:

## Kohorty

> **LIVE** - aktuální platby podle kohorty zjistíte spuštěním dotazů v `live-metrics.md`, oddíl „Prodeje“.

| Kohorta | Data | Platící |
|-------|------|------------|
| 1 | March 10-12, 2026 | LIVE |
| 2 | March 24-26, 2026 | LIVE |

Samostatný soubor live-metrics.md obsahuje připravené SQL dotazy a popisy jejich výsledků:

## Prodeje (platby podle kohorty)

```sql
SELECT c.name, COUNT(p.id) AS paid, SUM(p.amount) AS revenue
FROM purchases p
JOIN cohorts c ON c.id = p.cohort_id
WHERE p.status = 'paid'
GROUP BY c.name
ORDER BY c.starts_at DESC;
```

Když se agenta zeptám „kolik máme plateb za druhou kohortu?“, udělá toto:

1. Přečte business/products/practicum.md
2. U čísla uvidí značku LIVE
3. Otevře live-metrics.md
4. Najde oddíl „Prodeje“
5. Spustí dotaz nad produkční databází
6. Odpoví s použitím čerstvých dat

Tím se vyřeší dva problémy najednou. Čísla nezastarají. A rozhodnutí vycházejí z aktuální situace, ne z loňských údajů.

Jak AI prochází druhým mozkem při jednom požadavku?#

Konkrétní požadavek může znít například: „napiš e-mail účastníkům o nové kohortě“.

1. Claude začíná s prázdným oknem. Načte CLAUDE.md (pravidla, stack, směrování).
2. Ze směrování v CLAUDE.md zjistí: „ai-clone/INDEX.md – přečti vždy na začátku relace.“ Otevře soubor a zjistí, kdo jsem, jaký mám tón a která zakázaná slova používám.
3. Ze směrování zjistí: „šablony e-mailů – src/lib/email/layout.ts.“ Otevře soubor a pochopí formát.
4. Zjistí: „kontext produktu – business/products/practicum.md.“ Otevře soubor a přečte si informace o produktu.
5. V souboru uvidí značku LIVE a odkaz na live-metrics.md. Otevře soubor a najde připravený SQL dotaz. Pokud potřebuje aktuální číslo, spustí dotaz. Pokud ne, označí, že se má „toto číslo načíst při odeslání“.
6. Najde pravidla tónu v ai-clone/style/telegram-format.md, zákaz dlouhých pomlček v ai-clone/feedback/no-em-dashes.md a míru konverze v prodejním trychtýři v business/marketing/funnel.md.

Napíše e-mail mým tónem, s aktuálními čísly, bez dlouhých pomlček a bez znaků typických pro AI.

Anthropic tento přístup na svém technickém blogu nazývá kontextem načítaným právě včas:

Jinými slovy: Claude nosí ukazatele na data, ne samotná data. Je to výrazně úspornější na tokeny a přesnější, protože se do kontextu dostanou jen relevantní informace. Okno zůstává přehledné pro uvažování.

5 chybných postupů při budování druhého mozku – čemu se vyhnout?#

Chybný postup 1. Přerostlý CLAUDE.md. 500 řádků pokynů „místo toho, aby bylo všechno na jednom místě“. Anthropic se vyjadřuje jasně:

Cílový rozsah je 80-120 řádků. Všechno ostatní uložte do samostatných souborů a odkažte na ně.

Chybný postup 2. Univerzální složka. Do druhého mozku naházíte všechno: nezpracovanou korespondenci z chatů, zbytečné snímky obrazovky, zprávy, které nikdo nebude číst. Za měsíc se složka nafoukne, agent plýtvá tokeny čtením balastu a vy si nepamatujete, kde co je. Pravidlo: každý soubor druhého mozku má odpovídat na konkrétní otázku. Pokud ho nikdo šest měsíců neotevřel, smažte ho nebo přesuňte do archivu.

Chybný postup 3. Duplikování. „Platby procházejí přes CloudPayments v src/lib/payment/cloudpayments.ts; poskytovatel je nastavený v .env.“ Agent to všechno vidí v kódu. V business/ to neduplikujte. Duplikáty zastarávají: kód se změní, business/ se neaktualizuje a agent pracuje se zastaralými informacemi.

Chybný postup 4. Čísla zapsaná napevno. „Máme 1,247 klientů a míru konverze 6.3 %“ – představte si, že jde o čísla z nějakého abstraktního fintech startupu. Všechna taková čísla za týden zastarají. Používejte značku LIVE a live-metrics.md. O této části je řeč výše.

Chybný postup 5. Kontext bez dostupné cesty. Je-li druhý mozek jinde a agent nemá oprávnění ani odkaz, spuštění ve složce kódu nestačí. Pro sdílené poznámky bez citlivých údajů je umístění business/ a ai-clone/ uvnitř repozitáře pohodlné. Soukromý kontext ponechte na odděleně řízeném místě a výslovně nastavte povolený přístup a směrování. Pohodlí složek nemá přednost před důvěrností.

Jak vytvořit druhý mozek za hodinu – postup krok za krokem#

1. Vytvořte dvě kořenové složky

   V kořenové složce projektu vedle src/:

   mkdir -p business/{products,audience,goals,economics,marketing}
   mkdir -p ai-clone/{identity,voice,principles,feedback,style}
   

2. Vytvořte INDEX.md jako mapu složky

   business/INDEX.md je tabulka „otázka → soubor“. Začněte alespoň 5 řádky a postupně přidávejte další. Totéž udělejte v ai-clone/INDEX.md.

3. Přidejte stručné popisy produktu a klienta

   business/products/main.md – co je produkt, pro koho je určený, kolik stojí a čím se liší. 30-50 řádků. business/audience/avatar.md – kdo je klient, co ho trápí a co kupuje. 30-50 řádků. Nepopisujte ideálního klienta, ale skutečného. Pokud něco nevíte, označte to jako „k upřesnění“ a pokračujte.

4. Popište sebe v ai-clone/role.md

   Kdo jste, co děláte a na čem vám záleží. 20-30 řádků. To pro začátek stačí. Až si všimnete, že agent píše stylem, který vám nesedí, přidejte tón, zásady a zakázaná slova.

5. Přidejte směrování do CLAUDE.md

   Otevřete CLAUDE.md a přidejte oddíl:

   ## Mapa projektu
   
   - Obchodní kontext → `business/INDEX.md`
   - Kontext o mně → `ai-clone/INDEX.md`
   - Technické plány → `plans/YYYY-MM-DD-*.md`
   - Ohlédnutí za minulými relacemi → `retrospectives/`
   
   Na začátku každé relace vždy přečti `ai-clone/INDEX.md` a `business/INDEX.md`.
   

6. Spusťte Claude Code a ověřte funkčnost

   Otevřete agenta. Zeptejte se: „řekni mi o mém produktu a cílové skupině“. Pokud odpoví na základě kontextu ze složky, funguje to. Pokud si vymýšlí, zkontrolujte, že složky jsou vedle projektu, soubory jsou správně pojmenované a směrování v CLAUDE.md je formulováno přesně.

Poté druhý mozek roste podle dvou zásad.

Zaprvé: pokaždé, když agent udělá chybu, přidejte pravidlo. Po 3-4 týdnech bude ai-clone/feedback/ obsahovat 15-20 souborů s pravidly a agent přestane dělat většinu běžných chyb.

Zadruhé: pokaždé, když učiníte obchodní rozhodnutí, zaznamenejte ho do business/. Když zvýšíte cenu, přidejte do business/products/pricing.md poznámku s datem a důvodem. Když změníte pozicování, přidejte poznámku do business/company/about.md. Za šest měsíců budete mít archiv, který si pamatuje „proč“.

Tento týden jsme spolu udělali spoustu práce.

Prober všechny změny kódu z tohoto týdne a všechny commity, které jsme vytvořili.
Jaké cenné informace z toho patří do business/? Zapiš je do příslušných souborů
s wiki odkazy na sousední soubory, aby se kontext neztratil.

Pokud kód obsahuje rozhodnutí, která jsem nevysvětlil, zeptej se mě proč
 a zaznamenej důvod do příslušného souboru spolu s datem.

Neduplicuj nic, co je z kódu už zřejmé. Zahrň pouze to, co by agent
v příští relaci bez business/ nevěděl.

Co dál – Skills, Subagents a context engineering#

Jakmile je druhý mozek připravený, můžete přidat další tři nástroje, které Anthropic popisuje jako tři různé úrovně optimalizace kontextu.

Skills jsou procedurální znalosti. Pokud opakujete nějaký postup (psaní výukového průvodce, sestavení příspěvku na Telegram, audit webu), můžete ho zakódovat do souboru SKILL.md s popisem úkolu. Na začátku relace Claude projde názvy a popisy dovedností a načte jen ty, které odpovídají aktuálnímu úkolu. Šetří to tokeny a pomáhá udržet pozornost.

Subagents jsou izolované instance Claude s vlastními kontextovými okny. Zadejte subagentovi náročný úkol (přečíst 30 souborů a sestavit shrnutí) a pracuje ve vlastním okně a vrátí jen výsledek. Vaše hlavní okno zůstane přehledné. Anthropic píše:

Context engineering je správa toho, co se vůbec dostane do okna. Anthropic ho v roce 2025 označil za základní dovednost při práci s agenty, o úroveň výš než prompt engineering. Prompt engineering je volba formulace. Context engineering je výběr souborů, směrování, dovedností a subagentů.

Druhý mozek je první stavební kámen context engineeringu. Bez něj Skills čtou prázdný prostor, Subagents nemají kam jít a okno agenta se plní náhodnými informacemi. S ním začnou všechny tři nástroje fungovat.

Další krok. Vytvořte vedle projektu dvě složky: business/ a ai-clone/. Do každé přidejte INDEX.md s 5 řádky, které slouží jako mapa. Do CLAUDE.md přidejte čtyři směrovací řádky. Za hodinu budete mít funkční základ druhého mozku. Pak ho rozšiřujte podle pravidla „po každé chybě agenta přidej jeden řádek do ai-clone/feedback/“. Celou šablonu CLAUDE.md, kterou použijete ke směrování do druhého mozku, vysvětluji v průvodci Jak správně nastavit CLAUDE.md.

Pokračujte v objevování Ailoot na ailoot.ai.