gingiris-opensource

オープンソースマーケティング — GitHub スター獲得システム

🌍 言語 / 语言: English | 中文

スターは、優れたリポジトリがあるだけでは増えません。優れたリポジトリを、適切な開発者に、適切な順序で届けることが大切です。これは、AFFiNE をスター 0 件から 60K 件まで成長させるために使われた段階的な意思決定フレームワークです。

事例番号と引用の参照範囲：references/podcast-evidence.md。

2026 年のローンチ基準（チャネル計画の前に実施）

ポジショニング、クリーンなマシンでのクイックスタート、再現可能な証拠、ライセンス／セキュリティ／プライバシー、対応責任、ビジネスへの転換という 6 つのゲートについて、すべてのインプットを Go、Fix、No-Go に分類します。製品やドキュメントのゲートで失敗した場合、それを配信量の増加で補ってはいけません。

チャネルごとに、次の運用行を 1 つ作成します。

channel | ICP | native angle | CTA | source/UTM | owner | local time + timezone |
success threshold | stop condition | evidence URL

ソースシートのワークフローを、調査、コンテンツ、配信、測定、ローンチ管理の 5 つの連携したビューとして運用します。プラットフォームのルール、価格、アカウントの状態、クリエイターの指標、連絡先リストには日付を記録し、ローンチ週に再確認します。

ファネル全体を追跡します。 impression -> repo visit -> install/quickstart -> activation -> D7 retained -> contribution/qualified lead -> paid。2 時間後は運用上の異常のみを確認し、24 時間後に継続／変更／一時停止を判断し、72 時間後に第 2 波を決め、7 日後に再利用と予算を判断します。ネイティブ指標が利用できない場合は data unavailable と記録し、ビュー数から推測してはいけません。

厳守事項：スターやアカウントを購入しないこと、偽の投票やインセンティブ付きの投票を組織しないこと、有償関係を隠さないこと、非公開データをスクレイピングしないこと、DM やコメントを大量送信しないこと、AI を使って実際のコミュニティ参加を装わないこと。コミュニティへの投稿では所属を明示します。

---

English Version

3 段階のフレームワーク

ステージ 1 — ローンチ前（T-30 → T-0）

• README は英語を第一言語とし、最初の画面を 3 秒未満で理解できるようにします。
• デモ動画は 60 秒以内にし、字幕を付けます。
• ライセンスは慎重に選びます（MIT／Apache-2／AGPL にはそれぞれ注意点があります）。
• 初期メンテナー／コントリビューターを 3～5 名確保します。
• コミュニティチャネルを開設します（Discord または Telegram、英語を第一言語とします）。

ステージ 2 — ローンチ（T-0 → T+14）

• Product Hunt（専用のローンチ手順を実施します）。
• Hacker News Show HN — 火曜日の午前 9 時（ET）、または土曜日。
• Reddit — 関連性の高いサブレディットを3 つ選びます（r/selfhosted、r/programming、特定分野の技術系サブレディット 1 つ）。
• dev.to／Zenn／CSDN に技術的な詳細記事を投稿します。
• 拡散を支援する KOL を 3～5 名選びます（フォロワー数より活動状況を重視します）。

ステージ 3 — 成長（T+14 → T+180）

• 毎週、技術ブログを 1 本公開します。
• GitHub Issues をコンテンツに転換します（ユーザーの質問 → FAQ → 投稿）。
• 月次アップデートを配信します（メーリングリスト + Discord）。
• グローバル展開に向けてローカライズします（まずは日本／韓国）。

スターの地域別分布（診断用であり、Trending のルールではありません）

• 地域分布を使って、配信が想定市場に合っているかを診断します。GitHub は Trending の国別シェアのしきい値を公表していません。
• 過去のプロジェクトの分布は、日付が特定された事例上の証拠であり、普遍的な目標ではありません。
• より細かなベンチマーク（AFFiNE のローンチ前週に VSCode／Vue／AppFlowy を調査）：米国 19～21％、中国 約 19～21％、FR+DE+IT+UK 合計 10～15％。ロシアとブラジルは通常、国別トップ 10 に入ります。初週のスターがこの曲線に沿っていれば、健全なグローバル展開のコールドスタートです。
• ツール：star-history.com（推移グラフ） · oss.cool / OSS Insight（国別内訳、中国の開発者が構築）
• ローンチの順序：ICP、サポート対応範囲、現地のタイムゾーンに基づいて波を選びます。海外を先行させる順序は検証可能な選択肢の 1 つですが、Trending の掲載要件ではありません。
• AFFiNE の実例：初週は WeChat Moments／中国のコミュニティへの投稿を意図的に見送りました。

README の必須要素（チェックリスト）

• 構成：大きなロゴ → ひとこと説明 → バッジ → 短い説明（参考：Dify、Lobechat、AFFiNE）。
• 画面 8 枚以内 — 開発者向けドキュメントは本文に記載せず、別リンクにします。
• 「⭐ スターを促すリマインダー」GIFを追加します（Bilibili の「いいね／コイン／お気に入り」プロンプトと同じ心理効果です。ユーザーにはひと押しが必要です）。
• バックリンクのループ：外部へのリンク（ウェブサイト、ブログ、ドキュメント）にはすべて、目に見える GitHub へのリンクを付けます。戻る経路がないまま、トラフィックを逃がさないようにします。

PR 記事の戦略

• プロジェクトの価値を余すところなく説明する、信頼性の高い記事を 1 本公開します（公式ブログ／Medium／dev.to）。
• 目的：プロジェクトを広めたい人が、そのまま使える紹介文を用意することです。人々は質問せずにそれを使います。
• AFFiNE の事例：ドイツのユーザーが、事前の連絡なしに自発的に 40 以上のフォーラムへ投稿しました。明確な参考記事があったからこそ可能でした。

関係性を重視したアプローチ

• プラットフォームの規約で許可されており、メッセージが個別化され、誠実で、断りやすい場合に限り、関連性のある相手に連絡します。問題について公に話している人や、製品の情報収集を希望している人を優先し、競合のフォロワーを大量にスクレイピングしないでください。
• 過去の反応率やコンバージョン率に関する主張は、日付入りの情報源と、情報源からアクティベーションまでの証拠がない限り、自己申告として扱います。
• ターゲット：競合への不満を積極的に表明しているユーザーです。すでに乗り換える意向があります。

効果的なチャネルの順序

英語 > 多言語 > 中国語のみ。 ターゲットが中国語ユーザーでない限り、英語のプロジェクトをまず中国語圏のコミュニティで公開するのは、最大のチャンスを無駄にします。

アンチパターン（見つけてもらえなくなる行動）

• ❌ スターを不正に増やす — GitHub はすぐに検出します。ペナルティは検索結果から消えることです。
• ❌ Reddit に一度投稿して放置する — コミュニティの反感を買い、BAN されるリスクが高まります。
• ❌ README に絵文字やバッジを使いすぎる — 信頼性が下がります。
• ❌ Show HN を一度きりの投稿として扱う — 1 日を通してすべてのコメントに対応します。

初日向けの最低限のキット（準備期間 1 週間）

準備期間が 1 週間しかない場合（2022-08-03 にオープンソース化した AFFiNE も、まさにその状況でした）は、次の 4 つの素材だけを用意します。

#	素材	基準
1	ひとこと説明のウェブサイト	大きな文字と簡潔な行で構成します。最初の画面に見出し＋サブ見出し＋GitHub リンクを載せます（Vercel 風のオープンソース向けランディングページ）。
2	図解入り README	動画／GIF > 画像 > テキスト。訪問者が 30 秒で何を作っているのか、なぜ作っているのかを理解でき、その後にスターを促す CTA が表示されます。
3	競合比較記事を 1 本	「X はオープンソースの［主要な競合製品］の代替です」— 信頼性の高い記事を 1 本作成し、すべてのチャネルで再利用します。
4	最小限の開発者向けドキュメント	4 ページ：プロジェクトの概要 · 機能 · OS ごとのデプロイガイド（macOS / Windows / Linux） · 貢献方法。粗削りでも構いません。ないよりはあるほうがよいです。

コールドスタート向け 6 ステップ SOP（検証済み：1 週目に約 6,000 スター）

1. 何かを始める前に、成功したオープンソースプロジェクトがどのようにローンチしたかを調べます（AFFiNE は AppFlowy を調査しました）。
2. 図解入り README を公開します（上記のキットを参照）。
3. 「オープンソースの X 代替」ポジショニング記事を公開します。
4. オープンソースの代替製品を扱うディレクトリサイトに掲載を申請します。
5. 比較対象の競合製品をフォローしている Twitter/X ユーザーに DM を送ります。そのファンは、最も的確な初期ユーザー候補です。
6. Reddit と開発者コミュニティに投稿します。

ステップ 3〜6 は同じ日にまとめて実行し、集中的に露出を増やします。その後はフライホイールを回します。

競合製品のローンチ当日をリバースエンジニアリングする（star-history メソッド）

1. star-history.com / OSS Insight で、最も手ごわい競合製品がオープンソース化された正確な日付を確認します。
2. その日／週に絞って Google の詳細検索を行い、相手が投稿したすべての投稿、PR、ディレクトリーへの掲載を再構成します。
3. チャネルのスプレッドシートを作成します（AppFlowy の場合：約40チャネル。opensourcealternative.to などのディレクトリー20以上、Medium / dev.to、開発者フォーラム、Reddit など）。無料／有料のタグを付けます。
4. 直近2〜3年以内にローンチし、手の届く範囲にある競合製品を選びます。8年前からある巨大サービスを分析しないでください。

期待値の設定：SOP をコピーしても1週間で6,000スターを獲得できる保証はありませんが、3か月で1,000〜3,000スターは現実的です。

資金調達のレバレッジとしてのオープンソース（AFFiNE のデータチェーン）

オープンソース化前	オープンソース化後（2022-08-03）
エンジェルラウンド：約12か月で投資家との面談を約400回（自己申告）	1週目：約6,000スター、80％が海外から
	43日目：10,000スター
	ローンチから約1か月後：800万ドルの Pre-A が確定
	24か月：60K以上のスター

• 投資家が評価するのはスターの絶対数ではなく、スターの成長率です。成長の勢いがシグナルになります。
• 投資家はデューデリジェンス中にクローラーを実行し、スターがボットによるものではないか検証する場合があります。クリーンな履歴そのものが資産になります。

収益化の価格テスト（有料製品がまだ存在しない段階で）

• 有料プランを構築する前でも料金ページを公開します。プランの詳細は曖昧なままでもかまいません。各プランに「お問い合わせ」と Typeform を用意します（プラン＋質問＋連絡先情報）。
• AFFiNE の結果：2週間以内に数十件の料金に関する問い合わせがあり、質問は「無料ですか？」から「いくらになりますか？」に変わりました。関心の内訳は、コミュニティ無料プラン約70％／個人向け約20％／チーム向け約10％でした。
• 有料モデルがあることを早い段階でユーザーに伝えます。早く伝えるほど、早くユーザーにその認識が形成されます。「オープンソース＝無料」という固定観念に積極的に対処します。
• 一般ユーザー向けの戦略に移行するに従い、ウェブサイト上の「オープンソース／プライバシー優先」という表現を徐々に減らし、タグラインから「常に無料」を外します（AFFiNE は2023-02に削除しました）。

次に行うこと

• ステージ1が完了 → Product Hunt のローンチ手順を実施します。
• Show HN が成功 → 「<project> github」の SEO モニタリングを追加します。
• コンテンツエンジンが必要 → ブログ執筆のワークフローに進みます。
• 競合の新しい施策を発見 → 競合分析を実施します。

---

中国語版

3段階のフレームワーク

ステージ1 — ローンチ前（T-30 → T-0）

• README は英語をメインにし、最初の画面で3秒以内に内容を理解できるようにします。
• 字幕付きのデモ動画（≤ 60s）を用意します。
• ライセンスを適切に選びます（MIT / Apache-2 / AGPL にはそれぞれ落とし穴があります）。
• 早期参加の maintainer / contributor を3〜5人集めます。
• コミュニティのチャネルを整えます（Discord または Telegram、主に英語）。

ステージ2 — ローンチ（T-0 → T+14）

• Product Hunt（統一された公開手順に従います）。
• Hacker News Show HN — 米国東部時間の火曜日午前9時、または土曜日。
• Reddit — 関連する sub を3つ選びます（r/selfhosted、r/programming、専門技術 sub）。
• dev.to / Zenn / CSDN に技術解説記事を投稿します。
• KOL に3〜5人、シェアを依頼します（フォロワー数よりアクティブ度を重視）。

ステージ3 — 成長（T+14 → T+180）

• 毎週、技術ブログを1本公開します。
• GitHub Issues をコンテンツの素材にします（ユーザーの質問を FAQ にします）。
• 毎月1回、更新情報を配信します（メーリングリスト＋Discord）。
• 海外向けにローカライズします（まずは日本と韓国）。

Star の地域分布と公開時期

• 同一国内／地域からの star の割合を20％以下にします。そうでないと Trending 入りが難しくなります。
• 健全な分布の目安：中国19〜21％、米国19〜21％、残りはヨーロッパ／ロシア／カナダ／インドネシアに分散します。
• より詳細な基準（AFFiNE がオープンソース化する前の1週間に VSCode / Vue / AppFlowy を調査して得たもの）：米国19〜21％、中国約19〜21％、フランス・ドイツ・イタリア・英国の合計10〜15％。Top10 の国には通常、ロシアとブラジルが含まれます。1週目の star 分布がこの曲線に沿っていれば、グローバルなコールドスタートは健全です。
• ツール：star-history.com（増加傾向）· OSS Insight（国別分布、中国人開発者が開発）
• 公開時期：1週目は海外向けの告知のみを行い、2週目になってから国内向けに告知します。順番を逆にすると、分布の比率が崩れます。
• AFFiNE の実例：オープンソース化した最初の週は、意図的に WeChat モーメンツへの投稿や国内コミュニティへの参加をしませんでした。

README の最適化ポイント

• 構成：大きなロゴ＋一言の紹介＋バッジ＋簡潔な説明（Dify / Lobechat / AFFiNE を参考）
• 8画面以内に収めます。開発者向けドキュメントは別リンクにし、README に詰め込みません。
• star を促す小さなアニメーションを追加します（Bilibili の UP 主による「三連打」のようなものです。ユーザーにはリマインドが必要です）。
• バックリンクの循環：外部へのすべてのリンク（公式サイト／ブログ／ドキュメントサイト）から GitHub に戻れるようにします。トラフィックが一方通行にならないようにします。

PR 記事の戦略

• プロジェクトの強みを説明する包括的な記事を用意します（公式サイトのブログ / Medium / dev.to）。
• 目的：プロジェクトの拡散に協力したいすべての人に、そのまま引用でき、自分で紹介文を考えなくて済む材料を提供します。
• AFFiNE の事例：ドイツのユーザーが事前連絡なしに40以上のフォーラムへ投稿しました。参考記事があったからこそ、投稿できたのです。

競合製品の follower にダイレクトメッセージを送る

• 競合製品（Notion / Miro など）の Twitter follower にダイレクトメッセージを送ります。
• 実績データ：数百件のダイレクトメッセージから、数百の star を獲得しました。
• 競合製品への不満を投稿しているユーザーを優先します。すでに乗り換える意思があるためです。

チャネルの順序

英語 > 多言語 > 中国語のみ。 中国語ユーザーがターゲットでない限り、英語のプロジェクトを先に中国語のコミュニティで公開するのは、最も貴重な機会を無駄にすることになります。

アンチパターン

• ❌ star を水増しする（GitHub はすぐに検出するため、検索結果に表示されなくなります）。
• ❌ Reddit に一度だけ投稿して立ち去る（コミュニティの反感を買い、BAN されやすくなります）。
• ❌ README に絵文字やバッジを使いすぎる（信頼性が下がります）。
• ❌ Show HN を一度きりの投稿と考える（コメントへの返信に丸一日かかります）。

2026年の実験記録とエコシステムでの配信

• チャネルで施策を行うたびに、実験記録を1行残します：日付 / 仮説 / チャネル / 素材 / UTM / 24h結果 / 7d結果 / 次のステップ。Star は先行指標としてのみ扱い、インストール、初回の正常な実行、再訪、支払い意向も確認します。
• README、デモ動画、最短で実行できる手順は、ひと続きのアクティベーション導線です。どのステップも3分を超える場合は、トラフィックを増やす前にアクティベーションを改善します。
• プロジェクトを、実際に関連性のある Awesome Lists、パッケージマネージャー、テンプレートマーケットプレイス、上流・下流の連携ディレクトリに登録します。サイトごとの投稿ルールを守り、無差別に投稿したり、リンクを購入したりしません。
• 事例の数値には日付、サンプルの範囲、self-reported または検証可能な情報源を明記し、過去のプラットフォームの傾向を恒久的なアルゴリズム上の事実として記載しないようにします。

オープンソース公開 Day One の4点セット（一週間の準備期間に揃える最小限のもの）

準備期間が一週間しかない場合（AFFiNE の2022-08-03のオープンソース公開もこのペースでした）は、次の4つだけを用意します。

#	資産	基準
1	一言で伝える公式サイト	文字を大きく、行間を広くします。ファーストビューにはメインタイトル＋サブタイトル＋GitHub リンクだけを掲載します（Vercel のようなオープンソース公式サイトを参考にします）
2	画像や動画を取り入れた README	動画やGIFを載せられるなら載せ、難しければ画像を載せます。30秒以内に価値が伝わり、star を付けるよう直接促します
3	競合製品と比較する記事	「X is an open source [頭部競品] alternative」——信頼性の高い記事を1本作成し、すべてのチャネルで再利用します
4	最小限の開発者向けドキュメント	4本：私たちについて · 機能紹介 · システム別のデプロイ方法（macOS / Windows / Linux）· コントリビューションへの参加方法。粗削りでも構いません。ないよりはある方がよいです

オープンソースのコールドスタート6ステップ SOP（実績：最初の1週間で約6,000 star）

1. 成功した先行プロジェクトがどのようにオープンソース公開したかを調べてから着手します（AFFiNE は AppFlowy を参考にしました）。
2. 画像や動画を取り入れた README を用意します（上記の4点セットを参照）。
3. 「私は XXX のオープンソース代替です」という位置付けの記事を投稿します。
4. open-source-alternative 系のディレクトリサイトに登録します。
5. 競合製品の Twitter/X フォロワーに個別メッセージを送ります。競合製品のフォロワーは、最も精度の高い初期ユーザー候補です。
6. Reddit や開発者コミュニティに投稿します。

ステップ3〜6は1日のうちにまとめて実施し、認知度を高めたら、フライホイールが回るのを待ちます。

star-history を使った競合のオープンソース公開日の逆算

1. star-history.com / OSS Insight で、最も強力な競合製品のオープンソース公開日を調べます。
2. Google の高度な検索でその日または週に絞り込み、競合製品が当日に投稿したすべての投稿、PR、ディレクトリサイトへの登録を再現します。
3. チャネルの一覧表を作成します（AppFlowy の事例では約40チャネル：opensourcealternative.to などのディレクトリサイト20件以上、Medium / dev.to、開発者フォーラム、Reddit）。無料か有料かも記載します。
4. 直近2〜3年以内に公開され、規模が「手を伸ばせば届く」競合製品を選びます。8年前の巨大企業を分析するのは避けます。

期待値の管理：SOP をそのまま実行しても、1週間で6,000 star を獲得できる保証はありません。ただし、3か月で1,000〜3,000 star を獲得するのは比較的容易です。

オープンソース公開を資金調達につなげる（AFFiNE のデータ推移）

オープンソース公開前	オープンソース公開後（2022-08-03）
エンジェルラウンド：投資家約400人と面談し、約12か月を費やしました（本人の証言に基づく数値）	最初の1週間：約6,000 star、その80%は海外から
	43日目：1万 star を突破
	オープンソース公開から約1か月後：800万ドルの Pre-A を確保
	24か月：60K+ star

• 投資家が本当に評価するのは、star の絶対数ではなく star の増加速度 です。速度こそがシグナルです。
• 投資家はデューデリジェンスの際、star の水増しがないかを検証するクローラーを作る場合があります。クリーンな履歴そのものが資産になります。

商用化に向けた価格設定テスト（有料版ができていなくても実施できます）

• 商用版ができていなくても、先に価格ページを公開します。プランの内容は曖昧でも構いません。各プランに「お問い合わせ」と typeform を設けます（プラン選択＋質問＋連絡先）。
• AFFiNE の結果：2週間で価格を問い合わせる人が数十人いました。問い合わせの内容は「無料ですか」から「だいたいいくらですか」に変わりました。意向の割合は約70%がコミュニティ版の無料プラン、20%が個人版、10%がチーム版でした。
• 有料プランがあることを早い段階でユーザーに伝えます。早く伝えるほど、ユーザーは早く支払いを意識するようになります。「オープンソース＝無料」という固定観念に積極的に対処します。
• 一般ユーザー向けに戦略を転換した後、公式サイトでは「open source / privacy-first」の表記を徐々に小さくし、タグラインから「always free」を削除しました（AFFiNE は2023-02に変更）。

---

By Iris (生姜 Iris) · ex-COO @ AFFiNE (0 → 60k★) · Install: npx skills add Gingiris-1031/gingiris-opensource

海外進出コミュニティへの参加と資料パックの購入 · Community & Resources

• 海外進出コミュニティへの参加： WeChat で staywildgrow を追加し、「コミュニティへの参加」とメッセージを送ってください。

• 資料パックの購入： WeChat で staywildgrow を追加し、Gingiris 海外進出資料パックの購入についてお問い合わせください。価格は 599 元 です。

• 海外成長コミュニティへの参加： WeChat で staywildgrow を追加し、「加入社群」（コミュニティへの参加）と送信してください。

• 資料パックの購入： WeChat で staywildgrow を追加し、Gingiris 海外成長資料パックを 599 CNY で購入してください。

コミュニティと資料パックは任意です。このオープンソース Skill のインストールや使用には影響しません。

コミュニティと有料の資料パックは任意です。オープンソースのこの Skill のインストールや使用に必要なものではありません。