Git ワークフロー

作業をコミットする

cd ~/Code/community-patterns

git add patterns/$GITHUB_USER/pattern.tsx
git commit -m "Add pattern: description"
git push origin main

更新を取得する(ステップ 1 で既に実施)

git fetch upstream
git pull --rebase upstream main
git push origin main

作業を上流で共有する(プルリクエストの作成)

重要: ユーザーが PR 作成を指示するまで待ってください。 自動的にプッシュまたは PR を作成しないでください。

PR を作成する前に、必ず main から更新し、ブランチをリベースしてください:

ステップ 0: PR 作成前の更新とリベース

ワークスペース設定からキャッシュされたリポジトリタイプを使用:

# .claude-workspace から IS_FORK を読み込み(ステップ 2 で設定)
IS_FORK=$(grep "^is_fork=" .claude-workspace | cut -d= -f2)

# 使用するリモートを判定
if [ "$IS_FORK" = "true" ]; then
  echo "Working on fork - will fetch from upstream"
  MAIN_REMOTE="upstream"
else
  echo "Working on main repo - will fetch from origin"
  MAIN_REMOTE="origin"
fi

次に最新の main をフェッチしてブランチをリベース:

# 最新の main をフェッチ
git fetch $MAIN_REMOTE

# 現在のブランチを main の上にリベース
git rebase $MAIN_REMOTE/main

# リベースが成功したらプッシュ(フィーチャーブランチの場合は force-with-lease を使用)
if [ "$(git branch --show-current)" != "main" ]; then
  git push origin $(git branch --show-current) --force-with-lease
else
  git push origin main
fi

リベースにコンフリクトがある場合:

1. コンフリクトファイルを表示: git status
2. コンフリクトの解決を支援
3. 続行: git rebase --continue
4. その後プッシュ

このステップが重要な理由:

• PR が最新の main をベースにしていることを保証
• PR レビュー時のマージコンフリクトを回避
• PR レビューを簡単にする

---

ユーザーが独自のフォークを持っている場合(最も一般的)

ユーザーが上流にパターンを投稿したい場合:

ステップ 1: 変更がコミットされてフォークにプッシュされていることを確認

cd ~/Code/community-patterns
git status  # すべての変更がコミットされていることを確認
git push origin main

ステップ 2: 更新とリベース(上記のステップ 0 を参照)

ステップ 3: 上流へのプルリクエストを作成

gh pr create \
  --repo jkomoros/community-patterns \
  --title "Add: pattern name" \
  --body "$(cat <<'EOF'
## Summary
- パターンの簡単な説明
- 主な機能
- ユースケース

## Testing
- [x] パターンがエラーなくコンパイルされる
- [x] http://localhost:8000 でブラウザでテスト済み
- [x] すべての機能が期待通りに動作

🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"

jkomoros/community-patterns で直接作業する場合

重要: 上流リポジトリで直接作業する場合、ブランチと PR を使用する必要があります。main への直接プッシュは許可されていません。

ステップ 1: フィーチャーブランチを作成

cd ~/Code/community-patterns
git checkout -b username/feature-name

ステップ 2: コミットとブランチのプッシュ

git add patterns/$GITHUB_USER/
git commit -m "Add: pattern name"
git push origin username/feature-name

ステップ 3: 更新とリベース(上記のステップ 0 を参照)

ステップ 4: プルリクエストを作成

gh pr create \
  --title "Add: pattern name" \
  --body "$(cat <<'EOF'
## Summary
- 簡単な説明

## Testing
- [x] テスト済みで動作

🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"

ステップ 5: 承認時にリベースでマージ

gh pr merge PR_NUMBER --rebase --delete-branch

重要な注意事項

• PR を作成する前に必ずユーザーの許可を待ってください
• すべての PR は --rebase でマージされます(NOT --squash または --merge)
• これにより個別のコミット履歴が保持されます
• ローカルでは頻繁にコミットしますが、ユーザーが依頼した時だけ PR を作成します
• PR はマージ前にレビューされます
• マージ後、次回の更新時にすべてのユーザーが自動的にあなたのパターンを取得します