BuyWhere
← Back to documentation

developer_growth_ops

Developer Growth Ops Runbook

Owner: Reach Issue: BUY-2040 Prepared: 2026-04-16

This runbook shows the minimum operator loop for developer outreach tracking.

Files

  • Tracker: docs/social/developer_growth_tracking_template.csv
  • Relationship tracker: docs/social/developer_relationship_tracker.csv
  • Weekly report template: docs/social/developer_growth_weekly_report_template.md
  • Weekly report generator: scripts/developer_growth_weekly_report.py
  • Logging CLI: scripts/developer_growth_log.py
  • Validation CLI: scripts/developer_growth_validate.py
  • Weekly wrapper: scripts/run_developer_growth_weekly.sh

Daily Operator Loop

  1. Execute one or more outreach contributions on the target channels from:
    • docs/social/developer_growth_outreach_pack.md
    • docs/social/developer_growth_target_matrix.md
  2. Log every contribution with the logging CLI.
  3. Log every meaningful developer contact or follow-up in the relationship tracker.
  4. At the end of the week, generate the markdown report.

Log A Contribution

python3 scripts/developer_growth_log.py contribution \
  --date 2026-04-16 \
  --channel Discord \
  --community-or-account "LangChain" \
  --post-type reply \
  --url-or-thread "https://example.com/thread" \
  --utm-source discord \
  --utm-medium community \
  --utm-campaign developer-growth-apr16 \
  --topic-or-hook "shopping agents need retrieval" \
  --cta-target "https://api.buywhere.ai/docs" \
  --clicks 7 \
  --replies 2 \
  --notes "strong technical response"

Use --impressions, --dm-count, and --api-key-signups when those numbers are available.

Log A Developer Relationship

python3 scripts/developer_growth_log.py relationship \
  --date-added 2026-04-16 \
  --developer-name "Jane Doe" \
  --platform Discord \
  --profile-or-thread-url "https://example.com/jane" \
  --audience-fit high \
  --interest-area MCP \
  --status discovered \
  --last-interaction-date 2026-04-16 \
  --last-interaction-summary "Asked for hosted MCP details" \
  --next-action "Send MCP guide after reply" \
  --next-action-date 2026-04-17 \
  --owner Reach

Suggested status values:

  • discovered
  • engaged
  • follow_up_due
  • active
  • converted
  • stalled

Generate The Weekly Report

python3 scripts/developer_growth_weekly_report.py \
  --start 2026-04-14 \
  --end 2026-04-20

Default output:

  • docs/social/developer_growth_weekly_report_generated.md

One-Command Weekly Run

./scripts/run_developer_growth_weekly.sh 2026-04-14 2026-04-20

This runs validation first, then generates the weekly report.

Safe Testing

Test the logging CLI against temp tracker copies instead of the real CSVs:

tmpdir=$(mktemp -d)
cp docs/social/developer_growth_tracking_template.csv "$tmpdir/tracking.csv"
cp docs/social/developer_relationship_tracker.csv "$tmpdir/relationships.csv"

python3 scripts/developer_growth_log.py \
  --tracking-csv "$tmpdir/tracking.csv" \
  contribution \
  --date 2026-04-16 \
  --channel Discord \
  --community-or-account "LangChain" \
  --post-type reply \
  --url-or-thread "https://example.com/thread" \
  --utm-source discord \
  --utm-medium community \
  --utm-campaign developer-growth-apr16 \
  --topic-or-hook "shopping agents need retrieval" \
  --cta-target "https://api.buywhere.ai/docs"

Current Blocker

This workflow is ready for use, but execution on Discord, Reddit, X, Dev.to, Hashnode, and Product Hunt still depends on authenticated account access outside this environment.