Claude Cowork（協働ワークフロー）

• 1 人 + 1 Claude ではなく、1 人 + 3〜4 Claude を回すための運用術
• 鍵は「git worktree」で作業空間を物理的に分離すること
• 役割は Planner / Builder / Reviewer の 3 分業が最小構成
• 人間の仕事は：タスク分解 → 各 Claude に投入 → PR レビュー、の 3 つに集約される

• 効く：タスクが 2〜5 個並列に走らせられる規模のプロジェクト
• 効く：PR ベースの開発フローがすでに回っているチーム
• 効かない：小さな 1 ファイル修正が中心の運用（オーバースペック）
• 効かない：DB マイグレーションなど直列にしか進まない作業

1. メインリポの隣に worktree 用ディレクトリを掘る
2. feature ごとに worktree を切って、それぞれで `claude` を起動
3. ターミナルは tmux / iTerm 分割 / VSCode ターミナル分割のどれでも OK
4. 共有の `CLAUDE.md` はメインブランチで管理、各 worktree に自動で反映される

# 1. worktree を 3 本作る
git worktree add ../proj-planner   main
git worktree add ../proj-feature-a -b feature/a
git worktree add ../proj-feature-b -b feature/b

# 2. それぞれ別ターミナルで起動
cd ../proj-planner    && claude   # 計画係
cd ../proj-feature-a  && claude   # 実装係 A
cd ../proj-feature-b  && claude   # 実装係 B

「ログイン画面にパスワードリセット導線を追加」を 3 タブで回してみる例。

1. Planner タブ（plan モード）で全体設計を出させる
2. 出てきた TODO を、Builder A（UI）と Builder B（API）に切り分けて投入
3. 両方が終わったら Reviewer タブで両ブランチを順にチェックアウトしてレビュー
4. 指摘があれば Builder に戻す。OK なら PR を出させて統合

Planner への投入プロンプト例：
「ログイン画面にパスワードリセット導線を追加したい。
 UI と API に分解して、依存関係と受け入れ基準を明記した TODO を出して。実装は待って。」

Builder A への投入プロンプト例：
「Planner が出したこの TODO の『UI 部分』だけ実装して。API は別担当がやるからモック前提で。」

【Planner】
「plan モードのまま作業して。以下の要件を、UI / API / DB / テスト の4層に分解し、
 各層のタスクを 30 分以内で終わる粒度まで割ってから TODO リストで出して。」

【Builder】
「以下のタスクだけを実装して。他の層には触らない。実装後、影響範囲のテストを追加して。
 完了したら変更ファイル一覧と、次の担当者への申し送りを 3 行で書いて。」

【Reviewer】
「ブランチ feature/X を checkout して差分をレビューして。
 観点は ①要件を満たしているか ②テスト不足 ③設計上の懸念 の3つ。
 優先度付きで指摘リストを出して。」

1. 先にマージする PR を決めて統合
2. 残りの worktree で `git pull --rebase origin main` を Claude に依頼
3. コンフリクトが出たら、その worktree の Claude に「rebase 中のコンフリクトを、意図を保って解消して」と依頼
4. 解消後に必ずテストを走らせる（Claude に `pnpm test` させる）

• ○ 各 worktree は独立ブランチ。同一ブランチを 2 つの Claude に触らせない
• ○ `.env` は各 worktree に個別配置（シンボリックリンクでも可）
• ○ Planner が出した TODO はメインの Issue に貼って人間が可視化
• × main を触らせる → 事故の温床
• × 3 タブ全部に「全部よしなに」→ 同じファイルを別方向に書き換えて破綻
• × Reviewer を省く → 品質が担保できない。1 人でも Reviewer タブは必ず立てる

# worktree 操作
git worktree list                       # 一覧
git worktree add <path> -b <branch>      # 新規（新ブランチ）
git worktree add <path> <existing>       # 既存ブランチを開く
git worktree remove <path>               # 片付け

# セッション
claude -c        # 前回の続き（worktree ごとに独立に保存される）
/clear           # 現worktree のセッションだけリセット

git worktree で作業ディレクトリを分け、Claude を複数走らせる基本形。