paw-cra-quality-control

# Quality Control ## Overview This workflow aggregates quality control across all produced visual and video assets in a campaign, then generates a pass/fail report with revision tickets for anything that needs rework. Act as a meticulous QA lead who understands both brand standards and platform technical requirements. **Args:** Accepts `--headless` / `-H` for autonomous execution against a campaign folder. **Output:** `qa-report.md` with per-asset pass/fail verdicts, severity-rated issues, and revision tickets routed back to owning production workflows. **Key distinction:** This is campaign-level cross-asset QC. Individual production workflows (Designer, Video Producer) already have embedded per-asset review gates. This workflow aggregates those results and adds cross-asset consistency checking that no single production workflow can do alone --- verifying that all campaign assets feel like a cohesive set. ## On Activation Load available config from `{project-root}/.pawbytes/config/config.yaml` and `{project-root}/.pawbytes/config/config.user.yaml` (root level and `cra` section). If config is missing, let the user know `paw-cra-setup` can configure the module at any time. Resolve and apply throughout the session (defaults in parens): - `{user_name}` (null) --- address the user by name - `{communication_language}` (English) --- use for all communications - `{document_output_language}` (English) --- use for generated document content - `{output_directory}` (`.pawbytes/creative-suites`) --- base output path Load shared agency memory from `{project-root}/.pawbytes/creative-suites/index.md`. Identify the active brand and campaign. Load brand guidelines from `.pawbytes/creative-suites/brands/{brand-name}/guidelines.md`. **Campaign folder resolution:** Accept a campaign folder path as argument, or infer from the active campaign in memory. The campaign folder is expected at `.pawbytes/creative-suites/brands/{brand-name}/campaigns/{campaign-name}/` or `.pawbytes/creative-suites/campaigns/{campaign-name}/`. If no campaign can be resolved, ask the user. If `--headless` or `-H` is passed, run the full pipeline without interaction: collect assets, run all QC checks, generate report, route results. Otherwise, greet the user, confirm the target campaign, and proceed through the stages below. Offer a summary of what will be checked before starting. ## Stages This workflow progresses through four stages. Each stage writes findings to the in-progress `qa-report.md` using the document-as-cache pattern for compaction survival. | Stage | Purpose | Reference | |-------|---------|-----------| | 1. Asset Collection | Scan campaign folder, discover all manifests and assets | Load `./references/01-asset-collection.md` | | 2. Per-Asset QC | Visual checks, video checks, brand compliance per asset | Load `./references/02-per-asset-qc.md` | | 3. Cross-Asset Consistency | Verify cohesion across the full campaign asset set | Load `./references/03-cross-asset-consistency.md` | | 4. Report & Route | Generate final report, create revision tickets, update status | Load `./references/04-report-and-route.md` | ## Severity Model All issues use a three-tier severity: | Severity | Meaning | Effect | |----------|---------|--------| | **Critical** | Asset is unusable or off-brand --- wrong dimensions, broken file, wrong logo, unreadable text | Asset fails. Revision ticket created. | | **Warning** | Asset is usable but suboptimal --- slight color drift, audio slightly hot, missing optional metadata | Asset passes with note. Revision recommended. | | **Info** | Observation or suggestion --- could improve but not a quality gate issue | Logged for reference. No revision ticket. | An asset **passes** if it has zero critical issues. A campaign is **QC-approved** only when all assets pass. ## Manifest Types Production workflows emit these manifest files. This workflow reads all of them: | Manifest | Producer | Contains | |----------|----------|----------| | `design-manifest.json` | Designer workflows | Image assets, dimensions, format, brand colors used | | `video-manifest.json` | Video Producer workflows | Video assets, codec, resolution, duration, subtitle status | | `clip-manifest.json` | `paw-cra-video-clips` | Extracted clips with reframing and platform targets | | `batch-manifest.json` | `paw-cra-design-batch` | Batch-produced visual assets with content calendar mapping |