git-workflow-strategy

Git ワークフロー戦略

目次

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

概要

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

使用する場面

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

クイックスタート

最小限の動作例：

# Initialize GitFlow
git flow init -d

# Start a feature
git flow feature start new-feature
# Work on feature
git add .
git commit -m "feat: implement new feature"
git flow feature finish new-feature

# Start a release
git flow release start 1.0.0
# Update version numbers, changelog
git add .
git commit -m "chore: bump version to 1.0.0"
git flow release finish 1.0.0

# Create hotfix
git flow hotfix start 1.0.1
# Fix critical bug
git add .
git commit -m "fix: critical bug in production"
git flow hotfix finish 1.0.1

リファレンスガイド

詳細な実装は references/ ディレクトリにあります：

ガイド	内容
GitFlow ワークフローの設定	GitFlow ワークフローの設定、GitHub Flow ワークフロー、トランクベース開発、ワークフロー向けの Git 設定（ほか 1 件）
マージ戦略スクリプト	マージ戦略スクリプト
コードレビューを伴う共同ワークフロー	コードレビューを伴う共同ワークフロー

ベストプラクティス

✅ 推奨事項

• チームの規模やリリースサイクルに合ったワークフローを選びます
• 機能ブランチは短期間（3 日未満）で運用します
• 種類のプレフィックスを付けた、内容がわかるブランチ名を使います
• main へのマージ前にコードレビューを必須にします
• main/release ブランチに保護ルールを適用します
• 競合を最小限にするため、頻繁にリベースします
• 原子的で論理的なコミットを作成します
• コミットメッセージを明確かつ一貫性のあるものにします

❌ 禁止事項

• main ブランチに直接コミットしないでください
• 長期間存続する機能ブランチを作成しないでください
• 曖昧なブランチ名（dev、test、temp）を使わないでください
• コードレビューなしでマージしないでください
• 1 つのブランチに複数の機能を混在させないでください
• 共有ブランチに対して強制プッシュしないでください
• CI チェックの失敗を無視しないでください
• TBD ではマージコミットでマージしないでください