【2026年版】Git上級者ワークフロー：ブランチ戦略・リベース・Monorepo管理の実践テクニック

# 1. mainブランチから短命なフィーチャーブランチを作成
git checkout main
git pull origin main
git checkout -b feat/add-user-auth

# 2. 小さな単位でコミット
git add src/auth/login.ts
git commit -m "feat: add login form component"

git add src/auth/api.ts
git commit -m "feat: add authentication API client"

# 3. mainの最新をリベースで取り込み
git fetch origin
git rebase origin/main

# 4. プッシュしてPRを作成
git push origin feat/add-user-auth

# 5. レビュー後、squash mergeでmainに統合
# （GitHub/GitLabのUI上で実行）

// feature-flags.ts
const featureFlags = {
  newUserAuth: process.env.FF_NEW_USER_AUTH === 'true',
  darkMode: process.env.FF_DARK_MODE === 'true',
  aiAssistant: process.env.FF_AI_ASSISTANT === 'true',
};

// 利用側
if (featureFlags.newUserAuth) {
  // 新しい認証フロー
  return <NewAuthFlow />;
} else {
  // 従来の認証フロー
  return <LegacyAuthFlow />;
}

# フィーチャー開発の開始
git checkout develop
git pull origin develop
git checkout -b feature/payment-integration

# 開発作業...
git add .
git commit -m "feat: add Stripe payment integration"

# フィーチャーの完了（developへマージ）
git checkout develop
git merge --no-ff feature/payment-integration
git branch -d feature/payment-integration
git push origin develop

# リリース準備の開始
git checkout develop
git checkout -b release/v2.1.0

# バージョン番号の更新、最終調整...
git commit -m "chore: bump version to 2.1.0"

# リリース（mainとdevelopの両方にマージ）
git checkout main
git merge --no-ff release/v2.1.0
git tag -a v2.1.0 -m "Release v2.1.0"
git push origin main --tags

git checkout develop
git merge --no-ff release/v2.1.0
git branch -d release/v2.1.0

# 緊急修正
git checkout main
git checkout -b hotfix/fix-login-bug
# 修正作業...
git commit -m "fix: resolve login session timeout issue"

git checkout main
git merge --no-ff hotfix/fix-login-bug
git tag -a v2.1.1 -m "Hotfix v2.1.1"

git checkout develop
git merge --no-ff hotfix/fix-login-bug
git branch -d hotfix/fix-login-bug

# 直近5コミットを編集
git rebase -i HEAD~5

# リベース前のコミット履歴
# abc1234 feat: add login form
# def5678 fix: typo in login form
# ghi9012 feat: add login API call
# jkl3456 fix: handle API error
# mno7890 style: format code

# インタラクティブリベースで整理
git rebase -i HEAD~5

# エディタで以下のように編集：
# pick abc1234 feat: add login form
# fixup def5678 fix: typo in login form
# pick ghi9012 feat: add login API call
# fixup jkl3456 fix: handle API error
# fixup mno7890 style: format code

# 結果：きれいな2コミットに集約
# aaa1111 feat: add login form
# bbb2222 feat: add login API call

# リベース中にコンフリクトが発生した場合
git rebase origin/main

# コンフリクトを解決
# 1. コンフリクトファイルを確認
git status

# 2. ファイルを編集してコンフリクトを解決
# <<<<<<<, =======, >>>>>>> マーカーを修正

# 3. 解決したファイルをステージ
git add src/conflicted-file.ts

# 4. リベースを続行
git rebase --continue

# リベースを中止したい場合
git rebase --abort

# 絶対にやってはいけない
git checkout main
git rebase feature/my-branch  # 危険！mainをリベースしている

# 正しい使い方
git checkout feature/my-branch
git rebase main  # 自分のブランチをmainの上にリベース

{
  "$schema": "https://turbo.build/schema.json",
  "globalDependencies": ["**/.env.*local"],
  "pipeline": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": [".next/**", "!.next/cache/**", "dist/**"],
      "cache": true
    },
    "test": {
      "dependsOn": ["build"],
      "outputs": ["coverage/**"],
      "cache": true
    },
    "lint": {
      "outputs": [],
      "cache": true
    },
    "dev": {
      "cache": false,
      "persistent": true
    },
    "deploy": {
      "dependsOn": ["build", "test", "lint"],
      "outputs": [],
      "cache": false
    }
  }
}

packages:
  - "apps/*"
  - "packages/*"

# Sparse Checkoutの有効化
git clone --filter=blob:none --sparse https://github.com/org/monorepo.git
cd monorepo

# 必要なディレクトリのみをチェックアウト
git sparse-checkout set apps/web packages/ui packages/utils

# 追加のディレクトリをチェックアウトに含める
git sparse-checkout add apps/api

# 変更されたファイルを取得
CHANGED_FILES=$(git diff --name-only origin/main...HEAD)

# 影響を受けるパッケージを特定
echo "$CHANGED_FILES" | grep -oP '^(apps|packages)/[^/]+' | sort -u

# Turborepoのフィルター機能を使用
npx turbo run build --filter='...[origin/main...HEAD]'
npx turbo run test --filter='...[origin/main...HEAD]'

# Huskyのインストールと初期化
pnpm add -D husky
npx husky init

# .husky/pre-commit
#!/usr/bin/env sh
. "$(dirname -- "$0")/_/husky.sh"

# lint-stagedでステージされたファイルのみチェック
npx lint-staged

{
  "lint-staged": {
    "*.{ts,tsx}": [
      "eslint --fix",
      "prettier --write"
    ],
    "*.{json,md,yaml}": [
      "prettier --write"
    ],
    "*.test.{ts,tsx}": [
      "vitest related --run"
    ]
  }
}

# .husky/commit-msg
#!/usr/bin/env sh
. "$(dirname -- "$0")/_/husky.sh"

npx --no -- commitlint --edit ${1}

module.exports = {
  extends: ['@commitlint/config-conventional'],
  rules: {
    'scope-enum': [2, 'always', ['web', 'api', 'mobile', 'ui', 'config', 'database', 'utils', 'root']],
    'subject-max-length': [2, 'always', 72],
    'body-max-line-length': [2, 'always', 100],
  },
};

# .github/workflows/ci.yml
name: CI

on:
  pull_request:
    branches: [main]

jobs:
  detect-changes:
    runs-on: ubuntu-latest
    outputs:
      web: ${{ steps.filter.outputs.web }}
      api: ${{ steps.filter.outputs.api }}
      packages: ${{ steps.filter.outputs.packages }}
    steps:
      - uses: actions/checkout@v4
      - uses: dorny/paths-filter@v3
        id: filter
        with:
          filters: |
            web:
              - 'apps/web/**'
              - 'packages/**'
            api:
              - 'apps/api/**'
              - 'packages/**'
            packages:
              - 'packages/**'            

  test-web:
    needs: detect-changes
    if: needs.detect-changes.outputs.web == 'true'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: 'pnpm'
      - run: pnpm install --frozen-lockfile
      - run: pnpm turbo run build test lint --filter=web...

  test-api:
    needs: detect-changes
    if: needs.detect-changes.outputs.api == 'true'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: 'pnpm'
      - run: pnpm install --frozen-lockfile
      - run: pnpm turbo run build test lint --filter=api...