harnessed 3.9.14 → 3.9.16

package/dist/index.mjs

@@ -1,6 +1,6 @@
 // package.json
 var package_default = {
-  version: "3.9.14"};
+  version: "3.9.16"};
 
 // src/index.ts
 var VERSION = package_default.version;

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../package.json","../src/index.ts"],"names":[],"mappings":";AAAA,IAAA,eAAA,GAAA;AAAA,EAEE,OAAA,EAAW,QAgGb,CAAA;;;AC7FO,IAAM,UAAU,eAAA,CAAI","file":"index.mjs","sourcesContent":["{\n  \"name\": \"harnessed\",\n  \"version\": \"3.9.14\",\n  \"description\": \"AI coding harness package manager + composition orchestrator\",\n  \"type\": \"module\",\n  \"license\": \"Apache-2.0\",\n  \"author\": \"easyinplay\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/easyinplay/harnessed.git\"\n  },\n  \"homepage\": \"https://github.com/easyinplay/harnessed#readme\",\n  \"bugs\": \"https://github.com/easyinplay/harnessed/issues\",\n  \"keywords\": [\n    \"claude-code\",\n    \"ai-harness\",\n    \"package-manager\",\n    \"composition\",\n    \"skill-pack\",\n    \"mcp\",\n    \"orchestrator\"\n  ],\n  \"engines\": {\n    \"node\": \">=22.0.0\"\n  },\n  \"packageManager\": \"pnpm@10.12.0\",\n  \"bin\": {\n    \"harnessed\": \"./dist/cli.mjs\"\n  },\n  \"main\": \"./dist/index.mjs\",\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.mjs\",\n      \"default\": \"./dist/index.mjs\"\n    },\n    \"./schemas\": {\n      \"types\": \"./dist/schemas/index.d.ts\",\n      \"import\": \"./dist/schemas/index.mjs\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"dist\",\n    \"manifests\",\n    \"messages\",\n    \"workflows\",\n    \"routing\",\n    \"config-templates\",\n    \"schemas\",\n    \"README.md\",\n    \"LICENSE\",\n    \"NOTICE\",\n    \"THIRD-PARTY-NOTICES.md\"\n  ],\n  \"scripts\": {\n    \"dev\": \"tsup --watch\",\n    \"build\": \"tsc --noEmit && tsup\",\n    \"build:schema\": \"node ./scripts/build-schema.mjs\",\n    \"validate:schema\": \"node ./scripts/validate-schema.mjs\",\n    \"typecheck\": \"tsc --noEmit\",\n    \"test\": \"vitest run --passWithNoTests\",\n    \"test:watch\": \"vitest\",\n    \"test:coverage\": \"vitest run --coverage --passWithNoTests\",\n    \"bench\": \"vitest bench --run\",\n    \"lint\": \"biome check .\",\n    \"lint:fix\": \"biome check --write .\",\n    \"format\": \"biome format --write .\"\n  },\n  \"dependencies\": {\n    \"@anthropic-ai/claude-agent-sdk\": \"0.3.142\",\n    \"@clack/prompts\": \"^0.10.1\",\n    \"@sinclair/typebox\": \"^0.34.49\",\n    \"ajv\": \"^8.20.0\",\n    \"ajv-errors\": \"^3.0.0\",\n    \"ajv-formats\": \"^3.0.1\",\n    \"commander\": \"^13.0.0\",\n    \"diff\": \"^9.0.0\",\n    \"expr-eval\": \"^2.0.2\",\n    \"picocolors\": \"^1.1.1\",\n    \"proper-lockfile\": \"^4.1.2\",\n    \"yaml\": \"^2.9.0\"\n  },\n  \"devDependencies\": {\n    \"@biomejs/biome\": \"^2.0.0\",\n    \"@types/node\": \"^22.10.0\",\n    \"@types/proper-lockfile\": \"^4.1.4\",\n    \"@vitest/coverage-v8\": \"^4.0.0\",\n    \"tsup\": \"^8.3.0\",\n    \"typescript\": \"^5.6.0\",\n    \"vitest\": \"^4.0.0\"\n  },\n  \"pnpm\": {\n    \"onlyBuiltDependencies\": [\n      \"esbuild\"\n    ]\n  }\n}\n","// Main library entry — re-exports public APIs.\n// phase 1.1 batch 1: skeleton only; schema validator wired in batch 2 (T3+).\n\nimport pkg from '../package.json' with { type: 'json' }\n\nexport const VERSION = pkg.version\n"]}
+{"version":3,"sources":["../package.json","../src/index.ts"],"names":[],"mappings":";AAAA,IAAA,eAAA,GAAA;AAAA,EAEE,OAAA,EAAW,QAgGb,CAAA;;;AC7FO,IAAM,UAAU,eAAA,CAAI","file":"index.mjs","sourcesContent":["{\n  \"name\": \"harnessed\",\n  \"version\": \"3.9.16\",\n  \"description\": \"AI coding harness package manager + composition orchestrator\",\n  \"type\": \"module\",\n  \"license\": \"Apache-2.0\",\n  \"author\": \"easyinplay\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/easyinplay/harnessed.git\"\n  },\n  \"homepage\": \"https://github.com/easyinplay/harnessed#readme\",\n  \"bugs\": \"https://github.com/easyinplay/harnessed/issues\",\n  \"keywords\": [\n    \"claude-code\",\n    \"ai-harness\",\n    \"package-manager\",\n    \"composition\",\n    \"skill-pack\",\n    \"mcp\",\n    \"orchestrator\"\n  ],\n  \"engines\": {\n    \"node\": \">=22.0.0\"\n  },\n  \"packageManager\": \"pnpm@10.12.0\",\n  \"bin\": {\n    \"harnessed\": \"./dist/cli.mjs\"\n  },\n  \"main\": \"./dist/index.mjs\",\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.mjs\",\n      \"default\": \"./dist/index.mjs\"\n    },\n    \"./schemas\": {\n      \"types\": \"./dist/schemas/index.d.ts\",\n      \"import\": \"./dist/schemas/index.mjs\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"dist\",\n    \"manifests\",\n    \"messages\",\n    \"workflows\",\n    \"routing\",\n    \"config-templates\",\n    \"schemas\",\n    \"README.md\",\n    \"LICENSE\",\n    \"NOTICE\",\n    \"THIRD-PARTY-NOTICES.md\"\n  ],\n  \"scripts\": {\n    \"dev\": \"tsup --watch\",\n    \"build\": \"tsc --noEmit && tsup\",\n    \"build:schema\": \"node ./scripts/build-schema.mjs\",\n    \"validate:schema\": \"node ./scripts/validate-schema.mjs\",\n    \"typecheck\": \"tsc --noEmit\",\n    \"test\": \"vitest run --passWithNoTests\",\n    \"test:watch\": \"vitest\",\n    \"test:coverage\": \"vitest run --coverage --passWithNoTests\",\n    \"bench\": \"vitest bench --run\",\n    \"lint\": \"biome check .\",\n    \"lint:fix\": \"biome check --write .\",\n    \"format\": \"biome format --write .\"\n  },\n  \"dependencies\": {\n    \"@anthropic-ai/claude-agent-sdk\": \"0.3.142\",\n    \"@clack/prompts\": \"^0.10.1\",\n    \"@sinclair/typebox\": \"^0.34.49\",\n    \"ajv\": \"^8.20.0\",\n    \"ajv-errors\": \"^3.0.0\",\n    \"ajv-formats\": \"^3.0.1\",\n    \"commander\": \"^13.0.0\",\n    \"diff\": \"^9.0.0\",\n    \"expr-eval\": \"^2.0.2\",\n    \"picocolors\": \"^1.1.1\",\n    \"proper-lockfile\": \"^4.1.2\",\n    \"yaml\": \"^2.9.0\"\n  },\n  \"devDependencies\": {\n    \"@biomejs/biome\": \"^2.0.0\",\n    \"@types/node\": \"^22.10.0\",\n    \"@types/proper-lockfile\": \"^4.1.4\",\n    \"@vitest/coverage-v8\": \"^4.0.0\",\n    \"tsup\": \"^8.3.0\",\n    \"typescript\": \"^5.6.0\",\n    \"vitest\": \"^4.0.0\"\n  },\n  \"pnpm\": {\n    \"onlyBuiltDependencies\": [\n      \"esbuild\"\n    ]\n  }\n}\n","// Main library entry — re-exports public APIs.\n// phase 1.1 batch 1: skeleton only; schema validator wired in batch 2 (T3+).\n\nimport pkg from '../package.json' with { type: 'json' }\n\nexport const VERSION = pkg.version\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harnessed",
-  "version": "3.9.14",
+  "version": "3.9.16",
   "description": "AI coding harness package manager + composition orchestrator",
   "type": "module",
   "license": "Apache-2.0",

package/workflows/defaults.yaml

@@ -9,26 +9,6 @@ schema_version: harnessed.defaults.v1
 # Per-workflow per-phase ralph-loop iteration ceiling
 # Values balance: completion guarantee vs DoS prevention; sister ADR 0011 v0.2.0 ralph-loop SDK pattern
 ralph_max_iterations:
-  # v2 legacy (Phase 2.3 W1.2 SHIPPED, deprecated v3.0 per D-04 release-notes-only migration)
-  execute-task:
-    01-clarify: 5
-    02-code: 20
-    03-test: 15
-    04-deliver: 20
-
-  plan-feature:
-    01-gstack-decision: 1
-    02-brainstorm: 5
-    03-gsd-discuss: 3
-    04-gsd-plan: 3
-    05-persist: 5
-
-  verify-work:
-    01-gsd-verify-work: 3
-    02-code-review: 5
-    03-gstack-review: 3
-    04-code-simplifier: 5
-
   # v3 standalone (research v3 schema bump + retro NEW per Phase 3.4 W1.1+W1.2)
   research:
     01-fan-out: 3

package/workflows/execute-task/SKILL.md

@@ -1,84 +0,0 @@
----
-name: execute-task
-description: |
-  execute-task workflow v2 — 4-phase chain (brainstorming → karpathy + mattpocock route → TDD + diagnose → ralph-loop COMPLETE)
-  triggered by harnessed CLI `harnessed execute-task --task <text>`.
-  v2 delta (Phase v2.0-2.4 W1.1): schema_version: harnessed.workflow.v2 + ralph-loop 真接 SDK wrapper +
-  tdd-gate conditional + mattpocock route by condition (grill-with-docs / zoom-out / diagnose) +
-  explicit max_iterations_exceeded fallback (R20.10 NOT silent abort).
-trigger_phrases:
-  # forward-looking documentation — auto-invocation 实装推 Phase 2.3 extension category (B-28).
-  # Current enforced entry surface is the CLI subcommand below; these phrases are
-  # documentation-only hints for the eventual GSD orchestration agent.
-  - "execute this task"
-  - "implement this feature"
-  - "execute-task workflow"
-  - "跑 execute-task"
----
-
-# execute-task workflow (v2)
-
-## Overview
-
-4-phase chain mapping the user's CLAUDE.md Execute-phase discipline onto the harnessed
-runtime (ADR 0011 — SDK + ralph-loop integration; v2 schema upgrade T2.4.W1.1):
-
-| phase | id | upstream | model (intel CD-2 § 第 4 条) | v2 wiring |
-| ----- | -- | -------- | ---------------------------- | --------- |
-| 1 | `01-clarify` | `superpowers brainstorming` | opus | `capability: superpowers-brainstorming` + `gate: judgments.subtask-gate.brainstorming.fires` |
-| 2 | `02-code` | `karpathy` 心法 always-on | sonnet | `on[]` route to tdd-gate / grill-with-docs / zoom-out (D-09 + D-13) |
-| 3 | `03-test` | `superpowers TDD` | sonnet | `capability: tdd` + `on[]` route to diagnose on test_fail (D-13 + D-09) |
-| 4 | `04-deliver` | `ralph-loop` | haiku | `capability: ralph-loop` + `args: {completion_promise: COMPLETE}` + `gate/parallelism: judgments.parallelism-gate.*` + `fallback.max_iterations_exceeded: emit_warning_and_halt` (R20.10) |
-
-v2 schema fields per `src/workflow/schema/workflow.ts` (T2.4.W0.1 16th surface — harnessed.workflow.v2):
-- `capability: '{{ capabilities.<name>.cmd }}'` template interpolation (D-10 capability abstraction)
-- `gate: judgments.<file>.<gate>.fires` 4-level ref (pre-resolved by T2.3.W0.4 judgmentResolver)
-- `on: [{if, invoke|action}]` conditional clause (D-09 mattpocock route by condition)
-- `args: {completion_promise, max_iterations}` ralph-loop SDK params (R20.10 verbatim COMPLETE gate)
-- `parallelism: judgments.parallelism-gate.<route>.fires` (D-11 subagent / Agent Teams / main session route)
-- `fallback.max_iterations_exceeded: {action, message, exit_code}` (R20.10 acceptance c "explicit NOT silent")
-
-Per-phase models load from `workflows/execute-task/workflow.yaml` (v3 SoT post
-v3.4.4 Phase 6 — v2 phases.yaml deleted); runWorkflow spawns each phase as a
-sub-agent via `@anthropic-ai/claude-agent-sdk` 0.3.142+
-(`AgentDefinition` 5-字段 unpack — ADR 0011 § 4). ralph-loop SDK wrapper at 04-deliver
-reuses sister Phase 2.2 v0.2.0 ship: `src/workflow/lib/ralphLoop.ts` (54L) + `sdkSpawn.ts` (91L)
-+ 4-layer dual-signal `isComplete` (NOT 重写 — per RESEARCH § 3.1).
-
-## CLI invocation (the only enforced entry — B-28)
-
-```bash
-# Dry-run preview — arbitrate-only, never spawns SDK.
-harnessed execute-task --task "<text>" --dry-run --non-interactive
-
-# Apply path — real SDK spawn + ralph-loop COMPLETE round-trip.
-harnessed execute-task --task "<text>" --apply
-
-# `--model-tier inherit` escape hatch (B-10) — override per-phase models with
-# SDK 'inherit' (parent-thread model resolution).
-harnessed execute-task --task "<text>" --apply --model-tier inherit
-```
-
-H1 gate: `--non-interactive` requires `--apply` or `--dry-run` (exit 2 otherwise);
-sibling install-base.ts L51-56 + research.ts L37-43 pattern.
-
-EngineResult three-state → exit code mapping:
-- `0` — ok (ralph-loop returned verbatim `<promise>COMPLETE</promise>` round-trip)
-- `1` — ok:false {phase: arbitrate|install|spawn|verbatim} (typed error)
-- `2` — aborted {reason} (max-iter exceeded OR usage/config error)
-
-## Forward-looking note
-
-The `trigger_phrases:` frontmatter is currently **documentation purpose only** —
-auto-invocation by the GSD orchestration agent (skill auto-discovery) is deferred
-to Phase 2.3 extension category. In Phase 2.2 the only enforced entry surface is
-the CLI subcommand above (B-28 single-entry contract).
-
-## References
-
-- ADR 0011 — execute-task SDK + ralph-loop integration (phase 2.2 W6 — finalize)
-- `.planning/intel/omc-comparison.md` § CD-2 — per-phase model tier defaults
-- `src/cli/execute-task.ts` — CLI implementation (T5.1)
-- `workflows/execute-task/workflow.yaml` — 4-phase config (v3 SoT; v3.4.4 Phase 6 ship — v2 phases.yaml deleted)
-- `src/workflow/lib/sdkSpawn.ts` — SDK query() consumer (T4.1)
-- `src/workflow/lib/ralphLoop.ts` — verbatim COMPLETE round-trip

package/workflows/execute-task/workflow.yaml

@@ -1,93 +0,0 @@
-# workflows/execute-task/workflow.yaml — v3.4.4 Phase 4 Commit 1 NEW (Path A)
-# Former v2 `phases.yaml` (74L) deleted v3.4.4 Phase 6 Wave 3c — this v3
-# workflow.yaml is now the single SoT. Authored fresh per HANDOFF-v3.4.4 L745
-# Path A decision + PHASE-4-SPEC L101-180 verbatim.
-#
-# 4-phase chain mirrors v2 verbatim:
-#   01-clarify  superpowers-brainstorming  opus    gate: subtask-gate.brainstorming.fires
-#   02-code     karpathy 心法 + on[]       sonnet  conditional: tdd / grill-with-docs / zoom-out
-#   03-test     superpowers TDD            sonnet  on: test_fail → diagnose
-#   04-deliver  ralph-loop                 haiku   args.completion_promise=COMPLETE + fallback
-#
-# v2 → v3 字段 delta (PHASE-4-SPEC L13 + L116-178):
-#   BUMP `schema_version: harnessed.workflow.v3` (sister Phase 3.3 W0.5 WorkflowSchemaV3)
-#   ADD  `disciplines_applied: [6 basename]` (D-09 L0 Discipline Substrate, Pattern A A.1 strict Literal Union)
-#   ADD  `tools_available: [7 capabilities.yaml entry name]` (D-05 Contract C1 cross-validate)
-#   KEEP phases verbatim from former v2 phases.yaml (Path A1 — coexisted through Phase 5; v2 deleted Phase 6 Wave 3c)
-#
-# Per-phase model tier (intel CD-2 § 第 4 条) preserved verbatim from v2:
-#   opus / sonnet / sonnet / haiku
-# Override via CLI: `--model-tier inherit` (B-10 escape hatch).
-#
-# Sister refs:
-#   - .planning/v3.4.4/PHASE-4-SPEC.md L101-180 (NEW yaml shape verbatim)
-#   - workflows/execute-task/phases.yaml (former v2 SoT — DELETED v3.4.4 Phase 6 Wave 3c; this workflow.yaml is sole SoT)
-#   - workflows/research/workflow.yaml (v3 standalone shape reference)
-#   - workflows/verify/simplify/workflow.yaml (v3 sub-workflow shape reference)
-#   - workflows/capabilities.yaml (7 capability refs: superpowers-brainstorming/tdd/grill-with-docs/zoom-out/diagnose/ralph-loop/planning-with-files)
-#   - workflows/defaults.yaml ralph_max_iterations.execute-task.{01..04}
-#   - workflows/disciplines/{karpathy,output-style,language,operational,priority,protocols}.yaml (L0 substrate)
-#   - src/workflow/schema/workflow.ts WorkflowSchemaV3 (Phase 3.3 W0.5 SHIPPED 122L)
-
-schema_version: harnessed.workflow.v3
-workflow: execute-task
-description: |
-  子任务执行 workflow — 4-phase chain (brainstorming → karpathy + mattpocock route by
-  condition → TDD + diagnose → ralph-loop COMPLETE) triggered by harnessed CLI
-  `harnessed execute-task --task <text>` OR universal `harnessed run execute-task`.
-
-disciplines_applied: [karpathy, output-style, language, operational, priority, protocols]
-tools_available: [superpowers-brainstorming, tdd, grill-with-docs, zoom-out, diagnose, ralph-loop, planning-with-files]
-
-phases:
-  - id: 01-clarify
-    name: brainstorming
-    upstream: superpowers brainstorming
-    capability: '{{ capabilities.superpowers-brainstorming.cmd }}'
-    model: opus
-    max_iterations: '{{ defaults.ralph_max_iterations.execute-task.01-clarify }}'
-    gate: judgments.subtask-gate.brainstorming.fires
-
-  - id: 02-code
-    name: code (karpathy 心法 always-on + mattpocock conditional route)
-    upstream: karpathy
-    model: sonnet
-    max_iterations: '{{ defaults.ralph_max_iterations.execute-task.02-code }}'
-    on:
-      - if: 'judgments.tdd-gate.tdd-strongly-suggested.fires'
-        invoke: '{{ capabilities.tdd.cmd }}'
-      - if: 'phase.spec_ambiguous == true'
-        invoke: '{{ capabilities.grill-with-docs.cmd }}'
-      - if: 'phase.unfamiliar_module == true'
-        invoke: '{{ capabilities.zoom-out.cmd }}'
-
-  - id: 03-test
-    name: test (conditional TDD + diagnose on fail)
-    upstream: superpowers TDD
-    capability: '{{ capabilities.tdd.cmd }}'
-    model: sonnet
-    max_iterations: '{{ defaults.ralph_max_iterations.execute-task.03-test }}'
-    on:
-      - if: 'test_fail == true'
-        invoke: '{{ capabilities.diagnose.cmd }}'
-
-  - id: 04-deliver
-    name: deliver (ralph-loop COMPLETE gate + max-iter fallback)
-    upstream: ralph-loop
-    capability: '{{ capabilities.ralph-loop.cmd }}'
-    model: haiku
-    args:
-      completion_promise: COMPLETE
-      max_iterations: '{{ defaults.ralph_max_iterations.execute-task.04-deliver }}'
-    gate: judgments.parallelism-gate.fires
-    parallelism: judgments.parallelism-gate.ralph-loop-wrapper.fires
-    on:
-      - if: 'subtask.lines >= 20 and subtask.type != "single_command_query"'
-        invoke: '{{ capabilities.ralph-loop.cmd }}'
-      - if: 'subtask.lines < 20 or subtask.type == "single_command_query"'
-        action: skip
-    fallback:
-      max_iterations_exceeded:
-        action: emit_warning_and_halt
-        message: '⚠️ ralph-loop max-iterations ({{ args.max_iterations }}) exceeded for execute-task 04-deliver. Sub-task likely incomplete — see workflow engine catch handler for manual options.'
-        exit_code: 1

package/workflows/plan-feature/SKILL.md

@@ -1,98 +0,0 @@
----
-name: plan-feature
-description: |
-  plan-feature workflow v2 — 5-phase 三层栈 composition (gstack governance gate →
-  superpowers brainstorm → GSD /gsd-discuss-phase → GSD /gsd-plan-phase →
-  planning-with-files Claude Code plugin slash cmd `/plan` 持久化 task_plan.md +
-  progress.md + findings.md). schema_version: harnessed.workflow.v2 with
-  capability template interpolation + 4-level gate refs + conditional `on` clauses.
-  Triggered by harnessed CLI `harnessed plan-feature --task <text>` or slash command
-  `/plan-feature` after `harnessed setup`.
-trigger_phrases:
-  - "plan this feature"
-  - "design new feature"
-  - "plan-feature workflow"
-  - "跑 plan-feature"
----
-
-# plan-feature workflow (v2)
-
-## Overview
-
-5-phase chain mapping the user's CLAUDE.md Discuss + Plan discipline onto the harnessed
-runtime, upgraded to `harnessed.workflow.v2` schema (Phase v2.0-2.4 W1 T2.4.W1.3 —
-D-15 + Q-AUDIT-5a Option A: planning-with-files = Claude Code plugin slash cmd
-`/plan` 真接, **NOT** npm SDK call, **NOT** fs.writeFile self-impl).
-
-| phase | id | upstream | model | capability / invokes | gate / on |
-| ----- | -- | -------- | ----- | -------------------- | --------- |
-| 1 | `01-gstack-decision` | gstack | opus | `{{ capabilities.gstack-office-hours.cmd }}` / `{{ gstack_prefix }}office-hours` | `gate: judgments.strategic-gate.office-hours.fires` |
-| 2 | `02-brainstorm` | superpowers | sonnet | `{{ capabilities.superpowers-brainstorming.cmd }}` | `on: judgments.subtask-gate.brainstorming.fires → invoke` |
-| 3 | `03-gsd-discuss` | gsd | sonnet | `{{ capabilities.gsd-discuss-phase.cmd }}` | `on: judgments.phase-gate.gsd-discuss-phase.fires → invoke` |
-| 4 | `04-gsd-plan` | gsd | sonnet | `invokes: gsd-plan-phase` (literal — v2.x patch followup capabilities entry) | — |
-| 5 | `05-persist` | planning-with-files | haiku | `{{ capabilities.planning-with-files.cmd }}` / `invokes: /plan` | `on: phase.scope_days > 1 or phase.is_critical_module → invoke` |
-
-Per-phase config loads from `workflows/plan-feature/workflow.yaml`; engine.runRouting
-spawns each phase as a sub-agent via `@anthropic-ai/claude-agent-sdk` 0.3.142+.
-
-### v1 → v2 字段 delta
-
-- ADD `schema_version: harnessed.workflow.v2` (T2.4.W0.1 16th surface — first .v2)
-- ADD `description` root field (workflow purpose summary)
-- ADD `phase.capability: '{{ capabilities.<name>.cmd }}'` template interpolation (D-10)
-- ADD `phase.gate: judgments.<file>.<trigger>.fires` 4-level ref (D-04, pre-resolved by `judgmentResolver`)
-- ADD `phase.on: [{if, invoke|action}]` conditional clause (D-09)
-- ADD `phase.artifacts_expected: [...]` 3-file persistence list (D-15)
-- CHANGE `max_iterations` 改用 `{{ defaults.ralph_max_iterations.plan-feature.<phase> }}` jinja ref (T2.3.W1.2 ship)
-- KEEP `invokes: '/plan'` literal at 05-persist (Q-AUDIT-5a anti-pattern guard)
-
-### Phase 1 governance gate
-
-Phase 1 (gstack governance) uses workflow-level `on_veto: halt_workflow` — any
-CEO/EM/Designer/Paranoid/QA/CSO veto halts the entire workflow before proceeding
-to brainstorm or planning (D-04 PUSH 任 1 phase 转换前 read = vetoed → 全 halt).
-
-### Phase 5 planning-with-files plugin 真接 (Q-AUDIT-5a LOCKED Option A)
-
-05-persist invokes the **Claude Code plugin** slash command `/plan`. Requires
-the `planning-with-files` Claude Code plugin to be installed via the Claude Code
-plugin marketplace. The plugin generates 3 markdown files in
-`.planning/<phase-id>/`:
-
-- `task_plan.md` — 主计划 (task 列表 + 文件路径 + 依赖顺序 + 验收标准)
-- `progress.md` — 跨 session 进度跟踪
-- `findings.md` — 调研发现 / 知识沉淀
-
-Q-AUDIT-5a rejected alternatives (anti-pattern guard verified by
-`tests/workflow/plan-feature-v2.test.ts`):
-
-- (b) plugin script direct spawn — Windows PowerShell 跨平台不友好
-- (c) `fs.writeFile` self-implementation — duplicates plugin functionality, breaks
-  multi-IDE compatibility (sister .continue / .factory / .gemini / .codebuddy /
-  .cursor structure 已就绪)
-
-## CLI invocation
-
-```bash
-# Dry-run preview — arbitrate-only, never spawns SDK.
-harnessed plan-feature --task "<text>" --dry-run --non-interactive
-
-# Apply path — real SDK spawn + 5-phase chain.
-harnessed plan-feature --task "<text>" --apply
-```
-
-## Forward-looking note
-
-The `trigger_phrases:` frontmatter is active after `harnessed setup` copies this
-SKILL.md to `<claude-home>/skills/plan-feature/` — Claude Code then loads the slash
-command `/plan-feature` automatically (Gap B fix — v1.0.2).
-
-## References
-
-- ADR 0011 — SDK + ralph-loop integration
-- `workflows/plan-feature/workflow.yaml` — 5-phase config (v2 schema)
-- `workflows/capabilities.yaml` — capability manifest (35 entry baseline)
-- `workflows/judgments/{strategic-gate,phase-gate,subtask-gate}.yaml` — gate refs
-- `workflows/defaults.yaml` — ralph_max_iterations.plan-feature.* values
-- `docs/WORKFLOW.md` — 4-stage workflow mermaid + gap analysis
-- `.planning/phase-v2.0-2.2/RESEARCH.md` § 5.3 — D-15 实装路径 reframe

package/workflows/plan-feature/workflow.yaml

@@ -1,81 +0,0 @@
-# workflows/plan-feature/workflow.yaml — Phase v2.0-2.4 W1 T2.4.W1.3 (D-15 + Q-AUDIT-5a LOCKED)
-# 5-phase 三层栈 composition: gstack governance → superpowers brainstorm → GSD discuss/plan → planning-with-files plugin /plan persist
-# v1 → v2 delta (sister L1-40):
-#   ADD `schema_version: harnessed.workflow.v2`              (T2.4.W0.1 16th surface)
-#   ADD `description` root field                              (workflow purpose)
-#   ADD `capability: '{{ capabilities.<name>.cmd }}'` 各 phase (D-10 template interpolation)
-#   ADD `gate: judgments.<file>.<trigger>.fires` 01-gstack-decision (D-04 gate reference)
-#   ADD `on: [{if, invoke}]` 02-brainstorm + 03-gsd-discuss   (D-09 conditional clause)
-#   ADD `artifacts_expected: [...]` 05-persist                (D-15 planning-with-files 3 file 持久化)
-#   ADD `max_iterations: '{{ defaults.ralph_max_iterations.plan-feature.<phase> }}'` (T2.3.W1.2 ship)
-#   KEEP `invokes: '/plan'` literal at 05-persist             (Q-AUDIT-5a Claude Code plugin slash cmd, NOT npm SDK NOT fs.writeFile)
-# Q-AUDIT-5a anti-pattern guard (verified by tests/workflow/plan-feature-v2.test.ts):
-#   - NO npm SDK call (no `import` / `require` planning-with-files — yaml syntax natively absent)
-#   - NO fs.writeFile self-impl (no `fs.writeFile` / `writeFile` reference — anti-pattern reviewer guard)
-#   - YES `invokes: '/plan'` literal at 05-persist            (plugin slash cmd 真接 path a)
-#   - YES `capability: '{{ capabilities.planning-with-files.cmd }}'` template ref (resolve to /plan via capabilities.yaml L317)
-# 04-gsd-plan phase: `gsd-plan-phase` 在 capabilities.yaml 中暂未单独 entry — 沿袭 v1 L32 literal pattern (D-08 v2.x patch followup
-# 添加 gsd-plan-phase capability entry; v2.0 baseline 不阻塞 ship per T2.4.W1.3 Implementation Tasks #4-#5 scope)
-
-schema_version: harnessed.workflow.v2
-workflow: plan-feature
-description: |
-  plan-feature 5-phase 三层栈 workflow — gstack governance gate (CEO/EM/Designer/Paranoid/QA/CSO)
-  → superpowers brainstorm 子任务级澄清 → GSD /gsd-discuss-phase 灰色澄清 → GSD /gsd-plan-phase
-  Wave A/B/C planning → planning-with-files Claude Code plugin slash cmd `/plan` 持久化 3 file
-  (task_plan.md + progress.md + findings.md) 在 .planning/<phase-id>/.
-  Phase 1 gstack governance veto halts the entire workflow (D-04 PUSH) — engine-level
-  on_veto wiring lives in runtime, NOT yaml v2 root schema (WorkflowSchemaV2 strict
-  additionalProperties:false per T2.4.W0.1 + STRIDE T-2.2-02).
-
-phases:
-  - id: 01-gstack-decision
-    name: gstack-decision (governance gate — CEO/EM/Designer/Paranoid/QA/CSO)
-    upstream: gstack
-    capability: '{{ capabilities.gstack-office-hours.cmd }}'
-    invokes: '{{ gstack_prefix }}office-hours'
-    model: opus
-    gate: judgments.strategic-gate.office-hours.fires
-    max_iterations: '{{ defaults.ralph_max_iterations.plan-feature.01-gstack-decision }}'
-
-  - id: 02-brainstorm
-    name: brainstorm (子任务级澄清 multi-approach)
-    upstream: superpowers
-    capability: '{{ capabilities.superpowers-brainstorming.cmd }}'
-    model: sonnet
-    on:
-      - if: judgments.subtask-gate.brainstorming.fires
-        invoke: '{{ capabilities.superpowers-brainstorming.cmd }}'
-    max_iterations: '{{ defaults.ralph_max_iterations.plan-feature.02-brainstorm }}'
-
-  - id: 03-gsd-discuss
-    name: gsd-discuss (orchestration — phase 灰色澄清 4-question batch)
-    upstream: gsd
-    capability: '{{ capabilities.gsd-discuss-phase.cmd }}'
-    model: sonnet
-    on:
-      - if: judgments.phase-gate.gsd-discuss-phase.fires
-        invoke: '{{ capabilities.gsd-discuss-phase.cmd }}'
-    max_iterations: '{{ defaults.ralph_max_iterations.plan-feature.03-gsd-discuss }}'
-
-  - id: 04-gsd-plan
-    name: gsd-plan (orchestration — Wave A research + Wave B planner + Wave C checker)
-    upstream: gsd
-    invokes: 'gsd-plan-phase'
-    model: sonnet
-    max_iterations: '{{ defaults.ralph_max_iterations.plan-feature.04-gsd-plan }}'
-
-  - id: 05-persist
-    name: persist (planning-with-files plugin /plan — Manus-style markdown persistence)
-    upstream: planning-with-files
-    capability: '{{ capabilities.planning-with-files.cmd }}'
-    invokes: '/plan'
-    model: haiku
-    on:
-      - if: phase.scope_days > 1 or phase.is_critical_module == true
-        action: invoke
-    artifacts_expected:
-      - task_plan.md
-      - progress.md
-      - findings.md
-    max_iterations: '{{ defaults.ralph_max_iterations.plan-feature.05-persist }}'

package/workflows/verify-work/SKILL.md

@@ -1,90 +0,0 @@
----
-name: verify-work
-description: |
-  verify-work workflow v2 — Stage ④ Verify 9-phase composition per CLAUDE.md verbatim
-  (gsd-verify-work + gsd-progress 必跑串行 → code-review 多 agent 并行 fan-out → gstack /review
-  关键模块强制 → 可选 /qa /cso /design-review conditional → code-simplifier 末尾串行 →
-  关键发布/大重构 PR 升级 4-specialist Agent Team Pattern C 多维度审查 互相质询)。
-  schema_version: harnessed.workflow.v2 with capability template interpolation + parallelism
-  gate refs + conditional `on` clauses. Triggered by harnessed CLI `harnessed verify-work
-  --phase <num>` or slash command `/verify-work` after `harnessed setup`.
-trigger_phrases:
-  - "verify work"
-  - "verify-work workflow"
-  - "Stage 4 verify"
-  - "跑 verify-work"
----
-
-# verify-work workflow (v2)
-
-## Overview
-
-9-phase chain mapping the user's CLAUDE.md Stage ④ Verify discipline onto the harnessed
-runtime, fully `harnessed.workflow.v2` schema (Phase v2.0-2.4 W2 T2.4.W2.2 — D-12
-Q-AUDIT-2 amend + R20.12 + R20.11 + R20.14).
-
-| phase | id | upstream | model | capability / invokes | gate / on / parallelism |
-| ----- | -- | -------- | ----- | -------------------- | ----------------------- |
-| 1 | `01-gsd-verify-work` | gsd | sonnet | `{{ capabilities.gsd-verify-work.cmd }}` | serial — `max_iterations: 3` |
-| 2 | `02-gsd-progress` | gsd | haiku | `{{ capabilities.gsd-progress.cmd }}` | serial — `max_iterations: 2` |
-| 3 | `03-code-review-parallel` | mattpocock-skills | sonnet | `{{ capabilities.code-review.cmd }}` | `parallelism: judgments.parallelism-gate.subagent-default.fires` |
-| 4 | `04-gstack-review-conditional` | gstack | opus | `{{ capabilities.gstack-review.cmd }}` | `on: phase.is_critical_module → invoke / else skip` |
-| 5 | `05-qa-conditional` | gstack | sonnet | `{{ capabilities.gstack-qa.cmd }}` | `on: phase.has_ui_changes → invoke / else skip` |
-| 6 | `06-cso-conditional` | gstack | opus | `{{ capabilities.gstack-cso.cmd }}` | `on: phase.has_auth_or_secrets → invoke / else skip` |
-| 7 | `07-design-review-conditional` | gstack | sonnet | `{{ capabilities.gstack-design-review.cmd }}` | `on: phase.has_design_changes → invoke / else skip` |
-| 8 | `08-code-simplifier` | mattpocock-skills | sonnet | `{{ capabilities.code-simplifier.cmd }}` | serial 末尾 — `max_iterations: 5` |
-| 9 | `09-agent-team-multispecialist` | claude-platform | opus | `{{ capabilities.agent-teams-create.cmd }}` | `parallelism: judgments.parallelism-gate.agent-teams-upgrade.fires`; `on: is_major_release OR is_large_refactor → invoke` |
-
-Per-phase config loads from `workflows/verify-work/workflow.yaml`; engine.runRouting
-spawns each phase as a sub-agent via `@anthropic-ai/claude-agent-sdk` 0.3.142+.
-
-## Phase 9 Pattern C 4-specialist Agent Team (D-11 + R20.11)
-
-The Agent Team upgrade phase (`09-agent-team-multispecialist`) follows the
-bundled Agent Teams Pattern C 多维度审查 — 4 teammate
-(code-review + gstack-review + gstack-cso + gstack-qa) 互相 SendMessage 质询
-findings 是否真问题 (NOT fire-and-forget subagent fan-out)。Token estimate
-`team_cost < 2 × subagent_cost` is a prereq (bundled cost guideline; engine-level
-check, NOT yaml schema scope). Cleanup mandatory: `SendMessage shutdown_request`
-+ `TeamDelete` after round-trip complete (bundled cleanup discipline).
-
-Trigger condition: `phase.is_major_release == true OR phase.is_large_refactor
-== true`. 常规 PR / 单点任务**不触发** Pattern C — code-review fan-out (phase 3)
-+ gstack-review conditional (phase 4) 已够用且更省 token (per CLAUDE.md "Verify
-阶段" 末段 "关键发布 / 大重构 PR" 限定语)。
-
-## R20.16 chain_isolation 实装 (3 铁律 fallback)
-
-每个 conditional phase (4-7, 9) 都实装 `on: [{if: ..., action: invoke}, {if:
-..., action: skip}]` — skip 04-gstack-review **不**级联跳过 06-cso-conditional,
-等等。验证脚本 `node scripts/check-workflow-schema.mjs` 严格 schema 校验 +
-runtime engine 独立判 condition。
-
-## CLI invocation
-
-```bash
-# Dry-run preview — arbitrate-only, never spawns SDK.
-harnessed verify-work --phase <num> --dry-run --non-interactive
-
-# Apply path — real SDK spawn + 9-phase chain (conditional phases evaluate by phase fact context).
-harnessed verify-work --phase <num> --apply
-```
-
-## Forward-looking note
-
-The `trigger_phrases:` frontmatter is active after `harnessed setup` copies this
-SKILL.md to `<claude-home>/skills/verify-work/` — Claude Code then loads the slash
-command `/verify-work` automatically (Gap B fix — v1.0.2 sister mechanism).
-
-## References
-
-- D-12 (Q-AUDIT-2 amend) — verify-work 7+ phase 完整 4-stage 重定
-- R20.12 — verify-work full scope acceptance
-- R20.11 — 4-specialist Agent Team upgrade
-- R20.14 — special-purpose /qa /cso /design-review conditional
-- R20.7 — D-08 verify-work NEW 2 之一
-- R20.16 — fallback 3 铁律 chain_isolation
-- `workflows/capabilities.yaml` — gsd-verify-work / gsd-progress / code-review / gstack-{review,qa,cso,design-review} / code-simplifier / agent-teams-create entries
-- `workflows/judgments/parallelism-gate.yaml` — subagent-default + agent-teams-upgrade.fires
-- `workflows/defaults.yaml` — ralph_max_iterations.verify-work.* values
-- `docs/WORKFLOW.md` — 4-stage workflow mermaid + Stage ④ Verify 章节