Claude Code pro QA: agentní workflow pro testování

Testování je nutné zlo. Každý vývojář to ví — a přesto ho odkládá, zkracuje nebo deleguje na junior kolegy, kteří si s tím neví rady. Výsledek? Bugy v produkci, přesčasy před vydáním a technický dluh, který roste jako sněhová koule.

V roce 2026 se tohle mění. Claude Code dnes dokáže pokrýt velkou část QA workflow autonomně — píše testy, spouští je, analyzuje chyby a navrhuje opravy. McKinsey studie z února 2026 ukázala, že týmy s dobře nastavenými AI coding workflows ušetří průměrně 46 % času na rutinních úkolech. QA je přitom jeden z největších beneficientů — a pokud víš, jak ho správně nastavit, může ušetřit jednomu vývojáři přes 100 hodin ročně.

V tomto tutoriálu ti ukážu přesně, jak takový workflow postavit — od prvního nastavení až po noční headless QA kampaně.

01Proč je QA ideální kandidát pro AI automatizaci

QA trpí specifickým problémem: je repetitivní, ale zároveň vyžaduje znalost kontextu. Napsat unit testy pro novou funkci je nudné a zdlouhavé — ale zároveň to není kreativní práce, která by si zasloužila tvůj čas.

Claude Code je v tomto případě jako zkušený junior tester, který přečte tvůj kód, pochopí záměr a navrhne testovací scénáře, o kterých jsi ani nepřemýšlel. Na rozdíl od klasického code completion Claude Code spustí testy, uvidí, co selhalo, a iteruje — bez toho, aby tě rušil s každým krokem.

Co Claude Code zvládne sám:

• Generovat unit testy pro existující funkce na základě čteného kódu
• Psát integrační testy na základě API kontraktu nebo OpenAPI specifikace
• Identifikovat edge cases a negativní scénáře, které ti unikly
• Spouštět testy, analyzovat výstupy a autonomně fixovat failing testy
• Generovat regresní testy po bugfixu, aby se chyba neopakovala
• Auditovat celé moduly a reportovat coverage mezery

Co musíš stále dělat ty:

• Reviewovat vygenerované testy — McKinsey studie ukázala, že bez review se bug density v projektech zvyšuje o 23 %
• Definovat business logiku, prioritizaci a co je "správný" výsledek
• Schvalovat změny v kritických částech systému (platby, autentizace, GDPR)
• Nastavit pravidla a konvence, aby agent nepsal testy "naslepo"

Rozdělení je jasné: Claude Code dělá rutinu, ty děláš judgment calls.

02Krok 1: Nastav Claude Code jako QA agenta

Základem úspěšného QA agenta je správný kontext. Claude Code čte soubory v projektu — pokud mu dáš jasná pravidla předem, výsledky jsou výrazně lepší.

Vytvoř nebo rozšiř soubor CLAUDE.md v kořeni projektu o QA sekci:

# QA Pravidla

## Testing Framework
- Používáme Jest pro unit testy, Playwright pro E2E
- Každá funkce musí mít min. 3 testy: happy path, error case, edge case
- Coverage threshold: 80 % pro business logiku, 60 % pro utility funkce

## Konvence pojmenování
- Testy jmenuj: describe("funkce") → it("měla by udělat X při Y")
- Negativní scénáře: it("měla by vrátit chybu, pokud X chybí")

## Co testovat a co ne
- Mocky pouze pro external dependencies (API, DB, filesystem)
- Žádné snapshot testy pro dynamický obsah
- Integration testy musí testovat real database (Docker container v CI)

## Zakázané vzory
- Neimportuj implementaci jen kvůli testování private metod
- Nepoužívej `any` typ v testech bez komentáře proč

S tímto souborem Claude Code respektuje tvé standardy — a nepíše testy stylem "napíšu cokoliv, aby to prošlo".

03Krok 2: Použij /goal pro autonomní test generation

Nová funkce /goal v Claude Code ti umožňuje zadat výsledek, ne jen příkaz. Místo "napiš testy pro soubor auth.ts" zkus konkrétnější zadání s měřitelným cílem:

/goal 
Pokryj modul auth.ts testy na 85%+ coverage.
Prioritizuj: JWT validace, refresh token flow, rate limiting, logout.
Výsledek: passing testy v /tests/auth/, coverage report, 
PR popis se souhrnem co bylo přidáno a proč.

Co se pak stane:

1. Claude Code přečte celý modul a pochopí strukturu
2. Spustí existující testy a zjistí aktuální coverage
3. Identifikuje nepokryté větve a edge cases
4. Napíše testy, spustí je
5. Opraví failing testy (bez tvého zásahu)
6. Vygeneruje coverage report a PR popis

Ty dostaneš hotový PR k review. Bez jediného řádku kódu napsaného ručně. Pokud potřebuješ QA workflow ještě napojit na Slack, Jira nebo e-mailové follow-upy bez vlastní integrace, Zapier funguje jako rychlá orchestrace okolo CI.

04Krok 3: Postav CI/CD pipeline s AI QA vrstvou

Kde tenhle přístup opravdu zazáří, je automatizace v CI/CD. Nastav GitHub Actions workflow tak, aby Claude Code automaticky kontroloval a doplňoval testy při každém PR, který mění business logiku:

# .github/workflows/ai-qa.yml
name: AI QA Agent
on:
  pull_request:
    paths: ['src/**/*.ts', 'src/**/*.js']

jobs:
  ai-qa:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Run Claude Code QA Agent
        run: |
          claude --headless -p "Analyzuj soubory změněné v tomto PR (git diff origin/main).
          Pro každý soubor s business logikou:
          1. Zkontroluj, zda existují odpovídající testy
          2. Pokud coverage je pod 75%, doplň chybějící testy
          3. Spusť testy a reportuj výsledky
          Výstup: seznam přidaných testů, coverage diff, případné problémy"
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

      - name: Comment PR with QA Report
        uses: actions/github-script@v7
        with:
          script: |
            const fs = require('fs');
            if (fs.existsSync('qa_report.md')) {
              const report = fs.readFileSync('qa_report.md', 'utf8');
              github.rest.issues.createComment({
                issue_number: context.issue.number,
                owner: context.repo.owner,
                repo: context.repo.repo,
                body: '## 🤖 AI QA Report\n\n' + report
              });
            }

Výsledek: každý PR dostane automatický QA report jako komentář. Coverage se nesníží pod threshold bez vědomí celého týmu.

05Krok 4: Agent View pro oversight rozsáhlých QA kampaní

Pokud pracuješ na větším refaktoru nebo přidáváš testy do legacy kódu, využij Agent View v Claude Code. Tato funkce ti zobrazuje:

• Které soubory agent právě zpracovává a v jakém pořadí
• Stav testů v reálném čase (zelená = passing, červená = failing, žlutá = v práci)
• Kde agent narazil na problém, proč se zastavil a co potřebuje od tebe
• Celkový progress kampaně v procentech

Praktický tip pro legacy projekty Spusť QA kampaň přes noc pomocí headless módu. Ráno dostaneš kompletní report s desítkami nových testů a coverage auditem celého modulu.

# Spustí QA agenta na celý adresář v headless módu
claude --headless -p "Projdi celý adresář /src/payments. 
Přidej chybějící testy pro všechny funkce pod 70% coverage. 
Oprav failing testy, pokud najdeš existující.
Výsledek ulož do QA_REPORT_$(date +%Y%m%d).md a commitni změny na novou větev qa/auto-$(date +%Y%m%d)" &

echo "QA kampaň spuštěna v pozadí. Výsledky ráno."

Typicky 3–4 hodiny práce agenta = desítky nových testů, opravené failing testy a připravená větev k review.

06Krok 5: Regresní testy po bugfixu — automaticky

Jeden z nejvíc podceňovaných use cases: po opravě bugu by měl vždy vzniknout regresní test, který zabrání opakování. V praxi se to dělá jen zřídka — "nemám čas" je nejčastější výmluva.

S Claude Code to zvládneš za 2 minuty:

# Po commitu bugfixu:
claude -p "Přečti si poslední commit (git show HEAD). 
Vytvoř regresní test, který by selhal na původní chybě 
a projde s aktuální opravou. 
Přidej ho do správného test souboru s komentářem: 
'// Regresní test pro issue #[číslo]'"

Agent přečte diff, pochopí co se opravilo, a napíše test, který přesně ověřuje opravenou logiku. Tento pattern sám o sobě může za rok ušetřit desítky hodin — a ještě víc bugů v produkci.

07Krok 6: Review workflow — nejdůležitější krok

Tady většina týmů dělá zásadní chybu: přijmou vygenerované testy bez review. McKinsey studie to potvrzuje daty: bez adekvátního review se bug density v projektech zvyšuje o 23 % a čas na code review narůstá o 12 %.

Problém je dvojí:

1. AI může testovat implementaci, ne záměr — test projde, ale business logika je špatně
2. Vygenerované testy mohou být příliš úzké a neodhalit edge cases v budoucnosti

Doporučený review checklist (5 minut na 10 testů):

• Testuje test záměr funkce, nebo jen aktuální implementaci?
• Jsou edge cases realistické, nebo vymyšlené a zbytečné?
• Jsou mocky správně nastavené — testujeme kód, ne mock?
• Odpovídá naming konvenci projektu?
• Je test čitelný bez dalšího kontextu?
• Pokrývá test scénář, na který bychom sami zapomněli?

S tímto checklistem zvládneš review rychle — a přitom udržíš kvalitu na vysoké úrovni. Přidej ho přímo do PR šablony, aby ho nikdo nepřeskakoval.

08Reálné výsledky: kolik hodin ušetříš?

Na základě dat z McKinsey studie a zkušeností týmů v průzkumu The Pragmatic Engineer (12/2025, 840 respondentů):

Při týdenním tempu 2–3 PR vychází úspora na 8–15 hodin měsíčně. Za rok přes 100 hodin — na jednoho vývojáře. U týmu pěti lidí to je půl pracovního úvazku ročně.

09Začni tímto týdnem

Nejjednodušší start: vezmi jeden modul, který má nízkou coverage (zkontroluj přes npx jest --coverage), a zadej ho Claude Code s /goal příkazem.

Review výsledky, oprav případné problémy a iteruj. Nepotřebuješ perfektní setup, nepotřebuješ CI/CD integraci hned. Potřebuješ první zkušenost s tím, jak agent funguje v kontextu tvého kódu.

Jakmile uvidíš, jak rychle pokryje modul testy, které by ti trvaly hodiny — zbytek motivace přijde sám.

Pokud ještě nemáš Claude Code Max nebo Team plán, QA automatizace je pravděpodobně ten nejrychlejší ROI ze všech use cases. A pokud ho máš — CLAUDE.md soubor s QA pravidly je to první, co bys měl přidat ještě dnes.