harnessed 4.6.0 → 4.8.0

package/dist/index.mjs

@@ -1,6 +1,6 @@
 // package.json
 var package_default = {
-  version: "4.6.0"};
+  version: "4.8.0"};
 
 // 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,OAkGb,CAAA;;;AC/FO,IAAM,UAAU,eAAA,CAAI","file":"index.mjs","sourcesContent":["{\n  \"name\": \"harnessed\",\n  \"version\": \"4.6.0\",\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    \"harnessed-inject-state\": \"./bin/harnessed-inject-state.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    \"bin\",\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,OAkGb,CAAA;;;AC/FO,IAAM,UAAU,eAAA,CAAI","file":"index.mjs","sourcesContent":["{\n  \"name\": \"harnessed\",\n  \"version\": \"4.8.0\",\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    \"harnessed-inject-state\": \"./bin/harnessed-inject-state.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    \"bin\",\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/manifests/optional/codegraph.yaml

@@ -1,8 +1,10 @@
 # yaml-language-server: $schema=../../schemas/manifest.v1.schema.json
-# OPT-IN catalog manifest — lives in manifests/optional/ so `install-base` (which
-# globs only manifests/tools + manifests/skill-packs) never pulls it into the base
-# profile, and `harnessed install <name>` (tools + skill-packs only) never installs
-# it. CodeGraph ships its own installer; harnessed catalogs + detects only.
+# OPT-IN catalog manifest — lives in manifests/optional/ so `harnessed setup`
+# Step B (which globs only manifests/tools + manifests/skill-packs) never pulls it
+# into the base profile (no auto-install). It IS installable on demand: explicit
+# `harnessed install codegraph` resolves manifests/optional/ as the third tier and
+# runs the npm-cli method below. CodeGraph ships its own installer; harnessed
+# catalogs + detects only.
 apiVersion: harnessed/v1
 kind: Manifest
 metadata:

package/manifests/optional/ecc.ee5-answers.json

@@ -0,0 +1,13 @@
+{
+  "upstream": "github.com/affaan-m/ECC",
+  "created_at": "2026-06-17T00:00:00.000Z",
+  "author": "easyinplay",
+  "q1_reusable_surface": "真 reusable surface。ECC 是稳定分发的 CC plugin 上游 (marketplace ecc@ecc),提供 ~55 个 dev domain-pattern 知识库 + 28 个 per-language reviewer/build-resolver — 长期可复用的能力源,非临时 wrapper。A posture 只收能力片 (Bucket 11 加性 + verify alias),不收 ECC 的 orchestration loop。",
+  "q2_name_fit": "名字 fit (已是 plugin id ecc@ecc)。命名冲突: 存在且已在 ADR-0034 §3 de-confliction 矩阵处理 — ECC 的 review/orchestration/learn/checkpoint 与 gstack/gsd/superpowers/harnessed checkpoint 引擎重名。Bucket 11 加性 entry 走 domain/cost/hook 正交 fires_when 轴 (零命名冲突);per-language reviewer 走 alias-收编挂到现有 verify capability。",
+  "q3_overlap": "大量 overlap — ECC 是与 GSD/superpowers/gstack 平行的完整栈。已在 ADR-0034 逐 family 处理: 加性区 (domain/cost/hook, 零 overlap) / alias-收编区 (verify 维度, priority.yaml 仲裁单一 fire) / 碰撞区 (orchestration/review/learning/multi-agent/token, 默认 NOT wire) / 硬排除区 (checkpoint/ledger/compact/learning keystone 引擎)。枚举 (246 skills/61 agents) 已核对 partition 站得住。",
+  "q4_concept_vs_identity": "import 概念。收的是 domain-pattern 知识 + per-language review 能力, NOT import ECC 的产品身份/orchestration/做事方式。不 vendor 代码 (装配主义)。A posture 明确边界: 能力片可控同化, ECC 的 plan/execute/learn/checkpoint loop 一律不接。",
+  "q5_user_understanding": "能。Bucket 11 capability 以 harnessed 自己的 fires_when 语义暴露 (subtask.domain == 'postgres' → postgres pattern), 用户看到的是 harnessed 路由, 无需知道 ECC 存在。per-language reviewer 走现有 verify capability 的 alias 同理。ECC 仅作为 impl 来源, 对用户透明。",
+  "ee5_gate": "PASSED",
+  "deconfliction_adr": "docs/adr/0034-ecc-assimilation-deconfliction.md",
+  "posture": "A (additive-first: domain-pattern starter-set ≤8 + cost/hook + per-language reviewer alias)"
+}

package/manifests/optional/ecc.yaml

@@ -0,0 +1,64 @@
+# yaml-language-server: $schema=../../schemas/manifest.v1.schema.json
+#
+# OPT-IN catalog manifest — lives in manifests/optional/ so `harnessed setup` /
+# install-base (which globs ONLY manifests/tools + manifests/skill-packs) NEVER
+# auto-installs ECC into the base profile. ECC is an optional upstream AND a
+# pre-release (stability=unstable) — users opt in explicitly. harnessed catalogs
+# this manifest + routes a curated subset (capabilities.yaml Bucket 11 + verify
+# aliases, opt-in no-op when ECC absent); the install cmd below is the user-run
+# path (`claude plugin install ecc@ecc`). Sister: manifests/optional/codegraph.yaml.
+#
+# ECC (Affaan Mustafa) selective assimilation — A posture per ADR-0034.
+# ECC is a near-complete PARALLEL stack (its own plan/execute/review/learn/
+# checkpoint/multi-agent). harnessed does NOT wire that; it assimilates ONLY the
+# additive zones (domain-pattern starter-set ≤8 + cost-report/model-route +
+# hookify) and收编s per-language reviewers/build-resolvers as verify-dimension
+# aliases. checkpoint/ledger/compact/learning families are HARD-EXCLUDED (keystone
+# engine collision, same rationale as gsd-execute-phase).
+#
+# De-confliction matrix SoT: docs/adr/0034-ecc-assimilation-deconfliction.md
+# EE-5 gate record:           manifests/optional/ecc.ee5-answers.json
+apiVersion: harnessed/v1
+kind: Manifest
+metadata:
+  name: ecc
+  display_name: ECC (selective domain + verify-alias assimilation, A posture)
+  description: ECC selective assimilation per ADR-0034 (A posture) — additive domain-pattern + cost/hook + per-language reviewer alias.
+  upstream:
+    source: github.com/affaan-m/ECC
+    homepage: https://ecc.tools
+    repository: https://github.com/affaan-m/ECC.git
+    license: MIT
+    notice: |
+      ECC (Engineering Claude Code) by Affaan Mustafa, distributed via the `ecc`
+      Claude Code marketplace. harnessed assimilates a curated subset selectively
+      (A posture, de-confliction per ADR-0034) — NOT vendored, NOT wired as a
+      parallel stack. Upstream is pre-release (2.0.0-rc.1); stability=unstable.
+spec:
+  type: cc-plugin
+  component_type: command
+  category: engineering
+  install_type: skill
+  install:
+    method: cc-plugin-marketplace
+    cmd: "claude plugin marketplace add affaan-m/ECC && claude plugin install ecc@ecc"
+    git_ref: ec92b528471df708c2384ebbcc82b390b60f535a
+    idempotent_check: "claude plugin list 2>&1 | grep -qw ecc"
+    marketplace_source:
+      source: github
+      repo: affaan-m/ECC
+  verify:
+    cmd: "claude plugin list 2>&1 | grep -qw ecc"
+    timeout_ms: 10000
+  uninstall:
+    cmd: "claude plugin uninstall ecc@ecc"
+  upstream_health:
+    stability: unstable
+    last_check: "2026-06-17"
+    last_known_good_version: 2.0.0-rc.1
+    fallback_action: warn
+  signed_by: easyinplay
+  platforms:
+    - linux
+    - darwin
+    - win32

package/messages/en.json

@@ -28,7 +28,7 @@
   "agent_teams.missing_nonblocking": "   non-blocking — auto-degrades to subagent fan-out\n",
 
   "install.manifest_not_found": "error: manifest '{{name}}' not found",
-  "install.manifest_not_found.fix": "  fix:  ensure manifests/tools/{{name}}.yaml or manifests/skill-packs/{{name}}.yaml exists",
+  "install.manifest_not_found.fix": "  fix:  ensure manifests/tools/{{name}}.yaml, manifests/skill-packs/{{name}}.yaml, or manifests/optional/{{name}}.yaml exists",
   "install.audit_hint": "  fix:  run 'harnessed audit' to inspect manifest issues",
   "install.success": "installed {{name}}",
   "install.success_with_version": "installed {{name}}@{{version}}",
@@ -84,6 +84,9 @@
   "status.lock_release_hint": "  to release: wait for process to finish or delete {{path}}",
   "status.lock_free": "\nlock: free",
 
+  "here.no_workflow": "no active workflow for this repo ({{path}} has no entry for cwd)",
+  "here.no_workflow.hint": "  to start: run a stage (e.g. `harnessed gates discuss`) or `harnessed run <workflow>`",
+
   "audit_log.no_records_file": "no audit records found ({{path}} does not exist)",
   "audit_log.no_records_empty": "no audit records found (audit.log is empty)",
   "audit_log.jq_missing": "✗ jq not found in PATH — run: harnessed doctor",

package/messages/zh-Hans.json

@@ -28,7 +28,7 @@
   "agent_teams.missing_nonblocking": "   non-blocking — auto-degrades to subagent fan-out\n",
 
   "install.manifest_not_found": "error: manifest '{{name}}' not found",
-  "install.manifest_not_found.fix": "  fix:  ensure manifests/tools/{{name}}.yaml or manifests/skill-packs/{{name}}.yaml exists",
+  "install.manifest_not_found.fix": "  fix:  ensure manifests/tools/{{name}}.yaml, manifests/skill-packs/{{name}}.yaml, or manifests/optional/{{name}}.yaml exists",
   "install.audit_hint": "  fix:  run 'harnessed audit' to inspect manifest issues",
   "install.success": "installed {{name}}",
   "install.success_with_version": "installed {{name}}@{{version}}",
@@ -39,8 +39,22 @@
   "uninstall.confirm.prompt": "Uninstall '{{name}}'? This cannot be undone.",
   "uninstall.cancelled": "aborted: user cancelled",
   "uninstall.completed": "uninstalled {{name}}",
-  "uninstall.yes_dryrun_conflict": "error: --yes is incompatible with --dry-run (dry-run does not mutate)",
-  "uninstall.yes_dryrun_conflict.fix": "  fix:  harnessed uninstall {{name}} --yes  (immediate) OR harnessed uninstall {{name}} --dry-run  (preview)",
+  "uninstall.unified.nothing": "无需操作 — 未找到 harnessed 产物",
+  "uninstall.unified.header": "harnessed uninstall 将移除以下内容：",
+  "uninstall.unified.commands": "  Commands: ~/.claude/commands/ 中 {{count}} 个 harnessed 生成的 slash command 文件",
+  "uninstall.unified.skills": "  Skills: ~/.claude/skills/ 中 {{count}} 个 workflow skill 目录",
+  "uninstall.unified.settings": "  Settings: ~/.claude/settings.json 中的 harnessed 环境变量（CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS、HARNESSED_USER_LANG）",
+  "uninstall.unified.state_dir": "  State directory: ~/.claude/harnessed/（含 backups、audit log、state、lock）",
+  "uninstall.unified.upstream_note": "\nUpstream 组件（npm packages、MCP servers、CC plugins、git-cloned repos、npx skills）不受影响。",
+  "uninstall.unified.dry_run_hint": "\n（dry-run — 去掉 --dry-run 重新运行以实际移除）",
+  "uninstall.unified.confirm": "移除 harnessed 自身的文件？Upstream 组件（npm packages、MCP servers、CC plugins 等）不受影响。此操作不可撤销。",
+  "uninstall.unified.removing": "正在移除 harnessed 文件...",
+  "uninstall.unified.removed_commands": "  已移除 {{count}} 个 command 文件",
+  "uninstall.unified.removed_skills": "  已移除 {{count}} 个 skill 目录",
+  "uninstall.unified.removed_settings": "  已移除 ~/.claude/settings.json 中的 harnessed 环境变量",
+  "uninstall.unified.removed_state_dir": "  已移除 ~/.claude/harnessed/",
+  "uninstall.unified.partial_failure": "\n{{count}} 个条目无法移除（权限不足或已不存在）：",
+  "uninstall.unified.complete": "uninstall 完成 — harnessed 自身的文件已移除",
 
   "gc.invalid_duration": "error: invalid --older-than '{{value}}'",
   "gc.invalid_duration.fix": "  fix:  use format <N>{d|h|m|w} e.g. 30d / 24h / 60m / 4w",
@@ -70,6 +84,9 @@
   "status.lock_release_hint": "  to release: wait for process to finish or delete {{path}}",
   "status.lock_free": "\nlock: free",
 
+  "here.no_workflow": "当前 repo 无 active workflow（{{path}} 中没有 cwd 对应条目）",
+  "here.no_workflow.hint": "  开始：运行一个 stage（如 `harnessed gates discuss`）或 `harnessed run <workflow>`",
+
   "audit_log.no_records_file": "no audit records found ({{path}} does not exist)",
   "audit_log.no_records_empty": "no audit records found (audit.log is empty)",
   "audit_log.jq_missing": "✗ jq not found in PATH — run: harnessed doctor",

package/package.json

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

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

@@ -0,0 +1,129 @@
+---
+name: auto
+description: |
+  超级主控编排器 — 一行命令跑完整 6-stage 功能开发流 (research conditional →
+  discuss → plan → task → verify → retro mandatory), 适合 trivial / well-defined feature OR 你
+  想 hands-off。每 stage 内部仍 fan-out sub-workflow per 现有 stage-master orchestrator pattern。
+  v3.2.0 强化:Phase 0 AI 1-shot complexity assessment + Phase 0.5 understanding check prompt
+  + Phase 5 `/retro` mandatory。
+  schema_version: harnessed.workflow.v3 with delegates_to (6 sub: research conditional order 0 +
+  4 stage-master order 1-4 + retro mandatory order 5) + disciplines_applied (6 default)
+  + tools_available (agent-teams-create + planning-with-files)。Fail-fast default; opt-in
+  `--staged` flag 重现 stage gate UX (每 stage 完停 user review)。
+  Triggered by slash command `/auto` (bare per ADR 0030 namespace policy D-02 LOCK)
+  after `harnessed setup`.
+trigger_phrases:
+  - "auto"
+  - "自动跑完"
+  - "完整流程"
+  - "一键开发"
+  - "auto chain"
+  - "super master"
+---
+
+# auto 超级主控编排器 (v3.2.0 增强版)
+
+## 概述
+
+v3.2.0 新增 — 6-stage 节奏 (research conditional → discuss → plan → task → verify → retro
+mandatory), sister 四个 stage-master `/discuss /plan /task /verify` 仍可独立调用；
+`/auto` 是可选的一行命令 chain。
+
+| order | sub | gate ref | mode | when fires |
+| ----- | --- | -------- | ---- | ---------- |
+| 0 | `research` | `judgments.stage-routing.auto-research-unclear.fires` | serial | user_understanding_unclear == true (Phase 0.5 prompt n) |
+| 1 | `discuss` | (unconditional — 4-stage chain 起点) | serial | always |
+| 2 | `plan` | (unconditional — stage 2) | serial | always |
+| 3 | `task` | (unconditional — stage 3) | serial | always |
+| 4 | `verify` | (unconditional — stage 4 收尾) | serial | always |
+| 5 | `retro` | (unconditional — auto mode mandatory) | serial | always |
+
+引擎运行时通过 `runMasterOrchestrator` 依次 spawn 6 个子工作流 yaml，遵循
+T3.5.W0.1 — 递归单层抽象 (super-master → stage-master OR standalone → sub-workflow):
+
+- 顶层调用 `/auto` → 加载 `workflows/auto/workflow.yaml` → runAutoPreFlight hook
+- pre-flight Phase 0: `assessComplexity(taskDescription)` → small/medium 自动 continue；
+  large → 提示用户切 `--staged` (y) OR abort 建议手动 (n)
+- pre-flight Phase 0.5: `promptUserUnderstanding()` → y 跳过 research；n 设置
+  `user_understanding_unclear = true` 进 ctx → research 关卡触发
+- spawn order 0: `workflows/research/workflow.yaml` (if gate fires)
+- spawn order 1-4: 4 个 stage-master `workflows/<sub>/auto/workflow.yaml`
+- spawn order 5: `workflows/retro/workflow.yaml` (mandatory unconditional)
+
+K8 ctx single snapshot：auto 顶层调用 1 个 snapshot，传递给全部 6 个 spawn
+(sister Phase 3.5 W0.1 pattern verbatim，1 snapshot per top-level invoke 跨整个 cycle)。
+
+## 默认行为
+
+- **Pre-flight 关卡**: complexity assessment + understanding check (交互式提示)
+- **连续 chain**: 6 个 stage 一行命令跑完，中间不停
+- **Fail-fast**: 任一 stage 失败立即停止，`harnessed resume` 续跑
+- **Context 自动传递**: planning-with-files `.planning/<phase>/` 喂给下游 stage
+- **Retro mandatory**: auto mode hands-off 场景，末尾强制 `/retro` 总结 (无 opt-out flag)
+- **沿用 sister planning-with-files /plan 持久化 cadence**
+
+## 可选 flag
+
+- `--staged` opt-in: 每个 stage-master 跑完后停止，等用户 review/confirm 后跑下一个 stage (stage gate UX)
+
+## 何时用 `/auto` vs 4 个 stage-master 手动
+
+✅ **触发 `/auto`**:
+- Trivial / well-defined feature (e.g. CRUD endpoint + standard pattern)
+- Hands-off 场景 (你想"跑完再回来看")
+- 跨 stage decision 都明显 (无 open question)
+- AI 自动判断需求复杂度 small/medium → 直接 continue；large → 自动建议 `--staged`
+
+❌ **跳过 `/auto` → 分阶段手动 `/discuss` → `/plan` → `/task` → `/verify`**:
+- 关键发布 / 大重构 (需 stage gate 审查)
+- 跨 stage 有 open implementation decisions
+- 你想在 stage 之间做 hands-on 审查
+- 不确定整体方向 (此时手动 `/discuss` 强 grill)
+- AI complexity gate 判定 large 且用户不切 `--staged` → 建议 abort 手动
+
+## Capability refs
+
+Sister `workflows/capabilities.yaml`:
+- `agent-teams-create` — Bucket 5 agent-platform (verify 阶段 multispec Pattern C 4-specialist team，当 critical-release-upgrade 关卡触发时)
+- `planning-with-files` — Bucket 4 核心能力 (持久化 task_plan.md + progress.md
+  跨 6 个 stage 自动传递 context)
+- Downstream sub refs:
+  - sub `research` upstream → `workflows/research/workflow.yaml` (standalone)
+  - sub `discuss` upstream → `workflows/discuss/auto/workflow.yaml` (stage-master)
+  - sub `plan` upstream → `workflows/plan/auto/workflow.yaml` (stage-master)
+  - sub `task` upstream → `workflows/task/auto/workflow.yaml` (stage-master)
+  - sub `verify` upstream → `workflows/verify/auto/workflow.yaml` (stage-master)
+  - sub `retro` upstream → `workflows/retro/workflow.yaml` (standalone)
+
+## 调用方式
+
+- Slash command: `/auto <feature description>` (bare per ADR 0030 namespace policy D-02 LOCK
+  after `harnessed setup`)
+- 4 个 stage-master `/discuss /plan /task /verify` 仍可独立调用 — `/auto` 是可选的新工作流
+- `--staged` opt-in 启用 stage gate UX (每 stage 跑完后停止等用户 review)
+
+## 如何调用
+
+使用 Bash 工具运行：
+
+```bash
+echo "$ARGUMENTS" | harnessed run auto --task-stdin
+```
+
+如果 `$ARGUMENTS` 为空，运行 `harnessed run auto`（不带 stdin pipe）。
+
+完成后，Bash 输出会在 stderr 打印 `Next:` 提示，建议下一个阶段。根据对话上下文决定是否调用 — 该提示仅供参考，不作强制指引。
+- 如需逐 stage 审查，追加 `--staged`（每个 stage 完成后暂停，等待用户 review）。
+
+<!-- harnessed-generated:v3.4.4 -->
+
+## 参考文档
+
+- D-01 master orchestrator 委托模式
+- D-02 bare slash cmd 约定 (ADR 0030 namespace policy LOCK)
+- D-13 declarative SoT (delegates_to[] 声明 + engine 消费)
+- workflows/{research,retro}/workflow.yaml — 2 个 standalone (research conditional + retro mandatory)
+- workflows/{discuss,plan,task,verify}/auto/workflow.yaml — 4 个 stage-master Phase 3.5 SHIPPED
+- workflows/judgments/stage-routing.yaml — auto-research-unclear trigger (v3.2.0 新增)
+- src/workflow/masterOrchestrator.ts — 'auto' literal + recursive spawn + runAutoPreFlight hook
+- CHANGELOG [3.2.0] — complexity gate + research/retro flow + `--staged` rename

package/workflows/capabilities.yaml

@@ -137,6 +137,13 @@ capabilities:
     since: v2.0
     category: tool-slash-cmd
     description: verify-work parallel fan-out (multi-agent high-confidence findings)
+    # ADR-0034 Finding 1 — ECC per-language reviewers收编 as verify-dimension aliases
+    # (NOT a parallel Bucket 11 entry; runtime/priority.yaml picks the language-matching
+    # one → single fire, no triple-review). Opt-in: no-op when ECC absent.
+    aliases:
+      - { impl: ecc, cmd: "ecc:python-review" }
+      - { impl: ecc, cmd: "ecc:rust-review" }
+      - { impl: ecc, cmd: "ecc:go-review" }
     fires_when:
       - phase.stage == 'verify'
 
@@ -311,8 +318,14 @@ capabilities:
     since: v2.0
     category: tool-slash-cmd
     description: GSD systematic debugging (overlap with mattpocock /diagnose — alias)
+    # ADR-0034 Finding 1 — ECC per-language build-resolvers收编 as debug/verify-dimension
+    # aliases (build-failure fix; runtime picks language-matching one). Opt-in: no-op
+    # when ECC absent.
     aliases:
       - { impl: mattpocock-skills, cmd: /diagnose }
+      - { impl: ecc, cmd: "ecc:rust-build" }
+      - { impl: ecc, cmd: "ecc:go-build" }
+      - { impl: ecc, cmd: "ecc:build-fix" }
     fires_when:
       - subtask.type == 'debug'
 
@@ -1263,3 +1276,110 @@ capabilities:
     description: GSD docs-update post-ship doc update
     fires_when:
       - phase.needs_doc_update == true
+
+  # ============================================================================
+  # Bucket 11 — ECC selective assimilation, A posture (ADR-0034)
+  # ============================================================================
+  #
+  # ECC is a near-complete PARALLEL stack; per ADR-0034 de-confliction matrix
+  # harnessed wires ONLY the additive zones here (domain-pattern starter-set ≤8 +
+  # cost-report + hookify) on ORTHOGONAL fires_when axes (subtask.domain /
+  # needs_cost_report / needs_hook_authoring — no existing entry fires on these).
+  # per-language reviewers/build-resolvers are NOT here — they收编 as verify-
+  # dimension aliases under code-review / gsd-debug (Finding 1). orchestration/
+  # review/learning/multi-agent/checkpoint families are NOT wired / HARD-EXCLUDED.
+  #
+  # Opt-in pattern (sister `codegraph`): NO install_type/plugin_id presence-check —
+  # ECC is an optional upstream; absent ECC just means these cmds no-op (no warn
+  # for non-ECC users). cmd = plugin-namespaced `ecc:<skill>` (sister superpowers).
+  # impl: ecc is a provenance label (open-string per capabilities schema).
+
+  ecc-mcp-server-patterns:
+    impl: ecc
+    cmd: "ecc:mcp-server-patterns"
+    since: v7.1
+    category: tool-slash-cmd
+    description: MCP server design patterns (ECC domain library — CC-harness-builder core)
+    fires_when:
+      - subtask.domain == 'mcp_server'
+
+  ecc-python-patterns:
+    impl: ecc
+    cmd: "ecc:python-patterns"
+    since: v7.1
+    category: tool-slash-cmd
+    description: Python idiom/structure patterns (ECC domain library)
+    fires_when:
+      - subtask.domain == 'python'
+
+  ecc-rust-patterns:
+    impl: ecc
+    cmd: "ecc:rust-patterns"
+    since: v7.1
+    category: tool-slash-cmd
+    description: Rust ownership/idiom patterns (ECC domain library)
+    fires_when:
+      - subtask.domain == 'rust'
+
+  ecc-golang-patterns:
+    impl: ecc
+    cmd: "ecc:golang-patterns"
+    since: v7.1
+    category: tool-slash-cmd
+    description: Go idiom/concurrency patterns (ECC domain library)
+    fires_when:
+      - subtask.domain == 'golang'
+
+  ecc-postgres-patterns:
+    impl: ecc
+    cmd: "ecc:postgres-patterns"
+    since: v7.1
+    category: tool-slash-cmd
+    description: PostgreSQL schema/query/perf patterns (ECC domain library)
+    fires_when:
+      - subtask.domain == 'postgres'
+
+  ecc-docker-patterns:
+    impl: ecc
+    cmd: "ecc:docker-patterns"
+    since: v7.1
+    category: tool-slash-cmd
+    description: Docker/container build patterns (ECC domain library)
+    fires_when:
+      - subtask.domain == 'docker'
+
+  ecc-nextjs-turbopack:
+    impl: ecc
+    cmd: "ecc:nextjs-turbopack"
+    since: v7.1
+    category: tool-slash-cmd
+    description: Next.js + Turbopack frontend patterns (ECC domain library)
+    fires_when:
+      - subtask.domain == 'nextjs'
+
+  ecc-api-design:
+    impl: ecc
+    cmd: "ecc:api-design"
+    since: v7.1
+    category: tool-slash-cmd
+    description: API contract/versioning design patterns (ECC domain library)
+    fires_when:
+      - subtask.domain == 'api_design'
+
+  ecc-cost-tracking:
+    impl: ecc
+    cmd: "ecc:cost-tracking"
+    since: v7.1
+    category: tool-slash-cmd
+    description: LLM cost/token spend reporting (ECC additive — harnessed has no cost report)
+    fires_when:
+      - subtask.needs_cost_report == true
+
+  ecc-hookify-rules:
+    impl: ecc
+    cmd: "ecc:hookify-rules"
+    since: v7.1
+    category: tool-slash-cmd
+    description: Author CC hooks from observed behavior (ECC additive — no harnessed equivalent)
+    fires_when:
+      - subtask.needs_hook_authoring == true

package/workflows/disciplines/doc-discipline.zh-Hans.yaml

@@ -0,0 +1,49 @@
+# workflows/disciplines/doc-discipline.yaml
+# 文档纪律 — bundled discipline (STATE digest line-limit + one-fact-per-file +
+# overview-pointer-no-inline-narrative + transient-consume-then-archive +
+# status-derived-from-artifacts + responsibility-matrix-one-home)
+# Phase v6.0 T11.1 — 7th L0 Discipline Substrate per D-09
+# Codifies CLAUDE.md 文档纪律 section (三层渐进式结构 + 反腐防膨胀铁律)
+
+schema_version: harnessed.discipline.v1
+discipline: doc
+enforcement_layer: commit
+auto_enforce: true
+
+rules:
+  - id: state-digest-line-limit
+    description: STATE.md 超过 100 行触发 halt；通过 `HARNESSED_ALLOW_LONG_STATE=1` override
+    enforcement: halt
+    trigger: "phase.type == 'commit' AND changed_files contains '.planning/STATE.md'"
+    check_method: external-cmd
+    # No auto_fix_cmd — halt rules do not auto-fix; override is env-based in TS
+
+  - id: one-fact-per-file
+    description: 决策类文档必须单一主题；同一事实跨文件重复散布违反 one-fact-per-file
+    enforcement: warn
+    trigger: "phase.type == 'commit' AND changed_files matches '\\.planning/'"
+    check_method: heuristic
+
+  - id: overview-pointer-no-inline-narrative
+    description: ROADMAP/概览类文档不得内联收尾叙事（叙事进 SUMMARY，而非 ROADMAP）
+    enforcement: warn
+    trigger: "phase.type == 'commit' AND changed_files matches 'ROADMAP\\.md|STATE\\.md'"
+    check_method: heuristic
+
+  - id: transient-consume-then-archive
+    description: HANDOFF 及其他 transient 产物必须在消费后归档，不得堆积在 .planning/ 根目录
+    enforcement: warn
+    trigger: "phase.type == 'commit' AND changed_files matches 'HANDOFF'"
+    check_method: heuristic
+
+  - id: status-derived-from-artifacts
+    description: Phase 状态必须从 VERIFICATION 产物 + 测试结果派生，而非在 STATE/ROADMAP 里手动维护布尔值
+    enforcement: warn
+    trigger: "phase.type == 'commit' AND changed_files contains '.planning/STATE.md'"
+    check_method: heuristic
+
+  - id: responsibility-matrix-one-home
+    description: 每个事实按责任矩阵只有唯一归处（决策→ADR，需求→REQUIREMENTS 等）；跨文件重复即违规
+    enforcement: info
+    trigger: "phase.type == 'commit' AND changed_files matches '\\.planning/'"
+    check_method: heuristic

package/workflows/disciplines/karpathy.yaml

@@ -10,7 +10,7 @@ auto_enforce: true
 
 rules:
   - id: think-before-coding
-    description: 先思考后写代码,不直接 dump 代码;每个子任务前 brainstorm 设计意图
+    description: Think before coding; do not dump code directly; brainstorm the design intent before each subtask
     enforcement: warn
     trigger: subtask.type == 'code-write'
     check_method: heuristic
@@ -18,14 +18,14 @@ rules:
     # (e.g., 'Plan:' / 'Approach:' / '设计:' / '思路:'),若全是 code block → warn
 
   - id: simplicity-first
-    description: 追求最小有效代码,避免不必要复杂度;YAGNI / 不为假设场景写代码
+    description: Pursue the minimal effective code, avoid unnecessary complexity; YAGNI / do not write code for hypothetical scenarios
     enforcement: warn
     trigger: always-on
     check_method: llm-judge
     # check_method='llm-judge' — verify phase 调用 code-simplifier review
 
   - id: surgical-changes
-    description: 小步原子修改,每个 commit 单一职责;不大段重写
+    description: Small atomic changes, single responsibility per commit; no large-scale rewrites
     enforcement: warn
     trigger: phase.type == 'execute'
     check_method: external-cmd
@@ -33,13 +33,13 @@ rules:
     # 单 commit > 300 line diff → warn (rough heuristic, override allowed via task spec)
 
   - id: goal-driven-execution
-    description: 目标驱动,不发散 / 不无关重构;只解决当前任务 + 不夹带 cleanup
+    description: Goal-driven, do not diverge / do no unrelated refactoring; solve only the current task and do not smuggle in cleanup
     enforcement: warn
     trigger: phase.type == 'execute'
     check_method: heuristic
 
   - id: file-length-200-hard-limit
-    description: 单文件 ≤200L 硬限 (per project CLAUDE.md karpathy 心法 reminder);超过 → split helper
+    description: Single-file ≤200L hard limit (per project CLAUDE.md karpathy guideline reminder); over the limit → split into a helper
     enforcement: halt
     trigger: phase.type == 'execute' AND file.lines > 200
     check_method: external-cmd

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

@@ -0,0 +1,47 @@
+# workflows/disciplines/karpathy.yaml
+# karpathy 心法 + 编码硬限 — bundled discipline (think-before-coding / simplicity-first / surgical-changes / goal-driven)
+# Phase v3.0-3.3 W0.4 ship per D-09 (L0 Discipline Substrate)
+# Snapshot of CLAUDE.md as of v3.0 ship date (K7 mitigation, verbatim)
+
+schema_version: harnessed.discipline.v1
+discipline: karpathy
+enforcement_layer: code-writing
+auto_enforce: true
+
+rules:
+  - id: think-before-coding
+    description: 先思考后写代码,不直接 dump 代码;每个子任务前 brainstorm 设计意图
+    enforcement: warn
+    trigger: subtask.type == 'code-write'
+    check_method: heuristic
+    # check_method='heuristic' — runtime engine 检查 subagent 输出 first 200 char 是否含设计意图 marker
+    # (e.g., 'Plan:' / 'Approach:' / '设计:' / '思路:'),若全是 code block → warn
+
+  - id: simplicity-first
+    description: 追求最小有效代码,避免不必要复杂度;YAGNI / 不为假设场景写代码
+    enforcement: warn
+    trigger: always-on
+    check_method: llm-judge
+    # check_method='llm-judge' — verify phase 调用 code-simplifier review
+
+  - id: surgical-changes
+    description: 小步原子修改,每个 commit 单一职责;不大段重写
+    enforcement: warn
+    trigger: phase.type == 'execute'
+    check_method: external-cmd
+    auto_fix_cmd: 'git diff --stat HEAD~1 | awk ''{lines+=$3} END {if (lines>300) exit 1}'''
+    # 单 commit > 300 line diff → warn (rough heuristic, override allowed via task spec)
+
+  - id: goal-driven-execution
+    description: 目标驱动,不发散 / 不无关重构;只解决当前任务 + 不夹带 cleanup
+    enforcement: warn
+    trigger: phase.type == 'execute'
+    check_method: heuristic
+
+  - id: file-length-200-hard-limit
+    description: 单文件 ≤200L 硬限 (per project CLAUDE.md karpathy 心法 reminder);超过 → split helper
+    enforcement: halt
+    trigger: phase.type == 'execute' AND file.lines > 200
+    check_method: external-cmd
+    auto_fix_cmd: 'wc -l <file> | awk ''{if ($1>200) exit 1}'''
+    # 实装 split helper pattern (sister fallbackHandlers.ts / sdkReconcile.ts ≤80L)