merch-qa

Visual quality gate for all merch output — inspects mockups, sticker files, and print files using Claude vision before delivery. Blocks on critical failures, flags warnings. Every merch pipeline skill calls this before presenting output.

Model	Source
sonnet	pack: merch

Overview

Visual self-inspection agent called by every pipeline skill (printful-pod, sticker-forge, premium-gear). Receives generated image/file + product type → evaluates against product-specific checklist → returns pass/fail per criterion with confidence scores → blocks delivery if critical criteria fail.

Full Reference

┏━ 🔍 merch-qa ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Visual QA gate — inspecting merch output         ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Overview

Visual self-inspection agent called by every pipeline skill (printful-pod, sticker-forge, premium-gear). Receives generated image/file + product type → evaluates against product-specific checklist → returns pass/fail per criterion with confidence scores → blocks delivery if critical criteria fail.

Quick Reference

Property	Value
mode	read + Claude vision
output	QA report
integration	called by printful-pod, sticker-forge, premium-gear
severity levels	CRITICAL blocks · WARNING flags

Reference Index

File	Contents
reference/checklists.md	Full product-specific QA checklists — sticker, apparel mockup, apparel print, general

How It Works

1. Receive file path + product type from calling skill
2. Use Claude vision to inspect the output image/file
3. Evaluate against product-specific checklist
4. Score each criterion (pass/fail + confidence 0–100%)
5. Generate QA report with verdict (PASS/FAIL/WARN)

Severity Levels

CRITICAL — blocks delivery, sends back for revision. The output cannot be delivered until the criterion is resolved. Calling skill must surface the failure to the user and halt pipeline.

WARNING — flags but allows delivery with note. Output can proceed but the user must be informed. Calling skill appends warnings to its output summary.

Report Format

┏━ 🔍 merch-qa ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ QA Report: sticker-forge output                  ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Verdict: ✓ PASS (2 warnings)

CRITICAL
✓ Transparent background confirmed
✓ Resolution: 300 DPI at 4x4" (1200x1200px)
✓ Cut path follows design contour
✓ No text in bleed zone

WARNING
⚠ CMYK color shift ~8% on saturated red — verify with manufacturer
⚠ Fine detail on antennae may be lost below 2" print size

Verdict values:

• ✓ PASS — all critical criteria pass (warnings may be present)
• ✗ FAIL — one or more critical criteria failed (delivery blocked)
• ◐ WARN — all critical pass but warnings require user acknowledgment

Integration

Pipeline skills invoke this gate before presenting any output to the user:

1. Pass the output file path and product type to this skill
2. Receive the QA report
3. Check the verdict:
   • FAIL → surface the critical failures, do not present the output, request revision
   • PASS or WARN → present the output to the user; append warnings if any

# Example invocation pattern (from calling skill)
file_path: /path/to/output.png
product_type: sticker | apparel_mockup | apparel_print

All three pipeline skills (printful-pod, sticker-forge, premium-gear) call this skill as the final step before delivery. No merch output reaches the user without passing this gate.