Průvodce
Ekosystém
Tři komponenty spolupracují: oskar-stack plugin (kvalita kódu, workflow, hooky), greymatter plugin (kód + konverzační knowledge graph, paměť mezi sessions, behaviorální signály) a vyvoj-dash (tento dashboard — tasky, kanban, bugy, CF infra).
Greymatter je nástupce TheBrain — stejný cíl, přepsáno kolem jednoho sjednoceného grafu místo oddělených regional databází. Data jen lokálně v ~/.claude/greymatter/.
Session flow (zkráceně)
Každá session má jasný začátek, práci a konec. Detail →
- Session start — hooky ověří pluginy, stáhnou bugy, načtou greymatter signály (dopamine + oxytocin) jako gates do kontextu
- /work — naplánuje run (3-5 úkolů), grey-orient přinese recent sessions + decisions, 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ší
- Session end — Claude JSONL logy automaticky zaindexovány greymatter scanem do graph.db
Příkazy — oskar-stack plugin
| Příkaz | Co dělá |
|---|---|
/start | Bootstrap nového projektu z kostra šablony |
/init | Registrace projektu v dashboardu — detekce metadat, vytvoření v D1, ověření spojení |
/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 |
/bug | Strukturovaný záznam bugu nalezeného mimo dashboard |
/diskuze | Debug discussion mode — strukturovaný hypothesis/verified template |
/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 |
/context7-init | Detekce knihoven z package.json, uložení context7 IDs |
/bp | Best-practice search — lokální skill content + MCP fallback |
Příkazy — greymatter plugin
Greymatter běží převážně přes MCP server (graph navigation, find_identifier, blast_radius, grep_project) nebo CLI (node $PLUGIN_ROOT/scripts/query.js). Slash příkazy jsou jen pro behaviorální signály a test mapping:
| Příkaz | Co dělá |
|---|---|
/dopamine | Flag chování — pozitivní (nucleus_accumbens) nebo negativní (amygdala) signál s vahou, načte se do kontextu |
/oxytocin | Flag relační dynamiky — síly, které tvarují spolupráci, kompilují se do session-start gate |
/test-map | Stale-test-pair detekce — source změny bez doprovodných test updatů, missing tests |
Greymatter MCP nástroje (graph queries)
Při zapnutém MCP serveru (node scripts/mcp.js enable) volá Claude tyto strukturované nástroje místo grep + read řetězců:
| Nástroj | Použití |
|---|---|
get_project_overview | Recent sessions + file map projektu |
get_node_bundle | Tělo node + labels + 1-hop edges v jednom volání |
walk_flow | Path skeleton od startovacího node |
query_blast_radius | File-level dependencies — co soubor importuje + kdo ho importuje |
find_identifier | Lokalizace symbolu napříč projekty |
grep_project | Project-aware text search s kontextem (textual contracts) |
get_label_coverage | Hustota labelingu na úrovni projektu / souboru / okolí |
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.
Greymatter scan: První volání /work v projektu spustí cold-start scan (node $PLUGIN_ROOT/scripts/scan.js --dir . --project <id>). Další session už používá targeted reorient místo blanket map.
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/oskar-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.