@aipper/aiws-spec 0.0.23 → 0.0.25

package/docs/opencode-omo-validation-checklist.md

@@ -0,0 +1,90 @@
+# OpenCode + oMo Validation Checklist
+
+目的：补齐 `TOOLING-002L` 在真实项目环境中的人工验收路径，确认 `aiws` 对 OpenCode + `oh-my-opencode` 的支持停留在“合同 + 探测 + skill 路由提示”层，而不是 runtime orchestrator。
+
+## 范围
+
+- 验证项目级 `.opencode/oh-my-opencode.json` 探测是否生效
+- 验证 `using-aiws` / `ws-preflight` / `ws-plan` / `ws-review` 是否按约定输出 oMo 优先模式提示
+- 验证缺失 oMo 配置时是否稳定退化到 `standard-opencode`
+
+## 前置条件
+
+- 已在目标仓库执行 `aiws init .`
+- 当前仓库已生成：
+  - `.opencode/skills/`
+  - `.opencode/commands/`
+  - `.opencode/oh-my-opencode.json.example`
+- OpenCode 可正常读取项目内 `.opencode/` 目录
+
+## 场景 A：未启用 oMo（标准降级）
+
+1. 保持项目内不存在 `.opencode/oh-my-opencode.json`
+2. 运行：
+```bash
+aiws opencode status .
+```
+3. 预期：
+   - 输出 `mode: standard-opencode`
+   - 输出 `oMo config: missing`
+   - 输出 `oMo example: .opencode/oh-my-opencode.json.example (present)` 或同等信息
+4. 在 OpenCode 中执行：
+   - `/using-aiws`
+   - `/ws-preflight`
+5. 预期：
+   - 两者都输出 `OpenCode mode: standard-opencode`
+   - 不要求会话必须具备 `planner-sisyphus` / `oracle`
+
+## 场景 B：启用 oMo（项目级 agents override）
+
+1. 复制示例配置：
+```bash
+cp .opencode/oh-my-opencode.json.example .opencode/oh-my-opencode.json
+```
+2. 运行：
+```bash
+aiws opencode status .
+```
+3. 预期：
+   - 输出 `mode: oMo-enabled`
+   - 输出 `recommended_agents_ready: true`
+   - `planner=planner-sisyphus`
+   - `reviewer=oracle`
+4. 在 OpenCode 中执行：
+   - `/using-aiws`
+   - `/ws-preflight`
+   - `/ws-plan`
+   - `/ws-review`
+5. 预期：
+   - `/using-aiws` 与 `/ws-preflight` 输出 `OpenCode mode: oMo-enabled`
+   - `/ws-plan` 明确优先借用 `planner-sisyphus`，必要时再用 `@explore` / `@librarian`
+   - `/ws-review` 明确优先借用 `@oracle`
+
+## 场景 C：配置损坏
+
+1. 人为写入非法 JSON：
+```bash
+printf '{invalid json\n' > .opencode/oh-my-opencode.json
+aiws opencode status .
+```
+2. 预期：
+   - 命令不崩溃
+   - 输出 `invalid JSON`
+   - 给出“修复配置后重试”的下一步提示
+
+## 场景 D：回退纪律
+
+1. 在 OpenCode 会话中临时禁用或移除某个推荐 agent
+2. 执行：
+   - `/ws-plan`
+   - `/ws-review`
+3. 预期：
+   - skill 文案明确进入 fallback，而不是宣称 `aiws` 自己接管调度
+   - 产物仍统一落盘到 `changes/<id>/analysis/`、`patches/`、`review/`、`evidence/`
+
+## 记录建议
+
+- 将本次人工验收结论落盘到：
+  - `changes/<change-id>/review/opencode-runtime-check.md`
+  - 或 `.agentdocs/tmp/review/opencode-runtime-check.md`
+- 若发现 skill 输出与本清单不一致，优先修 `packages/spec/templates/workspace/.opencode/skills/` 与 `.opencode/commands/`，不要直接引入新的 runtime controller

package/docs/spec-contract.md

@@ -128,29 +128,44 @@ hash 规则（用于跨平台稳定性）：
 - 默认覆盖：Claude Code / OpenCode / Codex / iFlow。
 
 约定路径（示例；最终以模板 manifest 为准）：
-- Claude Code：`.claude/commands/p-aiws-*.md`（commands；私有原子入口）
-- OpenCode：`.opencode/command/p-aiws-*.md`（command；私有原子入口）
+- Claude Code native：`.claude/skills/*/SKILL.md`（skills）
+- Claude Code compatibility：`.claude/commands/p-aiws-*.md`（commands；私有原子入口）
+- OpenCode native skills：`.opencode/skills/*/SKILL.md`
+- OpenCode native commands：`.opencode/commands/p-aiws-*.md`
+- OpenCode legacy compatibility：`.opencode/command/p-aiws-*.md`（command；migration window）
 - Codex：`.agents/skills/*/SKILL.md`（skills）
 - iFlow：`.iflow/commands/aiws-*.toml`（commands）
 
 补充（workflow 入口，同样由模板提供；最终以模板 manifest 为准）：
-- Claude Code：`.claude/commands/ws-*.md`
-- OpenCode：`.opencode/command/ws-*.md`
+- Claude Code native：`.claude/skills/ws-*/SKILL.md`
+- Claude Code compatibility：`.claude/commands/ws-*.md`
+- OpenCode native skills：`.opencode/skills/ws-*/SKILL.md`
+- OpenCode native commands：`.opencode/commands/ws-*.md`
+- OpenCode legacy compatibility：`.opencode/command/ws-*.md`
 - Codex：`.agents/skills/ws-*/SKILL.md`
 - iFlow：`.iflow/commands/ws-*.toml`
 
 注意（Codex）：
 - Codex 的 repo skills 目录为 `.agents/skills/`（可随仓库共享；prompts 已 deprecated）。
-- 如需在任意仓库也能显式使用 AIWS skills：可用 `aiws codex install-skills` 从模板 `.agents/skills/*/SKILL.md` 安装到 `~/.codex/skills/` 或 `$CODEX_HOME/skills`。
+- 如需在任意仓库也能显式使用 AIWS skills：`aiws codex install-skills` 从模板 `.agents/skills/*/SKILL.md` 安装到 `~/.agents/skills/`。
+- `CODEX_HOME` 或 `--dir` 可作为 compatibility/test override；但不要继续把 `~/.codex/skills/` 当成目录真值。
 - 如仍需使用全局 prompts（遗留机制）：可用 `aiws codex install-prompts` 从模板 `.codex/prompts/*.md` 安装到 `~/.codex/prompts/` 或 `$CODEX_HOME/prompts`。
 
+注意（Claude Code / OpenCode）：
+- 当前 workspace 模板已经同时投影：
+  - Claude Code native skills：`.claude/skills/`
+  - Claude Code command-style compatibility：`.claude/commands/`
+  - OpenCode native skills / commands：`.opencode/skills/` / `.opencode/commands/`
+  - OpenCode legacy compatibility：`.opencode/command/`
+- `.claude/commands/` 与 `.opencode/command/` 继续保留为兼容层，但不再作为唯一长期真值。
+
 能力边界（必须在文档中不夸大）：
 - aiws **不保证** 工具会自动加载/自动注册这些文件（是否自动发现、是否需要重启/重新打开会话，由工具实现决定）。
 - aiws 的最低承诺是：这些文件提供一致的“工作流入口”（例如引导执行 `npx @aipper/aiws init|update|validate|rollback`），从而把用户带回同一套真值文件与门禁。
 
 每个文件的托管方式（推荐）：
-- 对于 commands 类文件（如 `.claude/commands/*.md`、`.opencode/command/*.md`）：每个文件包含**一个且仅一个**托管块（block id 形如 `claude:aiws-init`），aiws update 只更新托管块，块外内容保留给用户追加说明。
-- 对于 Codex skills（`.agents/skills/*/SKILL.md`）：由于文件顶部 YAML front matter 需要保持一致性，默认采用 `replace_file` 全量托管；如需自定义请新增独立 skill 目录。
+- 对于 commands 类文件（如 `.claude/commands/*.md`、`.opencode/commands/*.md`、`.opencode/command/*.md`）：每个文件包含**一个且仅一个**托管块（block id 形如 `claude:aiws-init`），aiws update 只更新托管块，块外内容保留给用户追加说明。
+- 对于 skills 类文件（`.agents/skills/*/SKILL.md`、`.claude/skills/*/SKILL.md`、`.opencode/skills/*/SKILL.md`）：由于文件顶部 YAML front matter 需要保持一致性，默认采用 `replace_file` 全量托管；如需自定义请新增独立 skill 目录。
 
 最小矩阵（建议写清以下字段，便于未来实现与验收）：
 - `path_pattern`：文件路径模式
@@ -161,14 +176,14 @@ hash 规则（用于跨平台稳定性）：
 
 建议的默认取值（与 `workspace` 模板一致）：
 - Claude Code
-  - `path_pattern`：`.claude/commands/p-aiws-*.md`
-  - `purpose`：提供“在 Claude 内可见的命令入口/说明”，引导用户运行 `npx @aipper/aiws ...`
+  - `path_pattern`：`.claude/skills/*/SKILL.md`
+  - `purpose`：提供 native workflow skills；兼容命令入口仍保留在 `.claude/commands/*.md`
   - `autodiscovery`：不作为契约要求（由工具决定；aiws 不做保证）
   - `reload_needed`：不作为契约要求
   - `fallback`：在 shell 直接运行 `npx @aipper/aiws init|update|validate|rollback`
 - OpenCode
-  - `path_pattern`：`.opencode/command/p-aiws-*.md`
-  - `purpose`：提供命令入口/说明（同上）
+  - `path_pattern`：`.opencode/skills/*/SKILL.md` + `.opencode/commands/*.md`
+  - `purpose`：提供 native workflow skills 与 native commands；legacy `.opencode/command/*.md` 继续作为迁移兼容层
   - `autodiscovery`：不作为契约要求
   - `reload_needed`：不作为契约要求
   - `fallback`：同上

package/docs/superpowers-collaboration-adoption.md

@@ -0,0 +1,92 @@
+# superpowers 与协同模式吸收路线
+
+## 目标
+
+把 `superpowers` 的优点和协同工作的成熟模式，吸收到 `aiws` 的治理契约里，让 `ws-*`、change 工件、review / validate / evidence 形成一套一致 workflow，而不是零散功能。
+
+## 优先吸收的能力
+
+### 1. workflow-first 启动纪律
+
+- 会话开始先看真值文件，再做实现。
+- 先判断任务属于哪个 workflow，再进入编码。
+- `ws-preflight` 应继续承担“先对齐规则，再开始”的入口职责。
+
+### 2. 阶段门禁
+
+- 把工作显式拆成 `preflight -> plan -> dev -> review -> commit -> finish / handoff`。
+- 每个阶段都要有输入、输出、失败条件和证据要求。
+- 这类阶段定义应优先写进 spec，而不是散落在某个工具的 prompt 文案里。
+
+### 3. skill 作为治理载体
+
+- skill 不只是提示词，而是 workflow contract 的入口。
+- skill 文案应指向 `AI_PROJECT.md`、`REQUIREMENTS.md`、`AI_WORKSPACE.md` 和 `changes/` 工件。
+- skill 的职责是把人和 agent 拉回真值，而不是绕过真值。
+
+### 4. 角色分工与委托回传
+
+- 允许不同 agent / 角色分别承担规划、实现、审查、设计等职责。
+- 委托结果必须回传为分析、patch 草案、review 结论或 handoff 说明。
+- 这部分可与 `TOOLING-001V` 的 analysis / patches / review 目录约定汇合。
+
+### 5. 双层审查
+
+- 第一层审查看 workflow / spec / gate 是否满足。
+- 第二层审查看实现质量、行为回归和验证覆盖。
+- 这样可以避免“代码写对了，但流程和证据缺失”的伪完成。
+
+### 6. workflow 级验证
+
+- 不只校验代码结果，也校验流程入口、工件和证据是否齐全。
+- 长期应把 `ws-*` 入口的存在性、文案契约、manifest 映射、证据文件约定纳入回归验证。
+
+## 明确不直接吸收的部分
+
+- 不直接复制 `superpowers` 的整套 hooks、目录结构和大段文案。
+- 不绑定 Claude-first 或任何单一工具假设。
+- 不把 `aiws` 做成协同 runtime、面板系统或 daemon。
+- 不把会话技巧直接当成仓库真值；仓库真值仍必须落在 `packages/spec/`。
+
+## 在 aiws 中的落点
+
+| 外部经验 | aiws 落点 |
+| --- | --- |
+| workflow-first | `ws-preflight`、`AI_PROJECT.md`、`REQUIREMENTS.md`、`AI_WORKSPACE.md` |
+| planning discipline | `ws-plan`、`plan/` 工件 |
+| execution discipline | `ws-dev`、`changes/<id>/` 工件 |
+| review loop | `ws-review`、review 证据、`aiws validate` |
+| commit gate | `ws-commit`、hooks、validate stamp |
+| handoff / finish | `ws-finish`、`ws-handoff`、archive / handoff 工件 |
+| delegation / collaboration | `TOOLING-001V` 相关 analysis / patches / multi-review 约定 |
+
+## 分阶段路线
+
+### Phase 1：定位与边界
+
+- 明确 `aiws` 是治理内核，而不是仅分发器。
+- 在 spec 文档中写清层次、边界、吸收与非吸收范围。
+
+### Phase 2：强化 ws-* 契约
+
+- 继续把 `ws-preflight`、`ws-plan`、`ws-dev`、`ws-review`、`ws-commit`、`ws-finish` 的输入输出和证据要求写清。
+- 减少“靠作者记忆执行流程”的隐性约定。
+
+### Phase 3：协同与双审查
+
+- 把委托分析、patch 草案、多审查结果与 handoff 工件整合进 change 生命周期。
+- 让协同能力成为标准 workflow 的一部分，而不是临时技巧。
+
+### Phase 4：workflow 集成回归
+
+- 为入口文件、manifest 映射、证据目录和关键 workflow 建立稳定回归校验。
+- 把“治理是否仍成立”作为与代码正确性同等级的回归目标。
+
+## 判断标准
+
+如果未来某项能力符合以下条件，就值得吸收进 `aiws`：
+
+- 它能被定义成稳定的 workflow contract。
+- 它能回指 `packages/spec/` 真值，而不是制造新的平行规则。
+- 它能留下可审计证据，而不是只依赖会话上下文。
+- 它提升的是治理能力，而不仅仅是某个 agent 的临时使用体验。

package/docs/workflow-delegation-contracts.json

@@ -0,0 +1,274 @@
+{
+  "version": 1,
+  "title": "workflow-delegation-contracts",
+  "description": "Machine-readable delegation contract for using native multi-agent capabilities without turning aiws into a runtime orchestrator.",
+  "purpose": [
+    "这份文档把 `aiws` 对原生多 agent 的吸收边界收口为机器可读真值：`aiws` 定义合同、角色、写边界、工件路径、审查收敛与降级策略，各工具自己负责原生执行。",
+    "重点不是统一调度不同工具的 agent API，而是约束任何 native delegation 都必须回到同一套 workflow/artifact/governance contract。"
+  ],
+  "truthFiles": [
+    "AI_PROJECT.md",
+    "REQUIREMENTS.md",
+    "AI_WORKSPACE.md"
+  ],
+  "delegationFlow": [
+    {
+      "step": "bind_task",
+      "action": "先把任务绑定到 `Req_ID` / change / Verify 入口，再决定是否允许委托。",
+      "why": "没有绑定的委托只会扩大漂移；delegation 不能绕过真值入口。"
+    },
+    {
+      "step": "select_role",
+      "action": "根据任务性质选择 `planner / explorer / worker / reviewer / integrator` 角色，而不是把所有子任务都视为同一种 agent。",
+      "why": "不同角色的读写权限、输出契约与收敛方式不同。"
+    },
+    {
+      "step": "limit_scope",
+      "action": "为每个委托声明 `readScope` / `writeScope` / `artifactTargets`，超出范围必须回退给主 agent。",
+      "why": "native 多 agent 的最大风险是越界写盘；scope 必须先于执行。"
+    },
+    {
+      "step": "converge_outputs",
+      "action": "把委托结果统一收敛到 `analysis/`、`patches/`、`review/`、`evidence/` 或明确允许的代码写入范围。",
+      "why": "即使执行方式不同，交付证据与审计路径必须一致。"
+    },
+    {
+      "step": "fallback_or_integrate",
+      "action": "原生能力不可用、权限不满足或结果不可靠时，回退到单 agent / 手工委托；由主 agent 负责最终整合。",
+      "why": "`aiws` 的职责是治理和降级，不是保证每个工具都支持同一套运行时。"
+    }
+  ],
+  "roleTypes": [
+    {
+      "id": "planner",
+      "summary": "拆分需求、明确非目标、绑定验证入口，产出计划与委托边界。",
+      "readScope": [
+        "AI_PROJECT.md",
+        "REQUIREMENTS.md",
+        "AI_WORKSPACE.md",
+        "plan/",
+        "changes/<id>/"
+      ],
+      "writeScope": [
+        "plan/",
+        "changes/<id>/analysis/"
+      ],
+      "artifactTargets": [
+        "plan/<timestamp>-<slug>.md",
+        "changes/<id>/analysis/*.md"
+      ],
+      "handoffRequirements": [
+        "写明目标、非目标、范围、验证方式",
+        "写明每个后续委托角色的 scope 边界"
+      ]
+    },
+    {
+      "id": "explorer",
+      "summary": "只读探索代码库、定位影响面、收集实现信息，不直接改业务文件。",
+      "readScope": [
+        "repo source files",
+        "packages/spec/",
+        "changes/<id>/"
+      ],
+      "writeScope": [
+        "changes/<id>/analysis/"
+      ],
+      "artifactTargets": [
+        "changes/<id>/analysis/*.md"
+      ],
+      "handoffRequirements": [
+        "结论必须附来源文件或路径",
+        "对不确定项要显式标注风险或缺口"
+      ]
+    },
+    {
+      "id": "worker",
+      "summary": "在明确授权的文件范围内实现局部改动，必要时补最小验证。",
+      "readScope": [
+        "assigned modules",
+        "AI_PROJECT.md",
+        "REQUIREMENTS.md",
+        "AI_WORKSPACE.md",
+        "changes/<id>/analysis/"
+      ],
+      "writeScope": [
+        "assigned source files",
+        "changes/<id>/patches/",
+        "changes/<id>/evidence/"
+      ],
+      "artifactTargets": [
+        "changes/<id>/patches/*.patch",
+        "changes/<id>/evidence/*.md",
+        "assigned source files"
+      ],
+      "handoffRequirements": [
+        "写清改动文件、验证命令、未完成项",
+        "不得越过显式授权的写入范围"
+      ]
+    },
+    {
+      "id": "reviewer",
+      "summary": "从需求、实现质量、回归风险或交付 gate 角度做独立审查。",
+      "readScope": [
+        "repo source files",
+        "changes/<id>/analysis/",
+        "changes/<id>/patches/",
+        "changes/<id>/evidence/"
+      ],
+      "writeScope": [
+        "changes/<id>/review/",
+        "changes/<id>/evidence/"
+      ],
+      "artifactTargets": [
+        "changes/<id>/review/*.md",
+        "changes/<id>/evidence/verify-before-complete.md"
+      ],
+      "handoffRequirements": [
+        "先列 findings，再给假设或残余风险",
+        "明确这是 spec review、quality review 还是交付前验证"
+      ]
+    },
+    {
+      "id": "integrator",
+      "summary": "主 agent 角色，负责汇总委托输出、决定是否应用改动、补齐最终验证与交接。",
+      "readScope": [
+        "repo source files",
+        "changes/<id>/analysis/",
+        "changes/<id>/patches/",
+        "changes/<id>/review/",
+        "changes/<id>/evidence/"
+      ],
+      "writeScope": [
+        "authorized source files",
+        "changes/<id>/evidence/",
+        "changes/<id>/review/",
+        "changes/<id>/handoff.md"
+      ],
+      "artifactTargets": [
+        "authorized source files",
+        "changes/<id>/evidence/*.md",
+        "changes/<id>/review/*.md",
+        "changes/<id>/handoff.md"
+      ],
+      "handoffRequirements": [
+        "收敛 delegated outputs，给出最终结论与残余风险",
+        "确认验证、review gate 与 artifact 状态"
+      ]
+    }
+  ],
+  "artifactTargets": [
+    {
+      "kind": "analysis",
+      "path": "changes/<id>/analysis/",
+      "purpose": "只读分析、影响面、方案草案、风险说明。",
+      "allowedRoles": ["planner", "explorer", "integrator"]
+    },
+    {
+      "kind": "patches",
+      "path": "changes/<id>/patches/",
+      "purpose": "委托 patch 草案或实现建议，不代表已应用。",
+      "allowedRoles": ["worker", "integrator"]
+    },
+    {
+      "kind": "review",
+      "path": "changes/<id>/review/",
+      "purpose": "多 reviewer 的 findings、双审查与最终审计结论。",
+      "allowedRoles": ["reviewer", "integrator"]
+    },
+    {
+      "kind": "evidence",
+      "path": "changes/<id>/evidence/",
+      "purpose": "验证命令、运行结果摘要、交付前 gate 证据。",
+      "allowedRoles": ["worker", "reviewer", "integrator"]
+    },
+    {
+      "kind": "source_files",
+      "path": "explicitly assigned source paths only",
+      "purpose": "只有在主 agent 显式授权时，worker/integrator 才能直接改业务文件。",
+      "allowedRoles": ["worker", "integrator"]
+    }
+  ],
+  "reviewConvergence": {
+    "requiredReviews": [
+      "spec_review",
+      "quality_review"
+    ],
+    "optionalReviews": [
+      "verify_before_complete"
+    ],
+    "rules": [
+      "多 agent review 不是投票系统；由 integrator 统一收敛 findings、假设与 blocker。",
+      "若委托 worker 直接改了代码，必须至少再有一个独立 reviewer 做审查。",
+      "交付前仍需满足现有 `validate_stamp`、`verify_before_complete` 与 finish gate。"
+    ],
+    "evidenceTargets": [
+      "changes/<id>/review/spec-review.md",
+      "changes/<id>/review/quality-review.md",
+      "changes/<id>/evidence/verify-before-complete.md"
+    ]
+  },
+  "fallbackMode": {
+    "default": "single_agent_with_artifacts",
+    "triggers": [
+      "当前工具没有稳定的 native multi-agent 能力",
+      "当前工具支持原生 agent，但无法声明 write scope / artifact 边界",
+      "native agent 结果无法审计、无法落盘或不能绑定 change/verify",
+      "任务规模太小，不值得引入额外委托复杂度"
+    ],
+    "requiredBehavior": [
+      "回退后仍使用同一套 `analysis/patches/review/evidence` 工件约定",
+      "主 agent 明确说明是原生 delegation 还是降级执行",
+      "不能因为降级而跳过 plan/review/finish gate"
+    ]
+  },
+  "toolCapabilityMatrix": [
+    {
+      "tool": "codex",
+      "nativeSupport": "yes",
+      "status": "phase1_target",
+      "entrypoint": "native multi-agent / sub-agent capability",
+      "writeIsolation": "可按角色和文件范围显式约束；优先用于 explorer/worker/reviewer 分工。",
+      "fallbackRoute": "若原生 delegation 不可用，则回退为单 agent + 协同工件模式。",
+      "notes": [
+        "作为第一优先适配对象。",
+        "即使支持原生多 agent，也必须遵守 artifact path 与 review convergence 约定。"
+      ]
+    },
+    {
+      "tool": "claude",
+      "nativeSupport": "partial",
+      "status": "capability_matrix_only",
+      "entrypoint": "后续根据稳定的 native delegation 能力补齐；当前只定义 contract 与 fallback。",
+      "writeIsolation": "若无法稳定声明 write scope，则不承诺 worker 级直接写盘委托。",
+      "fallbackRoute": "优先回退为单 agent + review/artifact 模式，而不是临时造桥接 runtime。",
+      "notes": [
+        "本阶段不把 `aiws` 做成 `claude_code_bridge` 风格系统。",
+        "先定义边界，再视工具能力补实现。"
+      ]
+    },
+    {
+      "tool": "opencode",
+      "nativeSupport": "partial",
+      "status": "capability_matrix_only",
+      "entrypoint": "后续根据稳定的 native delegation 能力补齐；当前只定义 contract 与 fallback。",
+      "writeIsolation": "若不能稳定约束 read/write scope，则仅允许 analysis/review 型委托。",
+      "fallbackRoute": "回退为单 agent + 协同工件，不新增 OpenCode 专属 runtime controller。",
+      "notes": [
+        "当前阶段先保证 workflow contract 与工件路径一致。",
+        "不为了工具差异再造一层统一调度面。"
+      ]
+    }
+  ],
+  "universalRules": [
+    "delegation 必须先绑定 `Req_ID` / change / Verify 入口，不能绕过真值文件。",
+    "主 agent 必须显式说明每个 sub-task 的角色、scope、产物目标与收敛方式。",
+    "除显式授权的 worker/integrator 外，delegated agent 默认不直接写业务文件。",
+    "任何 native multi-agent 结果都必须能回收到 `analysis/patches/review/evidence` 约定路径。",
+    "native delegation 是可选执行策略，不是 workflow 的必需前提。"
+  ],
+  "notes": [
+    "`aiws` 的价值在于治理内核和合同层，不在于成为统一 runtime。",
+    "这一版先把 contract 写清，再决定哪些入口需要在模板里显式投影。",
+    "后续若工具原生能力变化，只需要更新 capability matrix 与适配策略，不需要重写 workflow 真值。"
+  ]
+}