技術要約：GitHub テンプレートリポジトリ：対象ドメイン、メンテナンス、および実務家向けガイドライン

問題提起

GitHub は長らくフォークやプルリクエストを通じてコード共有をサポートしてきましたが、テンプレートリポジトリ（2019年に導入）は、スキャフォールディング（雛形生成）を通じて新しいプロジェクトを生成するための、より明確なメカニズムを提供しています。これらが利用可能であるにもかかわらず、以下の点に関する経験的な知見には大きな空白が存在します：

1. これらのテンプレートがどのようなドメインを対象としているか。
2. 再利用可能なアーティファクトとしてのメンテナンス特性と信頼性。
3. 効果的なテンプレート設計と採用を導く慣行と落とし穴。

フォークが協調的な進化を促進するのに対し、テンプレートは初期プロジェクトのセットアップを加速させることを目的としています。しかし、その普及度、品質、および使用パターンを理解しなければ、実務家や研究者は、これらのアーティファクトを効果的に設計、評価、または進化させるための指針を得ることができません。

メソドロジー

著者らは、GitHub で最も広く使用されている 5 つのプログラミング言語（TypeScript、Python、JavaScript、Java、C#）にわたる大規模な経験的研究を実施しました。研究は 3 つの研究質問（RQ）で構成され、厳格なデータ収集および分析パイプラインに従って行われました。

1. データ収集とフィルタリング

• ソース: GitHub Search API。
• 特定戦略: 著者らは、キーワードベースのヒューリスティック（例：「boilerplate」、「starter」）よりも包括的な、文書化されていない template:true パラメータを発見し、検証しました。
• フィルタリング: リポジトリは、アクティブであり、アーカイブされておらず、フォークではなく、公開されており、かつ 2 つ以上のスターを持つものに限定されました。
• サンプルサイズ: 合計 14,780 のリポジトリをマイニングし、言語固有のフィルタリングおよび非英語の除去後、ドメイン分析（RQ1）には 12,818、メンテナンス分析（RQ2/3）には 13,381 を保持しました。

2. 研究質問 1: ドメインと所有権

• アプローチ: プロジェクトの説明、トピック、および README に基づいてリポジトリをドメイン別に自動分類するために、LLM-as-a-judge 戦略（DeepSeek-V3.2 を使用）を採用しました。
• 検証: Python プロジェクト 100 件の目視分析を通じてタクソノミー（分類体系）を較正しました。LLM の性能は、192 件のリポジトリに対する人間による合意に基づくグラウンドトゥルースと比較され、85.4% の一致（Cohen's $\kappa$ = 0.82）を達成しました。
• 所有権分析: メタデータを抽出して、個人所有と組織所有を区別しました。

3. 研究質問 2: メンテナンスと信頼性

• ツール: テンプレートのスナップショットに対して静的解析を行い、コードの不吉な臭い（code smells）、バグ、セキュリティホットスポット、および脆弱性を検出するために SonarQube を使用しました。
• 統計分析: リポジトリの特性（スター、フォーク、経過年数、最近のコミット、所有権）と品質問題の関連性を分析するために、負の二項回帰モデルを使用しました。指標はリポジトリのサイズ（KLOC）によって正規化されました。
• 補正: 複数のテストにわたる偽発見率を制御するために、ベンジャミニ・ホックバーグ補正を適用しました。

4. 研究質問 3: ガイドラインと落とし穴

• 定性的分析: 品質スコア（最高、最低、および混合）に基づいた層化抽出サンプルを選択し、詳細な定性的調査を行いました。
• プロセス: 2 人の研究者がサンプルを独立して分析し、繰り返し現れるパターンを特定して、ガイドライン（ベストプラクティス）と落とし穴（一般的な誤り）へと集約しました。
• LLM による検証: 著者らは、LLM がこれらのガイドラインへの準拠を評価する際に人間の判断を近似できるかどうかをテストし、中程度の合意（$\kappa$ = 0.46）を確認しました。

主な結果

1. ドメインと所有権 (RQ1)

• 支配的なドメイン: Web 開発は、すべてのエコシステムにおいて主要なドメインです（例：TypeScript では 67.7%、JavaScript では 52%）。
• 言語による専門化:
  • Python は最も多才であり、機械学習/AI テンプレートが高い集中を示すものを含め、すべてのドメインを幅広くカバーしています。
  • C# と Java は、ゲーム開発との強い関連性を示しています。
  • TypeScript と JavaScript は、Web 開発に強く集中しています。
• 所有権: テンプレートの約 3 分の 2 は個人ユーザーによって所有されており、残りは組織によって所有されています。組織は標準化に焦点を当てる傾向がある一方、個人はオープンソースコミュニティへの貢献やベストプラクティスの提示を目的とする傾向があります。

2. メンテナンスと品質 (RQ2)

• 問題の分布: 品質問題は希薄であり、高度に偏っています。少数のリポジトリが大部分のバグや脆弱性を抱えています。言語ごとに、約 39～54% のテンプレートが問題ゼロの状態です。
• エコシステム依存性: リポジトリの特性と品質を結びつける普遍的なパターンは存在しません。
  • JavaScript/TypeScript: フォーク数が多いほど、問題が多くなる傾向があります（正の相関）。
  • Python: フォーク数が多いほど、バグが少なくなる傾向があります（負の相関）。
  • 所有権: 組織所有のテンプレートは、一部の言語（Java、C# など）では問題密度がわずかに低いものの、他の言語（TypeScript のバグなど）では高くなる場合もあり、所有権が均一な品質シグナルではないことを示しています。
• 活動量: 最近のコミット活動は問題数との間にわずかな関連しか示さず、人気や最近の活動自体がテンプレートの信頼性の弱い予測因子であることを示唆しています。

3. ガイドラインと落とし穴 (RQ3)

本研究では 7 つのガイドラインと 5 つの落とし穴を導き出しました。

ガイドライン:

• G1: メンテナンスの実践（CI/CD、リンティング、テスト）を統合すること。
• G2: 包括的でアクセシブルなドキュメントを提供すること（多言語サポートを含む）。
• G3: 「Use this template」機能の使用についてユーザーに明示的に教育すること（直接のクローンを避けるため）。
• G4: ロードマップを通じて進化を伝えること。
• G5: テンプレートを再利用可能なファミリーとして構成すること（コアから派生したバリアントを作成する）。
• G6: テクノロジーのバージョンをリリースと一致させること。
• G7: コミュニティのサポート（Discord、スポンサーシップなど）を推奨すること。

落とし穴:

• P1: 適切なスキャフォールディングを行わずに、完全な実装をそのままテンプレートとして流用すること。
• P2: 不透明または非アクティブなリポジトリの状態（アーカイブ化や廃止の通知の失敗）。
• P3: 単一のリポジトリ内に複数の異なるテンプレートを混在させること。
• P4: テクノロジーの実装に関する懸念と、テンプレートのスキャフォールディングを混同すること。
• P5: 空のテンプレート、またはドキュメントの欠如。

意義と貢献

本論文は、ソフトウェアエンジニアリング・コミュニティに対して以下の貢献を謳っています：

1. 経験的な洞察: GitHub テンプレートの初の大規模な特性評価を行い、Web 開発が主要なユースケースであること、およびメンテナンスの品質は一様ではなくエコシステムに依存することを明らかにしました。
2. 実行可能なガイダンス: 実務家がアドホックな作成を超えて、高品質なテンプレートを設計、選択、維持するための具体的なガイドラインと落とし穴を提供します。
3. データセットの公開: 著者らは上位 5 つのプログラミング言語をカバーするデータセットを公開しており、将来の研究を可能にします。
4. 研究者への示唆: テンプレートは完全な進化するプロジェクトではなくスキャフォールディングであるため、一般的なソフトウェア開発の慣行を分析する際には、テンプレートをフィルタリングして除外すべきであると警告しています。
5. GitHub への示唆: 現在の文書化されていないパラメータへの依存はバイアスを生じさせるため、将来のマイニング研究の再現性を高めるために、GitHub はテンプレートに対する公式の API サポートとメタデータを提供すべきであると提案しています。

本研究は、テンプレートを単なる静的なプロジェクトスターターではなく、下流のプロジェクトへの技術的負債の伝播を防ぐために、能動的なメンテナンスとバージョニングを必要とする上流の再利用可能なアーティファクトとして扱うべきであると結論付けています。