DanMcInerney/architect-loop

architect‑loop – 一個自主的 LLM 驅動軟體工廠

簡介 – architect-loop 是一個命令列編排工具，讓您能夠執行由大型語言模型代理（Claude 負責設計/審查，Codex 負責程式碼生成）驅動的全自動化開發流程。它能接收高階產品需求，將其拆解為獨立的問題，讓不同的「builder」代理在全新的 Git worktree 中實作每個問題，執行測試，並最終產出單一 PR（或本地完成記錄），無需任何人工審核。

運作方式

• 編排器 (Orchestrator) – 您啟動的會話（/architect、/architect‑fast 或 /architect‑research）是主程序。它會建立一個策略師 (strategist) 子代理來草擬規格，然後啟動處理各個問題的 builder 代理。
• 型別化證據與看門狗 (Typed evidence & watchdog) – 每個 builder 都在封裝的 CLI 作業中執行，該作業會寫入 JSON 元資料檔案、心跳訊號與退出狀態。看門狗僅記錄型別化證據；它從不終止作業 – 卡住的作業需手動使用 kill-job 清除。
• 追蹤器 (Tracker) – 狀態可儲存在 GitHub（透過 issues/PRs）或本地 docs/issues/<run>/ 下的 markdown 檔案中。所有執行元資料皆位於 docs/runs/<run>/ 下。
• 確定性閘道 (Deterministic gates) – 在任何 builder 執行前會先提交凍結檢查；最終審查由策略師進行唯讀檢查，決定整合或建立修復問題。
• 快速通道 (Fast lane) – /architect‑fast 將執行限制在 ≤3 個 builder 問題與約 400 行變更內，跳過策略師階段與凍結檢查，以進行快速、有界限的變更。
• 研究通道 (Research lane) – /architect‑research 執行結構化的文獻式調查，並產出附帶來源引用的報告。

關鍵指令

/architect-research <topic>   # 主題研究，答案優先報告
/architect <hours+ request>   # 完整的多小時工廠執行
/architect-fast <small change># 快速有界限的變更通道

執行時期輔助工具包括 run-job.sh|ps1、kill-job、status.sh|ps1 以及用於清理的 sweep‑deferred。

安裝

git clone https://github.com/DanMcInerney/architect-loop
cd architect-loop && ./install.sh        # Windows: .\install.ps1
npm i -g @openai/codex@latest            # 選用的 builder 後端

安裝程式會將 skills/ 目錄複製到適當的 Claude 與 Codex 技能位置；--project 會將技能安裝到當前儲存庫而非使用者設定檔中。

設定 (選用, ~/.architect/config 或 .architect/config)

strategist = claude/best       # 設計/審查代理
builders   = codex/best        # 程式碼生成代理
tracker    = markdown          # 或 github

設定檔讓您可以切換模型系列、固定努力程度或變更追蹤器模式。

驗證與測試

uv run --no-project python tests/validate_skills.py

驗證器會檢查技能定義、封裝與合約是否符合專案的架構不變量。

授權 – MIT。

---

總結 – architect-loop 是一個自包含、由 LLM 編排的開發框架，自動化了從規格到 PR 的整個週期，具備完整功能通道與輕量級快速通道，並支援 GitHub 或純 markdown 問題追蹤。