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 问题追踪。