harnessed 4.7.0 → 4.9.0

package/workflows/disciplines/priority.zh-Hans.yaml

@@ -0,0 +1,28 @@
+# workflows/disciplines/priority.yaml
+# 优先级仲裁 — bundled discipline (7-tier hierarchy: gstack > gsd > superpowers > planning-with-files > karpathy > mattpocock > parallel)
+# Phase v3.0-3.3 W0.4 ship per D-09
+# Snapshot of CLAUDE.md as of v3.0 ship date (K7 mitigation, verbatim)
+
+schema_version: harnessed.discipline.v1
+discipline: priority
+enforcement_layer: workflow
+auto_enforce: true
+
+priority_hierarchy:
+  - gstack                       # 决策层 最高优先
+  - gsd                          # 整体 orchestration
+  - superpowers                  # 子任务执行质量
+  - planning-with-files          # 计划持久化
+  - karpathy                     # 编码行为
+  - mattpocock                   # 招式 by-demand
+  - parallel                     # subagent / Agent Teams / ralph-loop 执行机制
+
+rules:
+  - id: multi-capability-arbitration
+    description: |
+      多 capability fires_when 同时 true → 按 priority_hierarchy order 选最高
+      e.g., gstack /office-hours + GSD /gsd-discuss-phase 同 fire → gstack 先跑
+    enforcement: warn
+    trigger: capabilities.fired_count > 1
+    check_method: heuristic
+    # NEW src/discipline/enforcement/before-spawn.ts hook — sort fired capabilities by tier rank

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

@@ -0,0 +1,75 @@
+---
+name: discuss
+description: |
+  Stage ① Discuss 主控编排器 — 3 个子工作流并行门控评估（chain-isolation 铁律）。
+  战略层 / Phase 层 / 子任务层独立判断 gate, 可能 3 个全跑 / 1-2 个 / 全跳 + 透明声明。
+  schema_version: harnessed.workflow.v3 with delegates_to (3 sub: strategic + phase + subtask, mode parallel)
+  + disciplines_applied (6 default) + tools_available (planning-with-files)。
+  Triggered by slash command `/discuss`
+  (bare per ADR 0030 namespace policy D-02 LOCK) after `harnessed setup`.
+trigger_phrases:
+  - "discuss"
+  - "讨论澄清"
+  - "新功能澄清"
+  - "stage 1 discuss"
+  - "三层澄清"
+---
+
+# discuss 主控编排器 (v3)
+
+## 概述
+
+4-stage cadence Stage ① 主控编排器，委托给 3 个独立子工作流
+（打包三层独立澄清：战略层 / phase 层 / 子任务层）：
+
+| 子工作流 | gate ref | mode | 触发时机 |
+| --- | -------- | ---- | ---------- |
+| `strategic` | `judgments.stage-routing.discuss-strategic-delegate.fires` | parallel | new_project / new_milestone / new_feature / is_major_release |
+| `phase` | `judgments.stage-routing.discuss-phase-delegate.fires` | parallel | open_decisions ≥ 2 / cross_phase_data_flow / scope_days > 1 |
+| `subtask` | `judgments.stage-routing.discuss-subtask-delegate.fires` | parallel | approaches ≥ 2 / core_algorithm / has_api_contract / error_cost=high |
+
+引擎运行时通过 `runMasterOrchestrator` 以
+T3.5.W0.1（sister sub-workflow `runWorkflow` SDK pattern，并行 fan-out 通过
+subagent 默认方式 — Path A `query()` 并行 OR Path B sub-shell 兜底，per
+T3.5.W2.1 dogfood cycle decision LOCK）生成 3 个子工作流阶段。
+
+## Chain-isolation 铁律（sister CLAUDE.md "Fallback 三条铁律"）
+
+- 拿不准 → 倾向跳过, 但在响应里**透明声明**: "这次跳过了 X, 因为 Y。如果你认为需要请明说"
+- 用户明示 → 覆盖判据 (用户说 "先 brainstorm" / "跑 office-hours" / "讨论一下" 时无条件激活)
+- **链式互不前置**: 跳过战略层 ≠ 必须跳过 phase 层; 每层独立判断 (防止 "上层没跑下层不敢跑" 的死板)
+
+## 能力引用
+
+Sister `workflows/capabilities.yaml`:
+- `planning-with-files` — Bucket 4 核心能力（impl: claude-code-plugin, cmd: /plan，discuss 汇入 findings.md）
+- sub `strategic` upstream → `gstack-office-hours` + `gstack-plan-ceo-review`
+- sub `phase` upstream → `gsd-discuss-phase`
+- sub `subtask` upstream → `superpowers-brainstorming` + `grill-with-docs` + `grill-me`
+
+## 调用方式
+
+- Slash command: `/discuss <text>`（bare per ADR 0030 namespace policy D-02 LOCK，`harnessed setup` 后可用）
+
+## 如何调用
+
+使用 Bash 工具运行：
+
+```bash
+echo "$ARGUMENTS" | harnessed run discuss --task-stdin
+```
+
+若 `$ARGUMENTS` 为空，运行 `harnessed run discuss`（不带 stdin pipe）。
+
+执行完成后，Bash 输出会在 stderr 打印 `Next:` 提示，建议下一个阶段。请根据对话上下文决定是否调用——该提示仅供参考，非强制指令。
+
+<!-- harnessed-generated:v3.4.4 -->
+
+## 参考资料
+
+- D-01 主控编排器委托模式
+- D-02 bare slash cmd 约定（ADR 0030 namespace policy LOCK）
+- D-04 Stage ① Discuss 三层独立判
+- workflows/judgments/stage-routing.yaml — discuss-{strategic,phase,subtask}-delegate triggers
+- workflows/discuss/{strategic,phase,subtask}/workflow.yaml — 3 个子工作流 Phase 3.4 已发布
+- workflows/judgments/fallback.yaml — 链式互不前置 chain-isolation 铁律

package/workflows/discuss/phase/SKILL.zh-Hans.md

@@ -0,0 +1,73 @@
+---
+name: discuss-phase
+description: |
+  Stage ①.b Phase 层 discuss 子工作流 — GSD /gsd-discuss-phase 灰色澄清（≥2 个开放
+  实现决策 / 跨 phase API contract 不清 / phase scope > 1 天 / 灰色地带）。
+  schema_version: harnessed.workflow.v3 with disciplines_applied (6 default) + tools_available
+  (gsd-discuss-phase + planning-with-files) + 2 phases（01-gsd-discuss + 02-persist findings.md
+  + knowledge.md）。Triggered by harnessed CLI `harnessed discuss-phase --phase <num>` or slash
+  command `/discuss-phase` after `harnessed setup`.
+trigger_phrases:
+  - "discuss phase"
+  - "phase 层澄清"
+  - "gsd discuss phase"
+  - "灰色地带澄清"
+  - "跑 discuss-phase"
+---
+
+# discuss-phase 工作流 (v3)
+
+## 概述
+
+2 阶段子工作流，将 CLAUDE.md "Stage ①.b Phase 层 — GSD /gsd-discuss-phase 灰色澄清"
+映射到 harnessed 运行时（Phase v3.0-3.4 W0.2 — D-04 Stage ① Discuss 三层 + Pattern A
+子工作流发布）。
+
+| 阶段 | id | upstream | model | 能力 / 调用 | 门控 / 产物 |
+| ----- | -- | -------- | ----- | -------------------- | ---------------- |
+| 1 | `01-gsd-discuss` | gsd | sonnet | `{{ capabilities.gsd-discuss-phase.cmd }}` | `gate: judgments.phase-gate.gsd-discuss-phase.fires` |
+| 2 | `02-persist` | planning-with-files | haiku | `{{ capabilities.planning-with-files.cmd }}` + `invokes: /plan` | `artifacts_expected: [findings.md, knowledge.md]` |
+
+## 能力引用
+
+Sister `workflows/capabilities.yaml` 条目：
+- `gsd-discuss-phase` — Bucket 2（impl: gsd, cmd: /gsd-discuss-phase）
+- `planning-with-files` — Bucket 4（impl: claude-code-plugin, cmd: /plan）
+
+## 门控引用
+
+Sister `workflows/judgments/phase-gate.yaml`:
+- `gsd-discuss-phase.fires` — `phase.open_decisions >= 2 or phase.has_cross_phase_data_flow == true or phase.scope_days > 1`
+
+## 调用方式
+
+- Slash command: `/discuss-phase <num>`（`harnessed setup` 后可用）
+
+## 路由规则
+
+跳过条件（sister CLAUDE.md "Phase 层 ❌ 跳过"）：
+- 单一明确子任务
+- 跟前 phase 同 module 同 pattern
+- < 1 天工作量
+- bug 修复且已有最小复现
+
+## 如何调用
+
+使用 Bash 工具运行：
+
+```bash
+echo "$ARGUMENTS" | harnessed run discuss-phase --task-stdin
+```
+
+若 `$ARGUMENTS` 为空，运行 `harnessed run discuss-phase`（不带 stdin pipe）。
+
+执行完成后，Bash 输出会在 stderr 打印 `Next:` 提示，建议下一个阶段。请根据对话上下文决定是否调用——该提示仅供参考，非强制指令。
+
+<!-- harnessed-generated:v3.4.4 -->
+
+## 参考资料
+
+- D-04 Stage ① Discuss 三层（战略层 / phase 层 / 子任务层）
+- workflows/capabilities.yaml — gsd-discuss-phase / planning-with-files
+- workflows/judgments/phase-gate.yaml — gsd-discuss-phase trigger
+- workflows/defaults.yaml — ralph_max_iterations.discuss-phase.* values (W2.2 backfill)

package/workflows/discuss/strategic/SKILL.zh-Hans.md

@@ -0,0 +1,78 @@
+---
+name: discuss-strategic
+description: |
+  Stage ①.a 战略层 discuss 子工作流 — gstack /office-hours + /plan-ceo-review 新功能 / 新
+  milestone / 新产品方向启动前强制治理关卡（打包 gstack governance gate，新功能前必跑）。
+  schema_version: harnessed.workflow.v3 with disciplines_applied (6 default) + tools_available
+  (gstack-office-hours + gstack-plan-ceo-review + planning-with-files) + 3 phases（gate
+  judgments.strategic-gate.* fires + planning-with-files /plan findings.md 持久化）。
+  Triggered by slash command
+  `/discuss-strategic` after `harnessed setup`.
+trigger_phrases:
+  - "discuss strategic"
+  - "战略层澄清"
+  - "office hours"
+  - "新功能启动"
+  - "跑 discuss-strategic"
+---
+
+# discuss-strategic 工作流 (v3)
+
+## 概述
+
+3 阶段子工作流，将 CLAUDE.md "Stage ①.a 战略层 — 新功能启动前强制 🔒"
+映射到 harnessed 运行时（Phase v3.0-3.4 W0.1 — D-04 Stage ① Discuss 三层 + D-12 gstack
+治理关卡 + Pattern A 子工作流发布）。
+
+| 阶段 | id | upstream | model | 能力 / 调用 | 门控 / 产物 |
+| ----- | -- | -------- | ----- | -------------------- | ---------------- |
+| 1 | `01-office-hours` | gstack | opus | `{{ capabilities.gstack-office-hours.cmd }}` | `gate: judgments.strategic-gate.office-hours.fires` |
+| 2 | `02-plan-ceo-review` | gstack | opus | `{{ capabilities.gstack-plan-ceo-review.cmd }}` | `gate: judgments.strategic-gate.plan-ceo-review.fires` |
+| 3 | `03-persist` | planning-with-files | haiku | `{{ capabilities.planning-with-files.cmd }}` + `invokes: /plan` | `artifacts_expected: [findings.md]` |
+
+## 能力引用
+
+Sister `workflows/capabilities.yaml` 条目：
+- `gstack-office-hours` — Bucket 3 治理关卡（impl: gstack, cmd: /office-hours）
+- `gstack-plan-ceo-review` — Bucket 3 治理关卡（impl: gstack, cmd: /plan-ceo-review）
+- `planning-with-files` — Bucket 4 核心能力（impl: claude-code-plugin, cmd: /plan）
+
+## 门控引用
+
+Sister `workflows/judgments/strategic-gate.yaml`:
+- `office-hours.fires` — `phase.type in ['new_project', 'new_milestone', 'new_feature']`
+- `plan-ceo-review.fires` — `phase.type == 'new_project' or phase.is_major_release == true`
+
+## 调用方式
+
+- Slash command: `/discuss-strategic <text>`（`harnessed setup` 后可用）
+
+## 路由规则
+
+跳过条件（sister CLAUDE.md "战略层 ❌ 跳过"）：
+- bug 修复 / 技术债 / 实现细节
+- scope 已在历史 `.planning/` 或 design doc 定义
+- continuing 已有 phase 的执行
+- 用户已给明确 ticket / spec
+
+## 如何调用
+
+使用 Bash 工具运行：
+
+```bash
+echo "$ARGUMENTS" | harnessed run discuss-strategic --task-stdin
+```
+
+若 `$ARGUMENTS` 为空，运行 `harnessed run discuss-strategic`（不带 stdin pipe）。
+
+执行完成后，Bash 输出会在 stderr 打印 `Next:` 提示，建议下一个阶段。请根据对话上下文决定是否调用——该提示仅供参考，非强制指令。
+
+<!-- harnessed-generated:v3.4.4 -->
+
+## 参考资料
+
+- D-04 Stage ① Discuss 三层（战略层 / phase 层 / 子任务层）
+- D-12 gstack 治理关卡强制
+- workflows/capabilities.yaml — gstack-office-hours / gstack-plan-ceo-review / planning-with-files
+- workflows/judgments/strategic-gate.yaml — office-hours / plan-ceo-review triggers
+- workflows/defaults.yaml — ralph_max_iterations.discuss-strategic.* values (W2.2 backfill)

package/workflows/discuss/subtask/SKILL.zh-Hans.md

@@ -0,0 +1,79 @@
+---
+name: discuss-subtask
+description: |
+  Stage ①.c 子任务层 discuss 子工作流 — superpowers brainstorming（≥2 种方案 / 核心算法 /
+  API contract / 错误成本高）。schema_version: harnessed.workflow.v3 with disciplines_applied (6
+  default) + tools_available (superpowers-brainstorming + grill-with-docs + grill-me) + 1 phase
+  （01-brainstorm，含 spec_ambiguous + no_docs 条件调用 invokes_tools）。Triggered by
+  harnessed CLI `harnessed discuss-subtask --task <text>` or slash command `/discuss-subtask`
+  after `harnessed setup`.
+trigger_phrases:
+  - "discuss subtask"
+  - "子任务澄清"
+  - "brainstorm"
+  - "多 approach 探索"
+  - "跑 discuss-subtask"
+---
+
+# discuss-subtask 工作流 (v3)
+
+## 概述
+
+1 阶段子工作流，将 CLAUDE.md "Stage ①.c 子任务层 — superpowers brainstorming"
+映射到 harnessed 运行时（Phase v3.0-3.4 W0.3 — D-04 Stage ① Discuss 三层 + D-05
+phase.invokes_tools 条件触发 + Pattern A 子工作流发布）。
+
+| 阶段 | id | upstream | model | 能力 / invokes_tools | 门控 |
+| ----- | -- | -------- | ----- | -------------------------- | ---- |
+| 1 | `01-brainstorm` | superpowers | opus | `{{ capabilities.superpowers-brainstorming.cmd }}` + conditional `invokes_tools[grill-with-docs, grill-me]` | `gate: judgments.subtask-gate.brainstorming.fires` |
+
+## 能力引用
+
+Sister `workflows/capabilities.yaml` 条目：
+- `superpowers-brainstorming` — Bucket 4（impl: superpowers, cmd: superpowers:brainstorming）
+- `grill-with-docs` — Bucket 1 mattpocock（impl: mattpocock-skills, cmd: /grill-with-docs）
+- `grill-me` — Bucket 1 mattpocock（impl: mattpocock-skills, cmd: /grill-me）
+
+## 门控引用
+
+Sister `workflows/judgments/subtask-gate.yaml`:
+- `brainstorming.fires` — `subtask.approaches >= 2 or subtask.core_algorithm == true or subtask.has_api_contract == true or subtask.error_cost == 'high'`
+
+## 条件工具调用（D-05 invokes_tools）
+
+- `phase.spec_ambiguous == true` → 触发 `grill-with-docs`
+- `phase.spec_ambiguous == true AND phase.no_docs == true` → 触发 `grill-me`
+
+## 调用方式
+
+- Slash command: `/discuss-subtask <text>`（`harnessed setup` 后可用）
+
+## 路由规则
+
+跳过条件（sister CLAUDE.md "子任务层 ❌ 跳过"）：
+- 常规 CRUD / 跟现有模式一致
+- 单一明显实现（< 20 行 / 一个文件）
+- 标准库直接调用
+- bug 修复且已知根因
+
+## 如何调用
+
+使用 Bash 工具运行：
+
+```bash
+echo "$ARGUMENTS" | harnessed run discuss-subtask --task-stdin
+```
+
+若 `$ARGUMENTS` 为空，运行 `harnessed run discuss-subtask`（不带 stdin pipe）。
+
+执行完成后，Bash 输出会在 stderr 打印 `Next:` 提示，建议下一个阶段。请根据对话上下文决定是否调用——该提示仅供参考，非强制指令。
+
+<!-- harnessed-generated:v3.4.4 -->
+
+## 参考资料
+
+- D-04 Stage ① Discuss 三层（战略层 / phase 层 / 子任务层）
+- D-05 phase.invokes_tools 条件触发（NEW v3）
+- workflows/capabilities.yaml — superpowers-brainstorming / grill-with-docs / grill-me
+- workflows/judgments/subtask-gate.yaml — brainstorming trigger
+- workflows/defaults.yaml — ralph_max_iterations.discuss-subtask.* values (W2.2 backfill)

package/workflows/plan/architecture/SKILL.zh-Hans.md

@@ -0,0 +1,74 @@
+---
+name: plan-architecture
+description: |
+  Stage ②.a 架构层 plan 子工作流 — gstack /plan-eng-review（复杂架构强制治理关卡；
+  打包的 plan-stage 节奏：复杂架构阶段前必须执行）。schema_version:
+  harnessed.workflow.v3 with disciplines_applied (6 default) + tools_available
+  [plan-eng-review] + 1 phase (01-plan-eng-review) + gate literal expr
+  `phase.is_complex_architecture == true`。Triggered by harnessed CLI `harnessed
+  plan-architecture --module <name>` or slash command `/plan-architecture` after
+  `harnessed setup`.
+trigger_phrases:
+  - "plan architecture"
+  - "架构审查"
+  - "plan eng review"
+  - "复杂架构"
+  - "跑 plan-architecture"
+---
+
+# plan-architecture 工作流 (v3)
+
+## 概述
+
+1 阶段子工作流，将 CLAUDE.md "⚠️ 复杂架构前 — plan-eng-review" 映射到 harnessed
+运行时（Phase v3.0-3.4 W0.4 — D-04 Stage ② Plan 二层 + D-12 gstack 治理关卡 + Pattern A
+sub-workflow ship）。
+
+| phase | id | upstream | model | capability | gate |
+| ----- | -- | -------- | ----- | ---------- | ---- |
+| 1 | `01-plan-eng-review` | gstack | opus | `{{ capabilities.plan-eng-review.cmd }}` | `gate: phase.is_complex_architecture == true` (literal expr) |
+
+## 能力引用
+
+Sister `workflows/capabilities.yaml` 条目：
+- `plan-eng-review` — Bucket 7 gstack 33 optional (impl: gstack, cmd: /plan-eng-review)
+  - Pattern A E.2 LOCK：无 `gstack-` 前缀，遵循 CLAUDE.md gstack skill 路由约定
+
+## 门控引用
+
+内联 literal expr `phase.is_complex_architecture == true` — sister capability
+`fires_when` 子句原文。W2.2 backfill 可加 `judgments/phase-gate.yaml`
+trigger `is-complex-architecture` 重构 ref。
+
+## 调用方式
+
+- Slash command：`/plan-architecture <name>`（`harnessed setup` 后生效）
+
+## 路由规则
+
+触发条件（sister CLAUDE.md "⚠️ 复杂架构前"）：
+- 涉及多模块跨界设计（≥3 模块协同）
+- 新引入核心抽象（新 framework / 新数据模型 / 新协议）
+- 性能 / scaling 关键路径
+- 引入显著技术债 / migration 风险
+
+## 如何调用
+
+使用 Bash 工具运行：
+
+```bash
+echo "$ARGUMENTS" | harnessed run plan-architecture --task-stdin
+```
+
+若 `$ARGUMENTS` 为空，运行 `harnessed run plan-architecture`（不带 stdin pipe）。
+
+完成后，Bash 输出会在 stderr 打印 `Next:` 提示，建议下一阶段。是否调用由对话上下文决定——该提示仅供参考，非强制指令。
+
+<!-- harnessed-generated:v3.4.4 -->
+
+## 参考文档
+
+- D-04 Stage ② Plan 二层（架构 / 计划）
+- D-12 gstack 治理关卡（复杂架构强制）
+- workflows/capabilities.yaml — plan-eng-review (Bucket 7)
+- workflows/defaults.yaml — ralph_max_iterations.plan-architecture.* values (W2.2 backfill)

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

@@ -0,0 +1,75 @@
+---
+name: plan
+description: |
+  Stage ② Plan 主控编排器 — 串行 invoke 2 个子工作流（architecture 条件触发 → phase 始终触发）。
+  复杂架构 gstack /plan-eng-review 锁定架构后再 GSD /gsd-plan-phase + planning-with-files 持久化
+  task_plan.md。schema_version: harnessed.workflow.v3 with delegates_to (2 sub: architecture
+  serial order 1 + phase serial order 2) + disciplines_applied (6 default) + tools_available
+  (planning-with-files + plan-eng-review + gsd-plan-phase)。
+  Triggered by slash command `/plan`
+  (bare per ADR 0030 namespace policy D-02 LOCK) after `harnessed setup`.
+trigger_phrases:
+  - "plan"
+  - "计划阶段"
+  - "stage 2 plan"
+  - "持久化计划"
+  - "task_plan"
+---
+
+# plan 主控编排器 (v3)
+
+## 概述
+
+4-stage cadence Stage ② 主控编排器，委派给 2 个串行子工作流
+（打包的 Plan 阶段节奏 + D-06 planning-with-files 横切工具）：
+
+| order | sub | gate ref | mode | when fires |
+| ----- | --- | -------- | ---- | ---------- |
+| 1 | `architecture` | `judgments.stage-routing.plan-architecture-delegate.fires` | serial | phase.is_complex_architecture == true |
+| 2 | `phase` | (unconditional — plan-phase always fires when stage=='plan') | serial | always |
+
+引擎运行时通过 `runMasterOrchestrator` 按 T3.5.W0.1 顺序派发 2 个子工作流阶段：
+order 1（architecture 条件触发）必须完成后，order 2 才启动
+（phase 无条件，GSD plan-phase + planning-with-files `/plan` task_plan.md 持久化）。
+K9 invariant 强制：每个 serial mode 委派必须携带显式 `order`。
+
+## 能力引用
+
+Sister `workflows/capabilities.yaml`：
+- `planning-with-files` — Bucket 4 核心 capability (impl: claude-code-plugin, cmd: /plan)
+- `plan-eng-review` — Bucket 7 gstack 33 optional (impl: gstack, cmd: /plan-eng-review)
+- `gsd-plan-phase` — Bucket 2 special-purpose (impl: gsd, cmd: /gsd-plan-phase)
+- sub `architecture` upstream → `plan-eng-review`
+- sub `phase` upstream → `gsd-plan-phase` + `planning-with-files`
+
+## 路由规则（sister CLAUDE.md "Plan 阶段"）
+
+- **复杂架构必须先跑** `/plan-eng-review` 锁定架构后再进入 plan-phase (sister CLAUDE.md "⚠️")
+- 普通 phase 跳过 architecture sub（gate `phase.is_complex_architecture == false`）
+- **禁止在规划阶段直接使用** `superpowers:writing-plans` 输出大文档（除非用户明确要求）
+
+## 调用方式
+
+- Slash command：`/plan <text>`（bare per ADR 0030 namespace policy D-02 LOCK，`harnessed setup` 后生效）
+
+## 如何调用
+
+使用 Bash 工具运行：
+
+```bash
+echo "$ARGUMENTS" | harnessed run plan --task-stdin
+```
+
+若 `$ARGUMENTS` 为空，运行 `harnessed run plan`（不带 stdin pipe）。
+
+完成后，Bash 输出会在 stderr 打印 `Next:` 提示，建议下一阶段。是否调用由对话上下文决定——该提示仅供参考，非强制指令。
+
+<!-- harnessed-generated:v3.4.4 -->
+
+## 参考文档
+
+- D-01 主控编排器委派模式
+- D-02 bare slash cmd 约定（ADR 0030 namespace policy LOCK）
+- D-06 planning-with-files 横切工具（NOT 独立 sub-workflow）
+- workflows/judgments/stage-routing.yaml — plan-{architecture,phase}-delegate triggers
+- workflows/plan/{architecture,phase}/workflow.yaml — 2 sub-workflow Phase 3.4 SHIPPED

package/workflows/plan/phase/SKILL.zh-Hans.md

@@ -0,0 +1,76 @@
+---
+name: plan-phase
+description: |
+  Stage ②.b 计划层 plan 子工作流 — GSD /gsd-plan-phase Wave A research + Wave B planner +
+  Wave C plan-checker + planning-with-files Claude Code plugin /plan 持久化 task_plan.md +
+  progress.md（打包的 Plan-stage 节奏：GSD + planning-with-files）。Stage ② 铁律:
+  dual capability (GSD orchestration + planning-with-files plugin)。schema_version:
+  harnessed.workflow.v3 with disciplines_applied (6 default) + tools_available [gsd-plan-phase,
+  planning-with-files] + 2 phases (01-gsd-plan + 02-persist)。Triggered by harnessed CLI
+  `harnessed plan-phase --phase <num>` or slash command `/plan-phase` after `harnessed setup`.
+trigger_phrases:
+  - "plan phase"
+  - "计划层 phase"
+  - "gsd plan phase"
+  - "持久化计划"
+  - "跑 plan-phase"
+---
+
+# plan-phase 工作流 (v3)
+
+## 概述
+
+2 阶段子工作流，将 CLAUDE.md "Plan 阶段 — GSD + planning-with-files" 映射到 harnessed
+运行时（Phase v3.0-3.4 W0.5 — D-04 Stage ② Plan 二层 + D-15 planning-with-files
+claude-code-plugin /plan + Pattern A sub-workflow ship）。
+
+| phase | id | upstream | model | capability / invokes | artifacts |
+| ----- | -- | -------- | ----- | -------------------- | --------- |
+| 1 | `01-gsd-plan` | gsd | sonnet | `{{ capabilities.gsd-plan-phase.cmd }}` | (Wave A research + Wave B planner + Wave C plan-checker) |
+| 2 | `02-persist` | planning-with-files | haiku | `{{ capabilities.planning-with-files.cmd }}` + `invokes: /plan` | `artifacts_expected: [task_plan.md, progress.md]` |
+
+## 能力引用
+
+Sister `workflows/capabilities.yaml` 条目：
+- `gsd-plan-phase` — Bucket 2 (impl: gsd, cmd: /gsd-plan-phase)
+- `planning-with-files` — Bucket 4 (impl: claude-code-plugin, cmd: /plan;
+  需要通过 Claude Code plugin marketplace 安装 `planning-with-files` Claude Code 插件；
+  输出：task_plan.md + progress.md + findings.md)
+
+## Stage ② 铁律 — dual capability
+
+GSD `/gsd-plan-phase` 编排（Wave A research → Wave B planner → Wave C
+plan-checker）→ planning-with-files `/plan` 持久化（插件真生成 task_plan.md +
+progress.md，NOT fs.writeFile self-impl per D-15 Q-AUDIT-5a claude-code-plugin
+reframe）。
+
+## 调用方式
+
+- Slash command：`/plan-phase <num>`（`harnessed setup` 后生效）
+
+## 输出产物
+
+- `task_plan.md` — 主任务清单 + 文件路径 + 依赖 + 验收标准
+- `progress.md` — phase 进度跟踪 + cross-session 恢复
+- （`findings.md` 由 discuss-* 子工作流产出，此处不重复）
+
+## 如何调用
+
+使用 Bash 工具运行：
+
+```bash
+echo "$ARGUMENTS" | harnessed run plan-phase --task-stdin
+```
+
+若 `$ARGUMENTS` 为空，运行 `harnessed run plan-phase`（不带 stdin pipe）。
+
+完成后，Bash 输出会在 stderr 打印 `Next:` 提示，建议下一阶段。是否调用由对话上下文决定——该提示仅供参考，非强制指令。
+
+<!-- harnessed-generated:v3.4.4 -->
+
+## 参考文档
+
+- D-04 Stage ② Plan 二层（架构 / 计划）
+- D-15 Q-AUDIT-5a planning-with-files claude-code-plugin reframe (NOT npm-sdk)
+- workflows/capabilities.yaml — gsd-plan-phase / planning-with-files (Bucket 4)
+- workflows/defaults.yaml — ralph_max_iterations.plan-phase.* values (W2.2 backfill)

package/workflows/research/SKILL.zh-Hans.md

@@ -0,0 +1,81 @@
+---
+name: research
+description: 多源调研工作流 — Tavily/Exa/ctx7 多源 fan-out + GSD discuss synth aggregate; harnessed v2.0 新增 per R20.7 (Stage ① Discuss 独立调用); schema bumped to harnessed.workflow.v3 in Phase v3.0-3.4 W1.1 (T3.4.W1.1) with disciplines_applied [6] + tools_available [tavily-mcp, exa-mcp, ctx7, gsd-discuss-phase], phases reuse v2 verbatim. Triggered by slash command `/research` after `harnessed setup`.
+preamble-tier: 2
+schema_version: harnessed.workflow.v3
+---
+
+# research 工作流
+
+harnessed v2.0 随附的多源调研工作流（Stage ① Discuss）；
+`workflow.yaml` schema 在 Phase v3.0-3.4 W1.1 中 bump 至 `harnessed.workflow.v3`
+(T3.4.W1.1 — D-09 L0 Discipline Substrate + D-05 tools_available 交叉验证)；
+phases 内容（01-fan-out + 02-synth）原样沿用 v2 SHIPPED，未做更改。
+
+## 阶段 (2)
+
+| # | Phase | Upstream | Capability | Model | Description |
+|---|-------|----------|-----------|-------|-------------|
+| 01 | `01-fan-out` | web-search | (route-by-subtask) | sonnet | 3 路并发调研 (Tavily MCP / Exa MCP / ctx7 CLI，遵循内置 web-search + context7 路由规则) |
+| 02 | `02-synth` | gsd | `gsd-discuss-phase` | opus | GSD discuss-phase 聚合 + 去重 + 对账 |
+
+## Capability refs
+
+Sister `workflows/capabilities.yaml` 条目：
+- `tavily-mcp` (impl: mcp-server，默认关键词搜索)
+- `exa-mcp` (impl: mcp-server，描述式 / 学术搜索)
+- `ctx7` (impl: cli-tool，库 API 文档)
+- `gsd-discuss-phase` (synth aggregate)
+
+## 调用方式
+- Slash command: `/research <topic>`（`harnessed setup` 后可用）
+
+## 路由规则（内置 web-search 路由 — `workflows/judgments/web-search-routing.yaml`）
+- 描述式查询（"找一篇对比 X 和 Y 的博客"）→ Exa MCP
+- 学术 / 论文 → Exa MCP
+- 库 / API 文档 → ctx7 CLI
+- 关键词 / 时效内容 → Tavily MCP（默认）
+- 抓整站 / 站点结构 → Tavily crawl/map
+
+## 如何调用
+
+**优先路径**（master orchestrator）：按当前 stage 规定的顺序依次调用各子工作流的 slash command。每个子命令安装在 `<claude-home>/commands/<sub-name>.md`（由 `harnessed setup` 安装），自带双路径兜底。
+
+**兜底路径**（当上游未安装或无返回结果时）：使用 Task 工具 spawn 一个通用 subagent，prompt 如下：
+
+> You are a **Research analyst**.
+>
+> **Mission**: Multi-source investigation (docs / web search / codebase grep / library probe) producing a `findings.md` with citations, NOT speculation. Use `ctx7` for library docs, `tavily-mcp` / `exa-mcp` for web, `gh` CLI for GitHub artifacts, and codebase `Grep` for internal references.
+>
+> **Default-suspect mode**: assume the change is broken / risky / incomplete until proven otherwise. Cite `file:line` for every finding; do not generalize.
+>
+> **Review checklist**:
+> 1. Resolve each unknown claim to a citable source (URL, file:line, or `ctx7` doc id)
+>
+> 2. Cite version explicitly when discussing library / framework APIs (training cutoff may be stale)
+>
+> 3. Capture conflicting sources side-by-side; do not silently pick one
+>
+> 4. Flag `OPEN: <question>` for items the user must decide; never paper over
+>
+> 5. Persist results to `.planning/<phase>/findings.md` for cross-session handoff
+>
+> **Output format**: structured report with severity-classified findings (verified / unverified / conflicting / open). One finding per line: `[severity] file:line — problem (one sentence); fix: suggested change`. If no findings, say so explicitly. No preamble, no end-of-report summary.
+
+（Role prompt 自包含 — 即使上游 `specialist` user-skill / plugin 未安装也可正常运行。）
+
+（`harnessed setup` 同时会在 `<claude-home>/commands/research.md` 安装一个 `research` Claude Code slash command，使 `/research` 成为真正的平台 slash command — 两个文件携带相同的双路径指令。之前 v3.4.x 中 `harnessed research --apply` CLI 的相关说明已移除；该子命令从未被实现。）
+
+## 如何调用
+
+使用 Bash 工具运行：
+
+```bash
+echo "$ARGUMENTS" | harnessed run research --task-stdin
+```
+
+如果 `$ARGUMENTS` 为空，运行 `harnessed run research`（不带 stdin pipe）。
+
+完成后，Bash 输出会在 stderr 打印 `Next:` 提示，建议下一个阶段。根据对话上下文决定是否调用 — 该提示仅供参考，不作强制指引。
+
+<!-- harnessed-generated:v3.4.4 -->