Kompletní workflow
Co se děje od startu session po její konec. Greymatter běží převážně automaticky přes session-start hooky a MCP nástroje — slash příkazy jsou jen pro behaviorální signály a test mapping.
1. Start session
Otevřeš Claude Code v projektu. Automaticky se spustí oskar-stack hooky:
- Ověření pluginů — kontroluje že oskar-stack a greymatter jsou nainstalované; jednou per stroj zkusí
claude plugin add githubatypescript-lsp - Bugy & vrácené tasky — stáhne z dashboardu, zobrazí na začátku
- Baseline — uloží snapshot dirty souborů (pro porovnání na konci)
- Greymatter signály — načte aktivní dopamine + oxytocin signály jako gates do session kontextu
- Test-map alerty — pokud je projekt opt-in, incremental scan nahlásí stale_pair / missing_test od poslední session
2. /work oskar-stack
Hlavní pracovní příkaz. Jedna session = jeden run (3-5 úkolů).
Fáze 0 — Orient + Scan
grey-orient.sh volá greymatter --reorient <project> (recent sessions + decisions ~300 tokens) místo blanket --map. Cold start fallback dělá full scan + map. Stáhne vrácené tasky a bugy z D1 — pokud existují, dostanou prioritu.
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, (bp) pro items vyžadující plánování souborů. 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, greymatter MCP nástroje pro graph queries — get_node_bundle, query_blast_radius, find_identifier), 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.
3. 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, dopamine pre_write triggery z greymatter signálů
Po každém zápisu — typecheck, kontrola velikosti souborů/funkcí, CSS quality review
Před commitem — ověřuje ž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/oskar-stack.local.md
Před bash příkazem — bash-mcp-nudge kontroluje, jestli má dotaz být spíš v MCP docs než shell; greymatter routing nudge navádí na graph queries místo grep řetězců
4. 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
5. Behaviorální signály greymatter
Když chceš, aby si Claude pamatoval konkrétní lekci nebo způsob spolupráce, použiješ jeden ze dvou příkazů — kompiluje se do greymatter-signals.md, který se načítá na začátku session jako rule file.
/dopamine — flag chování. Pozitivní (nucleus_accumbens) zafixuje dobrou strategii, negativní (amygdala) zablokuje špatnou. Trigger pre_write firne signál těsně před zápisem konkrétního souboru.
/oxytocin — flag relační dynamiky. Síly, které tvarují, jak spolu komunikujeme — hloubka odpovědí, tempo, tón.
/test-map — sumarizace stale_pair / missing_test alertů pro aktuální projekt; volitelně z toho udělá TodoWrite položky.
6. Konec session
Žádný explicit /wrapup příkaz není potřeba — greymatter se dívá na Claude JSONL logy, které se píší automaticky. Při příští session-start hook spustí incremental scan, doplní graph.db o nové soubory + sessions a tím je continuity zajištěná.
Doporučení: před zavřením session si projdi git status — uncommitted změny by se měly buď commitnout přes /deploy, nebo explicitně stash, aby další session navázala na čistý stav.