Git ワークフロー戦略

目次

• 概要
• 使用する場面
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

構造化されたブランチング戦略とマージパターンを通じて、チームコラボレーション、コード品質、デプロイ準備をサポートする効率的な Git ワークフローを確立します。

使用する場面

• チームコラボレーションのセットアップ
• リリース管理
• フィーチャー開発の調整
• ホットフィックス手順
• コードレビュープロセス
• CI/CD 統合の計画

クイックスタート

最小限の動作例:

# GitFlow を初期化
git flow init -d

# フィーチャーを開始
git flow feature start new-feature
# フィーチャーで作業
git add .
git commit -m "feat: implement new feature"
git flow feature finish new-feature

# リリースを開始
git flow release start 1.0.0
# バージョン番号とchangelogを更新
git add .
git commit -m "chore: bump version to 1.0.0"
git flow release finish 1.0.0

# ホットフィックスを作成
git flow hotfix start 1.0.1
# 本番環境の重大なバグを修正
git add .
git commit -m "fix: critical bug in production"
git flow hotfix finish 1.0.1

リファレンスガイド

references/ ディレクトリの詳細な実装:

ガイド	内容
GitFlow ワークフロー設定	GitFlow ワークフロー設定、GitHub Flow ワークフロー、Trunk-Based Development、ワークフロー用 Git 設定 (+1 件以上)
マージ戦略スクリプト	マージ戦略スクリプト
コードレビューを含むコラボレーティブワークフロー	コードレビューを含むコラボレーティブワークフロー

ベストプラクティス

✅ すべきこと

• チームサイズとリリースサイクルに合致したワークフローを選択する
• フィーチャーブランチを短命に保つ (< 3 日)
• タイププレフィックス付きの説明的なブランチ名を使用する
• main へのマージ前にコードレビューを必須にする
• main/リリースブランチの保護ルールを適用する
• 頻繁にリベースしてコンフリクトを最小化する
• アトミックで論理的なコミットを作成する
• コミットメッセージを明確で一貫性のあるものにする

❌ すべきでないこと

• main ブランチに直接コミットする
• 長命のフィーチャーブランチを作成する
• 曖昧なブランチ名を使用する (dev, test, temp)
• コードレビューなしでマージする
• 1つのブランチに複数のフィーチャーを混在させる
• 共有ブランチに force push する
• 失敗した CI チェックを無視する
• TBD でマージコミットを使用してマージする