ppt-deck-qa-gate

name	ppt-deck-qa-gate
description	Use when independently reviewing workflow sequence, rendered editable PowerPoint slides, or final decks for process compliance, visual fidelity, content consistency with accepted storyboards, and PASS/BLOCKED gate decisions.

PPT Deck QA Gate

Role

Act as an independent reviewer for workflow sequence, a rendered slide, or a final deck. The lead builder cannot use this skill to self-approve its own work.

Workflow Audit Inputs

• package folder tree or artifact list
• source_audit.md
• slide_plan.md
• storyboard/visual_style_spec.md
• storyboard/storyboard_contact_sheet.png
• storyboard/storyboard_index.md
• storyboard/storyboard_freeze.md
• qa/page_gate.md
• per-slide specs, storyboards, prompts, manifests, previews, object audits, and review files
• any command/tool log or notes showing whether Presentations, PowerPoint, artifact-tool, JSX authoring, or direct PPT authoring was used

Workflow Audit Checks

• editable-ppt-orchestrator was the lead controller for high-quality editable deck production.
• No Presentations, PowerPoint, artifact-tool, JSX authoring, or direct PPT authoring was used before source audit, slide plan, visual style spec, imagegen storyboard, and image-to-editable conversion were established.
• Presentations, PowerPoint, LibreOffice, or artifact-tool usage was limited to rendering previews, inspection, final merge, export, or QA evidence after conversion.
• The deck follows this order: slide specs -> full-deck imagegen storyboard batch -> storyboard contact sheet -> storyboard review -> storyboard freeze -> slide-by-slide element-level image-to-editable conversion -> true render -> object audit -> visual review -> content review -> PASS.
• Editable conversion did not start before all planned storyboard images, the contact sheet, the storyboard index, and the freeze file existed.
• Imagegen was not called after storyboard freeze unless the user explicitly approved unfreezing and replacing a storyboard image.
• No next conversion slide started before the current converted slide reached PASS.
• No slide is PASS without required artifacts and independent review files.
• No lead self-approval is used as PASS evidence.

Workflow audit output files:

• qa/workflow_audit_by_agent.md before per-slide PASS, or qa/workflow_audit.md only when agents are unavailable and the user accepts non-agent review.
• qa/final_workflow_audit_by_agent.md before final delivery, or qa/final_workflow_audit.md only when agents are unavailable and the user accepts non-agent review.

Use this format:

review_type: workflow
scope: slide XX | deck
decision: PASS | FAIL | BLOCKED
blocking_issues:
- ...
required_fix:
- ...
notes:
- ...

Mandatory Render Evidence

Visual PASS requires a true PowerPoint, LibreOffice, or Presentations render. If only a manifest, object count, HTML approximation, or synthetic preview exists, return FAIL or BLOCKED.

Per-Slide Visual Inputs

• storyboard/slide_XX.png
• previews/slide_XX.png
• manifests/slide_XX_conversion.json
• qa/slide_XX_object_audit.json
• crop/source assets if relevant

Per-Slide Content Inputs

• source_audit.md
• slide_plan.md
• slide_specs/slide_XX.md
• storyboard/slide_XX.png
• previews/slide_XX.png
• relevant source materials

Visual Fidelity Checks

• rendered preview matches storyboard in layout, hierarchy, scale, colors, margins, and density
• ordinary text/numbers and only the simplest lines/boxes were rebuilt natively; stylized icons, badges, styled arrows, charts, tables, plots, diagrams, complex panels, figures, logos, screenshots, and decorative visuals are complete independent crops unless the user explicitly requested deeper native editability
• no clipped text, legends, captions, icons, axes, arrows, borders, figures, colorbars, shadows, glows, or antialiasing
• no unintended crop overlap, hidden text, text overflow, crop residue, duplicated crop padding, or cropped page edge
• picture crops are granular and meaningful, not broad section screenshots
• picture crops are tracked through a human-auditable inventory with meaningful names, roles, source_bbox, and display_bbox
• no dense anonymous fragment set is used as the primary conversion strategy
• every external-source asset in the manifest has source proof and a valid reason
• no full-slide screenshot or broad structural crop is used
• icons and visual details did not become unrelated placeholders, generic replacements, or simplified redraws
• external source images are not distorted

Content QA Checks

• visible text, labels, numbers, captions, callouts, and chart/table text in the PPT preview match the accepted imagegen storyboard
• no visible content is added, removed, reworded, renumbered, or relabeled during editable conversion
• numbers, units, formulas, metrics, method names, baselines, captions, and claims that appear in the PPT match the accepted storyboard
• charts/tables in the PPT match the accepted storyboard
• no unsupported factual claim is introduced during conversion

Per-Slide Output Files

Write one or both as needed:

• qa/slide_XX_visual_review_by_agent.md
• qa/slide_XX_content_review_by_agent.md

Use this exact format:

slide: XX
review_type: visual | content
decision: PASS | FAIL | BLOCKED
blocking_issues:
- ...
required_fix:
- ...
notes:
- ...

If PASS, use `blocking_issues:

• noneandrequired_fix:
• none`.

Page Gate Rules

Update qa/page_gate.md after each stage transition. Mark a slide PASS only if:

• workflow audit is PASS for the current slide or deck state
• full storyboard set was frozen before conversion
• storyboard review is PASS
• visual review is PASS
• content review is PASS
• all required artifacts exist
• true render evidence exists
• all reviews have no blocking issues

If any condition fails, mark FAIL_REVISING or BLOCKED.

Final Deck Review

After merging only PASS slides, independently review the final deck.

Required inputs:

• final/*.pptx
• previews/contact_sheet.png
• all accepted per-slide previews and QA files
• slide_plan.md
• source_audit.md

Required final outputs:

• qa/final_deck_visual_review_by_agent.md
• qa/final_deck_content_review_by_agent.md
• qa/final_gate.md

Final deck PASS requires:

• final workflow audit returns PASS
• all slides present and ordered according to slide_plan.md
• slide size and style are consistent
• no new clipping or layout regression after merge
• final visible content matches the accepted storyboards
• no placeholder text or unsupported claim appears
• both final deck reviews return PASS