マージ可能性予測
Git の merge-tree --write-tree を使って進行中のエージェントブランチ同士のペアワイズマージを継続的にシミュレートし、Git 自身のマージ処理に基づいて予測します。
Braidkeep
Braidkeepは、並列AIコーディングエージェント向けのマージ安全性とスコープ管理ツールです。競合を予測し、ファイル権限を制御し、安全なマージ順を提案します。
概要
Braidkeepは、並列AIコーディングエージェントの群れ向けに提供される Apache-2.0 ライセンスのマージ安全性とスコープガード層です。エージェントがどこを編集できるかを制限し、ブランチを main に戻して統合する際のより安全な順序を判断し、マージ競合を予測することを目的としています。
このプロジェクトは、明示的に研究プレビュー（v0.1.0）として示されています。READMEでは、正しさではなくマージ可能性を予測すると説明されているため、まずは使い捨てまたは重要でないリポジトリで使用し、実際に操作する前に出力を確認する必要があります。
コア機能
ライブ競合マトリクス
コミットが着地すると競合が可視化され、マージを実行しなくても変更を確認できるライブの conflict-matrix TUI で、現在の競合状態を表示します。
スコープガードの許可リスト
braidkeep.yaml に定義されたエージェントごとのファイル所有権許可リストを使い、編集が反映される前にスコープ逸脱を検出します。
レビュー時の強制適用
エージェントの起動方法に関係なく、CI で差分に対して実行されるレビュー時のエンフォースメント手順として braidkeep check を提供します。
安全なマージ計画
競合のないブランチをバッチにまとめ、残りの複雑なブランチを競合の少ない順に並べる安全なマージ順を計算します。
読み取り専用 CLI バイナリ
単一の静的バイナリとして提供され、読み取り専用のまま動作し、作業ツリー、インデックス、refs を変更せずに Git の plumbing のみとやり取りします。
適用シーン
忙しいブランチキューを監視する
複数のエージェントブランチが稼働しているときに braidkeep watch を使い、誰かがマージする前にどの組み合わせが衝突しそうかをリアルタイムで把握します。
編集時にエージェントのスコープを制限する
エージェントがコードベースの狭い範囲だけを変更する想定のとき、たとえば internal/auth/ 内に留めたい認証修正のような場合に、許可リストのワークフローを使います。
マージを安全に順序付ける
どのブランチをすぐにまとめてマージでき、どのブランチを後回しにして順番に処理すべきか判断したいときに braidkeep plan を使います。
CI 強制でレビューをゲートする
エージェントの起動方法に関係なく、差分に対してファイル所有権ルールを強制したいときに、CI やレビュー自動化で braidkeep check を使います。
まず重要でないリポジトリで評価する
本番で重要なコードベースに導入する前に、デモワークフローまたは使い捨てリポジトリでツールを評価します。
Pros and Cons
Pros
- マージ前にペアワイズのマージ競合を予測します。
- 別のマージモデルではなく、Git の merge-tree の plumbing を使用します。
- エージェントごとのファイル所有権ガードレールを追加して、スコープ逸脱を抑えます。
- 競合のないバッチと扱いの難しいブランチに対して、実用的なマージ順を計算します。
- 複数のオーケストレーター下で動作し、CI でも利用できます。
Cons
- 初期段階の研究プレビューであり、完成した本番向け製品ではありません。
- マージ可能性の予測が成功しても、正しいマージや安全なマージが保証されるわけではありません。
- READMEでは、権限バイパスモードによって既定の書き込み時フックをスキップできるため、CI チェックが実際の強制ゲートになると記載されています。
FAQ
Braidkeepは本番利用に対応していますか？
Braidkeepは初期段階の研究プレビューとして位置づけられています。READMEでは、正しさではなくマージ可能性を予測すると説明しているため、クリーンな予測が出ても、正しいマージや安全なマージが保証されるわけではありません。
主なコマンドやワークフローは何ですか？
READMEでは、braidkeep watch はライブのペアワイズ競合マトリクス、braidkeep plan は安全なマージ順のプランナー、braidkeep check はファイル所有権ルールのレビュー時エンフォースメントゲートとして説明されています。
Braidkeepはどのようにスコープの境界を強制しますか？
このプロジェクトでは、braidkeep.yaml にエージェントごとのファイル所有権の許可リストを定義し、Claude Code PreToolUse フックを既定で有効な書き込み時ガードレールとして使用することが示されています。また README では、braidkeep check が CI 上で差分に対して実行され、エージェントの起動方法では回避できないと説明されています。
Braidkeepは特定のエージェントオーケストレーターに依存しますか？
READMEによると、Braidkeepは Claude Squad、Conductor、Vibe Kanban、通常の tmux、CI を含む、あらゆるオーケストレーター上で動作します。
使用前に留意すべきことはありますか？
READMEでは、Braidkeep は現状有姿で提供され、まずは使い捨てまたは重要でないリポジトリで試し、その出力を確認してから操作することが推奨されています。
Quick Facts
- カテゴリ
- 開発者向けツール
- ソースドメイン
- github.com
- ライセンス
- Apache-2.0
- リリース状況
- 研究プレビュー（v0.1.0）
- プラットフォーム / 形式
- 単一の静的バイナリ CLI
- 主な利用者
- 並列AIコーディングエージェントを運用するチーム
Braidkeepの代替品
ByteAsk
ByteAskは、C/C++向けのターミナル起点AIコーディングエージェント。リポジトリを編集し、コンパイラやデバッガ、サニタイザ、テストで変更を検証してから差分を表示。無料枠あり。
CreateOS Sandbox
CreateOS Sandboxは、FirecrackerマイクロVM上でコードやエージェントのワークロードを実行できる分離型コンピュート環境です。SDK、CLI、MCPで制御可能。
hob
hobは、エージェントのセッション、ターミナル、履歴、後続作業を、既存のツールやプロバイダーに合わせて整理できる独立したコーディングエージェント向けワークスペース。ローカルでの制御を重視する開発者に最適。
Manta AI
Manta AIは、URLからアプリの挙動を把握し、回帰を検出し、スクリプトやセレクタ管理なしでテストを生成できる自律型Webアプリテストツールです。
SonOf
SonOfは、リポジトリとPMツールに接続し、コードベースと周辺の製品コンテキストを監査して、承認済みの作業をシニアエンジニアのレビュー付きで公開済みチケットに変えます。
Ghost
Ghostは、チャット、コード生成、コマンドラインでのタスク実行に対応したターミナル向けAIアシスタントです。無料モデルを同梱し、Linux、macOS、Windowsで使えます。オープンソースです。