QAwalk

Sinfin QAwalk · proof of concept

Každá obrazovka flow, schválená na jedné plachtě.

Váš agent projde akceptační plán s vašimi skilly a vaší konfigurací. QAwalk cestou zachytí každou obrazovku a e-mail, ověří každé kritérium a rozloží běh na plachtu. Tým ji zkontroluje, kroky schválí nebo vrátí, a každý běh zůstane uložený s větví, commitem a PR.

Založit organizaciNainstalovat do projektuOtevřít aplikaci

Jak to funguje

  1. Akceptační plán

    ACCEPTANCE.md u tasku říká, co má každá obrazovka splnit. scenario.yml z něj udělá kroky, větve a kritéria, která CLI umí spustit.

  2. Průchod

    Flow projde Playwright skript, agent s prohlížečem nebo computer use, nebo člověk. Všichni ve sdíleném prohlížeči. Každý krok se zachytí stejně: screenshoty celé stránky na desktopu i mobilu, vykreslené HTML, chyby v konzoli a e-maily z testovací schránky (Mailpit).

  3. Kontrola

    Co jde spočítat (prvky, texty, ceny, metadata, přetečení), ověří CLI přímo v živé stránce a ke každému kritériu přiloží důkaz. Kritéria, která chtějí úsudek, zodpoví AI evaluátor ze zredukované textové osnovy stránky. Vrátí pravděpodobnost a QAwalk z ní udělá splněno, nesplněno nebo k revizi. Výchozí evaluátor je JEV od TypeSafe a lze ho vyměnit.

  4. Plachta a schválení

    Z běhu vznikne plachta: obrazovky, větve, testované jazyky, metadata a důkaz u každého kritéria. Kontrolující krok schválí, nebo ho s poznámkou zamítne. Agent si poznámky načte příkazem qawalk feedback a v dalším běhu je opraví.

Co plachta ukáže

Instalace do projektu

QAwalk běží tam, kde je váš kód a váš agent. Služba výsledky ukládá a verzuje, zobrazuje plachtu a sbírá schválení.

  1. Přidejte CLI do projektu
    npm install --save-dev github:sinfin/qawalk#v0.1.0

    Proof of concept: repozitář je zatím soukromý. O přístup požádejte Sinfin.

  2. Vytvořte konfiguraci a nainstalujte skill
    npx qawalk init --agent claude --org <your-org>

    Skill se zkopíruje do .claude/skills/qawalk. Místo toho ho můžete nainstalovat jako plugin: /plugin marketplace add sinfin/qawalk.

  3. Založte organizaci a vytvořte token

    Založte organizaci, stanete se jejím adminem. Úvodní stránka nabídne token s rolí tester jedním kliknutím, později ho najdete v Nastavení → API tokeny. Uložte ho do .env projektu:

    QAWALK_TOKEN=qwk_…
TYPESAFE_API_KEY=…   # optional: semantic evaluator
  4. Spusťte a nasdílejte
    npx qawalk start --scenario docs/tasks/TASK-123/qa/scenario.yml --env local
npx qawalk walk        # playwright steps; agent/manual steps: qawalk capture
npx qawalk evaluate
npx qawalk share

    Nebo požádejte agenta: “Projdi akceptační plán TASK-123 s QAwalk na local a nasdílej výsledek.”

Data a bezpečnost

Evaluátor vidí osnovu, ne stránku

AI evaluátor dostane zredukovanou textovou osnovu stránky se zamaskovanými e-maily a tokeny. Screenshoty ani surové HTML nedostane nikdy.

Přihlášení odkazem z e-mailu, tři role

Lidé se přihlašují jednorázovým odkazem na pracovní e-mail. Viewer čte a hodnotí, tester navíc nahrává běhy, admin navíc spravuje členy, domény a tokeny.

Běhy mají expiraci

Každý běh má datum expirace (výchozí 30 dní) a potom se smaže. Zachycené HTML se servíruje v sandboxu bez skriptů.