AlexandrAI AGENTS.md
agents-md

Gumroad Shorts QA Manager Agent Guide

Project-specific AGENTS.md guidance for the Gumroad shorts QA manager role, deterministic video QA, manual review, dimensions, captions, real proof, and launch-ready blockers.

AGENTS.md

Guidance for coding agents working on the Gumroad shorts QA manager role.

Project Overview

The shorts QA manager validates a Gumroad launch short before it is treated as launch-ready. It checks published-product proof, manifest completeness, script and captions, storyboard scene count, video dimensions and duration, real product asset usage, layout safety, and claim boundaries.

Source Files

  • agents/shorts-qa-manager.md defines the role.
  • skills/shorts-video-qa/SKILL.md defines deterministic and manual QA.
  • scripts/shorts_artifacts.py qa writes qa_report.json.
  • marketing/shorts//shorts_manifest.json defines plan and outputs.
  • marketing/shorts//trailer_script.md, captions.srt, storyboard.csv, hyperframe_brief.md, and MP4 are checked.
  • gumroad_result.json proves publication.

Setup Commands

bashUV_LINK_MODE=copy UV_PROJECT_ENVIRONMENT="$HOME/.cache/gumroad-codex-agent-venv" uv run python scripts/shorts_artifacts.py qa products/<slug>

Change Rules For Agents

  • Block launch-ready status when the product is not published.
  • Require manifest, script, voiceover text, captions, storyboard, and render brief.
  • Require at least 8 scenes or cuts.
  • Require vertical mobile video dimensions when rendered.
  • Require captions.
  • Reject hard-sell language, fake scarcity, fake reviews, fake social proof, fake results, and guaranteed outcomes.
  • Reject generic AI icon visuals when real product assets should be shown.
  • Reject static slideshow pacing.
  • Reject text that overlaps product screenshots, covers, preview cards, card shadows, URLs, or CTA text.

Manual QA

Watch the output. The first few seconds should create curiosity, not a generic ad intro. Captions must match voiceover. Visuals should show actual product assets and claims must stay inside the Gumroad page and files.

Verification

Run the QA command and inspect marketing/shorts/<campaign>/qa_report.json. Treat passed deterministic QA as necessary, then complete manual review before launch-ready status.

Security Notes

Do not expose private ids, credentials, local absolute paths, buyer data, fake metrics, or unpublished URLs in video metadata or scripts.

PR Checklist

  • Published product proof exists.
  • Deterministic shorts QA passes.
  • Manual watch review passes.
  • Claims match product files.
  • Launch-ready status is blocked when any core evidence is missing.