Git ワークフロー

構造化されたステップから恩恵を受ける一般的な git 操作のためのガイド付きワークフロー。

PR の準備

プルリクエストを準備する場合:

1. コンテキストの収集

   • git log main..HEAD --oneline — ブランチ上のすべてのコミットを一覧表示
   • git diff main...HEAD --stat — 変更されたすべてのファイルを表示
   • git status — コミットされていない作業がないか確認

2. PR コンテンツのドラフト作成

   • タイトル: 70 文字以下で、変更内容を説明 (ブランチ名ではなく)
   • 本文: 「なぜ」を要約し、主な変更を列挙し、テスト計画を追加
   • コミット履歴を使用して要約を記述 — 記憶に頼らない

3. プッシュして作成

   git push -u origin HEAD
   gh pr create --title "..." --body "$(cat <<'EOF'
   ## Summary
   - ...
   
   ## Test plan
   - [ ] ...
   
   🤖 Generated with [Claude Code](https://claude.com/claude-code)
   EOF
   )"
   

4. 確認 — gh pr view --web でブラウザで開く

ブランチのクリーンアップ

マージ済みブランチを安全にクリーンアップ:

1. main に切り替えて最新をプル

   git checkout main && git pull
   

2. マージ済みブランチを一覧表示 (main/master/develop を除外)

   git branch --merged main | grep -vE '^\*|main|master|develop'
   

3. ローカルのマージ済みブランチを削除

   git branch --merged main | grep -vE '^\*|main|master|develop' | xargs -r git branch -d
   

4. リモート追跡参照をプルーン

   git fetch --prune
   

5. ローカル追跡なしのリモートブランチを一覧表示 (オプション)

   git branch -r --merged origin/main | grep -vE 'main|master|develop|HEAD'
   

マージコンフリクトの解決

PR がコンフリクトを持つ場合:

1. コンフリクト範囲を評価

   git fetch origin
   git merge origin/main --no-commit --no-ff
   git diff --name-only --diff-filter=U  # コンフリクトしたファイルを一覧表示
   

2. 各コンフリクトファイルについて、ファイルを読んで解決:

   • 異なる領域の変更の場合は両方を保持
   • アーキテクチャ的に互換性がない場合は main ブランチのアプローチを優先し、その上に PR の意図を再適用

3. リベースがより簡潔な場合 (コミット数が少ない、共有履歴がない):

   git rebase origin/main
   # コミットごとにコンフリクトを解決してから:
   git rebase --continue
   

4. リベースが複雑な場合 (コンフリクトが多い、アーキテクチャの乖離):

   • 中止: git rebase --abort または git merge --abort
   • 有用なコードを抽出: git show origin/branch:path/to/file > /tmp/extracted.txt
   • main に手動で変更を適用
   • 説明付きで元の PR をクローズ

5. 確認 — テストを実行し、diff が正しいか確認

モノレポのリリースタグ

モノレポでは、タグをパッケージにスコープ:

# ❌ モノレポでは曖昧
git tag v2.1.0

# ✅ パッケージにスコープ
git tag contextbricks-v2.1.0
git push origin contextbricks-v2.1.0

パターン: {package-name}-v{semver}

.gitignore ファースト初期化

新しいリポジトリを作成するときは、最初の git add の前に必ず .gitignore を作成:

cat > .gitignore << 'EOF'
node_modules/
.wrangler/
dist/
.dev.vars
*.log
.DS_Store
.env
.env.local
EOF

git init && git add . && git commit -m "Initial commit"

node_modules が既に追跡されている場合:

git rm -r --cached node_modules/
git commit -m "Remove node_modules from tracking"

プライベートリポジトリライセンス監査

プライベートリポジトリを公開または共有する前に:

gh repo view --json visibility -q '.visibility'

PRIVATE の場合、以下を確認:

• LICENSE に独有表示が含まれている (MIT/Apache ではなく)
• package.json に "license": "UNLICENSED" と "private": true がある
• README に CONTRIBUTING.md または「貢献を歓迎」がない