讨论-记录-开发-测试循环

这个项目后续采用交替迭代方式推进：

讨论 -> 记录 -> 开发 -> 测试 -> 复盘 -> 下一轮讨论

每轮讨论产物

每次讨论结束后，至少落下一个产物：

• 新增或更新一页文档。
• 新增一个架构决策记录。
• 新增一个工具 schema。
• 新增一个 workflow 草案。
• 新增一个测试样例。
• 新增一段原型代码。

不让关键判断只停留在聊天里。

工作流

1. 讨论 明确问题、约束、备选方案和当前判断。

2. 记录 更新 MkDocs 文档，把结论写到对应页面。

3. 开发 对成熟判断做最小原型，例如 adapter、MCP 工具、workflow runner。

4. 测试 用单测、集成测试、手工 smoke test 或 eval case 验证。

5. 复盘 把测试结果、风险和下一步写回文档。

文档维护规则

• 协作方式写入 docs/collaboration/。
• 产品和方案知识写入 docs/knowledge/。
• 架构判断写入 docs/knowledge/decision-log.md。
• 总体方向写入 docs/knowledge/vision.md。
• 系统分层写入 docs/knowledge/architecture.md。
• 工具接口写入 docs/knowledge/tool-plane.md 或后续工具专页。
• 流程设计写入 docs/knowledge/workflow.md 或后续 workflow 专页。
• 安全和权限写入 docs/knowledge/governance.md。
• 测试和质量写入 docs/knowledge/evals.md。

开发维护规则

后续代码建议放在：

text src/ harness/ adapters/ tools/ workflows/ policy/ evals/ tests/

文档先行不是为了拖慢开发，而是为了让每次开发都有明确边界。