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 个文件，有效降低上下文碎片化并维持代码质量。