mcpField
C
community-building-playbook

community-building-playbook

github.com/gingiris-1031Marketing & growth87152 installsUpdated 2w ago
Repository

About community-building-playbook

A practical playbook for teams planning developer or user communities and ambassador programs. It combines readiness checks, setup procedures, event guidance, and examples drawn from named companies.

Key features

  1. 01Community readiness checklist
  2. 02Seven-step community setup
  3. 03Ambassador tiers and contribution points
  4. 04Event formats and operating procedures
  5. 05Retention signals and engagement cadence

Use cases

  1. 01Assessing whether a product is ready for a community program
  2. 02Setting up community channels and operating routines
  3. 03Designing ambassador recruitment and rewards
  4. 04Planning online workshops or local meetups

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/gingiris-1031/gingiris-skills --skill community-building-playbook

After installing, type/community-building-playbookin Claude Code to confirm it loaded.

Bundled filesreferences/benchmarks.mdreferences/templates.md

Details

From the project README

Community Building Playbook — Developer & User Community Growth

Real-world frameworks distilled from Notion, Lovable ($50M ARR in 6 months via CLG), AFFiNE (0→60K GitHub Stars), ClickUp, Asana, and Lark's global community operations. Read references/benchmarks.md for deep dives into each case study when you need them.


The Core Principle

You cannot build a community. You can only create the conditions for one to form.

The flywheel: Great Product → Organic Love → Self-Generated Content → Community Formation → Ambassador Identification → Ambassador Enablement → More Content + Events → More Users → Repeat.

Every failure to build community traces back to one of two mistakes: starting too early (pre-PMF), or treating community as a distribution channel rather than a mutual-value ecosystem.


Phase 0: Are You Ready?

Before any community program, run this checklist. If more than two items are unchecked, stop and build product.

  • Internal team uses own product daily (Notion's commercial readiness signal — they waited until 2016 to start)
  • Product has a usable core loop (create → use → share works smoothly)
  • You can share something (templates, tutorials, roadmap direction, or user cases)
  • Someone owns community full-time (even 20% of one person's time counts)
  • You can handle inbound (someone reads and responds to community posts within 24h)

The stage decision:

StageSuitable?Strategy
Pre-PMF❌ Not yetFind 50–100 deep users, do 1-on-1 interviews, collect feedback
Post-PMF, early growth⚠️ Cautiously5–10 seed ambassadors, zero KPIs, completely free
Stable growth✅ Full programFormal ambassador system with tiers, points, events
Market leader✅ Full investmentEcosystem network, Affiliate commissions, regional leads

Notion's timeline: Product usable in 2016 → Database launch in 2018 → Founder Ivan starts 1-on-1 with active contributors in 2019 → Official ambassador program in 2020. Four years. Don't rush.


Part 1: Community Setup SOP (7 Steps)

Step 1: Choose Your Platform
PlatformBest ForNotes
DiscordDeveloper/open-source communitiesChannel categorization, Bot ecosystem, real-time
SlackInternational professional communities (Notion, Asana model)Mature, efficient for ambassador channels
Lark/FeishuAsian-market communities, product deeply boundOfficial direct operation
TelegramFast reach, regional groupsMessages bury quickly
Facebook/LinkedIn GroupsRegional consumer communitiesEasy local discovery

If a community already exists in your space, reach out to the admin about collaborating before creating a competing group.

Step 2: Write Your Welcome Post Template
👋 Welcome to [Community Name]!

[One sentence: what the brand does + why this community exists]

🔗 Official links:
- Product: [link]
- Docs/Help: [link]

📋 Community rules:
1. No unauthorized ads
2. Respect everyone — no personal attacks
3. Verify before sharing
4. [Brand-specific rule]
Step 3: Set Admin Standards

Minimum viable admin:

  • 3+ content posts per week (events, product news, user stories)
  • Respond to questions within 24h
  • Invite 10+ new members per week
  • Handle rule violations promptly
Step 4: Set Up Brand Monitoring (CRITICAL)

Notion built a crawler that auto-detects all tweets mentioning the brand and pushes internal notifications. You don't need a crawler on day one, but the behavior is the same: follow and respond to every single person who posts about your product.

Key insight from Notion ambassador Linmi: "One ordinary user consistently posting is worth more than a KOL posting once." Official follow + repost of every brand mention is the highest-ROI social action in early community building.

Set this up now:

  • Brand24 or Mention.com for web monitoring
  • Manual Twitter/X search for brand name daily (until you can automate)
  • When you find someone posting → follow + repost + DM to invite to community
Step 5: Build a Community Wiki
PageContent
Events CalendarUpcoming events (embed from Luma/Notion)
Tutorial LibraryNative-language tutorials, help docs
Member DirectoryVoluntary member database for collaboration
Landing PagePublic welcome page for newcomers
Step 6: Set Baseline Metrics
MetricSeed Phase TargetGrowth Phase Target
Total members50500+
Weekly active rate≥30%≥20%
Content posts/week≥3Daily
Q&A response time≤24h≤4h
Events/month12–4
Step 7: Distribute Everywhere on Launch
  • Invite every existing user personally
  • DM competitors' followers on Twitter/LinkedIn (Notion/ClickUp users = your ICP)
  • Post to relevant subreddits (r/SaaS, r/productivity, r/programmingg — follow community rules)
  • LinkedIn posts + targeted DMs to potential members in target industries
  • Local professional forums and groups

Part 2: Ambassador Program Design

The True Nature of an Ambassador Program

From Notion ambassador Linmi's insider interview: "Ambassadors are free outsourcing. Surface has values packaging, core is win-win."

Ambassadors become KOLs and build monetizable businesses through spreading your product. You get community content, user education, regional penetration, and brand risk transfer. Both sides must win or it collapses.

Ambassador motivations (ranked by actual impact from Notion data):

  1. Product is genuinely good — prerequisite for everything else; no amount of incentive compensates for a weak product
  2. Beta/gray release priority — ambassadors feel like insiders, experience new features first
  3. Direct founder dialogue — Ivan's 1-on-1 meetings with active Notion contributors in 2019 was the single most cited motivator
  4. Help ambassadors become KOLs — official repost, community announcements, showcasing their content
  5. Official follows and reposts everything — making every ordinary creator feel recognized
Ambassador Entry Standards (Notion: must satisfy A AND B)
RequirementDescription
A: Event organization abilityCan organize offline meetups, has local connections
B: Content production abilityVideo creation OR written tutorials OR template creation (any one)

Maintain high standards. Notion's active ambassador rate is ~25% of enrolled ambassadors — this is normal. Don't lower standards chasing headcount.

The 4-Tier System
TierAnnual PointsCore Benefits
BronzeAuto on entryOfficial recognition, community badge, product news
Silver≥100 pts/yearBeta access, official social media repost
Gold≥300 pts/year1-on-1 with official team, invited to annual events
Platinum≥600 pts/yearCustomized support, annual awards, event sponsorship

Points Matrix:

ContributionPointsNotes
Twitter/X post tagging brand5 ptsMust @official account
Tutorial article20 pts≥1000 words with real steps
Video tutorial30 ptsAny platform, ≥3 min with demo
Community Q&A (marked best answer)3 ptsQuality filter
Valid bug report10 ptsConfirmed and fixed
Organize local event50 ptsPrior approval required
Translation of docs/UI15 ptsPer page, must pass review
Invite new active user5 ptsMust become active
Ambassador Benefits (Notion-Validated)
BenefitNotion PracticeUniversal Template
Tool accessFree Personal Pro + Notion AI (1 year)Pro tier access
Event support$200 event fee + $150 transportBudget-dependent subsidy
Founder dialogueIvan did 1-on-1s personally in 2019Regular Town Hall Q&A
Monetization supportHelp ambassadors take Fiverr/Upwork template ordersOfficial recommendation + brand endorsement
Career endorsementAmbassador badge + certificationLinkedIn recommendation
Content exposureAnnounce outstanding ambassadors in communityOfficial multi-channel promotion
Ambassador Recruitment Application (Required Fields)

Design your Typeform/form with: Name, email, location, social media links, "Why do you love [brand]?", contribution types interested in, how they plan to contribute, weekly time available, event organization experience, content creation experience + links.

Reference application: https://6dxre9ihosp.typeform.com/to/CLw1pUAp

Onboarding a New Ambassador
TimelineActionOwner
Within 3 business daysReview applicationCommunity ops
On approvalWelcome email + handbook + resource linksCommunity ops
Week 1Invite to ambassador-exclusive channelCommunity ops
Week 130-min 1-on-1 video call to understand goalsAmbassador lead
After 1-on-1Share product roadmap (aspirational OK, but must deliver)Product team
After 1-on-1Assign first task matching ambassador typeAmbassador lead
Day 30Check-in: review contributions, give feedbackCommunity ops
Weekly Ambassador Engagement (Notion's "Ambassador Seminar" Pattern)

Notion's Slack has different channels where they schedule one seminar per week or two weeks. 10–20 people, no fixed topic, free exchange. They also post cats/dogs/memes to maintain atmosphere. No fixed topic is intentional — it keeps it feeling like community, not obligation.

Churn Warning Signals
SignalResponse
No contributions for 2 monthsPrivate check-in message
Content quality decliningShare content creation resources
Feeling undervaluedArrange 1-on-1 call, repost their content
Retention Rhythm
  • Monthly: Community newsletter (product updates + ambassador spotlights)
  • Quarterly: Ambassador-only online call (casual, no agenda required)
  • Bi-annually: Official team personally reaches out to key ambassadors
  • Annually: Ambassador gala + awards ceremony
Annual Awards
AwardCriteria
Most Active AmbassadorHighest annual points
Best Content CreatorHighest value content output
Best LocalizationHighest quality translation volume
Best Bug HunterMost confirmed bugs
Best Community BuilderMost new members + most events
Best InnovationMost impactful product suggestion adopted

Part 3: Community Event SOP

Event Types
TypeScaleFrequencyPurpose
Online Workshop20–1001–2x/monthProduct education, user activation
AMAUnlimited1x/quarterFounder trust-building
User Case Sharing50–2001x/monthSocial proof, UGC
Ambassador Seminar10–20Weekly/bi-weeklyAmbassador peer learning
Local Meetup10–50As neededRegional deep connections
HackathonUnlimitedEvery 6 monthsInnovation, UGC output
Event SOP (3 Phases)

Phase 1 — Setup (at least 3 weeks before)

  1. Confirm date and venue (ask community members if they can host — free venue)
  2. Submit event form to official team: https://bytedance.larkoffice.com/share/base/form/shrcnww1MbaxwOKngVDsEh4zQOe
  3. Design poster in Canva (include: date, location, community QR code, registration link)
  4. Publish to Luma/Eventbrite/Meetup/Peatix
  5. Post everywhere: LinkedIn, Facebook, Twitter, community channels

Recommended event structure (1–2 hours):

  • Warm-up (Slido poll: "How many tools in your workflow?")
  • Lark/brand intro video if needed
  • User case presentation (15–20 min)
  • Key feature training (20–30 min)
  • Group discussion (15–20 min)
  • Group photo

Phase 2 — During

  • Full rehearsal before start
  • Take photos and videos throughout
  • Post real-time to community + social media
  • Invite all attendees to join the local community (don't skip this)

Phase 3 — After

  • Verify attendees joined the community (the single most important post-event action)
  • Post event summary + review questionnaire to community
  • Edit long video → YouTube Shorts
  • Post recap (photos + text) on Twitter/Facebook/LinkedIn
  • Archive everything — every piece of content should be repurposed

Event Checklist:

  • Date and venue confirmed
  • Event form submitted
  • Structure confirmed
  • Poster designed
  • Published to event platforms
  • Posted link everywhere
  • Social media posts scheduled
  • Rehearsed
  • Event recorded
  • Post-event summary and social recap done
  • Links shared to community channels

Part 4: Content Strategy

The Build-in-Public Post Framework

For product updates and feature announcements, structure posts with:

For Product Previews: What are you introducing? What's the impact? Any direction changes? CTA: Are you looking for feedback?

For Design Previews: What is the feature? What design choices were made and why? CTA: Which do you prefer?

For Dev Feature Previews: Feature name, user benefit in one sentence, GIF/video of how to use it, where to access it (insider sneak peek / testing / live).

Keep it honest and specific. "We shipped X and it helps you do Y in Z seconds" beats "We're excited to announce..."

Content Type Weights (Data-Validated from 200 Tweets)
TypePriorityNotes
Long-form story/case study⭐⭐⭐⭐⭐Highest engagement and retention
Tutorial/how-to⭐⭐⭐⭐High bookmark rate
Thread (8+ points)⭐⭐⭐Use when multiple independent insights
User case/social proof⭐⭐⭐⭐Trust-building
Pure philosophy/quotes⭐Data shows consistently low performance — avoid
Platform Distribution Matrix
PlatformUser TypeFormat
Twitter/XBuilders, indie devs, tech foundersLong-form, threads, real data
LinkedInEnterprise buyers, B2BCase studies, ROI data
YouTube/TikTokBroad audienceTutorial videos, demos
RedditDevelopers, enthusiastsAuthentic discussion, no hard promotion
HackerNewsTechnical buildersOnly launch/Show HN — must be genuine

Part 5: PLG + CLG Growth Models

Lovable's CLG Flywheel ($50M ARR, 6 months)

The core mechanic: Remix. Every free user's project is public and remixable. Every remix is a product demo. Free tier = projects must be public = every free user is an advertisement.

Key data: 100,000+ Discord members, 85% subscription retention, 67% of users have almost no programming experience, 21.22M monthly traffic vs. competitors at 5–6M.

To replicate the pattern:

  1. Build a product-level viral mechanic (share, remix, fork, duplicate)
  2. Free tier that requires public-facing output → fuels UGC
  3. Discord/community as primary retention mechanism (social lock-in)
  4. "Built with [Brand]" branding on free outputs → free distribution
AFFiNE's Open Source Community Flywheel
  • Day 1 strategy: Simultaneous posting to r/producthunt, r/SaaS, r/Entrepreneur
  • 24h rule: Team members respond to every single comment within 24 hours
  • 1-week follow-up: Post a recap/thank-you post that builds long-term relationship
  • Result: 3–4M effective traffic from Reddit, ~5–8% Star conversion rate
ClickUp's PLG Metrics
  • CAC:LTV = 1:3 (healthy PLG benchmark)
  • Daily blog posts (16 internal authors + external contributors)
  • Zapier integration drove +170% growth
  • Onboarding activation + monetization activation as two separate metrics

Part 6: Community Health Dashboard

Operating SLA and safety gate
  • Publish who owns onboarding, moderation, events, support, and escalation; an “official community” without named owners becomes an unmanaged support queue.
  • Set a visible first-response SLA (default: within 24 hours; faster for security/payment issues), then track resolution time and unanswered-thread rate.
  • Measure the funnel from join → first meaningful action → week-2 return → contribution/referral, not raw member count.
  • Ban coordinated voting, fake accounts, undisclosed promotion, harassment, and attempts to evade platform enforcement. Preserve consent for member quotes and case studies.

Track weekly/monthly:

CategoryMetricTarget
GrowthNew members / month≥15% MoM
ActivityWAU / total members≥20–30%
ContentUGC posts / week≥10
SupportAvg response time≤24h
EventsEvents / month≥1
AmbassadorActive ambassadors (≥10 pts/month)≥20
AmbassadorActive rate (vs enrolled)≥25% (Notion benchmark)
AmbassadorContent coverage≥60% of active ambassadors

Tool Stack

CategoryTools
Community platformDiscord, Slack, Lark, Telegram
EventsLuma, Peatix, Eventbrite, Meetup
Live interactionSlido
DesignCanva
Brand monitoringBrand24, Mention
AffiliateRewardful
Ambassador applicationsTypeform
VideoYouTube, TikTok, Loom, Screen Studio
SEOAhrefs
Ambassador monetizationFiverr, Upwork, Udemy, Gumroad
AnalyticsLark Bitable, custom dashboards

Reference Files

加入出海社群与购买资料包 · Community & Resources

  • 加入出海社群: 微信添加 staywildgrow,留言「加入社群」即可。

  • 购买资料包: 微信添加 staywildgrow,咨询购买 Gingiris 出海资料包,价格 599 元人民币。

  • Join the global growth community: Add staywildgrow on WeChat and send “加入社群” (join the community).

  • Get the resource pack: Add staywildgrow on WeChat to purchase the Gingiris global growth resource pack for CNY 599.

社群与资料包为可选入口,不影响本开源 Skill 的安装和使用。

The community and paid resource pack are optional; neither is required to install or use this open-source skill.

Comments

Markdown supported