💻 システム開発

GitHub_導入計画

最終更新 2026年06月03日／ 31_システム開発部/GitHub_導入計画.md

GitHub 導入計画（SCALE 22サービス）

退化問題の根絶 + 22サービス並列開発の安全化 + Claude Code 連携強化
SCALE 全システムを GitHub Organization scale-group に集約する実行計画。

30秒で全体像

観点	一言
核心	22サービス + 4エンジニア + ゲンカイ + Claude Code の体制で、Git未導入は限界
キーワード	scale-group Org / Cloudflare Pages自動デプロイ / PRレビュー / 退化禁止
期日感	今月中に Phase 0-2 完了、来月で全社展開
コスト	当面 Free（無料） / 必要時 Team $4/user/月
動機	2026-05-13 X炎上事例（開発会社がGitコミット開示拒否）+ 大串の社内体制強化

結論：絶対やるべき3つの理由

22サービス並行 + 4エンジニア + ゲンカイ + Claude Code = 衝突事故が起きてる前提の体制
CLAUDE.mdに「機能追加するたびに過去verに戻る」と書いてある = 退化問題が頻発してる証拠
tar.gzバックアップ + changelog.ts手動運用 = Gitなら全部自動化される

→ 遅らせるほど移行コストが上がる。22サービスが30になったら倍大変。

メリット（SCALE固有の効果）

A. 退化問題の根絶

今	GitHub後
「機能追加で過去verに戻る」が頻発	`git revert` で即ロールバック・絶対戻らない
「誰がいつ何を変えたか」不明	`git log` で全部見える
過去FB対応コードが上書きされる	`git diff` で差分検知・PRレビューで止まる
tar.gz手動バックアップ忘れる	Git = 自動で全履歴保存（バックアップ不要）

B. エンジニア並列体制の安全化

今	GitHub後
4エンジニアが同じファイル触ると後勝ち	コンフリクト検知 → マージで衝突解決
「今誰が何を触ってるか」不明	PR一覧で全員の進行中作業が可視化
Claude Code と人間が同時編集して衝突	AI作業ロックスクリプト不要（Gitが自動制御）
エンジニア辞めたらコード行方不明	GitHubに全部残ってる

C. 経営者目線の透明性

今	GitHub後
エンジニアの作業量わからない	コミット数・PR数で定量化
「ちゃんと作業してる？」が不明	毎日のコミットで一目瞭然
外注時の品質チェック手段なし	コミットメッセージ・コードレビューで判定
22サービスの全体把握困難	GitHub Org の Dashboard で一覧

D. SCALE固有の効果

メリット	効果
changelog.ts 自動生成	Git commit から自動でユーザー向けchangelogを生成可能
Cloudflare Pages 自動デプロイ	GitHub連携で `git push` → 自動デプロイ（今の手動デプロイ廃止）
Claude Code との相性最強	Claude Code が Git操作前提で設計されてる
退化禁止フロー自動化	PR必須化 + レビュー必須化で人為的退化を防げる
AI作業ロック不要に	Gitのブランチ機能で衝突防止が組み込まれる

デメリット（正直に）

A. 学習コスト

対象	コスト
大串本人	5時間で実用レベル（経営者用語だけならもっと早い）
エンジニア4名	既にGit使ってる前提で発注すべき。使えないなら採用ミス
ゲンカイ	AIエージェントだから即対応可
非エンジニアメンバー	学習不要（GitHub見るだけならボタン操作）

→ 結論: 大串が5時間使えば、後は流れる。

B. 月額コスト

プラン	価格	SCALEの場合
Free	無料	プライベートリポジトリ無制限・3人まで協力者OK
Team	$4/user/月（約¥600）	5〜10人で使うなら ¥3,000〜¥6,000/月
Enterprise	$21/user/月	必要なし

→ 当面 Free → 必要時 Team へ。年間 ¥72,000 程度。手動バックアップ事故1回防ぐだけで元取れる。

C. 機密情報の漏洩リスク

漏洩物	対策
API キー（Claude API、Cloudflare等）	`.gitignore` で `.env` を除外（初回設定で済む）
パスワード	同上
顧客データ	コードに直書きしない（Supabase/D1からfetch）
経営情報	プライベートリポジトリなら外部から見えない

→ 初期設定さえ間違えなければ問題なし。.gitignore テンプレ作って全リポジトリで使い回す。

D. 既存システム移行作業

22サービス分の移行作業：

項目	工数
1サービスあたり	30分〜1時間（git init + push + 設定）
22サービス合計	15〜20時間（1日で終わる規模）
Cloudflare Pages 連携設定	+5分/サービス

→ Claude Code に丸投げすれば1日で終わる。

SCALE現状の問題点 vs GitHub解決例

退化問題（実例ベース）

今の問題:
「SCALE Base の v9.155 で過去版に戻った」
→ check-current-state.sh で機械チェック必要
→ CLAUDE.md に最新スタンプ手動更新必要

GitHub導入後:
git log --oneline で「最新コミットがどれか」が常に明確
→ 戻りようがない
→ チェックスクリプト不要

バックアップ問題

今:
tar.gz 手動バックアップ
→ ファイル名で管理（pre-deploy / post-deploy）
→ Drive容量を圧迫
→ 古いの削除タイミング不明

GitHub導入後:
全変更が自動で履歴に残る
→ 任意の過去時点に1コマンドで戻せる
→ tar.gz 完全廃止可能

Claude Code との連携

今:
~/.claude/commands/backup.md でtar.gz作成
~/.claude/commands/handoff.md で changelog.ts追記

GitHub導入後:
Claude Code が git commit して push するだけ
→ 全部Git任せ
→ コマンドも簡素化

導入Phase（4 Phase・実所要時間で）

Phase 0: 準備（30分・今日できる）

1. github.com にアクセス → アカウント作成（個人アカウント）
2. メールアドレス: y-ogushi@scale-group.co.jp
3. 個人アカウント名: ogushi-yuuki または scale-yogushi
4. 二要素認証（2FA）を必ず有効化
5. Profile設定（写真・bio）

→ 個人アカウント = 大串のオーナー権限を握る器。Organization作るための前提。

Phase 1: Organization作成（30分）

1. GitHub右上「+」→「New organization」
2. プラン: Free選択
3. Organization名: scale-group（or株式会社SCALE的な名前）
4. メールアドレス: y-ogushi@scale-group.co.jp
5. ビジネスタイプ: My personal account（後でTeam化）
6. メンバー招待は後回しでOK

→ これで scale-group という会社アカウントが完成。22サービス全部ここに集約。

Phase 2: パイロット導入（1日・SCALE Baseで試す）

最も活発な SCALE Base で先にやる：

# 1. ローカルに移動
cd "/Users/oogushiyuuki/Library/CloudStorage/GoogleDrive-y-ogushi@scale-group.co.jp/マイドライブ/AI/scale-base/"

# 2. Git初期化（まだの場合）
git status  # → エラーなら未初期化
git init    # 初期化

# 3. .gitignore 作成（機密情報除外）
cat > .gitignore <<'EOF'
node_modules/
.env
.env.local
.env.*.local
.DS_Store
*.log
.wrangler/
dist/
.next/
build/
*.tar.gz
EOF

# 4. 初回コミット
git add .
git commit -m "Initial commit: SCALE Base 既存コード移行"

# 5. GitHub上で空リポジトリ作成
# https://github.com/organizations/scale-group/repositories/new
# 名前: scale-base / Private / READMEなし

# 6. ローカルとGitHub連携
git remote add origin https://github.com/scale-group/scale-base.git
git branch -M main
git push -u origin main

→ これで scale-base が GitHub に上がった。次から git push で自動同期。

Phase 3: Cloudflare Pages 連携（10分）

1. Cloudflare Dashboard → Pages → scale-base プロジェクト
2. 「設定」→「ビルド設定」
3. 「GitHub連携」→ scale-group/scale-base リポジトリ選択
4. 「main ブランチへの push で自動デプロイ」を有効化

→ これで git push するだけで本番デプロイ。手動デプロイ卒業。

Phase 4: 全社展開（1日・残り21サービス）

Claude Code に投げる：

「scale-lead, scale-form, scale-call, hp, terasu... を全部GitHub Organization 'scale-group' に上げて。
各リポジトリのプライベート設定で、Cloudflare Pages連携も全部やって」

→ Claude Code が並列処理で1日で終わる。

Phase 5: チーム運用ルール（1週間で浸透）

ルール	内容
ブランチ戦略	`main` = 本番 / `feature/<内容>` = 開発
PR必須化	mainに直push禁止・必ずPR経由
レビュー必須	1人以上の承認必須
コミットメッセージ規約	`feat: 〇〇追加` / `fix: 〇〇修正` / `docs: 〇〇`
README必須	全リポジトリに「これは何か・どう動かすか」を記載

メンバー招待手順

1. GitHub Organization → People → Invite member
2. メールアドレスで招待:
   - ゲンカイ: AIエージェント用アカウント作成必要
   - エンジニア4名: 個人GitHubアカウントを聞いて招待
3. 権限:
   - 大串: Owner（最高権限）
   - エンジニア: Member（リポジトリ単位で権限付与）
   - ゲスト（パートナー）: Outside collaborator（個別招待）

必須セキュリティ設定

Organization レベル

Settings → Member privileges:
- Default repository permission: Read（過剰権限防止）
- Allow forking: No
- Two-factor authentication requirement: Required（全員2FA必須）

リポジトリレベル

Settings → Branches:
- main ブランチを保護
- Pull request 必須
- レビュー1人以上必須
- 直push禁止

Secrets管理

Settings → Secrets and variables → Actions:
- CLAUDE_API_KEY
- CLOUDFLARE_API_TOKEN
- 等を登録（コード内に直書き禁止）

落とし穴・注意点

落とし穴	対策
`.env` を誤コミット → API key 漏洩	`.gitignore` 最優先・git-secrets ツール導入
巨大ファイル誤コミット → リポジトリ重い	`.tar.gz`, `.zip`, 動画は除外
パブリックで作って機密漏洩	Organization の Default private を設定
エンジニア辞めた時のアカウント残存	Owner権限は大串のみ・他はMember
Google Drive 同期との競合	Drive側のscale-baseは別管理（Driveから外す検討）
ゲンカイ用アカウントの扱い	サービスアカウント作成・bot用Token発行

1つだけ警告：Drive側 scale-base の扱い

今: /Users/oogushiyuuki/Library/CloudStorage/GoogleDrive.../scale-base/
→ Google Driveが5分おきに同期
→ Gitの履歴と競合する可能性

推奨: GitHub化したら Drive側からは抜く（or 別フォルダに退避）。Gitが履歴管理してくれるからDrive同期は不要。

今日からの行動プラン

今日（30分）

1. github.com でアカウント作成
2. 2FA有効化
3. Organization "scale-group" 作成

今週（2-3時間）

4. SCALE Base を Phase 2 の手順でGitHub化（パイロット）
5. Cloudflare Pages 連携
6. 1〜2回 git push してデプロイの流れを体感

今月（1日）

7. Claude Code に「残り21サービスをGitHub化して」と投げる
8. メンバー招待
9. ブランチ保護ルール設定

大串の管理画面オープン用コマンド

# GitHub アカウント作成画面
open "https://github.com/signup"

# Organization 作成画面（アカウント作成後）
open "https://github.com/organizations/new"

# Cloudflare Pages 管理画面（連携設定用）
open "https://dash.cloudflare.com/?to=/:account/pages"

移行対象22サービスチェックリスト

#	サービス	パス	状態
1	SCALE Base	`/Users/oogushiyuuki/Library/.../scale-base/`	未
2	SCALE CRM (scale-lead)	`~/株式会社SCALE/scale-lead/`	未
3	SCALE Base CRM	`~/株式会社SCALE/scale-base-crm/`	未
4	TERASU公式HP	`~/Library/CloudStorage/.../scale-hp-showcase/`	完了（2026-05-27）
5	コーポレートHP	`~/株式会社SCALE/hp/`	未
6	FS Dashboard	`~/scale-fs/`	未
7	PM Dashboard	`~/scale-pm/`	未
8	SCALE Form	`~/株式会社SCALE/scale-form/`	未
9	SCALE Call	`~/株式会社SCALE/scale-call/`	未
10	SCALE Match	`~/株式会社SCALE/scale-match/`	未
11	SCALE Coach	`~/株式会社SCALE/scale-coach/`	未
12	SCALE List	`~/株式会社SCALE/scale-list/`	未
13	SCALE Insight	`~/株式会社SCALE/scale-insight/`	未
14	SCALE Slack Bot	`~/株式会社SCALE/scale-slack-bot/`	未
15	SCALE Dashboard	`~/株式会社SCALE/scale-dashboard/`	未
16	SCALE Bridge	`~/株式会社SCALE/scale-bridge/`	未
17	SCALE X Tool	`~/株式会社SCALE/scale-x-tool/`	未
18	SCALE Tasks	`~/株式会社SCALE/scale-tasks/`	未
19	SCALE Admin	`~/株式会社SCALE/scale-admin/`	未
20	SCALE QA	`~/株式会社SCALE/scale-qa/`	未
21	SCALE Academy	`~/株式会社SCALE/scale-academy/`	未
22	SCALE Org	`~/株式会社SCALE/scale-org/`	未
23	SCALE Ops	`~/株式会社SCALE/scale-ops/`	未
24	SCALE Company	`~/株式会社SCALE/scale-company/`	未
25	scale-lead-manual	`~/株式会社SCALE/scale-lead-manual/`	未

→ 移行完了したら を に更新。

改訂履歴

日付	内容
2026-05-13	初版作成。X炎上事例（Gitコミット開示拒否）をきっかけに、SCALE 22サービスのGitHub Organization化を実行計画化
2026-05-27	Phase 1 完了。Org `scale-group-jp` 作成・SSH認証OK・TERASU HP push成功。詳細: 31_システム開発部/_作業ログ/2026-05-27_GitHub_Phase1_初期設計