orgOSv8 Build Principles

本文档记录 orgOSv8 在正式实现前确定的硬约束。后续架构、拆卡、实现、验收，默认都以这些原则为准。

1. Cloudflare-only

orgOSv8 只使用云服务，并且系统组件只使用 Cloudflare 提供的能力。

这意味着：

当前首要参考目录：

设计含义：

2. Do not reinvent the wheel

orgOSv8 绝不重新发明轮子。

遇到问题时，参考优先级固定为：

  1. /home/patrix/orgOSv8/ref/hermes-agent
  2. /home/patrix/orgOSv8/ref/claw-code
  3. Cloudflare 官方 agents 文档与示例

执行要求：

注意：

3. Dogfooding as the default test case

orgOSv8 每次迭代的测试用例，都使用同一个核心问题：

如何使用新构建的 agent 开发当前项目？

这意味着：

典型测试方向：

设计含义：

4. Kanban-first and delegate-only coding workflow

orgOSv8 的所有编码工作都必须遵守以下流程：

  1. 先写看板文件
  2. 按顺序编号
  3. 在当前 Discord channel 里委派给小 c 实现
  4. 绝不由我直接修改代码

这意味着：

默认执行方式：

4.0 Milestone-first

从现在起，orgOSv8 后续推进必须遵守：

  1. 先建 milestone
  2. 再在 milestone 下面开卡

目的：

执行要求：

4.1 最近五张卡的流程加速规则

Pat 已追加指示：最近五张卡 在小 c 回报完成后，我可以继续往下推进，不用等待小 q 先完成复核。

适用范围：

执行方式：

注意：

5. 对现有文档的约束影响

因此，后续文档和实现需要统一遵守：

6. 立即生效的执行规则

从本文件落盘起：

7. Code hygiene 守则

后续 coding agent 在实现卡片时，默认还必须遵守 docs/CODE-HYGIENE.md。

这份守则来自 M8.9 代码清理返工后的经验，重点约束：