Brain System v2.0
Persistentní paměť pro Claude Code
Co je Brain System?
Problem: AI asistenti zapomínají kontext mezi sessions. Každý nový rozhovor začínáte od nuly.
Řešení: Brain System je persistentní paměť pro Claude Code. Strukturované soubory, které si agent čte a zapisuje sám.
Výsledek: Žádné opakování, žádné ztracené kontexty. Agent ví co dělal minule, co má dělat teď a co přijde dál.
Jak to funguje
Architektura na jeden pohled
Jak to vzniklo
Od frustrace ke kontinuitě
Ztracená kontinuita
Pracoval jsem s Claude na projektech a pokaždé, když jsem začal nový rozhovor, musel jsem vysvětlovat kontext znova. Agent si nic nepamatoval.
První pokusy
Vytvořil jsem CONTEXT.md, kam jsem psal poznámky. Ale jeden soubor nestačil - informace se mísily a rychle přerostly.
Local Brain
Klíčový průlom: .brain/memory/ v každém projektu.
Auto-detection při startu. Nemusím nic říkat - prostě to funguje.
Skills revoluce
V1.0 načítala 10KB+ při každém startu. V2.0 s on-demand skills snížila token usage o 85%. Průlom v efektivitě.
Dual-Brain Architektura
Local + Global = Kompletní kontext
Local Brain
Projektová paměť v .brain/memory/
tasks/- Aktivní úkoly (lifecycle tracking)context/- Opakovatelné vzorydecisions/- Architekturální rozhodnutíchangelog/- Historie sezenílearned/- Poučení z chybNEXT_SESSION_TODO.md- Handoff pro další sezení
Global Brain
Systémové znalosti v $BRAIN/
- EJS meta-brain šablony
- 7 core skills
- Globální příkazy
- Agent definice
Brain Vault
Centrální Git repo pro všechny projekty
- Symlinky z
.brain/memory/ - Automatický sync
- Verzovaná historie
Skills-Based Loading
Načti jen to co potřebuješ
Proč skills?
V1.0 načítala celý rules.md (10KB+) při každém startu.
V2.0 načítá skills on-demand - každý skill má ~1-2KB a načte se jen když je potřeba.
| Přístup | Token Cost | Kvalita |
|---|---|---|
| v1.0 - Načtení všech souborů | ~20KB | 100% (overkill) |
| v2.0 - Skills on-demand | ~5KB | 90% |
brain-memory-reader
Orientace v session, brain-status.sh
~2KBbrain-first-answer
Session start protokol, git check
~1KBbrain-task-lifecycle
OPEN → PLAN → PROCESS → DONE
~2KBbrain-changelog-writing
Session logging, historie změn
~1KBbrain-context-files
Pattern dokumentace
~1KBbrain-decision-making
ADR - architekturální rozhodnutí
~1.5KBbrain-mastery
Kompletní reference (textbook)
~4-5KBWorkflow
Jak to funguje v praxi
Session Start
- EJS šablony vygenerují základní kontext
- brain-first-answer zkontroluje git status
- brain-status.sh zobrazí přehled
- Skills se načtou on-demand
Task Lifecycle
Agent automaticky přechází mezi stavy bez permission.
Session End
/brain-finish- Review aktivních tasků
- Changelog entry
- NEXT_SESSION_TODO update
- Brain vault sync
NEXT_SESSION_TODO
Most mezi sezeními
Proč je to klíčové?
Je pátek večer, pracujete na složitém featureu. Zítra ráno potřebujete vědět: kde jste skončili, co je další krok, jaká je priorita. NEXT_SESSION_TODO je explicitní handoff z jednoho dne do druhého.
Žádné hádání. Žádné ztrácení času. Prostě pokračujete tam, kde jste skončili.
Praktické příklady
Jak to vypadá v praxi
Rozpracované změny
Agent detekuje necommitnuté změny a zastaví:
Čisté repo
Auto brain-status.sh a ready to go:
Příkazy
Globálně dostupné v každém projektu
| Příkaz | Popis |
|---|---|
| /brain-initialize | Vytvoření .brain/ struktury v novém projektu |
| /brain-status | Přehled stavu projektu, aktivní tasky, changelog |
| /brain-update | Synchronizace paměti po manuálních změnách |
| /brain-finish | Ukončení session, příprava NEXT_SESSION_TODO |
| /brain-cleanup | Archivace starých tasků, detekce sirotků |
| /brain-debug | Verifikace kontextu, debug info |
Agent Orchestration
Tým specializovaných agentů
Proč multi-agent?
Jeden agent nemůže být expert na všechno. Místo jednoho "superagenta" mám tým specialistů - každý dělá jednu věc dobře.
brain-orchestrator
Dirigent - deleguje úkoly sub-agentům podle potřeby
- information-miner
- documentation-expert
- test-runner
- git-analyzer
Main Roles
Specializace pro main agenta
- brain-master
- ent-master
- system-administrator
- claude-code-expert
Kdy delegovat?
Decision framework
- Specializované znalosti
- Komplexní task
- Simple task → direct work
Kde Brain System pomáhá
Reálné příklady z praxe
Web Development
Tento web vznikl kompletně s Claude Code. Brain si pamatuje design systém, strukturu stránek, a kde jsme minule skončili. Nová session = pokračování, ne start od nuly.
Home Assistant
Konfigurace HA, automatizace, Grafana dashboardy — Brain zná celou infrastrukturu. Agent ví jaké senzory mám, jaké entity existují a jak spolu souvisí.
Pracovní projekty
Frontend, backend, microservices — každý projekt má svůj Brain s architekturou, konvencemi a rozhodnutími. Přepnu projekt a agent okamžitě ví co je za kód.
Multi-Agent Orchestrace
Více agentů pracuje paralelně — jeden researchuje, druhý kóduje, třetí testuje. Brain zajišťuje synchronizaci kontextu mezi nimi.
Jak to používám
Brain Vault a synchronizace mezi PC
Problém: Více počítačů
Pracuji na několika PC (práce, doma, notebook). Potřebuji mít brain paměť synchronizovanou - když skončím v práci, chci doma pokračovat tam kde jsem skončil.
Brain Vault
Centrální Git repo — 10 projektů na jednom místě
Soukromé GitHub repo — synchronizace mezi zařízeními přes Git.
Symlinky
Projekty odkazují do brain-vault
Každý projekt má symlink do odpovídající složky v brain-vault.
Auto-sync
Automatický push při ukončení
Změny se automaticky pushnou do GitHub při ukončení session.
Workflow mezi PC
Skončím v práci → změny jdou do GitHubu → doma git pull → pokračuji kde jsem skončil. Žádné ruční kopírování, žádné ztracené kontexty.
Brain v akci
Reálný příklad: vývoj tohoto webu
Jak Brain pomáhá při vývoji ongy.cz
Tento web vzniká po večerech v krátkých sessions. Bez Brain System bych musel pokaždé vysvětlovat: jaký je tech stack, kde jsou soubory, jaký je design systém, co jsem dělal minule. S Brainem to prostě funguje.
Bez Brain System
"Mám web ongy.cz, je to statický web, vanilla JS, žádný framework, barvy jsou teal a amber, fonty Montserrat a Inter, obrázky na Cloudinary, minule jsem dělal sekci Deskovky..."
~5 minut kontextu na začátku každé session
S Brain System
"Načti si brain."
Agent si přečte NEXT_SESSION_TODO, ví co je za projekt, zná design systém, vidí aktivní úkoly a rovnou se ptá na čem chci pokračovat.
~10 sekund a jedeme
Konkrétní session: 8. března 2026
Řekl jsem "načti si brain" a během jedné session jsme:
- Přidali 4 blogposty o historii webu
- Aktualizovali popis na hlavní stránce
- Provedli bezpečnostní audit celého webu
- Přidali CSP, Referrer Policy a Permissions Policy do 16 souborů
- Vylepšili tuto stránku o diagram a příklady
Agent celou dobu věděl: jaký je design systém, kde jsou soubory, jaké jsou pravidla (žádné emoji, žádné frameworky, čeština). Nemusel jsem nic opakovat.
Klíčové principy
Kontinuita
Externí paměť pro dlouhodobé projekty. Agent si pamatuje rozhodnutí i mezi sezeními.
Efektivita
On-demand loading, 85% úspora tokenů. Žádné plýtvání kontextem.
Autonomie
Agent píše do paměti sám bez ptaní. Žádné "Mohu zapsat do changelog?"
Struktura
Všechno má své místo. Tasks, decisions, context - každý typ informace má vlastní složku.