harnessed 4.7.0 → 4.9.0

package/dist/index.mjs

@@ -1,6 +1,6 @@
 // package.json
 var package_default = {
-  version: "4.7.0"};
+  version: "4.9.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.7.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.9.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/perturn-inject.yaml

@@ -0,0 +1,49 @@
+# yaml-language-server: $schema=../../schemas/manifest.v1.schema.json
+# Phase 35 (v5.0 Spec 3/G) — opt-in per-turn injection hook.
+# Registers a UserPromptSubmit hook that runs bin/harnessed-inject-state.mjs each
+# turn: the bin prints a <workflow-state> breadcrumb (you-are-here / next sub) +
+# a relevance-filtered <project-context> block for the ACTIVE session's workflow
+# (session-scoped via the composite ledger key — Phase 34/35). The bin exits 0
+# silently when there is no active workflow, so an enabled hook in a non-workflow
+# repo is a cheap no-op. Opt-in (manifests/optional/) because per-turn injection
+# has a token cost (~1500 budget) and only matters in a harnessed-workflow repo.
+# Idempotent — re-install on an existing matching entry → skip.
+apiVersion: harnessed/v1
+kind: Manifest
+metadata:
+  name: perturn-inject
+  display_name: Per-Turn State Injection (UserPromptSubmit)
+  description: Opt-in UserPromptSubmit hook injecting the active session's workflow-state + project-context each turn (Spec 3/G).
+  upstream:
+    source: perturn-inject
+    homepage: https://github.com/easyinplay/harnessed
+    repository: https://github.com/easyinplay/harnessed.git
+    license: MIT
+    notice: First-party harnessed hook (Phase 35, v5.0 Spec 3/G).
+spec:
+  type: cc-hook
+  component_type: command
+  category: meta
+  install_type: hook
+  install:
+    method: cc-hook-add
+    cmd: "node bin/harnessed-inject-state.mjs"
+    hook_event: UserPromptSubmit
+    hook_command: "node bin/harnessed-inject-state.mjs"
+    idempotent_check: "grep -q harnessed-inject-state ~/.claude/settings.json"
+  verify:
+    cmd: "grep -q harnessed-inject-state ~/.claude/settings.json"
+    timeout_ms: 5000
+    expected_exit_code: 0
+  uninstall:
+    cmd: "true"
+  upstream_health:
+    stability: beta
+    last_check: "2026-06-25"
+    last_known_good_version: "0.1.0"
+    fallback_action: warn
+  signed_by: easyinplay
+  platforms:
+    - linux
+    - darwin
+    - win32

package/messages/zh-Hans.json

@@ -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",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harnessed",
-  "version": "4.7.0",
+  "version": "4.9.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/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)

package/workflows/disciplines/operational.yaml

@@ -12,7 +12,7 @@ auto_enforce: true
 rules:
   - id: biome-preempt
     description: |
-      TS/JS commit 前必跑 `pnpm exec biome check --write` (3 CI-red recurrences Phase 2.1.1/2.2/2.3 project memory)
+      Before any TS/JS commit you must run `pnpm exec biome check --write` (3 CI-red recurrences Phase 2.1.1/2.2/2.3 project memory)
     enforcement: auto-fix
     trigger: |
       phase.type == 'commit' AND
@@ -23,8 +23,8 @@ rules:
 
   - id: a7-adr-conservation
     description: |
-      新 ADR 不动旧 ADR main body,baseline tag iterate,CI A7 step 守恒
-      (sister Phase 1.3-2.6 ADR errata 路径)
+      A new ADR does not touch the main body of old ADRs; iterate via baseline tag, conserved by the CI A7 step
+      (sister Phase 1.3-2.6 ADR errata path)
     enforcement: warn
     trigger: phase.type == 'commit' AND changed_files contains 'docs/adr/'
     check_method: external-cmd
@@ -40,14 +40,14 @@ rules:
 
   - id: no-skip-hooks
     description: |
-      不允许 --no-verify / --no-gpg-sign 等 skip hook flag,除非用户明确要求
+      Skip-hook flags such as --no-verify / --no-gpg-sign are not allowed, unless the user explicitly requests them
     enforcement: halt
     trigger: cmd.type == 'git-commit' AND args contains '--no-verify'
     check_method: regex
 
   - id: destructive-ops-explicit
     description: |
-      Destructive ops (git reset --hard / push --force / rm -rf / drop table) 必须用户 explicit 确认
+      Destructive ops (git reset --hard / push --force / rm -rf / drop table) require explicit user confirmation
     enforcement: halt
     trigger: cmd.is_destructive == true
     check_method: heuristic
@@ -55,7 +55,7 @@ rules:
 
   - id: authorization-not-transitive
     description: |
-      用户 approve 一次 push ≠ 全程 approve;每个 destructive / shared-state 操作单独确认
+      A user approving one push ≠ approval for the whole session; each destructive / shared-state operation needs separate confirmation
     enforcement: warn
     trigger: cmd.requires_approval == true AND session.has_prior_approval == true
     check_method: heuristic

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

@@ -0,0 +1,79 @@
+# workflows/disciplines/operational.yaml
+# 操作纪律 — bundled discipline (biome preempt + commit safety +
+# A7 ADR + no-skip-hooks + authorization-not-transitive + destructive-ops-explicit)
+# 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: operational
+enforcement_layer: commit
+auto_enforce: true
+
+rules:
+  - id: biome-preempt
+    description: |
+      TS/JS commit 前必跑 `pnpm exec biome check --write` (3 CI-red recurrences Phase 2.1.1/2.2/2.3 project memory)
+    enforcement: auto-fix
+    trigger: |
+      phase.type == 'commit' AND
+      changed_files matches '\\.(ts|tsx|js|mjs)$'
+    check_method: external-cmd
+    auto_fix_cmd: 'corepack pnpm exec biome check --write'
+    # NEW src/discipline/enforcement/before-commit.ts hook; exit 0 才允许 commit
+
+  - id: a7-adr-conservation
+    description: |
+      新 ADR 不动旧 ADR main body,baseline tag iterate,CI A7 step 守恒
+      (sister Phase 1.3-2.6 ADR errata 路径)
+    enforcement: warn
+    trigger: phase.type == 'commit' AND changed_files contains 'docs/adr/'
+    check_method: external-cmd
+    auto_fix_cmd: 'scripts/check-adr-conservation.sh'
+
+  - id: no-push-without-approval
+    description: |
+      NEVER push to remote without user explicit approval (project CLAUDE.md commit safety)
+    enforcement: halt
+    trigger: cmd.type == 'git-push'
+    check_method: external-cmd
+    # ralph-loop / subagent 自动调 git push → halt;user explicit `git push` 在主 session 允许
+
+  - id: no-skip-hooks
+    description: |
+      不允许 --no-verify / --no-gpg-sign 等 skip hook flag,除非用户明确要求
+    enforcement: halt
+    trigger: cmd.type == 'git-commit' AND args contains '--no-verify'
+    check_method: regex
+
+  - id: destructive-ops-explicit
+    description: |
+      Destructive ops (git reset --hard / push --force / rm -rf / drop table) 必须用户 explicit 确认
+    enforcement: halt
+    trigger: cmd.is_destructive == true
+    check_method: heuristic
+    # heuristic — 命令含 'rm -rf' / 'reset --hard' / '--force' / 'DROP TABLE' / 'delete from'
+
+  - id: authorization-not-transitive
+    description: |
+      用户 approve 一次 push ≠ 全程 approve;每个 destructive / shared-state 操作单独确认
+    enforcement: warn
+    trigger: cmd.requires_approval == true AND session.has_prior_approval == true
+    check_method: heuristic
+
+  # v3.6.0 Phase 3 — transparent-skip discipline (P0b 下半,Audit § fallback
+  # 三条铁律 "拿不准 → 倾向跳过 + 透明声明"). prompt-inject method delivered
+  # via src/workflow/run.ts TRANSPARENT_SKIP_RULES const appended to
+  # criticalSystemReminder_EXPERIMENTAL alongside ESCALATION_RULES (v3.5.0
+  # Phase 2 sister). Spawned subagent reads the rule + emits the verbatim
+  # skip message when gate context is ambiguous instead of silent execution.
+  - id: transparent-skip-on-low-confidence
+    description: |
+      When a phase gate condition cannot be confidently evaluated (e.g.
+      expected context fields missing, default-valued, or contradictory),
+      prefer skip + transparent explanation over silent execution.
+      Verbatim format: "这次跳过了 <phase>, 因为 <reason>. 如果你认为
+      需要请明说" / English: "Skipped <phase> because <reason>. Tell me
+      if you actually need it."
+    enforcement: warn
+    trigger: gate_evaluation_low_confidence
+    check_method: prompt-inject

package/workflows/disciplines/output-style.yaml

@@ -10,7 +10,7 @@ auto_enforce: true
 
 rules:
   - id: bluf-conclusion-first
-    description: 结论先行 (BLUF),每段先一句给答案/判断/推荐,再展开理由
+    description: Conclusion first (BLUF); each paragraph leads with one sentence giving the answer/judgment/recommendation, then expands the reasoning
     enforcement: warn
     trigger: always-on
     check_method: heuristic
@@ -18,7 +18,7 @@ rules:
     # 失败 → warn 'BLUF missing: first sentence is not a conclusion'
 
   - id: no-sycophantic-open-close
-    description: 删除"好问题/太棒了/完美/希望对你有帮助/还需要别的吗"等开场闭合套话
+    description: Remove opening/closing filler phrases like "good question / awesome / perfect / hope this helps / anything else"
     enforcement: auto-fix
     trigger: always-on
     check_method: regex
@@ -26,14 +26,14 @@ rules:
     # NEW src/discipline/enforcement/strip-sycophantic.ts — regex strip 13 known phrase
 
   - id: no-emoji-unless-requested
-    description: 禁用 emoji,除非用户明确要求 (项目 markdown 文件如 README/PR/CHANGELOG 不约束)
+    description: No emoji unless the user explicitly requests it (project markdown files such as README/PR/CHANGELOG are not constrained)
     enforcement: warn
     trigger: response.target == 'chat' AND user.requested_emoji == false
     check_method: regex
     # regex /\p{Emoji_Presentation}/u; 命中 + trigger fires → warn
 
   - id: no-em-dash
-    description: 禁用 em-dash (—— / —);替代:补充用括号/冒号,并列用顿号,转折单独成句
+    description: No em-dash (—— / —); instead use parentheses or colons for asides, commas for lists, and a separate sentence for contrast
     enforcement: auto-fix
     trigger: response.target == 'chat'
     check_method: regex
@@ -41,13 +41,13 @@ rules:
     # auto-replace '——' → ',  ' (单段内逗号);'—' → ':' OR ','
 
   - id: precise-quantifier
-    description: 量词精确,能给具体数字/文件名/行号/commit hash 就不用"一些/几个/多个"
+    description: Precise quantifiers; when a concrete number/filename/line number/commit hash is available, do not say "some/a few/several"
     enforcement: info
     trigger: always-on
     check_method: llm-judge
 
   - id: no-end-recap
-    description: 不做结尾总结,除非用户明确要求"汇总/recap"
+    description: No closing summary unless the user explicitly asks to "summarize/recap"
     enforcement: warn
     trigger: response.target == 'chat'
     check_method: heuristic
@@ -55,7 +55,7 @@ rules:
     # → warn 'redundant end recap'
 
   - id: no-empty-continuation-question
-    description: 禁空洞续作询问 (要不要我帮你 X?/还需要别的吗?);保留工作流必要下一步指引
+    description: No empty continuation questions ("want me to help you X?" / "anything else?"); keep workflow-necessary next-step guidance
     enforcement: warn
     trigger: response.target == 'chat'
     check_method: regex

package/workflows/disciplines/output-style.zh-Hans.yaml

@@ -0,0 +1,62 @@
+# workflows/disciplines/output-style.yaml
+# 对话回答风格 — bundled discipline (BLUF + no-sycophantic + no-emoji + no-em-dash + 量词精确 + no-end-recap + no-empty-continuation-question)
+# 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: output-style
+enforcement_layer: output
+auto_enforce: true
+
+rules:
+  - id: bluf-conclusion-first
+    description: 结论先行 (BLUF),每段先一句给答案/判断/推荐,再展开理由
+    enforcement: warn
+    trigger: always-on
+    check_method: heuristic
+    # heuristic — 第一句长度 ≤ 100 char + 含答案动词 ('是' / '不是' / '推荐' / '应该' / 'use X')
+    # 失败 → warn 'BLUF missing: first sentence is not a conclusion'
+
+  - id: no-sycophantic-open-close
+    description: 删除"好问题/太棒了/完美/希望对你有帮助/还需要别的吗"等开场闭合套话
+    enforcement: auto-fix
+    trigger: always-on
+    check_method: regex
+    auto_fix_cmd: 'strip-sycophantic'
+    # NEW src/discipline/enforcement/strip-sycophantic.ts — regex strip 13 known phrase
+
+  - id: no-emoji-unless-requested
+    description: 禁用 emoji,除非用户明确要求 (项目 markdown 文件如 README/PR/CHANGELOG 不约束)
+    enforcement: warn
+    trigger: response.target == 'chat' AND user.requested_emoji == false
+    check_method: regex
+    # regex /\p{Emoji_Presentation}/u; 命中 + trigger fires → warn
+
+  - id: no-em-dash
+    description: 禁用 em-dash (—— / —);替代:补充用括号/冒号,并列用顿号,转折单独成句
+    enforcement: auto-fix
+    trigger: response.target == 'chat'
+    check_method: regex
+    auto_fix_cmd: 'replace-em-dash'
+    # auto-replace '——' → ',  ' (单段内逗号);'—' → ':' OR ','
+
+  - id: precise-quantifier
+    description: 量词精确,能给具体数字/文件名/行号/commit hash 就不用"一些/几个/多个"
+    enforcement: info
+    trigger: always-on
+    check_method: llm-judge
+
+  - id: no-end-recap
+    description: 不做结尾总结,除非用户明确要求"汇总/recap"
+    enforcement: warn
+    trigger: response.target == 'chat'
+    check_method: heuristic
+    # heuristic — 末尾 200 char 含 '## 总结' / '## Summary' / 'In summary' / '综上所述'
+    # → warn 'redundant end recap'
+
+  - id: no-empty-continuation-question
+    description: 禁空洞续作询问 (要不要我帮你 X?/还需要别的吗?);保留工作流必要下一步指引
+    enforcement: warn
+    trigger: response.target == 'chat'
+    check_method: regex
+    # regex /要不要|还需要别的|希望对你有帮助/  + trigger fires → warn

package/workflows/disciplines/priority.yaml

@@ -20,8 +20,8 @@ priority_hierarchy:
 rules:
   - id: multi-capability-arbitration
     description: |
-      多 capability fires_when 同时 true → 按 priority_hierarchy order 选最高
-      e.g., gstack /office-hours + GSD /gsd-discuss-phase 同 fire → gstack 先跑
+      Multiple capabilities fires_when true at once → pick the highest by priority_hierarchy order
+      e.g., gstack /office-hours + GSD /gsd-discuss-phase fire together → gstack runs first
     enforcement: warn
     trigger: capabilities.fired_count > 1
     check_method: heuristic