AlexandrAI AGENTS.md
agents-md

Gumroad Discount Manager Agent Guide

Project-specific AGENTS.md guidance for the Gumroad discount manager role, explicit coupon campaigns, sale URLs, manual expiry, campaign records, and anti-scarcity rules.

AGENTS.md

Guidance for coding agents working on the Gumroad discount manager role.

Project Overview

The discount manager handles account-mutating coupon and sale-campaign work only after products are already published and only when the owner explicitly asks. It can plan, apply, verify, show, update, or end bounded campaigns through the local script.

Source Files

  • agents/gumroad-discount-manager.md defines the role.
  • skills/gumroad-discount-manager/SKILL.md defines hard rules and campaign workflow.
  • scripts/gumroad_discount_manager.py performs plan, apply, status, and end operations.
  • research/discount-campaigns// stores campaign manifests and records.
  • roadmap/product-roadmap.md receives dated notes when campaign results change store operations.

Setup Commands

bashpython3 scripts/gumroad_discount_manager.py plan --campaign <campaign> --code <CODE> --percent-off <PERCENT> --start-date <YYYY-MM-DD> --end-date <YYYY-MM-DD>
python3 scripts/gumroad_discount_manager.py apply --campaign <campaign> --code <CODE> --percent-off <PERCENT> --start-date <YYYY-MM-DD> --end-date <YYYY-MM-DD>
python3 scripts/gumroad_discount_manager.py status --campaign <campaign>
python3 scripts/gumroad_discount_manager.py end --campaign <campaign>

Use apply and end only when owner intent is explicit.

Change Rules For Agents

  • Do not create cron jobs, background services, or automatic expiry loops.
  • Do not change product prices when the owner requested coupon-style discounting.
  • Do not claim automatic expiry unless the CLI exposes and verifies that capability.
  • Treat discount-applied sale URLs as first-class outputs.
  • Tell buyers whether the sale is automatic or requires a code based on verified behavior.
  • Use concrete visible dates supplied by the campaign plan.
  • Do not use fake scarcity, fake countdowns, or invented demand pressure.
  • Preserve campaign manifests under research/discount-campaigns/.

Verification

Run status after apply. Verify affected products, active code, visible copy, retired legacy codes, sale URLs, manifest path, and the manual end command.

Security Notes

Do not publish account credentials, private CLI state, private buyer data, unpublished products, or hidden campaign internals. Public sale copy should be honest and dated.

PR Checklist

  • Owner explicitly requested the campaign.
  • Plan exists before apply.
  • Campaign manifest records affected products and sale URLs.
  • Expiry behavior is manual unless verified otherwise.
  • End command is reported.