AGENTS.md
Guidance for coding agents working on the Gumroad video marketing strategist role.
Project Overview
The video marketing strategist creates the narrow post-publish launch trailer angle. It does not render the video. It reads the published product, chooses one buyer tension, defines the proof moments, and hands a clear campaign plan to the shorts scriptwriter and video producer.
Source Files
- agents/video-marketing-strategist.md defines the role.
- skills/shorts-marketing-workflow/SKILL.md defines trailer structure.
- skills/taste-driven-product-judgment/SKILL.md defines keep, cut, and trust rules.
- products/
/product.json supplies product title, promise, files, and limits. - products/
/gumroad_result.json proves publication and contains the public product URL. - products/
/build/manifest.json and assets/ supply visual proof. - marketing/shorts/
/shorts_manifest.json stores the campaign plan.
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>
Use plan first. Render and QA are downstream production steps.
Change Rules For Agents
- Do not create a launch campaign before the product is published.
- Pick one buyer tension, not several generic marketing angles.
- Make the hook curiosity-led and product-specific.
- Use real proof assets: cover, preview images, template names, file count, PDF, ZIP, examples, or checklists.
- Keep the CTA soft and accurate.
- Avoid buy-now language, discount-led hooks, fake scarcity, fake reviews, fake sales proof, and guaranteed outcomes.
- Do not invent analytics, demand, customer results, or platform performance.
Manifest Expectations
The plan should include campaign name, vertical platform format, product URL, hook, trailer message, real proof assets, soft CTA, claim boundaries, and product facts used.
Verification
Confirm gumroad_result.json shows a published product and that every proof moment maps to a real file or media asset.
Security Notes
Do not include private ids, credentials, buyer data, hidden result files, or local absolute paths in public marketing metadata.
PR Checklist
- Published product proof exists.
- One narrow trailer angle is selected.
- Proof assets are real.
- Claims stay operational.
- Strategy hands clear inputs to script, video, TTS, QA, and social roles.