beads-workflow

beads-workflow 是一種專為管理多代理軟體開發週期的開發人員和 AI 工程師設計的專業方法論。它是將抽象規劃（大型 Markdown 文件）與代理群（如 Claude Code、Codex 或 Gemini）自動執行之間的關鍵橋樑。透過將長篇架構規劃拆解為被稱為「beads」的獨立、原子級任務，此工作流確保每個任務皆具備自我說明性、豐富的上下文以及依賴感知能力。這種方法消除了代理需要頻繁參考原始計畫的需求，從而減少上下文視窗的干擾，並顯著降低實作偏差或架構破碎的風險。

• 將高階架構 Markdown 規劃轉換為細粒度、針對機器優化的任務結構。

• 整合明確的依賴關係管理，以定義執行順序與阻礙限制。

• 提供用於初始轉換與迭代「潤飾」階段的標準化提示詞模板，以完善任務邏輯。

• 確保每個 bead 的完全獨立性，包含背景資訊、推理邏輯、技術合理化說明以及單元測試與端對端測試的需求。

• 透過允許可互換的通用代理從任務圖中領取任務，促進開發工作的水平擴展。

• 利用提供的精確提示詞進行「從計畫到 Beads」的轉換，以及多輪潤飾環節以達到穩定的任務品質。

• 建議搭配 Beads Viewer (bv) 工具使用，以視覺化任務圖、PageRank 或介數中心性等指標，以及監控整體專案進度。

• 採用「檢查 N 次，實作一次」的迭代哲學，其中 N 指的是在「規劃空間」中執行的潤飾輪數。

• 限制：需要持續使用 'br' 二進位執行檔來建立與修改 beads；透過將所有上下文直接嵌入 bead 的 Markdown 中來避免手動任務偏差。

• 極適合複雜重構、新功能開發以及大規模架構遷移，這些場景通常是保持多個代理同步的常見失效點。