tomevault-io ブランチ管理ガイド
責務
ブランチ戦略・命名規則・PR作成ルールを管理する。
- リリースフロー全体（version bump → tag → merge）は
/release-procedureskill を参照 - CI 実行方法・エラー対処は
/local-ciskill を参照
トリガー条件
以下の操作について議論・作業する際に自動的に実行:
mainブランチへのマージ・PR作成developブランチへのマージ・PR作成release/*ブランチの作成・マージ- 作業ブランチの作成・派生元の決定
ブランチ戦略
全体フロー図
flowchart LR
subgraph Protected["保護ブランチ（直接push禁止）"]
main[main]
develop[develop]
end
subgraph Release["リリースブランチ"]
release[release/*]
end
subgraph Work["作業ブランチ"]
feature[feature/*]
fix[fix/*]
refactor[refactor/*]
docs[docs/*]
end
develop -->|派生| release
release -->|派生| feature
release -->|派生| fix
release -->|派生| refactor
release -->|派生| docs
feature -->|PR| release
fix -->|PR| release
refactor -->|PR| release
docs -->|PR| release
release -->|PR| develop
develop -->|PR| main
マージ方向図
flowchart TD
A[作業ブランチ] -->|"① PR作成・マージ"| B[release/*]
B -->|"② PR作成・マージ"| C[develop]
C -->|"③ PR作成・マージ"| D[main]
D -->|"④ vタグ付与"| E[リリース完了]
style A fill:#e1f5fe
style B fill:#fff3e0
style C fill:#f3e5f5
style D fill:#e8f5e9
style E fill:#fce4ec
ルール一覧
| 操作 | 許可 | 禁止 |
|---|---|---|
| main への変更 | develop からの PR マージのみ | 直接 push、他ブランチからのマージ |
| develop への変更 | release/* からの PR マージのみ | 直接 push |
| release/* の作成 | develop から派生 | main や作業ブランチから派生 |
| 作業ブランチの作成 | release/* から派生 | main や develop から直接派生 |
実施手順
1. 現在のブランチ状態を確認
git branch -a
git log --oneline -5
2. 操作タイプ別の確認
作業ブランチを作成する場合
# 正しい手順
git checkout release/x.y.z
git checkout -b feature/my-feature
# または
git checkout -b feature/my-feature release/x.y.z
PR を作成する場合
| 現在のブランチ | PR先 | コマンド例 |
|---|---|---|
| feature/, fix/, refactor/, docs/ | release/* | gh pr create --base release/x.y.z |
| release/* | develop | gh pr create --base develop |
| develop | main | gh pr create --base main |
PR をマージする場合
1. PR の状態確認
# PR一覧を確認
gh pr list
# 特定のPRの詳細を確認
gh pr view <PR番号>
# CIステータスを確認
gh pr checks <PR番号>
2. マージ前チェックリスト
flowchart TD
A[PRマージ開始] --> B{CIが通過?}
B -->|No| C[CI失敗を修正]
C --> B
B -->|Yes| D{レビュー承認済み?}
D -->|No| E[レビューを依頼]
E --> D
D -->|Yes| F{コンフリクトなし?}
F -->|No| G[コンフリクト解消]
G --> F
F -->|Yes| H[マージ実行]
H --> I[ローカル反映]
3. マージ実行
# Squash マージ（推奨：コミット履歴をクリーンに保つ）
gh pr merge <PR番号> --squash
# 通常マージ（コミット履歴を保持）
gh pr merge <PR番号> --merge
# リベースマージ
gh pr merge <PR番号> --rebase
4. マージ方法の選択基準
| マージ方法 | 使用場面 | コマンド |
|---|---|---|
| Squash | 作業ブランチ → release（複数コミットを1つに） | gh pr merge --squash |
| Merge | release → develop（履歴保持） | gh pr merge --merge |
| Merge | develop → main（履歴保持） | gh pr merge --merge |
5. マージ後の確認
# マージ完了を確認
gh pr view <PR番号> --json state
# リモートの状態を確認
git fetch origin
git log origin/develop --oneline -5
マージ後のローカル反映
git checkout develop
git pull origin develop
3. リリースフロー
リリース手順（version bump → PR → merge → vtag）の詳細は /release-procedure skill を参照。
警告パターン
以下の操作を検知した場合は警告:
| 操作 | 警告メッセージ |
|---|---|
git push origin main |
main への直接 push は禁止です。develop からの PR を作成してください。 |
git push origin develop |
develop への直接 push は禁止です。release/* からの PR を作成してください。 |
git checkout -b feature/* develop |
作業ブランチは release/* から派生してください。 |
git checkout -b refactor/* develop |
作業ブランチは release/* から派生してください。 |
git merge main |
main からのマージは想定外です。派生元を確認してください。 |
クイックリファレンス
作業ブランチの種類:
feature/* - 新機能
fix/* - バグ修正
refactor/* - リファクタリング
docs/* - ドキュメント
作業開始:
git checkout release/x.y.z
git checkout -b feature/my-work # または refactor/*, fix/*, docs/*
作業完了（PR作成）:
gh pr create --base release/x.y.z
PRマージ:
gh pr checks <PR番号> # CI確認
gh pr merge <PR番号> --squash # 作業ブランチ用
gh pr merge <PR番号> --merge # release/develop用
マージ後のローカル反映:
git checkout <マージ先ブランチ>
git pull origin <マージ先ブランチ>
完全リリースフロー:
/release-procedure skill を参照
Converted and distributed by TomeVault — claim your Tome and manage your conversions.