worktreeで消えるのはコードより「議論」——Claude Code並列開発の事故類型と除去前チェック

Claude Codeでの並列開発において、git worktree使用時に発生する事故類型と、その除去前チェック運用ルールを解説。作業成果の消失を防ぐための実体験に基づいたノウハウと、関連する英語圏の報告リンクをまとめる。

• git worktreeはエージェントごとの独立した作業コピーを提供しますが、意図しない親リポジトリへの変更や設定の引き継ぎ漏れといった事故が起こり得ます。
• 特に、未コミットのドキュメント変更が警告なく消える、または親ブランチにマージされるなど、コードだけでなく議論の成果物が失われるリスクがあります。
• worktree事故は「分離していない」「環境が引き継がれない」「ライフサイクル管理の事故」「Windows固有の問題」の4類型に分類されます。
• 事故防止のため、「編集したら必ずコミット」「親ツリーのgit status確認」「作業開始時に禁止コマンドのテスト」の3つを運用ルールとして推奨しています。