kafe-dash

Průvodce dashboardem

Co je kafe-dash?

QA dashboard pro sledování auditů kódu. Každý projekt má sessions (audity) a v nich checklist položky, které tester posuzuje jako OK nebo Bug. K bugům lze přiložit screenshoty.

Jak založit nový projekt

  1. Nainstalovat plugin — v Claude Code přidat kafe-stack plugin. Plugin obsahuje příkazy pro celý vývojový cyklus.
  2. Vytvořit prázdnou složku — název složky = název projektu. Otevřít ve VS Code.
  3. Spustit /start — naklonuje šablonu (kostra), přejmenuje projekt, nainstaluje závislosti, vytvoří GitHub repo, zaregistruje v dashboardu a založí první sprint. Vše automaticky.
  4. Spustit /work — zahájí práci na sprintu.
nebo pro existující projekt
  1. Mít wrangler.jsonc v repu — plugin z něj přečte název projektu (pole name).
  2. Spustit /init — zaregistruje projekt v dashboardu, vytvoří docs/PROJECT.md s milníky a první sprint.

Jak funguje audit flow

  • Vývojář spustí /audit

    Claude projde kód, najde problémy a vytvoří session s checklist položkami.

  • Tester posoudí položky

    Otevře session v dashboardu. Každou položku označí jako OK nebo Bug. K bugům přidá poznámku a případně screenshot (📎).

  • Vývojář spustí /fix

    Plugin stáhne bugy z dashboardu, opraví je v kódu a automaticky je označí jako vyřešené. Lze spustit kdykoliv — hned po auditu i v nové session.

  • Vývojář spustí /handoff

    Plugin uzavře session, aktualizuje stav projektu a navrhne další sprint pokud je potřeba.

Stránky dashboardu

Stránka K čemu slouží
Projekty Přehled všech sledovaných projektů s počtem sessions a bugů
Sessions Seznam všech auditů napříč projekty
Checklists Souhrnný přehled bugů a položek čekajících na posouzení
Bugy Všechny otevřené bugy seskupené podle kategorie a projektu
API Docs Dokumentace REST API pro programatický přístup (automatizace, CI)

Příkazy pluginu

Příkaz Co dělá
/start Bootstrap nového projektu — naklonuje šablonu, přejmenuje, vytvoří repo, zaregistruje v dashboardu
/init Inicializace existujícího projektu — vytvoří PROJECT.md, zaregistruje v dashboardu, založí první sprint
/work Strukturovaný sprint — plán, implementace, review
/review Self-review před commitem — kontrola logiky, chyb, MCP pokrytí
/audit Audit kódu a nahrání checklistu do dashboardu k testování
/fix Stáhne bugy z dashboardu, opraví je v kódu, označí jako vyřešené
/deploy Commit, push, ověření deploye na Cloudflare Workers
/handoff Uzavře sprint, aktualizuje stav projektu, navrhne další sprint
/status Rychlý přehled — otevřené bugy, aktuální sprint, stav projektu
/lint Spustí všechny kontroly naráz — typecheck, astro check, eslint, testy
/tests Generování testů pro změněné soubory
/checkmcp Audit MCP pokrytí nebo rychlé hledání v dokumentaci

Kategorie checklist položek

Každá položka má oblast, která určuje co se kontroluje:

layout — rozvržení a UI tests — testy types — typová bezpečnost docs — dokumentace accessibility — přístupnost performance — výkon logic — logika a správnost security — bezpečnost