ユースケース

AIエージェントが同じファイルを編集する前に、調整する

同じコードベースで2つ以上のエージェントを走らせるとき、問題は速度ではなく「2つが同時に同じファイルを編集して互いを上書きする」ことです。Vibsync はエージェントが書き込む前に調整できるようにします：重なりを確認し、触る対象を claim し、誰が何を持っているかを見える化。

先に正直に。 Vibsync の claim は advisory（協調的）な連携シグナルで、エージェントが編集前に確認するものです。OS レベルのロックや分散mutexではありません。行儀のよいエージェント同士の不意の衝突は防ぎますが、プロセスが物理的にファイルを書くのを止めるわけではありません。厳密な分離が要る場合は、claim をエージェントごとの git worktree と併用してください。

衝突の問題

並行エージェントは共有ファイルシステム上で動き、境界を自然には守りません。近くのファイルを「関連あり」と判断して触ったり、2つが同時に同じファイルを空きと見なして両方書いたりします。ファイル単位で仕事を分けるほど衝突は減りますが、分け方と「今どちらが触っているか」は誰かが調整する必要があります。

Vibsync はどう調整するか

check_conflicts — 書き始める前に、これから触るパスが他のエージェントの claim と重なっていないか確認。
claim / release — 触るファイル／ディレクトリを宣言して advisory にロックし、終わったら解放。
共有タスクボード（create_task / claim_task / update_task）— 同じ仕事を別々のエージェントが始めるのを防ぐ。

似た手段との違い

手段	できること	単独で残る課題
Git worktree	各エージェントの作業コピーを分離	分離は得意だが、誰がどのファイルを持つべきか・判断の共有はしない
強制ファイルロック / mutex	排他を強制	マシン・ツールをまたぐと脆く重い。MCP エージェントの動き方に合わない
Vibsync の claim	編集前に確認する advisory な連携シグナル（軽量・マシン/ツール横断）	協調的であり強制ではない。無視するエージェントは書けてしまう

正直な限界

claim は協調シグナルです。設定ミスや行儀の悪いエージェントは、claim を無視して書き込めます。強い分離が必要なら worktree と併用してください。Vibsync が確実にするのは「行儀のよいエージェントが、気づかずに衝突しない」ことです。

1分で接続

{
  "mcpServers": {
    "vibsync": { "type": "http", "url": "https://mcp.vibsync.com/mcp" }
  }
}

各クライアント別の手順はスタートガイドに。関連記事：How to Prevent Multiple AI Coding Agents from Editing the Same Files。