Braidkeep icon

Braidkeep

Braidkeep 是專為平行 AI 程式設計代理打造的合併安全與範圍防護工具,可預測可能的合併衝突、限制檔案權限,並協助團隊選擇更安全的合併順序。

Braidkeep

概覽

Braidkeep 是一個採用 Apache-2.0 授權的合併安全與範圍防護層,適用於平行 AI 程式設計代理的群組。它旨在協助團隊預測合併衝突、限制代理可編輯的位置,並決定將分支整合回 main 的更安全順序。

這個專案明確標示為研究預覽版(v0.1.0)。README 說它預測的是可合併性,而不是正確性,因此應先在一次性或非關鍵的儲存庫上使用,並在採取行動前先審閱其輸出。

核心功能

可合併性預測

使用 Git merge-tree --write-tree,持續模擬進行中的代理分支之間的成對合併,因此預測是基於 Git 自身的合併底層機制。

即時衝突矩陣

在即時衝突矩陣 TUI 中顯示目前的衝突狀態;當某個 commit 落地時,衝突會即時亮起,而且不需要實際合併即可看到變化。

範圍防護允許清單

使用在 braidkeep.yaml 中宣告的每個代理檔案所有權允許清單,在變更落地前攔截範圍擴張。

審查時強制執行

提供 braidkeep check 作為審查時的強制執行步驟,無論代理是如何被啟動的,都會在 CI 中對 diff 執行檢查。

安全合併規劃

計算安全的合併順序,將沒有衝突的分支分組成批次,並以最少衝突優先的方式安排其餘較棘手的分支。

唯讀 CLI 二進位檔

以單一靜態二進位檔形式提供,且維持唯讀,只與 Git 底層機制互動,不會修改工作樹、索引或 refs。

適用情境

  • 監控繁忙的分支佇列

    當有多個代理分支同時活躍,而你想在任何人合併之前即時查看哪些分支配對可能衝突時,使用 braidkeep watch。

  • 在編輯期間限制代理範圍

    當代理只應觸碰程式碼庫中很小的一部分,例如應該限制在 internal/auth/ 內的驗證修正時,使用允許清單工作流程。

  • 安全安排合併順序

    當你需要決定哪些分支可以立即一起合併、哪些分支應延後並稍後排序處理時,使用 braidkeep plan。

  • 以 CI 強制執行作為審查門檻

    當你希望無論代理是如何啟動的,都能在 CI 或審查自動化中對 diff 強制執行檔案所有權規則時,使用 braidkeep check。

  • 先在非關鍵儲存庫上評估

    在將工具導入重要程式碼庫之前,先使用示範流程或一次性儲存庫來評估它。

Pros and Cons

Pros

  • 可在合併前預測成對合併衝突。
  • 使用 Git 的 merge-tree 底層機制,而不是獨立的合併模型。
  • 加入每個代理的檔案所有權防線,以減少範圍擴張。
  • 能為無衝突批次與較困難的分支計算實用的合併順序。
  • 可在多種 orchestrator 下運作,也能在 CI 中使用。

Cons

  • 這是一個早期階段的研究預覽版,還不是成熟的正式生產品。
  • 成功的可合併性預測不保證合併一定正確或安全。
  • README 指出,權限繞過模式可以跳過預設的寫入時 hook,因此 CI 檢查才是真正的強制執行閘門。

FAQ

Braidkeep 已可用於正式生產環境嗎?

Braidkeep 被定位為早期研究預覽版。README 說它預測的是可合併性,而不是正確性,因此乾淨的預測不代表一定能正確或安全地合併。

主要的指令或工作流程有哪些?

README 將 braidkeep watch 描述為即時的成對衝突矩陣,將 braidkeep plan 描述為安全合併順序規劃器,並將 braidkeep check 描述為針對檔案所有權規則的審查時強制檢查閘門。

Braidkeep 如何強制執行範圍邊界?

這個專案在 braidkeep.yaml 中記錄了每個代理的檔案所有權允許清單,並使用 Claude Code PreToolUse hook 作為預設啟用的寫入時防護措施。README 也說 braidkeep check 會在 CI 中對 diff 執行,且無法被代理的啟動模式繞過。

Braidkeep 是否依賴特定的代理 orchestrator?

README 說 Braidkeep 可在任何 orchestrator 下運作,包括 Claude Squad、Conductor、Vibe Kanban、純 tmux 或 CI。

在使用前我需要注意什麼?

README 說 Braidkeep 依原樣提供,且應先在一次性或非關鍵的儲存庫上測試,並在採取行動前先審閱其輸出。

Quick Facts

類別
開發者工具
來源網域
github.com
授權
Apache-2.0
發布狀態
研究預覽版(v0.1.0)
平台 / 格式
單一靜態二進位檔 CLI
主要使用者
使用平行 AI 程式設計代理的團隊