---
name: swarm-qa
description: >
  کارزار کامل «سوارم کیوای» روی یک محصول زنده با متد چهار فازی: ممیزی استاتیک سوارمی کد، کیوای عمیق زنده، سوارم فیکس، و کیوای تأیید نهایی. با چک‌پوینت روی دیسک و گزارش تاریخ‌دار. Use when the user says "سوارم کیوای", "سوارم", "swarm qa", "/swarm-qa", "کیوای کامل بزن", or asks for a full multi-agent QA campaign over a live stack. Not for a quick single-page check.
---

# swarm-qa: کیوای سوارمی چهار فازی

هدف: همان مأموریتی که قبلا هر بار با یک پرامپت ده‌هزار کاراکتری ساخته می‌شد، حالا با یک کلمه. تو ارکستراتور هستی: قضاوت و طراحی با تو، اجرای گسترده با ایجنت‌های Sonnet، بررسی عمیق با Opus.

## پیش‌پرواز
1. اول `.claude/swarm-qa.local.md` پروژه را بخوان (فرمت پایین). هرچه آنجا هست دوباره نپرس.
2. کمبودها را در یک پرسش batched بگیر: آدرس‌ها و استک، منبع کردهای تست (فقط مسیر فایل یا نام env؛ مقدار سیکرت هرگز در چت تکرار نشود)، سقف‌های همزمانی (پیش‌فرض: مرورگر 1، کال‌های سنگین 8)، فایل known-issues، و دامنهٔ ممنوعه.
3. کانفیگ نهایی را در همان فایل ذخیره کن تا دفعهٔ بعد پرسش صفر شود.

## قوانین سخت (در همهٔ فازها)
- مرورگر یک surface مشترک است: همیشه فقط یک ایجنت مرورگر زنده. فن‌اوت وسیع فقط برای کار read-only و کد و API.
- دادهٔ پروداکشن read-mostly است. نوشتن فقط روی دادهٔ تست مشخص‌شده.
- بیلد و دیپلوی فقط روی سرور، نه لپ‌تاپ. بعد از هر دیپلوی smoke test و چک locale.
- سشن‌ها و پروسه‌های زندهٔ کاربر هرگز kill یا overwrite نمی‌شوند.
- هیچ ادعای «انجام شد» بدون verify واقعی (نه استاب).

## چهار فاز (با ابزار Workflow؛ هر فاز یک ورک‌فلوی جدا تا بین فازها در جریان بمانی)
1. ممیزی استاتیک: سوارم گستردهٔ Sonnet روی خود کد، بدون مرورگر. هر ایجنت یک برش عمودی: auth، پرداخت، فرم‌ها، i18n و RTL، پرفورمنس، امنیت. خروجی: یافته‌های حدسی با اسکیمای پایین.
2. کیوای زنده: ایجنت‌های کم‌تعداد اما عمیق (Opus) روی محصول واقعی. لاین مرورگر سریالی. فلوهای اصلی کاربر تا انتها (ورود تا خرید). یافته‌های فاز 1 را هم راستی‌آزمایی کن.
3. سوارم فیکس: فقط یافته‌های تأییدشدهٔ P0 تا P2. هر یافته یک ایجنت فیکس؛ در صورت برخورد فایل‌ها worktree ایزوله. ship small: هر فیکس کامیت جدا.
4. تأیید نهایی: ایجنت‌های verify مستقل، هر فیکس در محیط واقعی، رگرشن‌چک فلوهای اصلی. اگر رد شد، یافته دوباره باز می‌شود و به فاز 3 برمی‌گردد.

## اسکیمای یافته (خروجی ساخت‌یافتهٔ همهٔ ایجنت‌ها)
`{surface, flow, severity: P0|P1|P2|P3, symptom, repro, evidence, root_cause, is_regression}`

## چک‌پوینت و تاب‌آوری
- مسیر کارزار: `reports/swarm-qa/<YYYY-MM-DD>/`. بعد از هر فاز و هر 10 یافته `checkpoint.json` آپدیت شود.
- بعد از قطعی: اول checkpoint و `resumeFromRunId` ورک‌فلو. هیچ فازی از صفر تکرار نمی‌شود.

## خروجی نهایی
گزارش مارک‌داون تاریخ‌دار + پوشهٔ evidence (اسکرین‌شات‌ها) + جمع‌بندی فارسی به‌صورت کارت readable: شمار یافته‌ها به تفکیک severity و وضعیت فیکس هرکدام.

## قواعد ثابت
بدون ایموجی و بدون خط‌تیرهٔ بلند در همهٔ خروجی‌ها. زبان سادهٔ فارسی در گزارش نهایی. هیچ وابستگی جدید نصب نشود.

## فرمت `.claude/swarm-qa.local.md`
```markdown
---
stack: dana
urls: [https://example.com]
creds: .env.qa
browser_lane: 1
heavy_cap: 8
known_issues: docs/known-issues.md
no_touch: [db:prod, sessions:live]
---
```