looped-builder

looped-builder 是一款專為工程師與開發人員設計的架構工具，適用於處理大型程式開發專案、大規模重構或深度的技術探索，解決單一 AI 對話視窗限制的問題。透過將高層級需求轉化為結構化的檔案導向路徑，它能實現持久且迭代的開發工作流。代理程式會建立詳細規格 (spec.md) 與階段性實作計畫 (implementation_plan.md)，並產生一個 Bash 迴圈 (run.sh) 讓 Claude 能逐步執行任務。每個步驟都聚焦於極小的範圍，例如尋找定義、重構特定函式或更新單一檔案，確保模型在長時程運作中保持準確。適用於複雜功能開發，避免人工追蹤進度時產生錯誤。

• 自動產生專案架構，包含 spec.md, implementation_plan.md, prompt.md 與 run.sh。

• 將複雜需求拆解為適合 AI 上下文視窗的原子化任務步驟。

• 提供 iterative Bash 迴圈，支援暫停、恢復執行以及透過核取方塊追蹤進度。

• 內建代碼庫上下文分析功能，能理解既有設計模式並驗證成功準則。

• 提供結構化的探索、實作、整合與測試階段流程。

• 確保在多次執行週期中保持文檔清晰與狀態持久化。

• 適用於大型程式碼重構、複雜功能實作或系統遷移作業。

• 使用者需提供明確的最終目標，以便代理程式產生高品質且具可執行性的步驟。

• 建議在執行迴圈前審閱產生的計畫，確認邏輯與順序符合專案需求。

• 執行狀態記錄於 implementation_plan.md 中，使用者可即時監控進度。

• 兼容標準 Bash 環境，只需設定專案根目錄與迭代限制即可使用。

• 每個步驟設計為最多修改 1-3 個檔案，有效降低上下文碎片化並維持程式碼品質。