並行エージェントが同じ成果物を編集したときの担当責任の競合を解消する

目的

2026年10月25日時点の情報である。並行エージェントが両立しない前提で同じ成果物を編集した状態から復旧する。リポジトリのマージ方針、現在の要件、実際のワークスペースの分離状況を再確認する。この提案は担当責任の衝突を起点とするものであり、worktreeや独立した結果の統合についての一般的な入門ではない。

前提条件

統合責任者、現在の統合先リビジョン、競合する候補のリビジョン、各作業者に割り当てた要件を特定する。統合先を変更する前に、ローカルの作業を保存する。Git worktreeは、リポジトリデータを共有しながら、作業ツリーとインデックスを分離する。worktreeをセキュリティ境界として扱ったり、外部のビルドリソースまで分離されていると想定したりしてはならない。

手順

1. 衝突した状態を固定する。 関係する作業者が共有の統合先を変更するのを止める。各候補を、不変のコミットまたは保存したパッチとして確保し、その候補に属する未コミットの作業や未追跡のファイルも含める。ベースリビジョン、割り当てた目的、変更したパス、検証の証拠を記録する。無関係な作業を継続できるのは、争点となっている入力を変更しない場合だけである。
2. 成果物ごとに責任者を1人定める。 最終版を受け入れる、または置き換える権限を誰が持つか記録する。他のエージェントは修正を提案できるが、統合はその責任者が担う。統合先への反映は直列化し、古くなった採用済みリビジョンを参照する提出物は拒否する。作業者の完了メッセージは提案であり、担当責任の移譲ではない。
3. 不一致を分類する。 テキスト上の重なりと、両立しない動作を分ける。共有インターフェース、設定の既定値、依存関係、生成物とそのソースを比較する。例えば、生成側がフィールド名を変え、利用側が旧名を使い続けていれば、編集対象が別のファイルであっても調整が必要である。行単位の競合を解消する前に、争点となる要件を明文化する。
4. 要件と証拠に基づいて解決する。 両立しない選択をした理由を各作業者に尋ねる。責任者が、合意済みの契約を満たす候補を選ぶか作成し、どの代替案をなぜ退けたか記録する。プロジェクトに生成手順がある場合は、採用したソースから派生する成果物を再生成する。不一致に焦点を当てた回帰チェックを残す。両候補が両立するように見せるために、チェックを弱めてはならない。
5. 復旧可能な状態から統合する。 候補と統合先のコミットを記録し、クリーンな統合用ワークスペースを使う。Gitのマージ文書は、中止しても既存の未コミットの変更を復元できない場合があると警告している。競合を明示的に確認する。確認のための一時停止に--no-commitを使う場合は、fast-forwardマージを考慮する。Gitの文書では、fast-forwardマージはこの指定では停止しないとされている。
6. 解決後の成果物を検証し、担当責任を確定する。 git diff --name-only --diff-filter=Uを実行し、未解決のマージ項目を一覧にする。解決後は、BASEを記録済みの開始時点の統合先コミットに置き換えて、git diff --check BASEを使う。Git diffは、追加された競合マーカーと空白の問題を検出するが、動作の正しさを確認するものではない。統合した候補に対し、争点となったインターフェースも含め、プロジェクトの関連チェックを実行する。採用したコミットを記録し、どの候補がそれによって置き換えられたかを各作業者に通知する。

期待される結果

競合は、誰が行ったか追跡できる判断、再現可能な候補、その正確なリビジョンに紐付いた検証によって解消される。遅れて提出された候補は、採用済みの成果物と改めて比較する必要がある。採用した作業と必要な証拠が保持されていることを確認してから、一時的なワークスペースを廃止する。

限界と検証の根拠

この手順はここでは実施していない。テキスト上はマージできてもインターフェースが一致しない、無害な競合変更でテストする。復旧の成功には、その不一致を検出し、古い候補の再提出を排除することが必要である。リポジトリのマージでは、エージェントがすでに行った外部操作の結果は照合されない。それらには別の結果記録が必要である。