AlexandrAI AGENTS.md
agents-md

Gumroad Social Shorts Publisher Agent Guide

Project-specific AGENTS.md guidance for the Gumroad social shorts publisher role, upload metadata, platform gates, manual-first publishing, and no-bulk-posting boundaries.

AGENTS.md

Guidance for coding agents working on the Gumroad social shorts publisher role.

Project Overview

The social shorts publisher prepares upload-ready metadata for YouTube Shorts and TikTok after the local Gumroad product short passes QA. The default is manual-first: metadata and checklist are prepared, but no platform upload happens without explicit owner approval and credentials.

Source Files

  • agents/social-shorts-publisher.md defines the role.
  • skills/social-shorts-publisher/SKILL.md defines output files and upload policy.
  • marketing/shorts//qa_report.json must pass before upload preparation is final.
  • marketing/shorts//youtube_metadata.json stores YouTube title, description, and tags.
  • marketing/shorts//tiktok_caption.txt stores TikTok caption.
  • marketing/shorts//upload_checklist.md stores manual upload steps.
  • marketing/shorts//-.mp4 is the local video.
  • marketing/shorts//captions.srt and voiceover assets support review.

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

  • Verify shorts QA passed before upload-ready status.
  • Verify MP4, captions, metadata, caption text, and upload checklist exist.
  • Prepare manual upload instructions by default.
  • Do not upload to YouTube, TikTok, or any social platform without explicit owner approval.
  • Do not run bulk upload loops.
  • Do not invent analytics, clicks, watch time, buyer response, sales, or campaign results.
  • Keep captions non-hard-sell and claim-safe.
  • Add API publishing only as a scoped script with dry-run and single-upload guards when owner credentials and approval exist.

Manual Upload Gate

Before upload, verify the video is vertical, duration matches the plan, captions are readable, voiceover exists or silent draft is intentionally accepted, product URL is correct, and no fake urgency or guaranteed outcomes appear in metadata.

Verification

Run shorts QA and inspect the upload checklist. The owner should be able to review account, thumbnail frame, caption, and platform preview before public posting.

Security Notes

Do not store platform credentials in metadata, captions, or checklist files. Do not publish private account ids, tokens, local absolute paths, buyer data, or unapproved social account details.

PR Checklist

  • Shorts QA passed.
  • Metadata files exist.
  • Manual upload checklist exists.
  • No auto-posting occurs without explicit approval.
  • Claims and CTA match the product.