@modus-ai/modus 0.2.5 → 0.2.7

package/templates/skills/modus-design-brief/SKILL.md

@@ -27,7 +27,7 @@ disable: false
 
 | `mode` 值 | 来源类型 | 处理方式 |
 |----------|---------|---------|
-| `harness` | 文件路径 | 读取 `modus/plans/active/{story-id}/01-analysis.md` |
+| `harness` | 文件路径 | 读取 `modus/stories/{story-id}/harness/01-analysis.md`（v3.2 路径）|
 | `spec` | 文件路径 | 读取调用方目录下的 `proposal.md`；若存在同级 `specs/*/spec.md` 也一并读取 |
 | `vibe` | 运行时字符串 | `analysis_doc` 参数是调用方直接传入的「用户意图摘要」字符串，**不读取任何文件**；直接将此字符串作为需求描述，与 Step 5 加载的 Skill 内容结合生成设计方案 |
 
@@ -106,9 +106,10 @@ disable: false
 **落盘模式（spec / harness）：**
 
 将生成内容写入调用方指定路径：
+- plan 模式：`modus/plans/{name}/design-brief.md`
 - spec 模式：`modus/changes/{name}/design-brief.md`（gate_status 写 `passed`，此模式无 Gate 检查）
-- harness 模式：`modus/plans/active/{story-id}/01.5-design-brief.md`
-  - **gate_status 必须由 `modus-designer` SubAgent 在 Step 4 后动态评估并填写**（见 `modus-agents/designer/SKILL.md` 的 gate_status 赋值规则）
+- harness 模式：`modus/stories/{story-id}/harness/02-design-brief.md`
+  - **gate_status 必须由 `modus-designer` SubAgent 在 Step 4 后动态评估并填写**（见 `modus-harness-agents/01-5-design/SKILL.md` 的 gate_status 赋值规则）
   - 固定写 `passed` 将使 Gate A0.5 失效，严禁在 harness 模式下硬编码该字段
 
 写入后输出确认：
@@ -140,12 +141,17 @@ disable: false
 ## 产出物格式（design-brief.md）
 
 ```markdown
-# Design Brief: {功能名称}
-
-<!--HANDOFF
-agent: "01.5-design"
+---
+schema_version: "1.1"
+agent: "02-design"
+run_id: "{YYYYMMDD}-{story_id_prefix}"
 story_id: "{story-id}"
+task_id: ""
 domains: ["{domain1}", "{domain2}"]
+gate_status: "passed"
+artifact_status: "complete"
+issues: []
+skill_refs: []
 design_decisions:
   - "{决策1}"
   - "{决策2}"
@@ -157,7 +163,9 @@ gate_status: "{passed|warning|failed}"
 #   warning — 存在低风险未确认点，不阻塞开发
 #   failed  — 存在高风险未确认点或用户答复后仍有歧义，Orchestrator 将重入本 SubAgent
 # 注：plan/spec/vibe 模式调用时此字段不参与 Gate 检查，默认写 passed 即可
--->
+---
+
+# Design Brief: {功能名称}
 
 ## 1. 基本信息
 
@@ -339,4 +347,4 @@ constitution: {constitution 字段内容}
 
 ### harness 模式调用方式
 
-由 SubAgent 01.5 独立执行（见 `modus-agents/designer/SKILL.md`），输入为 `01-analysis.md`，输出为 `01.5-design-brief.md` 含 HANDOFF 块。
+由 SubAgent 02（设计阶段，原 01.5）独立执行（见 `modus-harness-agents/01-5-design/SKILL.md`），输入为 `modus/stories/{story-id}/harness/01-analysis.md`，输出为 `modus/stories/{story-id}/harness/02-design-brief.md` 含 HANDOFF 块（`agent: "02-design"`）。

package/templates/skills/modus-harness/SKILL.md

@@ -19,17 +19,19 @@ disable: false
 
 ## SubAgent 清单与 Token 预算
 
-| ID | Skill 路径 | 职责 | 产出物 | 知识查询预算 |
-|----|-----------|------|--------|------------|
-| 00 | `modus-skill-creator` | Skills 更新/知识提取 | Skill 文件 + catalog | 无限制 |
-| 01 | `modus-analyst` | 需求分析 | `01-analysis.md` | ≤ 3 个 Skill 文件 |
-| 01.5 | `modus-designer` | 设计方案生成 | `01.5-design-brief.md` | ≤ 3 个 Skill 文件 |
-| 02 | `modus-developer` | 代码开发 | `02-sprint-contract.md` | ≤ 5 个 Skill 文件 + ≤ 10 个代码文件 |
-| 03 | `modus-tester` | 代码测试 | `03-test-report.md` | ≤ 2 个 Skill 文件 |
-| 04 | `modus-perf-auditor` | 性能审计 | `04-perf-report.md` | ≤ 2 个 Skill 文件 |
-| 05 | `modus-security-auditor` | 安全审计 | `05-security-report.md` | ≤ 2 个 Skill 文件 |
-| 06 | `modus-reviewer` | 代码评审 | `cr-report.md` | ≤ 1 个团队约定 Skill |
-| 07 | `modus-deployer` | 部署发布 | `07-deploy-status.md` | ≤ 1 个 Skill 文件 |
+> **命名说明：** SubAgent ID（调度用）与 Skill 文件名中的编号存在偏移，原因是 SubAgent 02（设计阶段）对应 `modus-harness-01-5-design`（插入在 01 和 02 之间），导致后续 Skill 文件名编号均比 SubAgent ID 少 1。HANDOFF `agent` 值以 SubAgent ID 为基准（见 `protocol.md` §六 三方映射表）。
+
+| SubAgent ID | Skill 路径 | HANDOFF agent 值 | 职责 | 产出物 | 知识查询预算 |
+|-------------|-----------|-----------------|------|--------|------------|
+| 00 | `modus-harness-00-skills-builder` | `00-skills-builder` | Skills 更新/知识提取 | Skill 文件 + catalog | 无限制 |
+| 01 | `modus-harness-01-analysis` | `01-analysis` | 需求分析 | `01-analysis.md` | ≤ 3 个 Skill 文件 |
+| 02 | `modus-harness-01-5-design` | `02-design` | 设计方案生成 | `02-design-brief.md` | ≤ 3 个 Skill 文件 |
+| 03 | `modus-harness-02-dev` | `03-dev` | 代码开发 | `03-sprint-contract.md` | ≤ 5 个 Skill 文件 + ≤ 10 个代码文件 |
+| 04 | `modus-harness-03-test` | `04-test` | 代码测试 | `04-test-report.md` | ≤ 2 个 Skill 文件 |
+| 05 | `modus-harness-04-perf` | `05-perf` | 性能审计 | `05-perf-report.md` | ≤ 2 个 Skill 文件 |
+| 06 | `modus-harness-05-security` | `06-security` | 安全审计 | `06-security-report.md` | ≤ 2 个 Skill 文件 |
+| 07 | `modus-harness-06-review` | `07-review` | 代码评审 | `cr-report.md` | ≤ 1 个团队约定 Skill |
+| 08 | `modus-harness-07-deploy` | `08-deploy` | 部署发布 | `08-deploy-status.md` | ≤ 1 个 Skill 文件 |
 
 **预算原则：** SubAgent 超出预算时，应优先读 status 更高（proven > verified > draft）的 Skill；若 catalog 中某 Skill 标注 `⚠️` 可能过时，优先读最新代码而非该 Skill。
 
@@ -37,36 +39,34 @@ disable: false
 
 ## 结构化产物交接格式（HANDOFF 协议）
 
-每个 SubAgent 的产出物 Markdown 文件头部附加一个机器可读的 `HANDOFF` 块，供 Orchestrator 和下游 SubAgent 精准解析，**无需读取整份文档**即可决策：
+每个 SubAgent 的产出物 Markdown 文件头部附加一个机器可读的 YAML frontmatter，供 Orchestrator 和下游 SubAgent 精准解析，**无需读取整份文档**即可决策：
 
 ```markdown
-<!--HANDOFF
+---
+schema_version: "1.1"
 agent: "01-analysis"
+run_id: "20260518-200034"
 story_id: "{story-id}"
-domains: ["order", "payment"]
-sprint_count: 3
-risk_level: "medium"          # low | medium | high
-key_constraints:
-  - "不能修改 OrderStatus 枚举"
-  - "需要兼容 v1 接口"
+task_id: ""
+domains: ["biz-track", "biz-album"]
+gate_status: "passed"
+artifact_status: "complete"
+issues: []
 skill_refs:
-  - "modus-biz-order@v3.1.0"
-  - "modus-team-conventions@v1.2.0"
-gate_status: "passed"          # passed | failed | pending
-issues: []                     # P1/P2 问题列表（cr-report 专用）
--->
+  - "biz-track@v2.1"
+---
 ```
 
-Orchestrator 每步只需读 HANDOFF 块（≤ 20 行），而非整份 MD 文件，大幅节省 token。
+Orchestrator 每步只需读 HANDOFF 块（≤ 20 行），而非整份 MD 文件，大幅节省 token。完整字段说明见 `modus/docs/protocol.md` schema v1.1。
 
 ---
 
 ## 执行流程
 
-### Step 0：项目宪法 + 前置检查
+### Step 1：项目宪法 + 前置检查
 
 **读取 constitution：**
-读取 `modus/config.yaml` 的 `constitution` 字段，将 `hard_rules` 传递给所有 SubAgent 作为硬性约束。
+读取 `{project}/modus/config.yaml`（即当前项目根目录下的 `modus/config.yaml`，多项目 workspace 需先通过 `workspace-catalog.md` 确认项目路径，如 `operations-job/modus/config.yaml`）的 `constitution` 字段，将 `hard_rules` 传递给所有 SubAgent 作为硬性约束。SubAgent 直接使用 Orchestrator 传入的 constitution 内容，无需独立解析路径。
 
 **检查业务 Skill：**
 读取 `modus/knowledge-catalog.md`（Level 1 加载）：
@@ -82,19 +82,19 @@ B. 强制继续（无业务上下文，风险较高）
 
 **解析 Story ID + 初始化状态追踪：**
 - 从 TAPD URL 提取 Story ID（格式：`tapd.cn/{project}/stories/view/{id}`）
-- 创建工作目录：`modus/plans/active/{story-id}/`
+- 创建工作目录：`modus/stories/{story-id}/harness/`
 
 **`.harness-state.yaml` 断点续跑机制（优先级高于 HANDOFF 块探测）：**
 
-检查工作目录下是否存在 `.harness-state.yaml`：
+检查工作目录下是否存在 `.harness-state.yaml`；若存在部分产出物（含 HANDOFF frontmatter），也可从断点处继续。
 
 ```yaml
-# 示例：modus/plans/active/{story-id}/.harness-state.yaml
+# 示例：modus/stories/{story-id}/harness/.harness-state.yaml
 story_id: "{story-id}"
 loop: 1                         # 当前 Loop 轮次（1 或 2）
-# SubAgent ID 约定：00=INIT 阶段(skill-creator)、01/01.5/02/03/04/05/06/07 为主流程；00-ARCHIVE=ARCHIVE 阶段
-completed_agents: ["00-INIT", "01", "01.5", "02", "03"]  # 已成功完成的 SubAgent ID
-current_agent: "04"             # 当前正在执行的 SubAgent（空=未开始/全部完成）
+# SubAgent ID 约定：00=INIT 阶段、01/02/03/04/05/06/07/08 为主流程；00-ARCHIVE=ARCHIVE 阶段
+completed_agents: ["00-INIT", "01", "02", "03", "04"]  # 已成功完成的 SubAgent ID
+current_agent: "05"             # 当前正在执行的 SubAgent（空=未开始/全部完成）
 loop2_triggers: []              # Loop 2 触发的 P1/P2 问题列表
 last_updated: "2026-01-01T12:00:00"
 ```
@@ -108,13 +108,8 @@ last_updated: "2026-01-01T12:00:00"
   → 若 current_agent 非空（说明上次中途失败），重新执行该 SubAgent
 
 .harness-state.yaml 不存在
-  → 全新流程，初始化状态文件（completed_agents: []，loop: 1）
-  → 注意：若目录已有产出物但无状态文件（极端情况），以 HANDOFF 块作为降级判断，但输出警告
-
-SubAgent 00 状态写入规则：
-  → INIT 阶段（Step 2 skill-creator 执行完）完成后，写入 "00-INIT" 到 completed_agents
-  → ARCHIVE 阶段（Step Final 完成后），写入 "00-ARCHIVE" 到 completed_agents
-  → 断点续跑时，若 "00-INIT" 已在列表中则跳过 INIT；若 "00-ARCHIVE" 已在列表中则跳过 ARCHIVE
+  → 扫描目录，若存在部分产出物（含 HANDOFF frontmatter），以 HANDOFF 块降级判断断点
+  → 全新流程则初始化状态文件（completed_agents: []，loop: 1）
 ```
 
 **每个 SubAgent 完成后，立即更新状态文件**（在 Orchestrator 层执行，不依赖 SubAgent 自身）：
@@ -124,7 +119,7 @@ current_agent: "{下一个 subagent_id}"
 last_updated: "{ISO 8601 时间戳}"
 ```
 
-### Step 1：澄清意图（仅全新流程）⏸️ 【人工交互节点】
+### Step 2：澄清意图（仅全新流程）⏸️ 【人工交互节点】
 
 读取 TAPD Story 内容后，在启动 SubAgent 01 之前，先确认关键信息：
 
@@ -140,7 +135,7 @@ last_updated: "{ISO 8601 时间戳}"
 
 3. [技术约束] 有没有特殊要求（如不能修改某接口入参 / 需兼容旧版本）？
 
-4. [重点关注] 03/04/05 并行审计时，是否有需要特别关注的风险方向？
+4. [重点关注] 04/05/06 并行审计时，是否有需要特别关注的风险方向？
 ```
 
 等待用户回答后，输出启动摘要：
@@ -154,7 +149,7 @@ last_updated: "{ISO 8601 时间戳}"
 启动 Harness 流程...
 ```
 
-### Step 2：INIT——知识注入
+### Step 3：INIT——知识注入
 
 **Level 1 → Level 2 加载：**
 基于用户确认的业务域，调用 SubAgent 00（模式 B：增量更新）：
@@ -165,7 +160,7 @@ last_updated: "{ISO 8601 时间戳}"
 
 ```
 [Harness Orchestrator 启动]
-Story: {id} | 工作目录: modus/plans/active/{id}/
+Story: {id} | 工作目录: modus/stories/{id}/harness/
 知识注入: order[verified→已更新] | payment[proven→已读取] | user[新建 draft]
 Constitution: {N} 条硬性规则已加载
 ```
@@ -178,25 +173,25 @@ Constitution: {N} 条硬性规则已加载
 
 ```
 SubAgent 01（需求分析）
-  ↓ 产出 01-analysis.md（含 HANDOFF 块）
+  ↓ 产出 01-analysis.md（含 HANDOFF frontmatter）
   ↓ Gate A0: 读 01-analysis.md HANDOFF 块，检查 gate_status = "passed"（需求分析质量门）
-SubAgent 01.5（设计方案生成）⏸️ 含人工架构决策确认
-  ↓ 产出 01.5-design-brief.md（含 HANDOFF 块）
-  ↓ Gate A0.5: 读 01.5-design-brief.md HANDOFF 块，检查 gate_status ∈ {passed, warning}
-SubAgent 02（代码开发）
-  ↓ 产出 02-sprint-contract.md（含 HANDOFF 块）
+SubAgent 02（设计方案生成）⏸️ 含人工架构决策确认
+  ↓ 产出 02-design-brief.md（含 HANDOFF frontmatter）
+  ↓ Gate A0.5: 读 02-design-brief.md HANDOFF 块，检查 gate_status ∈ {passed, warning}
+SubAgent 03（代码开发）
+  ↓ 产出 03-sprint-contract.md（含 HANDOFF frontmatter）
   ↓ Gate A: 编译验证（项目构建工具编译，exit code = 0）
-SubAgent 03（代码测试）  ┐
-SubAgent 04（性能审计）  ├─ 并行启动，等全部完成（各自读取相关 Skill，预算独立）
-SubAgent 05（安全审计）  ┘
-  ↓ Gate B: 03/04/05 三份报告全部写入（各含 HANDOFF 块）
+SubAgent 04（代码测试）  ┐
+SubAgent 05（性能审计）  ├─ 并行启动，等全部完成（各自读取相关 Skill，预算独立）
+SubAgent 06（安全审计）  ┘
+  ↓ Gate B: 04/05/06 三份报告全部写入（各含 HANDOFF frontmatter）
             + 各报告 gate_status ≠ "failed"
-            + 05 安全报告无严重/高危未修复问题
-SubAgent 06（代码评审）
-  ↓ 产出 cr-report.md（含 HANDOFF 块，issues 字段列出 P1/P2）
-  ↓ Gate C: HANDOFF.issues 为空
-SubAgent 07（部署发布）
-  ↓ 产出 07-deploy-status.md
+            + 06 安全报告无严重/高危未修复问题
+SubAgent 07（代码评审）
+  ↓ 产出 cr-report.md（含 HANDOFF frontmatter，issues 字段列出 P1/P2）
+  ↓ Gate C: HANDOFF.issues 为空（或全为 P3）
+SubAgent 08（部署发布）
+  ↓ 产出 08-deploy-status.md
   ↓ ARCHIVE 知识提取
   ↓ Human Final Review
 ```
@@ -206,17 +201,17 @@ SubAgent 07（部署发布）
 | Gate | 检查方式 | 失败处理 |
 |------|---------|---------|
 | Gate A0 | 读 `01-analysis.md` HANDOFF 块，检查 `gate_status` = "passed"（需求分析质量门） | `failed` 时重入 SubAgent 01，最多 2 次 |
-| Gate A0.5 | 读 `01.5-design-brief.md` HANDOFF 块，检查 `gate_status` ∈ {passed, warning} | `failed` 时重入 SubAgent 01.5，最多 2 次 |
-| Gate A | 执行 `constitution.build_command`，exit code = 0 | 重入 SubAgent 02，最多 3 次 |
-| Gate B | 扫描目录，检查 03/04/05 三个 HANDOFF 文件均存在，且各文件 HANDOFF 块的 `gate_status ≠ "failed"`；05（安全审计）报告中若存在严重/高危问题则强制拦截 | 继续等待（文件未齐），超时上报；若 gate_status = "failed" 则重入对应 SubAgent（最多 2 次）|
-| Gate C | 读 cr-report.md 的 HANDOFF 块，检查 `issues` 是否为空 | 触发 Loop 2 精准重入 |
+| Gate A0.5 | 读 `02-design-brief.md` HANDOFF 块，检查 `gate_status` ∈ {passed, warning} | `failed` 时重入 SubAgent 02，最多 2 次 |
+| Gate A | 执行 `constitution.build_command`，exit code = 0 | 重入 SubAgent 03，最多 3 次 |
+| Gate B | 扫描目录，检查 04/05/06 三个 HANDOFF 文件均存在，且各文件 HANDOFF 块的 `gate_status ≠ "failed"`；06（安全审计）报告中若存在严重/高危问题则强制拦截 | 继续等待（文件未齐），超时上报；若 gate_status = "failed" 则重入对应 SubAgent（最多 2 次）|
+| Gate C | 读 cr-report.md 的 HANDOFF 块，检查 `issues` 是否为空（或全为 P3） | 触发 Loop 2 精准重入 |
 
 **Gate 检查优先读 HANDOFF 块**，只有当 HANDOFF 块信息不足时才读完整文件。
 
 ### Loop 2 规则
 
-- SubAgent 06 完成后若 HANDOFF.issues 含 P1/P2 → 从 issues 中定位受影响的 Sprint → 精准重入 SubAgent 02
-- 重入后重新执行：02 → Gate A → 03/04/05 → 06（完整验证）
+- SubAgent 07 完成后若 HANDOFF.issues 含 P1/P2 → 从 issues 中定位受影响的 Sprint → 精准重入 SubAgent 03
+- 重入后重新执行：03 → Gate A → 04/05/06 → 07（完整验证）
 - 连续 3 次重入仍有 P1/P2 → 暂停流程，上报用户，请求人工介入
 
 **精准重入 Sprint 定位规则：**
@@ -224,14 +219,14 @@ SubAgent 07（部署发布）
 - 若 `sprint` 字段缺失或为 0：fallback 为重跑**全量 Sprint**（降级为保守策略）
 - 若同一 Loop 2 中多个 issue 指向不同 Sprint，取 Sprint 编号的**并集**一并重跑
 
-### Step Final：ARCHIVE——知识提取
+### Step 4（ARCHIVE）——知识提取
 
-SubAgent 07 完成后（进入 Human Final Review 等待阶段），调用 SubAgent 00（模式 D：知识提取）：
+SubAgent 08 完成后（进入 Human Final Review 等待阶段），调用 SubAgent 00（模式 D：知识提取）：
 
 ```
 [ARCHIVE 阶段启动]
-产物范围: 01-analysis.md + 02-sprint-contract.md + 03-test-report.md
-        + 04-perf-report.md + 05-security-report.md + cr-report.md + 07-deploy-status.md
+产物范围: 01-analysis.md + 02-design-brief.md + 03-sprint-contract.md + 04-test-report.md
+        + 05-perf-report.md + 06-security-report.md + cr-report.md + 08-deploy-status.md
 提取目标: [decision] [guideline] [pitfall] [process] [invariant]
 ```
 
@@ -240,17 +235,18 @@ SubAgent 07 完成后（进入 Human Final Review 等待阶段），调用 SubAg
 | 产出物 | 可提取的知识类型 |
 |--------|---------------|
 | `cr-report.md` 的 P2/P3 | `[pitfall]`（发现的编码反模式）、`[invariant]`（金额/并发/事务的不变量） |
-| `02-sprint-contract.md` 的架构决策 | `[decision]`（技术选型）、`[process]`（新增业务流程） |
-| `07-deploy-status.md` 的部署注意事项 | `[guideline]`（上线操作规范） |
+| `02-design-brief.md` 的架构决策章节 | `[decision]`（技术选型权衡、架构设计决策） |
+| `03-sprint-contract.md` 的架构决策 | `[decision]`（实现层决策）、`[process]`（新增业务流程） |
+| `08-deploy-status.md` 的部署注意事项 | `[guideline]`（上线操作规范） |
 | `01-analysis.md` 的业务规则 | `[invariant]`（系统必须始终为真的业务约束，违反即为 Bug） |
-| `04-perf-report.md` 的高/中风险项 | `[pitfall]`（N+1 查询、大数据量无分页等性能反模式） |
-| `05-security-report.md` 的严重/高危项 | `[pitfall]` `[invariant]`（多租户隔离漏洞、权限缺失等安全反模式，必须提取） |
+| `05-perf-report.md` 的高/中风险项 | `[pitfall]`（N+1 查询、大数据量无分页等性能反模式） |
+| `06-security-report.md` 的严重/高危项 | `[pitfall]` `[invariant]`（多租户隔离漏洞、权限缺失等安全反模式，必须提取） |
 
 提取完成后输出知识积累摘要：
 ```
 📚 本次 Harness 知识沉淀：
-- [decision] tech-wiki：新增事件驱动架构决策（来自 02-sprint-contract）
-- [pitfall] biz-order：批量审批超 50 条时需分批处理（来自 04-perf-report）
+- [decision] tech-wiki：新增事件驱动架构决策（来自 03-sprint-contract）
+- [pitfall] biz-order：批量审批超 50 条时需分批处理（来自 05-perf-report）
 - [guideline] team-conventions：@Transactional + AopContext 组合用法（来自 cr-report P2）
 - [invariant] biz-payment：支付金额必须 > 0 且 ≤ 账户余额，违反即为 Bug（来自 cr-report）
 - status 更新: modus-biz-order draft→verified（首次工作流验证）
@@ -268,11 +264,11 @@ SubAgent 07 完成后（进入 Human Final Review 等待阶段），调用 SubAg
 
 ```
 ✅ SubAgent 01 完成 → 01-analysis.md（影响范围: N 处 | 风险点: N 个 | domains: order,payment）
-⏸️ SubAgent 01.5 执行中...（等待架构决策确认）
-✅ SubAgent 01.5 完成 → 01.5-design-brief.md（设计决策: N 个 | 追踪矩阵: N 行 | Gate A0: passed）
-🔄 SubAgent 02 执行中...（Sprint 2/3 | token: 3/5 Skill 预算已用）
-⏳ 并行等待 03/04/05（2/3 完成）
-❌ Gate A 失败 → 重入 SubAgent 02（第 N 次）
+⏸️ SubAgent 02 执行中...（等待架构决策确认）
+✅ SubAgent 02 完成 → 02-design-brief.md（设计决策: N 个 | 追踪矩阵: N 行 | Gate A0: passed）
+🔄 SubAgent 03 执行中...（Sprint 2/3 | token: 3/5 Skill 预算已用）
+⏳ 并行等待 04/05/06（2/3 完成）
+❌ Gate A 失败 → 重入 SubAgent 03（第 N 次）
 📚 ARCHIVE 完成 → 提取知识 N 条（decision:1 | pitfall:2 | guideline:1）
 ─── Loop 1 第 N 轮 | Loop 2 第 N 轮 | 修复问题: N 个 ───
 ```
@@ -305,26 +301,29 @@ feat: {业务摘要}
 
 | 如果发现自己在做… | 立即停止，转交给… |
 |----------------|----------------|
-| 修改任何业务代码 | `modus-developer` |
-| 分析 TAPD 需求内容 | `modus-analyst` |
-| 生成设计方案或询问架构决策 | `modus-designer` |
-| 对代码质量发表意见 | `modus-reviewer` |
-| 执行测试或验证逻辑 | `modus-tester` / `modus-perf-auditor` / `modus-security-auditor` |
-| 操作部署流程 | `modus-deployer` |
-| 更新 Skill 文件 | `modus-skill-creator` |
+| 修改任何业务代码 | SubAgent 03（`modus-harness-02-dev`）|
+| 分析 TAPD 需求内容 | SubAgent 01（`modus-harness-01-analysis`）|
+| 生成设计方案或询问架构决策 | SubAgent 02（`modus-harness-01-5-design`）|
+| 对代码质量发表意见 | SubAgent 07（`modus-harness-06-review`）|
+| 执行测试或验证逻辑 | SubAgent 04/05/06 |
+| 操作部署流程 | SubAgent 08（`modus-harness-07-deploy`）|
+| 更新 Skill 文件 | SubAgent 00（`modus-harness-00-skills-builder`）|
 
 ---
 
-## 调度 CoT（每次行动前执行）
+## 调度 CoT（每次行动前循环执行）
 
-1. 扫描 `modus/plans/active/{story-id}/` 目录，列出已有 HANDOFF 块
-2. 只需读各文件的 HANDOFF 块（≤ 20 行），对照串行顺序确定当前阶段
+1. 扫描 `modus/stories/{story-id}/harness/` 目录，列出已有 HANDOFF frontmatter
+2. 只需读各文件的 HANDOFF frontmatter（≤ 20 行），对照串行顺序确定当前阶段
 3. 检查当前阶段的 Gate 条件是否满足（优先读 HANDOFF，必要时读全文）。**每个 Gate 仅在对应 SubAgent 完成后单独执行，互相独立，不同时触发**：
-   - Gate A0：**当 SubAgent 01 写入 `01-analysis.md` 后**，检查该文件 HANDOFF 块的 `gate_status` 字段（仅需求分析完成后的质量门，与 Gate A0.5 无关）
-   - Gate A0.5：**当 SubAgent 01.5 写入 `01.5-design-brief.md` 后**，检查该文件 HANDOFF 块的 `gate_status` 字段（仅设计方案完成后的质量门，独立于 Gate A0 执行结果）
+   - Gate A0：**当 SubAgent 01 写入 `01-analysis.md` 后**，检查该文件 HANDOFF 块的 `gate_status` 字段，确保 = "passed"（需求分析质量门，独立于 Gate A0.5）
+   - Gate A0.5：**当 SubAgent 02 写入 `02-design-brief.md` 后**，检查 `gate_status ∈ {passed, warning}`；`failed` 时重入 SubAgent 02，最多 2 次
+   - Gate A：执行 `constitution.build_command`（如 `mvn clean compile -q -DskipTests`），检查 exit code = 0；失败时重入 SubAgent 03，最多 3 次
+   - Gate B：扫描 harness/ 目录，检查 `04-test-report.md`、`05-perf-report.md`、`06-security-report.md` 的 HANDOFF `artifact_status` 均为 `complete`；各报告 `gate_status ≠ "failed"`；06（安全审计）有严重/高危则强制拦截；超时（30 分钟）上报用户
+   - Gate C：读 `cr-report.md` HANDOFF，检查 `issues` 数组为空或全为 P3；有 P1/P2 时从 `issues[].affected_sprint` 定位受影响 Sprint，触发 Loop 2 精准重入 SubAgent 03
 4. Gate 通过 → 调用下一个 SubAgent 的 Skill（传递 constitution + 相关 Skill 内容）
-   - 调用 SubAgent 02 时，必须同时传入 `01.5-design-brief.md` 内容
+   - 调用 SubAgent 03 时，必须同时传入 `02-design-brief.md` 内容
 5. Gate 失败 → 按规则处理（重入/上报）
 6. 输出本轮进度卡片
-7. 若 SubAgent 07 完成 → 触发 ARCHIVE 知识提取（SubAgent 00 模式 D）
-8. 等待 SubAgent 写入产出物，重复 Step 2
+7. 若 SubAgent 08 完成且 `08-deploy-status.md` HANDOFF `artifact_status = complete` → 触发 ARCHIVE 知识提取（SubAgent 00 模式 D），进入 Step 4
+8. 等待 SubAgent 写入产出物，重复步骤 1