AlexandrAI AGENTS.md
agents-md

Gumroad Hyperframe Video Producer Agent Guide

Project-specific AGENTS.md guidance for the Gumroad Hyperframe video producer role, vertical trailer package, scene timing, real assets, layout safety, and local fallback rendering.

AGENTS.md

Guidance for coding agents working on the Gumroad Hyperframe video producer role.

Project Overview

The Hyperframe video producer prepares a vertical product trailer package from real Gumroad product assets. It creates or verifies scene timing, asset order, captions, voiceover notes, frame outputs, render brief, and local MP4 fallback when external Hyperframe access is unavailable.

Source Files

  • agents/hyperframe-video-producer.md defines the role.
  • skills/hyperframe-shorts-producer/SKILL.md defines scene, asset, and fallback rules.
  • scripts/shorts_artifacts.py creates plans, frames, local renders, and QA inputs.
  • marketing/shorts//hyperframe_brief.md is the handoff brief.
  • marketing/shorts//frames/ stores rendered frames.
  • marketing/shorts//-.mp4 is the local video output when rendered.

Setup Commands

bashUV_LINK_MODE=copy UV_PROJECT_ENVIRONMENT="$HOME/.cache/gumroad-codex-agent-venv" uv run python scripts/shorts_artifacts.py plan products/<slug>
UV_LINK_MODE=copy UV_PROJECT_ENVIRONMENT="$HOME/.cache/gumroad-codex-agent-venv" uv run python scripts/shorts_artifacts.py render products/<slug> --tts edge
UV_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

  • Use the real cover and preview images wherever possible.
  • Build at least 8 visual scenes with different layouts or motion cues.
  • Keep total duration at the campaign duration from the manifest.
  • Use professional scene language: cold open, handoff log, scattered inputs, artifact reveal, proof badges, process timeline, payoff, and end card.
  • Do not accept a static slideshow as final.
  • Do not use zoom-in effects on document or product previews.
  • Keep text zones and product-image zones separate with visible whitespace.
  • Avoid fake dashboards, fake reviews, fake sales counts, generated icon packs, floating symbols, and illegible AI text.
  • If Hyperframe access is unavailable, produce the render brief and local MP4 package instead of pretending an external upload happened.

Verification

Run shorts QA and inspect the MP4 when rendered. Confirm dimensions, duration, captions, product URL, scene count, layout separation, and non-hard-sell language.

Security Notes

Do not include credentials, private account ids, local absolute paths, buyer data, hidden media URLs, fake performance claims, or unapproved platform tokens in render briefs or metadata.

PR Checklist

  • Real product assets are used.
  • Scene count and duration match the manifest.
  • Text does not overlap product imagery.
  • Render brief exists.
  • Local fallback is honest when Hyperframe access is unavailable.