以仓库为中心的 agent loop

architect-loop 是一组 Claude Code skills,用于运行 manager 和 builder 分工。README 里把 Claude Fable 放在规划和审查位置,把 Codex 放在执行和研究位置,把仓库本身当共享记忆。流程是先写 spec 和 acceptance gates,再把新的 Codex 上下文分派到 worktrees,最后由 architect 审查证据再集成。

这个项目很新,创建于 2026-06-12,所以应把它看成正在冒头的工作流,不是成熟基础设施。但它值得入库,因为它抓住了很多 agent 用户正在手工尝试的模式:一个模型定范围,另一个模型执行,仓库记录状态。

安装和命令

README 给出的安装方式很短:

git clone https://github.com/DanMcInerney/architect-loop
cd architect-loop && ./install.sh
npm i -g @openai/codex@latest

Windows 使用 install.ps1。README 还说 ./install.sh --project 只安装到当前仓库。前提是你有付费 Claude Code,并且 Codex CLI 已登录 ChatGPT 计划。

安装后主要是两个命令:

/architect
/architect-research <what you're considering>

和普通 prompt 有什么不同

它会先写 gates,再启动 builders。builders 在隔离 worktree 里运行,并且应该只改声明过的文件。architect 自己运行 gate commands,读 diff,再决定是否集成。仓库记忆放在 docs/HANDOFF.md、docs/gates/ 和 docs/lanes/ 等文件里。

这个纪律的价值在于:builder 的说法只是待验证证据,不是事实。现实里的 coding agent 经常出现测试通过但 diff 没完成意图的情况,这个流程正是针对这类失败。

注意点

这不是免费的自动化按钮。它会消耗 Claude 和 ChatGPT plan 容量,创建 worktrees,写流程文件,并依赖本机 CLI 行为。首次使用最好放在小仓库里,并确认额外分支和 docs 目录可以接受。真实分支前也应先读安装进去的 skills。

相关

方法论优先的 agent 工作流可以对比 obra/superpowers。给 agent 提供行为素材的 skill 集合可以看 mattpocock/skills 和 phuryn/pm-skills。

FAQ

architect-loop 需要 API key 吗? README 说默认不需要。它依赖 Claude Code 和 Codex CLI 的付费计划登录状态。

/architect 做什么? 它运行构建循环:判断上一轮、写下一片 spec、分派 builders、审查证据。

为什么用 worktrees? worktrees 能隔离 builder lanes,让文件边界和 diff 更容易检查。

它成熟吗? 不成熟。按 2026-06 的状态看,它还是很新的工作流实验。