← Back to documentation

BUY-2773_operator_posting_brief

BUY-2773 Operator Posting Brief

Prepared: 2026-04-17 Owner: Reach Issue: BUY-2773

Objective

Ship the BuyWhere 1M product catalog milestone into two high-signal technical communities:

  • Hacker News via Show HN or Ask HN
  • Reddit via r/LocalLLaMA or r/MachineLearning

This brief exists so a credentialed operator can execute without re-planning.

Source Assets

Hypotheses

  1. A milestone post framed as a retrieval-infrastructure problem, not a launch announcement, will generate higher-quality technical discussion than a product-led post.
  2. Hacker News should deliver the strongest mix of clickthrough and product feedback from agent builders.
  3. Reddit should produce fewer clicks than HN, but more detailed objections that can be reused in docs, FAQ, and follow-up content.

Primary Metrics

  • HN clickthroughs to docs URL with utm_campaign=buy2773-milestone-apr17
  • Reddit clickthroughs to docs URL with utm_campaign=buy2773-milestone-apr17
  • Comment count and quality
  • API key signups attributable to the campaign

Success Thresholds

  • Minimum success in 72 hours:
    • 150 combined tracked clicks
    • 10 combined comments/replies
    • 3 API key signups
  • Strong success in 7 days:
    • 400 combined tracked clicks
    • 20 combined comments/replies
    • 10 API key signups

Timing

  • Hacker News:
    • Preferred window: 9-11 AM SGT
    • Fallback: next weekday in the same window
  • Reddit:
    • Preferred window: 8-10 PM SGT
    • Post after HN so any strong framing from HN comments can tighten the Reddit version

Channel Decision Rules

  • Use Show HN first if the operator is comfortable posting under the product identity.
  • Use Ask HN if a discussion-first posture feels safer than a launch-style post.
  • Use r/LocalLLaMA before r/MachineLearning unless subreddit rules or current mood make promotion risk too high.
  • Skip the Reddit post entirely that day if the top page is hostile to product posts or moderation risk looks elevated.

Operator Checklist

  1. Re-read the chosen draft and remove any claim you cannot defend in replies.
  2. Confirm the live CTA targets load:
    • https://api.buywhere.ai/docs?utm_source=hackernews&utm_medium=community&utm_campaign=buy2773-milestone-apr17
    • https://api.buywhere.ai/docs?utm_source=reddit&utm_medium=community&utm_campaign=buy2773-milestone-apr17
  3. Publish the HN post.
  4. Save the final HN URL into the execution log and issue comment.
  5. Watch the first 60 minutes closely and reply to real technical questions.
  6. Publish the Reddit post in the preferred evening window.
  7. Save the final Reddit URL into the execution log and issue comment.
  8. Record 24-hour and 72-hour metrics in the issue thread.

Reply Guidance

  • Lead with retrieval/data quality specifics, not brand claims.
  • If asked about coverage, keep the scope precise: Singapore + Southeast Asia for this milestone.
  • If asked about US scale, say that is a separate milestone and not the claim of this post.
  • If challenged on scraping vs APIs, acknowledge mixed data collection realities and focus on the normalized agent-facing interface.
  • If a thread turns hostile to promotion, stop pushing links and answer only technical questions.

Close Condition

BUY-2773 can move to done after:

  • at least one HN submission and one Reddit submission are published or explicitly attempted,
  • final URLs are logged back into the issue,
  • first-pass metrics are captured,
  • and any immediate follow-up questions are answered or triaged.

Until then, this issue should remain blocked if no authenticated operator can post.