Kompletní workflow
Co se děje od startu session po její konec. Každý krok je automatický nebo spuštěný jedním příkazem.
1. Start session
Otevřeš Claude Code v projektu. Automaticky se spustí 4 hooky:
- Ověření pluginů — zkontroluje že kafe-stack + brain jsou nainstalované
- Bugy & vrácené tasky — stáhne z dashboardu, zobrazí na začátku
- Baseline — uloží snapshot dirty souborů (pro porovnání na konci)
- Brain hello — pošle instrukci spustit
/thebrain:hello
2. /thebrain:hello brain
Brain plugin načte prefrontal cortex, project memory a nedávné záznamy. Claude ví kde minule skončil, jaké soubory editoval a jaká rozhodnutí udělal.
3. /work kafe-stack
Hlavní pracovní příkaz. Jedna session = jeden run (3-5 úkolů).
Fáze 0 — Scan
Stáhne vrácené tasky a bugy z D1. Pokud existují, dostanou prioritu v zadání.
Fáze 1 — Plánování
Přečte PROJECT.md a PLAN.md, navrhne 3-5 TODO items. Tagy: (mcp) pro framework kód (blokováno hookem — povinné MCP docs ověření), (bp) nudge podívat se do lokálních .claude/skills/ před MCP. Auto-approve — nečeká na potvrzení.
Fáze 1b — Registrace v dashboardu
createRun + createTasks — run a tasky se objeví v kanbanu. ID se uloží do run souboru.
Fáze 2 — Exekuce
Pro každý task: status → doing, práce (s MCP docs pokud framework kód), status → done. Hooky při každém write kontrolují kvalitu.
Fáze 3 — Prereview
Čestné prohlášení agenta. Povinné, nesmí se přeskočit.
Fáze 4 — Uzavření
/review → /deploy → /handoff → E2E test (pokud UI změny). Handoff běží paralelně s deploy čekáním.
4. Hooky při práci
Během exekuce automaticky běží tyto kontroly:
Před každým zápisem — blokuje zakázané patterny (as any, throw v Effect, Svelte 4), ověřuje MCP doc searches pro framework kód, CSS blocklist
Po každém zápisu — kontrola velikosti souborů/funkcí (advisory), CSS quality review
Před commitem — typecheck + ESLint přes změněné soubory, ověří že /review proběhl a byl důkladný (četl soubory, citoval řádky, hledal v MCP docs)
Před deployem — blokuje deploy bez testing evidence pro UI soubory
Při každém promptu — injektuje per-project konfiguraci z .claude/kafe-stack.local.md
5. Handoff a dashboard
/handoff uzavírá run:
- Přejmenuje run soubor na
.done.md, zapíše řešení - Zapíše solutions ke každému tasku v dashboardu
- Uzavře run (a sprint, pokud je kompletní)
- Aktualizuje PLAN.md a PROJECT.md
- Vyhodnotí a případně vytvoří soubor pro další run
6. /wrapup brain
Poslední krok před koncem session. Brain uloží: project memory, prefrontal cortex záznam (co se dělalo, co je next), popisy editovaných souborů do hippocampu, kontext noty do working memory. Nakonec spustí mechanický wrapup (re-scan, indexy, CC2).
Stop hook blokuje ukončení bez wrapupu (max 2×, pak jen varování). Uncommitted změny generují varování.