harnessed 4.7.0 → 4.8.0

package/workflows/task/auto/SKILL.zh-Hans.md

@@ -0,0 +1,80 @@
+---
+name: task
+description: |
+  Stage ③ Task 主控编排器 — 串行 invoke 4 sub per subtask (clarify → code → test → deliver)。
+  ralph-loop COMPLETE wrapper 在 deliver phase 内 (D-10 orthogonal wrapper)。tdd-gate conditional
+  fire on test sub。schema_version: harnessed.workflow.v3 with delegates_to (4 sub: clarify order 1
+  conditional + code order 2 + test order 3 conditional + deliver order 4) + disciplines_applied
+  (6 default) + tools_available (8 entry: superpowers-brainstorming + tdd + grill-with-docs +
+  zoom-out + improve-codebase-architecture + diagnose + ralph-loop + planning-with-files)。
+  Triggered by slash command `/task`
+  (bare per ADR 0030 namespace policy D-02 LOCK) after `harnessed setup`.
+trigger_phrases:
+  - "task"
+  - "子任务执行"
+  - "stage 3 execute"
+  - "ralph loop"
+  - "执行子任务"
+---
+
+# task 主控编排器 (v3)
+
+## Overview
+
+4-stage cadence Stage ③ 主控编排器，针对每个 subtask 依次委托给 4 个串行子工作流
+（捆绑 Execute-stage cadence + karpathy 心法 always-on）：
+
+| order | sub | gate ref | mode | 触发条件 |
+| ----- | --- | -------- | ---- | ---------- |
+| 1 | `clarify` | `judgments.subtask-gate.brainstorming.fires` | serial | approaches ≥ 2 / core_algorithm / has_api_contract / error_cost=high |
+| 2 | `code` | （无条件 — karpathy 心法 always-on + mattpocock conditional route） | serial | 始终触发 |
+| 3 | `test` | `judgments.tdd-gate.tdd-strongly-suggested.fires` | serial | 核心业务 / 算法 / 数据处理 / 回归 risk / reliability (6 fires_when OR-chain) |
+| 4 | `deliver` | （无条件 — ralph-loop COMPLETE wrapper） | serial | 始终触发 |
+
+Engine runtime 通过 `runMasterOrchestrator` 按顺序 spawn 4 个子工作流阶段
+（依照 T3.5.W0.1：clarify → code → test → deliver）。K9 invariant 强制执行：每个 serial
+mode delegate 必须携带显式 `order`。每个 subtask 入口走一次此主控编排器。
+
+## ralph-loop 正交 wrapper (D-10)
+
+ralph-loop 是正交 wrapper, 套在 deliver sub 的 01-deliver phase 外层保 completion-promise
+verbatim "COMPLETE" (R20.10)。任何执行单元 (subagent / team / 主 session) 都可外层套 ralph-loop
+保 completion-promise (bundled subagent vs Agent Teams routing — orthogonal wrapper rule).
+
+## Capability refs
+
+Sister `workflows/capabilities.yaml`:
+- `superpowers-brainstorming` — Bucket 4 核心 capability (sub clarify upstream)
+- `tdd` — Bucket 4 核心 capability TDD red-green-refactor (sub test upstream)
+- `grill-with-docs` — Bucket 1 mattpocock conditional invoke (clarify)
+- `zoom-out` — Bucket 1 mattpocock conditional invoke (code, unfamiliar_module)
+- `improve-codebase-architecture` — Bucket 1 mattpocock conditional invoke (code, architecture_health_audit)
+- `diagnose` — Bucket 1 mattpocock conditional invoke (code/test, bug_root_cause_unknown / test_fail)
+- `ralph-loop` — Bucket 4 核心 capability orthogonal wrapper (deliver)
+- `planning-with-files` — Bucket 4 核心 capability (code + deliver progress.md update)
+
+## Invocation
+
+- Slash command: `/task <text>` (bare per ADR 0030 namespace policy D-02 LOCK after `harnessed setup`)
+
+## How to invoke
+
+使用 Bash 工具运行：
+
+```bash
+echo "$ARGUMENTS" | harnessed run task --task-stdin
+```
+
+若 `$ARGUMENTS` 为空，运行 `harnessed run task`（不带 stdin pipe）。
+
+执行完成后，Bash 输出会在 stderr 打印 `Next:` 提示，建议下一个阶段。根据对话上下文自行决定是否调用——该提示仅供参考，不具强制性。
+
+<!-- harnessed-generated:v3.4.4 -->
+
+## References
+
+- D-01 master orchestrator delegation pattern
+- D-02 bare slash cmd convention (ADR 0030 namespace policy LOCK)
+- D-10 ralph-loop orthogonal wrapper
+- workflows/judgments/{subtask-gate,tdd-gate}.yaml — brainstorming + tdd-strongly-suggested triggers
+- workflows/task/{clarify,code,test,deliver}/workflow.yaml — 4 sub-workflow Phase 3.4 SHIPPED

package/workflows/task/clarify/SKILL.zh-Hans.md

@@ -0,0 +1,79 @@
+---
+name: task-clarify
+description: |
+  task-clarify workflow v3 — Stage ③.a 子任务澄清 sub-workflow (superpowers
+  brainstorm + mattpocock /grill-with-docs conditional invoke)。Per-subtask
+  repeat invoke 入口 — execute-task 每个 subtask 起步先走 task-clarify 评估 gate
+  (judgments.subtask-gate.brainstorming.fires) 是否激活 brainstorming + 条件性
+  fire grill-with-docs (phase.spec_ambiguous == true)。
+  schema_version: harnessed.workflow.v3 with disciplines_applied [6] + tools_available
+  [superpowers-brainstorming, grill-with-docs]. Triggered by harnessed CLI
+  `harnessed task-clarify --task <text>` or slash command `/task-clarify` after
+  `harnessed setup`.
+trigger_phrases:
+  - "clarify this subtask"
+  - "task-clarify workflow"
+  - "Stage 3 clarify"
+  - "跑 task-clarify"
+---
+
+# task-clarify workflow (v3)
+
+## Overview
+
+单阶段子工作流，将 CLAUDE.md Stage ③.a 子任务澄清纪律映射到 harnessed runtime，
+完整采用 `harnessed.workflow.v3` schema（Phase v3.0-3.4 W0 T3.4.W0.6 — D-09 L0
+Discipline Substrate + D-05 conditional `invokes_tools` + D-04 gate ref）。
+
+| phase | id | upstream | model | capability / invokes_tools | gate |
+| ----- | -- | -------- | ----- | -------------------------- | ---- |
+| 1 | `01-brainstorm` | superpowers | sonnet | `{{ capabilities.superpowers-brainstorming.cmd }}` + `invokes_tools: [{if: phase.spec_ambiguous, tool: grill-with-docs}]` | `judgments.subtask-gate.brainstorming.fires` |
+
+每阶段配置从 `workflows/task/clarify/workflow.yaml` 加载；engine.runRouting 通过
+`@anthropic-ai/claude-agent-sdk` 0.3.142+ 将每个阶段 spawn 为 sub-agent。
+
+## Per-subtask 重复 invoke 模式
+
+task-clarify **不是**一次性阶段——execute-task 主控编排器对**每个 subtask 入口**委托一次
+task-clarify，评估 gate（subtask-gate.brainstorming.fires）是否激活。跳过路径
+（subtask.type in ['crud','standard_lib_call'] OR subtask.lines < 20）完全绕过
+brainstorming，遵循 CLAUDE.md「拿不准 → 倾向跳过」原则。
+
+## Discipline Substrate (L0 always-on)
+
+6 个 discipline（karpathy + output-style + language + operational + priority + protocols）
+按 D-09 L0 Discipline Substrate 横切应用——workflow runtime pre-phase hook 加载
+discipline yaml 并应用规则。Sentinel 类别 `behavioral` 跳过 cmd invoke；runtime engine
+通过 `discipline_ref` 路由至 `workflows/disciplines/<basename>.yaml`。
+
+## 条件性 grill-with-docs 触发 (D-05 invokes_tools)
+
+Phase 01-brainstorm 在 `phase.spec_ambiguous == true` 时条件性 fire `grill-with-docs`——
+对应 CLAUDE.md「Discuss / Research 阶段」mattpocock 招式按需召唤模式；**非**强制
+无条件 fire（D-05 invokes_tools 与 OnClause 并存，但作用面不同——invokes_tools
+属于 phase 级别的条件性工具触发，不决定 phase 是否执行）。
+
+## How to invoke
+
+使用 Bash 工具运行：
+
+```bash
+echo "$ARGUMENTS" | harnessed run task-clarify --task-stdin
+```
+
+若 `$ARGUMENTS` 为空，运行 `harnessed run task-clarify`（不带 stdin pipe）。
+
+执行完成后，Bash 输出会在 stderr 打印 `Next:` 提示，建议下一个阶段。根据对话上下文自行决定是否调用——该提示仅供参考，不具强制性。
+
+<!-- harnessed-generated:v3.4.4 -->
+
+## References
+
+- D-09 — L0 Discipline Substrate always-on (6 disciplines)
+- D-05 — phase-level `invokes_tools` conditional tool fire
+- D-04 — `gate` 4-level ref pre-resolved by `judgmentResolver`
+- D-02 — SKILL.md `name:` bare slash cmd (`task-clarify` NOT `task/clarify`) per ADR 0030
+- `workflows/judgments/subtask-gate.yaml` triggers.brainstorming
+- `workflows/capabilities.yaml` — superpowers-brainstorming + grill-with-docs entries
+- `workflows/defaults.yaml` — ralph_max_iterations.task-clarify.* values (T3.4.W2.2 followup)
+- `docs/WORKFLOW.md` — 4-stage workflow mermaid + Stage ③ Execute 章节

package/workflows/task/code/SKILL.zh-Hans.md

@@ -0,0 +1,85 @@
+---
+name: task-code
+description: |
+  task-code workflow v3 — Stage ③.b 子任务编码 sub-workflow (karpathy 4 心法
+  always-on + mattpocock conditional route + planning-with-files progress.md update)。
+  2-phase composition: 01-code (karpathy 心法 + zoom-out 陌生模块 / improve-arch
+  周期审查 / diagnose bug conditional invokes_tools) → 02-progress (Claude Code plugin
+  /plan 更新 progress.md 跨 session 进度同步)。
+  schema_version: harnessed.workflow.v3 with disciplines_applied [6] + tools_available
+  [zoom-out, improve-codebase-architecture, diagnose, planning-with-files]. Triggered
+  by harnessed CLI `harnessed task-code --task <text>` or slash command `/task-code`
+  after `harnessed setup`.
+trigger_phrases:
+  - "code this subtask"
+  - "task-code workflow"
+  - "Stage 3 code"
+  - "跑 task-code"
+---
+
+# task-code workflow (v3)
+
+## Overview
+
+2-phase 子工作流，将 CLAUDE.md Stage ③.b 子任务编码纪律映射到 harnessed runtime，
+完整采用 `harnessed.workflow.v3` schema（Phase v3.0-3.4 W0 T3.4.W0.7 — D-09 L0
+Discipline Substrate + D-05 conditional `invokes_tools` + D-15
+planning-with-files plugin）。
+
+| phase | id | upstream | model | capability / invokes_tools |
+| ----- | -- | -------- | ----- | -------------------------- |
+| 1 | `01-code` | karpathy | sonnet | `invokes_tools: [{if: phase.unfamiliar_module, tool: zoom-out}, {if: phase.architecture_health_audit, tool: improve-codebase-architecture}, {if: subtask.bug_root_cause_unknown, tool: diagnose}]` |
+| 2 | `02-progress` | planning-with-files | haiku | `{{ capabilities.planning-with-files.cmd }}` / `invokes: /plan` / `artifacts_expected: [progress.md]` |
+
+每阶段配置从 `workflows/task/code/workflow.yaml` 加载；engine.runRouting 通过
+`@anthropic-ai/claude-agent-sdk` 0.3.142+ 将每个阶段 spawn 为 sub-agent。
+
+## Karpathy 4 心法 (L0 Discipline Substrate always-on)
+
+Phase 01-code 的 upstream 是 `karpathy`——runtime engine 加载 `workflows/disciplines/
+karpathy.yaml` discipline rules 横切应用（Think Before Coding / Simplicity
+First / Surgical Changes / Goal-Driven Execution + ≤200L hard limit + no-feature-creep
++ trust-internal-code + no-comments-default）。不 invoke slash cmd，通过 hook 强制
+behavioral rule，遵循 D-09 L0 Discipline Substrate。
+
+## mattpocock conditional route (D-05 invokes_tools)
+
+Phase 01-code 根据 phase fact context 条件性 fire 3 个 mattpocock 招式：
+- `zoom-out` — 陌生模块导航（当 `phase.unfamiliar_module == true`）
+- `improve-codebase-architecture` — 周期架构健康审查（当 `phase.architecture_health_audit == true`）
+- `diagnose` — bug 系统化排错（当 `subtask.bug_root_cause_unknown == true`）
+
+3 个触发条件 OR-chain，任 1 触发即 invoke 对应招式——互不排斥（对应 CLAUDE.md
+「mattpocock 招式按需召唤」模式，NOT exclusive）。无触发 = pure karpathy 心法 only。
+
+## Phase 02-progress planning-with-files plugin 直接对接 (Q-AUDIT-5a LOCKED Option A)
+
+02-progress 调用 **Claude Code plugin** slash command `/plan` 更新
+`.planning/<phase-id>/` 下的 `progress.md`——跟踪 subtask 完成 / blocked / next step，
+遵循捆绑的「跨 session 恢复」模式 + R20.6 Manus-style 持久化。需要安装
+`planning-with-files` Claude Code plugin（通过 Claude Code plugin marketplace 安装）。
+
+## How to invoke
+
+使用 Bash 工具运行：
+
+```bash
+echo "$ARGUMENTS" | harnessed run task-code --task-stdin
+```
+
+若 `$ARGUMENTS` 为空，运行 `harnessed run task-code`（不带 stdin pipe）。
+
+执行完成后，Bash 输出会在 stderr 打印 `Next:` 提示，建议下一个阶段。根据对话上下文自行决定是否调用——该提示仅供参考，不具强制性。
+
+<!-- harnessed-generated:v3.4.4 -->
+
+## References
+
+- D-09 — L0 Discipline Substrate always-on (karpathy 心法 4 条 cross-cutting)
+- D-05 — phase-level `invokes_tools` conditional tool fire
+- D-15 + Q-AUDIT-5a — planning-with-files = Claude Code plugin slash cmd `/plan`
+- D-02 — SKILL.md `name:` bare slash cmd (`task-code` NOT `task/code`) per ADR 0030
+- `workflows/disciplines/karpathy.yaml` — 4 心法 + ≤200L hard limit 等 rules (L0 substrate)
+- `workflows/capabilities.yaml` — zoom-out / improve-codebase-architecture / diagnose / planning-with-files entries
+- `workflows/defaults.yaml` — ralph_max_iterations.task-code.* values (T3.4.W2.2 followup)
+- `docs/WORKFLOW.md` — 4-stage workflow mermaid + Stage ③ Execute 章节

package/workflows/task/deliver/SKILL.zh-Hans.md

@@ -0,0 +1,113 @@
+---
+name: task-deliver
+description: |
+  task-deliver workflow v3 — Stage ③.d 子任务交付 sub-workflow (ralph-loop COMPLETE
+  wrapper + Agent Teams conditional escalation + R20.10 explicit max_iterations_exceeded
+  fallback)。2-phase composition: 01-deliver (ralph-loop SDK wrapper with completion_promise
+  verbatim "COMPLETE" + parallelism judgments.parallelism-gate.ralph-loop-wrapper.fires +
+  fallback emit_warning_and_halt exit_code 1) → 02-progress-mark (Claude Code plugin
+  /plan mark subtask complete in progress.md)。
+  schema_version: harnessed.workflow.v3 with disciplines_applied [6] + tools_available
+  [ralph-loop, agent-teams-create, agent-teams-send-message, agent-teams-shutdown,
+  planning-with-files]. Triggered by harnessed CLI `harnessed task-deliver --task <text>`
+  or slash command `/task-deliver` after `harnessed setup`.
+trigger_phrases:
+  - "deliver this subtask"
+  - "task-deliver workflow"
+  - "Stage 3 deliver"
+  - "ralph-loop COMPLETE"
+  - "跑 task-deliver"
+---
+
+# task-deliver workflow (v3)
+
+## Overview
+
+2-phase 子工作流，将 CLAUDE.md Stage ③.d 子任务交付纪律映射到 harnessed runtime，
+完整采用 `harnessed.workflow.v3` schema（Phase v3.0-3.4 W0 T3.4.W0.9 — D-09 L0
+Discipline Substrate + D-10 ralph-loop SDK wrapper + D-11 Agent Teams 升级 5 触发
+OR-chain + R20.10 explicit max_iterations_exceeded handler）。
+
+| phase | id | upstream | model | capability / args / parallelism / fallback |
+| ----- | -- | -------- | ----- | ------------------------------------------ |
+| 1 | `01-deliver` | ralph-loop | haiku | `{{ capabilities.ralph-loop.cmd }}` + `args: {completion_promise: COMPLETE, max_iterations: ...}` + `parallelism: judgments.parallelism-gate.ralph-loop-wrapper.fires` + `fallback.max_iterations_exceeded.action: emit_warning_and_halt` |
+| 2 | `02-progress-mark` | planning-with-files | haiku | `{{ capabilities.planning-with-files.cmd }}` / `invokes: /plan` / `artifacts_expected: [progress.md]` |
+
+每阶段配置从 `workflows/task/deliver/workflow.yaml` 加载；engine.runRouting 通过
+`@anthropic-ai/claude-agent-sdk` 0.3.142+ 将每个阶段 spawn 为 sub-agent。
+
+## Phase 01 ralph-loop COMPLETE wrapper (R20.10 + D-10 + ADR 0011)
+
+ralph-loop SDK wrapper 保 completion-promise verbatim string `"COMPLETE"`——sub-task
+被认为完成的判据是子任务输出包含 verbatim "COMPLETE" string（NOT 启发式 / NOT
+LLM-as-judge）。Sister capabilities.yaml `ralph-loop` entry impl `bundled-skill` +
+`sdk_ref: src/workflow/lib/ralphLoop.ts`（Phase 2.2 v0.2.0 ship）。
+
+### Parallelism — ralph-loop 正交 wrapper
+
+`parallelism: judgments.parallelism-gate.ralph-loop-wrapper.fires` ref——遵循 R20.10
++ D-10，ralph-loop 是**正交 wrapper**，套在 subagent-default / agent-teams-upgrade /
+main-session-fallback 任意 1 种模式外层（NOT 互斥触发器，而是 parallelism-gate.yaml
+L42-45 中的 `wraps:` 正交字段）。Runtime engine 评估 wrapping mode 后 spawn 相应
+执行单元并套 ralph-loop completion check。
+
+### Agent Teams 条件性升级 (D-11 + agent-teams.md 5 OR-chain)
+
+5 个升级触发（来自 capabilities.yaml `agent-teams-create.fires_when` + agent-teams.md）：
+1. `teammate_send_message_needed == true` — teammate 间 SendMessage 互通（NOT fire-and-forget）
+2. `subagent_context_overflow == true` — subagent 撞 context 上限
+3. `shared_task_list == true` — 多 teammate 共享 task list 自协调
+4. `opposing_hypothesis_debate == true` — 对立假设辩论
+5. `fullstack_three_way == true` — 全栈三路协同
+
+任 1 触发 → 升级 subagent fan-out → Agent Teams Pattern A/B/C。清理是强制的，
+遵循 agent-teams.md 防呆清单（SendMessage shutdown_request + TeamDelete）——属于
+engine 级别的连接，NOT yaml schema 的职责范围。
+
+### R20.10 explicit max_iterations_exceeded handler（非静默中止）
+
+phase.fallback.max_iterations_exceeded = `{action: emit_warning_and_halt, message,
+exit_code: 1}`——通过 FallbackMaxIterationsExceeded Type.Literal(
+'emit_warning_and_halt')（workflow.ts L70-77）做 schema 级强制约束。Sister Phase 2.4
+W1.2 fallbackHandlers.ts engine.ts wire——ralph-loop 撞 max_iterations 时显式 emit
+warning + halt with exit_code 1，NOT 静默中止/继续执行。
+
+Brief enforcement W0.9: ✅ ralph-loop completion_promise COMPLETE / ✅ parallelism-gate
+ref / ✅ R20.10 explicit max_iterations_exceeded handler。
+
+## Phase 02 progress-mark planning-with-files (D-15 + Q-AUDIT-5a Option A)
+
+02-progress-mark 调用 Claude Code plugin slash cmd `/plan`，在 `progress.md` 中将
+subtask 标记为完成——对应 Phase 01-code progress update 模式，是 Stage ③ task chain
+的最后一次调用。需要安装 `planning-with-files` Claude Code plugin（通过
+Claude Code plugin marketplace 安装）。
+
+## How to invoke
+
+使用 Bash 工具运行：
+
+```bash
+echo "$ARGUMENTS" | harnessed run task-deliver --task-stdin
+```
+
+若 `$ARGUMENTS` 为空，运行 `harnessed run task-deliver`（不带 stdin pipe）。
+
+执行完成后，Bash 输出会在 stderr 打印 `Next:` 提示，建议下一个阶段。根据对话上下文自行决定是否调用——该提示仅供参考，不具强制性。
+
+<!-- harnessed-generated:v3.4.4 -->
+
+## References
+
+- D-09 — L0 Discipline Substrate always-on (6 disciplines)
+- D-10 — ralph-loop 真接 SDK wrapper (NOT mock reference; v0.2.0 ship)
+- D-11 — Agent Teams 升级 5 触发 OR-chain per bundled parallelism-gate rules
+- R20.10 — ralph-loop max_iterations_exceeded explicit emit_warning_and_halt
+  (acceptance c "NOT silent abort"); ralph-loop 正交 wrapper wraps 3 mode
+- D-02 — SKILL.md `name:` bare slash cmd (`task-deliver` NOT `task/deliver`) per ADR 0030
+- ADR 0011 — SDK + ralph-loop integration v0.2.0 baseline
+- `workflows/judgments/parallelism-gate.yaml` triggers.ralph-loop-wrapper +
+  agent-teams-upgrade + subagent-default + main-session-fallback
+- `workflows/capabilities.yaml` — ralph-loop + agent-teams-{create,send-message,shutdown}
+  + planning-with-files entries
+- `workflows/defaults.yaml` — ralph_max_iterations.task-deliver.* values (T3.4.W2.2 followup)
+- `docs/WORKFLOW.md` — 4-stage workflow mermaid + Stage ③ Execute 章节

package/workflows/task/test/SKILL.zh-Hans.md

@@ -0,0 +1,90 @@
+---
+name: task-test
+description: |
+  task-test 工作流 v3 — Stage ③.c 子任务测试 sub-workflow (superpowers TDD
+  red-green-refactor 强制 + diagnose 条件调用)。单阶段组合：
+  01-test（能力 `superpowers:test-driven-development` + 关卡
+  judgments.tdd-gate.tdd-strongly-suggested.fires + invokes_tools[{if: test_fail,
+  tool: diagnose}]）。Alias /tdd (mattpocock-skills) 可替代 superpowers TDD per D-13。
+  schema_version: harnessed.workflow.v3，含 disciplines_applied [6] + tools_available
+  [tdd, diagnose]。通过 harnessed CLI `harnessed task-test --task <text>` 或
+  `harnessed setup` 后的斜杠命令 `/task-test` 触发。
+trigger_phrases:
+  - "test this subtask"
+  - "task-test workflow"
+  - "Stage 3 test"
+  - "TDD red-green-refactor"
+  - "跑 task-test"
+---
+
+# task-test workflow (v3)
+
+## 概述
+
+单阶段子工作流，将用户 CLAUDE.md Stage ③.c 子任务测试 + TDD
+强烈建议开启纪律映射到 harnessed 运行时，完整采用 `harnessed.workflow.v3`
+schema（Phase v3.0-3.4 W0 T3.4.W0.8 — D-09 L0 Discipline Substrate + D-04 关卡引用
++ D-05 条件式 `invokes_tools` + D-13 tdd 能力别名）。
+
+| phase | id | upstream | model | capability / invokes_tools | gate |
+| ----- | -- | -------- | ----- | -------------------------- | ---- |
+| 1 | `01-test` | superpowers | sonnet | `{{ capabilities.tdd.cmd }}` + `invokes_tools: [{if: test_fail == true, tool: diagnose}]` | `judgments.tdd-gate.tdd-strongly-suggested.fires` |
+
+每阶段配置从 `workflows/task/test/workflow.yaml` 加载；engine.runRouting
+通过 `@anthropic-ai/claude-agent-sdk` 0.3.142+ 将每个阶段作为 subagent 启动。
+
+## TDD 关卡（D-04 + judgments/tdd-gate.yaml 6 fires_when + 3 skips_when）
+
+关卡 `judgments.tdd-gate.tdd-strongly-suggested.fires` 机器化 CLAUDE.md
+「Execute 阶段」TDD 强烈建议开启节的 6 项 OR-chain：
+- `subtask.is_core_business_logic == true`
+- `subtask.is_algorithm == true`
+- `subtask.is_data_processing == true`
+- `subtask.regression_risk == 'high'`
+- `subtask.reliability_required == true`
+
+跳过条件（per tdd-gate.yaml skips_when）：
+- `subtask.type in ['crud', 'ui_polish', 'docs_only']`
+
+关卡 4 级引用由 `judgmentResolver`（T2.3.W0.4 SHIPPED）在 expr-eval 求值**前**预解析——
+运行时引擎在关卡未触发时跳过该阶段。
+
+## D-13 tdd 能力别名
+
+能力 `tdd`（per capabilities.yaml L346-359）主 impl 为 `superpowers:test-driven-
+development`，别名 `[{impl: mattpocock-skills, cmd: /tdd}]` — 两者可替代 per D-13
+LOCKED 决策。`{{ capabilities.tdd.cmd }}` 默认 resolve 至 superpowers
+SDK，用户发出明确信号时可切换至 mattpocock /tdd 别名路径。
+
+## 条件式 diagnose 调用（D-05 invokes_tools）
+
+阶段 01-test 在 `test_fail == true` 时条件性触发 `diagnose`（capabilities.yaml L55-64 mattpocock-skills
+/diagnose）— 对应 sister CLAUDE.md「系统化排错」模式；
+测试失败时进入 diagnose 循环（reproduce → minimise → hypothesise → instrument →
+fix → regression-test），测试通过则完全跳过 diagnose。
+
+## 调用方式
+
+使用 Bash 工具运行：
+
+```bash
+echo "$ARGUMENTS" | harnessed run task-test --task-stdin
+```
+
+若 `$ARGUMENTS` 为空，运行 `harnessed run task-test`（不带 stdin pipe）。
+
+执行完成后，Bash 输出会在 stderr 打印 `Next:` 提示，建议下一阶段操作。是否调用取决于对话上下文——该提示仅供参考，不具强制性。
+
+<!-- harnessed-generated:v3.4.4 -->
+
+## 参考资料
+
+- D-09 — L0 Discipline Substrate always-on
+- D-04 — `gate` 4 级引用由 `judgmentResolver` 预解析
+- D-05 — 阶段级 `invokes_tools` 条件工具触发
+- D-13 — tdd 能力 2 impl 候选别名（superpowers 主 + mattpocock /tdd 备）
+- D-02 — SKILL.md `name:` 裸斜杠命令（`task-test` 而非 `task/test`）per ADR 0030
+- `workflows/judgments/tdd-gate.yaml` triggers.tdd-strongly-suggested
+- `workflows/capabilities.yaml` — tdd（superpowers + mattpocock 别名）+ diagnose 条目
+- `workflows/defaults.yaml` — ralph_max_iterations.task-test.* 值（T3.4.W2.2 followup）
+- `docs/WORKFLOW.md` — 4-stage 工作流 mermaid + Stage ③ Execute 章节

package/workflows/verify/auto/SKILL.zh-Hans.md

@@ -0,0 +1,89 @@
+---
+name: verify
+description: |
+  Stage ④ Verify 主控编排器 — 7 个条件子工作流，按打包的 Verify 阶段节奏执行：
+  progress 必跑 → code-review 并行 → paranoid 关键模块强制 → qa/security/design 可选
+  并行 conditional → simplify 末尾 → multispec 关键发布 Pattern C 4-specialist Agent Team。
+  schema_version: harnessed.workflow.v3，含 delegates_to（7 sub：progress serial order 1 +
+  5 parallel conditional + simplify serial order 99）+ disciplines_applied（6 default）+
+  tools_available（10 entry）。通过 harnessed CLI `harnessed verify --phase <num>` 或
+  `harnessed setup` 后的斜杠命令 `/verify`（裸命令，per ADR 0030 命名空间规范 D-02 LOCK）触发。
+trigger_phrases:
+  - "verify"
+  - "验证阶段"
+  - "stage 4 verify"
+  - "verify work"
+  - "代码审查 + 简化"
+---
+
+# verify 主控编排器（v3）
+
+## 概述
+
+4-stage 节奏 Stage ④ 主控编排器，委托给 7 个子工作流
+（打包的 Verify 阶段节奏 — 9 阶段组合压缩为 7 个子委托
+via stage-routing.yaml）：
+
+| order/mode | sub | gate ref | mode | when fires |
+| ---------- | --- | -------- | ---- | ---------- |
+| 1 (serial) | `progress` | （无条件 — verify 起点） | serial | 当 stage=='verify' 时始终触发 |
+| parallel | `code-review` | （无条件 — multi-agent fan-out） | parallel | 始终触发 |
+| parallel | `paranoid` | `judgments.stage-routing.verify-paranoid-critical.fires` | parallel | phase.is_critical_module == true |
+| parallel | `qa` | `judgments.stage-routing.verify-qa-ui.fires` | parallel | phase.has_ui_changes == true |
+| parallel | `security` | `judgments.stage-routing.verify-security-secrets.fires` | parallel | phase.has_auth_or_secrets == true |
+| parallel | `design` | `judgments.stage-routing.verify-design-changes.fires` | parallel | phase.has_design_changes == true |
+| parallel | `multispec` | `judgments.stage-routing.verify-multispec-critical-release.fires` | parallel | is_critical_release == true（Pattern C 4-specialist Agent Team） |
+| 99 (serial) | `simplify` | （无条件 — 末尾收尾） | serial | 始终触发 — code-simplifier 末尾移除重复 / 多余逻辑 |
+
+引擎运行时 per T3.5.W0.1 `runMasterOrchestrator`：
+- **串行链**：progress（order 1）起点 → ... → simplify（order 99）末尾收尾
+- **并行 fan-out**：5 个条件子工作流（code-review + paranoid + qa + security + design + multispec）
+  并发启动，按关卡求值结果决定触发或跳过
+- K9 不变量强制执行：每个 serial 模式委托必须携带显式 `order`
+
+## Verify 节奏（sister CLAUDE.md「Verify 阶段」原文）
+
+1. 子任务完成后立即 `/gsd-verify-work` + `/gsd-progress`（sub progress 起点必跑串行）
+2. 项目 / 大功能整体完成后：
+   - 先 `code-review` 多 Agent 并行（sub code-review）
+   - **关键模块强制** `/review` Paranoid Staff Engineer（sub paranoid，关卡 is_critical_module）
+   - 可选 `/qa`（sub qa，关卡 has_ui_changes）/ `/cso`（sub security，关卡 has_auth_or_secrets）/ `/design-review`（sub design，关卡 has_design_changes）
+   - **关键发布 / 大重构 PR** 升级 4-specialist Agent Team Pattern C（sub multispec，关卡 critical-release-upgrade）
+   - 再 `code-simplifier` 末尾（sub simplify，serial order 99）
+
+## 能力引用
+
+Sister `workflows/capabilities.yaml`：
+- `gsd-verify-work` + `gsd-progress` — Bucket 2（progress sub upstream）
+- `code-review` + `code-simplifier` — Bucket 1 mattpocock（code-review + simplify subs）
+- `gstack-review` + `gstack-qa` + `gstack-cso` + `gstack-design-review` — Bucket 3 治理关卡（paranoid/qa/security/design subs）
+- `agent-teams-create` — Bucket 5 agent-platform（multispec Pattern C 4-specialist team）
+- `planning-with-files` — Bucket 4 核心（progress.md sink throughout）
+
+## 调用方式说明
+
+- 斜杠命令：`/verify`（裸命令，per ADR 0030 命名空间规范 D-02 LOCK，在 `harnessed setup` 后使用）
+
+## 如何调用
+
+使用 Bash 工具运行：
+
+```bash
+echo "$ARGUMENTS" | harnessed run verify --task-stdin
+```
+
+若 `$ARGUMENTS` 为空，运行 `harnessed run verify`（不带 stdin pipe）。
+
+执行完成后，Bash 输出会在 stderr 打印 `Next:` 提示，建议下一阶段操作。是否调用取决于对话上下文——该提示仅供参考，不具强制性。
+
+<!-- harnessed-generated:v3.4.4 -->
+
+## 参考资料
+
+- D-01 主控编排器委托模式
+- D-02 裸斜杠命令约定（ADR 0030 命名空间规范 LOCK）
+- D-12 gstack 治理关卡引用（paranoid / qa / security / design subs）
+- workflows/judgments/parallelism-gate.yaml — Pattern C 多维度审查（multispec sub 4-specialist 互相质询）
+- workflows/judgments/stage-routing.yaml — verify-* 6 触发器（7 sub 委托）
+- workflows/verify/{progress,code-review,paranoid,qa,security,design,simplify,multispec}/workflow.yaml
+  — 8 个子工作流 Phase 3.4 SHIPPED

package/workflows/verify/code-review/SKILL.zh-Hans.md

@@ -0,0 +1,71 @@
+---
+name: verify-code-review
+description: |
+  Stage ④.b verify 子工作流 — code-review 多 agent 并行 fan-out 高置信度 finding
+  （subagent 默认路由，per 打包的 parallelism 关卡 — Task / Agent 工具 spawn
+  多 subagent fan-out，context 隔离，token 敏感）。
+  schema_version: harnessed.workflow.v3，含 disciplines_applied（6 default）+ tools_available
+  （code-review）+ 1 阶段（parallelism ref judgments.parallelism-gate.subagent-default.fires）。
+  通过 `harnessed setup` 后的斜杠命令
+  `/verify-code-review` 触发。
+trigger_phrases:
+  - "verify code review"
+  - "代码审查"
+  - "multi-agent code review"
+  - "并行 review"
+  - "跑 verify-code-review"
+---
+
+# verify-code-review workflow (v3)
+
+## 概述
+
+单阶段子工作流，将 CLAUDE.md「Verify 阶段 — code-review 多 agent 并行」章节
+映射到 harnessed 运行时（Phase v3.0-3.4 W0.11 — D-04 Stage ④ Verify 7 sub + 子任务并行
+机制 subagent 默认路由机器化 + Pattern A 子工作流发布）。
+
+| phase | id | upstream | model | capability | parallelism |
+| ----- | -- | -------- | ----- | ---------- | ----------- |
+| 1 | `01-code-review` | mattpocock-skills | sonnet | `{{ capabilities.code-review.cmd }}` | `judgments.parallelism-gate.subagent-default.fires` |
+
+每阶段配置从 `workflows/verify/code-review/workflow.yaml` 加载；引擎以并行 fan-out 方式
+启动多个 subagent（打包的 subagent-default 规则 — Task / Agent
+工具 spawn 多任务并发，context 隔离，summary 折叠回主 context）。
+
+## 能力引用
+
+Sister `workflows/capabilities.yaml` 条目：
+- `code-review` — Bucket 1 mattpocock 高频招式（impl: mattpocock-skills，cmd: /code-review）
+
+## Parallelism 关卡引用
+
+Sister `workflows/judgments/parallelism-gate.yaml`：
+- `subagent-default.fires` — `subtask.parallel_count <= 3 and subtask.communication_needed == false`
+  （默认 fan-out，focused 任务 research / verify / review 单文件 / 跑测试 / 抓 doc / 探索模块）
+
+## 路由规则
+
+在 `phase.stage == 'verify'` 触发后，必须先跑串行（verify-progress），之后并行 fan-out。无跳过
+条件 — code-review 多 agent 是 verify-work 第 3 阶段的默认 fan-out（sister CLAUDE.md 原文）。
+
+## 如何调用
+
+使用 Bash 工具运行：
+
+```bash
+echo "$ARGUMENTS" | harnessed run verify-code-review --task-stdin
+```
+
+若 `$ARGUMENTS` 为空，运行 `harnessed run verify-code-review`（不带 stdin pipe）。
+
+执行完成后，Bash 输出会在 stderr 打印 `Next:` 提示，建议下一阶段操作。是否调用取决于对话上下文——该提示仅供参考，不具强制性。
+
+<!-- harnessed-generated:v3.4.4 -->
+
+## 参考资料
+
+- D-04 Stage ④ Verify 7 sub 分解
+- workflows/capabilities.yaml — code-review
+- workflows/judgments/parallelism-gate.yaml — subagent-default.fires
+- workflows/defaults.yaml — ralph_max_iterations.verify-code-review.* 值（W2.2 backfill）
+- workflows/verify-work/workflow.yaml v2 SHIPPED phase 03-code-review-parallel sister verbatim