Průvodce
Ekosystém
Tři komponenty spolupracují: kafe-stack plugin (kvalita kódu, workflow, hooky), TheBrain plugin (paměť mezi sessions, navigace kódem) a kafe-dash (tento dashboard — tasky, kanban, bugy, CF infra).
Jak začít
Krok za krokem — co napsat do Claude Code.
Nový projekt (od nuly)
/start— vytvoří projekt z kostra šablony, GitHub repo, první commit/context7-init— detekuje knihovny z package.json, uloží context7 IDs pro docs/init— zaregistruje projekt v dashboardu (D1)/plan— vytvoří PROJECT.md + PLAN.md, rozplánuje sprinty a runy/work— spustí první run (3-5 úkolů, review, deploy, handoff)
Existující projekt (ještě není v dashboardu)
/context7-init— uloží context7 IDs knihoven/init— zaregistruje v dashboardu- Pak normálně pracuj —
/planpokud potřebuješ naplánovat, jinak rovnou/work
Každá session
- Na začátku:
/thebrain:hello— obnoví kontext z minulé session - Práce:
/work— jeden run za session - Na konci:
/thebrain:wrapup— uloží stav pro příště
Session flow (zkráceně)
Každá session má jasný začátek, práci a konec. Detail →
- Session start — hooky ověří pluginy, stáhnou bugy, nastaví baseline
- /thebrain:hello brain — obnoví kontext z minulé session
- /work — naplánuje run (3-5 úkolů), registruje v D1, exekuce s MCP ověřením
- /prereview → /review — kontrola kvality před commitem
- /deploy — commit, push, ověření CF Workers buildu
- /handoff — uzavře run v dashboardu, připraví další
- /thebrain:wrapup brain — uloží stav pro příští session
Příkazy — kafe-stack plugin
| Příkaz | Co dělá |
|---|---|
/start | Bootstrap nového projektu z kostra šablony |
/context7-init | Detekce knihoven z package.json, uložení context7 IDs |
/init | Registrace projektu v dashboardu (D1) |
/plan | Strategické plánování — PROJECT.md + PLAN.md, sprinty a runy |
/work | Strukturovaný run — plan → execute → review → deploy → handoff |
/prereview | Čestné prohlášení před review (anti-bullshit gate) |
/review | Hloubková kontrola kódu, hook ověří důkladnost |
/audit | Sprint audit — kontrola všech změn od main |
/full-audit | Kompletní audit celého projektu soubor po souboru |
/arch | Architektonický audit — bloated funkce, god komponenty |
/deploy | Commit, push, ověření CF Workers deploye |
/handoff | Uzavře run v dashboardu, připraví další |
/fix | Stáhne bugy z dashboardu a opraví je |
/status | Rychlý přehled — bugy, run, stav projektu |
/tests | Generování testů pro změněné soubory |
/lint | Všechny code quality checky najednou |
/checkmcp | Audit MCP pokrytí nebo hledání v docs |
/bp | Grep lokálních .claude/skills/ — free pre-filter před context7 MCP |
/diskuze | Debug mode — Fakta → Hypotéza → Ověření (pro error paste) |
Příkazy — TheBrain plugin
| Příkaz | Co dělá |
|---|---|
/thebrain:hello | Start session — obnoví kontext z minulé práce |
/thebrain:wrapup | Konec session — uloží stav, indexy, paměť |
/thebrain:continue | Obnoví kontext po ztrátě (kompakce kontextu) |
/thebrain:dopamine +/- | Flag chování — co šlo dobře (+) nebo špatně (-) |
/thebrain:oxytocin | Flag stylu spolupráce — jak spolu komunikovat |
Napojení projektu
Spusť /init v projektu — plugin automaticky zjistí ID, název a repo z wrangler.jsonc / package.json / git remote a zaregistruje projekt v dashboardu.
# V Claude Code, v adresáři projektu:
/init
Worker auto-detect: CF infrastruktura (D1, KV, R2, logy, deploye) se napojí automaticky — dashboard matchne repo proti Workers Builds triggers.
Ruční přiřazení v Worker Discovery je jen fallback.
Dashboard stránky
| Stránka | K čemu slouží |
|---|---|
| Projekty | Přehled projektů s metrikami (sessions, bugy, tasky) |
| Kanban | Globální kanban — drag & drop, filtry, keyboard shortcuts |
| Bugy | Otevřené bugy seskupené dle kategorie a projektu |
| Sessions | QA audity napříč projekty |
| Per-project | |
| Tasks / Sprints / Runs | Tasky v kanbanu, sprinty s runy, progress bary |
| D1 / KV / R2 | SQL konzole, KV browser, R2 browser |
| Logs / Deploy | Real-time worker logy, deploy historie |
| Infra | |
| Workers / D1 / R2 / KV / Domains | Globální přehled CF zdrojů, metriky, správa |
Per-project konfigurace
Každý projekt může mít vlastní pravidla v .claude/kafe-stack.local.md:
UI framework, zakázané frameworky, CSS blocklist, architektonické limity, E2E požadavky.
Plugin je čte automaticky a vynucuje při práci.