Workflow

Code review pre QA s AI agentami

PR review je fáza, kde QA tímy najčastejšie kolabujú — buď sa neprebehne poriadne (deadline pressure), alebo ukradne toľko času seniorom, že sa sami nedostanú k písaniu testov. AI review agent je kompromis: nezruší human review, ale chytí 50–70 % issues predtým, ako sa to dostane k človeku.

Ako nastaviť QA review agenta v Claude Code

Vytvor súbor .claude/agents/qa-reviewer.md:

---
name: qa-reviewer
description: PR review pre QA testy. Kontroluje Page Object
  patterns, anti-flaky best practices, pokrytie negative scenárov
  a duplicity. Spúšťaj pri každom PR s test súbormi.
---

Si QA reviewer senior level. Prechádzaš diff pridaných/
zmenených test súborov a kontroluješ:

## Kritické (blokuj merge)
- Hardcoded timeouts (cy.wait(number))
- Chýbajúce data-qa selektory — nikdy CSS class alebo ID
- Cez-test dependencies (state leak z predchádzajúceho testu)
- Chýbajúce beforeEach/afterEach cleanup
- Tested len happy path, bez negative scenárov tam, kde dáva zmysel

## Warning (nezjednostavuje)
- Duplikát existujúceho test case-u (prezrel si cypress/e2e/)
- Inline test data namiesto factory
- Nesprávny súborový zaraďovací (feature patrí do cypress/e2e/X, nie do Y)

## Nitpick (len mention, nezjednostavuje)
- Neosadené aria-labely v page objecte
- Chýbajúci JSDoc pri exportovaných helperoch

Výstup formátuj ako GitHub review:
- **file.ts:23** [CRITICAL] hardcoded timeout, použij cy.intercept()
- **file.ts:45** [WARN] duplikát cypress/e2e/checkout/payment.spec.ts:12

Spustenie agenta

Pri PR spusti v termináli:

git checkout feature/new-checkout-tests
claude /agents qa-reviewer

> Reviewuj diff oproti main pre všetky .spec.ts súbory.

Claude prečíta diff, aplikuje pravidlá zo súboru a vypíše review. Nakopíruj do GitHub PR.

Integrácia do CI (advanced)

Automatický komentár pri PR cez GitHub Action:

name: QA Review
on:
  pull_request:
    paths: ['cypress/**/*.spec.ts']

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with: { fetch-depth: 0 }

      - name: Run Claude review
        uses: anthropics/claude-code-action@v1
        with:
          api-key: ${{ secrets.ANTHROPIC_API_KEY }}
          agent: qa-reviewer
          diff: ${{ github.event.pull_request.base.sha }}..HEAD

      - name: Post comment
        uses: peter-evans/create-or-update-comment@v4
        with:
          issue-number: ${{ github.event.pull_request.number }}
          body-path: .claude/review-output.md

Čo merateľne dodá

  • Human reviewer bandwidth — senior QA sa nemusí pozerať na každý trivial PR. Pozrie až na PR-y, kde AI agent povedal „LGTM ale jednu vec check-ni".
  • Stabilita frameworku — anti-flaky patterns sa dodržujú konzistentne, nielen keď sa reviewerovi podarí zbadať.
  • Onboarding juniora — juniorný tester dostane okamžitý feedback na každý PR. Naučí sa patterny rýchlejšie než z manuálov.

Čo AI reviewer nevyrieši

  • Biznisovú logiku — „testujeme ten správny scenár?" je human job.
  • Architektonické rozhodnutia — „patrí toto do page objectu alebo je to shared helper?" AI odporúča, ale nie autoritatívne.
  • Tradeoff-y — rýchlosť testu vs. dôkladnosť je business decision.

Best practice: 2-step review

  1. AI review agent — automaticky pri PR. Zachytí technické detaily.
  2. Human review — senior QA alebo dev lead sa pozrie najviac 5 min. Sústreďuje sa len na biznisovú a architektonickú správnosť.

Reálny čas potrebný na review PR klesne zo 25–45 min na 5–10 min, s vyššou kvalitou.


Chcete rovnaký prístup u vás? Napíšte nám — dohodneme 30-minútový discovery call.