Code review pro QA s AI agenty

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

Vytvořte soubor .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

U PR spusťte v terminálu:

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

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

Claude přečte diff, aplikuje pravidla ze souboru a vypíše review. Zkopírujte ho do PR na GitHubu.

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 patterny se dodržují konzistentně, ne jen když si jich reviewer všimne.
• Onboarding juniora — juniorní tester dostane okamžitou zpětnou vazbu ke každému PR. Patterny se naučí rychleji než z manuálů.

Čo AI reviewer nevyrieši

• Biznisovú logiku — „testujeme ten správny scenár?" je human job.
• Architektonická rozhodnutí — „patří tohle do page objectu, nebo je to sdílený helper?" AI doporučí, ale ne autoritativně.
• 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. Lidské review — senior QA nebo dev lead se podívá nanejvýš 5 minut. Soustředí se jen na byznysovou a architektonickou správnost.

Reálný čas na review PR klesne z 25–45 minut na 5–10, a s vyšší kvalitou.

---

Chcete stejný přístup u vás? Napište nám — domluvíme 30minutový discovery call.