valkor-ai/loom

What it solves

编码代理（Coding agents）通常在处理大型软件任务时感到吃力，因为它们会丢失上下文、跳过关键检查，或者在会话结束后无法恢复工作。Loom 提供了一个有状态的交付框架（stateful delivery harness），通过将单次编码会话转变为一个结构化的、可恢复的“规划、构建、测试、修复”循环，从而防止目标漂移和任务仅部分完成。

How it works

Loom 作为一个本地 Model Context Protocol (MCP) 交付状态机运行，与 Claude Code、Codex 或 OpenCode 等代理并排运行。Loom 不让代理通过记忆来管理整个工作流，而是在 .loom/ 目录中管理项目本地状态。它引导代理执行特定的序列：明确需求（可选地使用本地知识源）、建立技术基准、执行具有特定读/写边界的受限任务，并通过评审和修复循环验证结果。它使用“上下文路由”（context routing）为代理提供当前步骤所需的必要字段组和引用，从而减少噪声和 Token 使用量。

Who it’s for

使用 AI 编码代理的开发者，他们需要从简单的原型开发转向交付可验证的软件，特别是对于那些对于单个 Prompt 来说过于庞大的任务，例如功能开发、部署或复杂的修复工作。

Highlights

• Stateful Delivery: 保存需求、任务进度和修复笔记，允许通过 continue 命令恢复会话。
• Context Routing: 通过提供针对性的检索路径，而不是重新加载整个仓库，来防止上下文窗口溢出。
• Knowledge Integration: 允许用户将本地领域文档注册为可搜索的知识源，以辅助需求明确。
• Multi-Agent Support: 支持多种具备 MCP 能力的代理，包括 Claude Code、Codex 和 OpenCode。
• Local Deployment Previews: 准备带有拓扑感知服务和健康检查的 Docker Compose 预览，用于验证。