harnessed 3.3.1 → 3.4.1

package/dist/index.mjs

@@ -1,6 +1,6 @@
 // package.json
 var package_default = {
-  version: "3.3.1"};
+  version: "3.4.1"};
 
 // 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,OA8Fb,CAAA;;;AC3FO,IAAM,UAAU,eAAA,CAAI","file":"index.mjs","sourcesContent":["{\n  \"name\": \"harnessed\",\n  \"version\": \"3.3.1\",\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    \"workflows\",\n    \"routing\",\n    \"config-templates\",\n    \"schemas\",\n    \"README.md\",\n    \"LICENSE\",\n    \"NOTICE\"\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,OA8Fb,CAAA;;;AC3FO,IAAM,UAAU,eAAA,CAAI","file":"index.mjs","sourcesContent":["{\n  \"name\": \"harnessed\",\n  \"version\": \"3.4.1\",\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    \"workflows\",\n    \"routing\",\n    \"config-templates\",\n    \"schemas\",\n    \"README.md\",\n    \"LICENSE\",\n    \"NOTICE\"\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.3.1",
+  "version": "3.4.1",
   "description": "AI coding harness package manager + composition orchestrator",
   "type": "module",
   "license": "Apache-2.0",

package/workflows/capabilities.yaml

@@ -36,6 +36,7 @@ capabilities:
 
   grill-with-docs:
     impl: mattpocock-skills
+    plugin_namespace: mattpocock-skills
     cmd: /grill-with-docs
     since: v2.0
     category: tool-slash-cmd
@@ -45,6 +46,7 @@ capabilities:
 
   zoom-out:
     impl: mattpocock-skills
+    plugin_namespace: mattpocock-skills
     cmd: /zoom-out
     since: v2.0
     category: tool-slash-cmd
@@ -54,6 +56,7 @@ capabilities:
 
   diagnose:
     impl: mattpocock-skills
+    plugin_namespace: mattpocock-skills
     cmd: /diagnose
     since: v2.0
     category: tool-slash-cmd
@@ -64,6 +67,7 @@ capabilities:
 
   caveman:
     impl: mattpocock-skills
+    plugin_namespace: mattpocock-skills
     cmd: /caveman
     since: v2.0
     category: tool-slash-cmd
@@ -73,6 +77,7 @@ capabilities:
 
   grill-me:
     impl: mattpocock-skills
+    plugin_namespace: mattpocock-skills
     cmd: /grill-me
     since: v2.0
     category: tool-slash-cmd
@@ -82,6 +87,7 @@ capabilities:
 
   to-prd:
     impl: mattpocock-skills
+    plugin_namespace: mattpocock-skills
     cmd: /to-prd
     since: v2.0
     category: tool-slash-cmd
@@ -91,6 +97,7 @@ capabilities:
 
   to-issues:
     impl: mattpocock-skills
+    plugin_namespace: mattpocock-skills
     cmd: /to-issues
     since: v2.0
     category: tool-slash-cmd
@@ -100,6 +107,7 @@ capabilities:
 
   improve-codebase-architecture:
     impl: mattpocock-skills
+    plugin_namespace: mattpocock-skills
     cmd: /improve-codebase-architecture
     since: v2.0
     category: tool-slash-cmd
@@ -109,6 +117,7 @@ capabilities:
 
   code-review:
     impl: mattpocock-skills
+    plugin_namespace: mattpocock-skills
     cmd: /code-review
     since: v2.0
     category: tool-slash-cmd
@@ -118,6 +127,7 @@ capabilities:
 
   code-simplifier:
     impl: mattpocock-skills
+    plugin_namespace: mattpocock-skills
     cmd: /code-simplifier
     since: v2.0
     category: tool-slash-cmd
@@ -127,6 +137,7 @@ capabilities:
 
   investigate:
     impl: mattpocock-skills
+    plugin_namespace: mattpocock-skills
     cmd: /investigate
     since: v2.0
     category: tool-slash-cmd
@@ -144,6 +155,7 @@ capabilities:
 
   ui-ux-pro-max:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /ui-ux-pro-max
     since: v2.0
     category: tool-slash-cmd
@@ -154,6 +166,7 @@ capabilities:
 
   frontend-design:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /frontend-design
     since: v2.0
     category: tool-slash-cmd
@@ -181,6 +194,7 @@ capabilities:
 
   webapp-testing:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /webapp-testing
     since: v2.0
     category: tool-bundled-skill
@@ -226,6 +240,7 @@ capabilities:
 
   gsd-discuss-phase:
     impl: gsd
+    plugin_namespace: gsd
     cmd: /gsd-discuss-phase
     since: v2.0
     category: tool-slash-cmd
@@ -235,6 +250,7 @@ capabilities:
 
   gsd-plan-phase:
     impl: gsd
+    plugin_namespace: gsd
     cmd: /gsd-plan-phase
     since: v2.0
     category: tool-slash-cmd
@@ -244,6 +260,7 @@ capabilities:
 
   gsd-review:
     impl: gsd
+    plugin_namespace: gsd
     cmd: /gsd-review
     since: v2.0
     category: tool-slash-cmd
@@ -253,6 +270,7 @@ capabilities:
 
   gsd-debug:
     impl: gsd
+    plugin_namespace: gsd
     cmd: /gsd-debug
     since: v2.0
     category: tool-slash-cmd
@@ -264,6 +282,7 @@ capabilities:
 
   gsd-progress:
     impl: gsd
+    plugin_namespace: gsd
     cmd: /gsd-progress
     since: v2.0
     category: tool-slash-cmd
@@ -273,6 +292,7 @@ capabilities:
 
   gsd-verify-work:
     impl: gsd
+    plugin_namespace: gsd
     cmd: /gsd-verify-work
     since: v2.0
     category: tool-slash-cmd
@@ -286,6 +306,7 @@ capabilities:
 
   gstack-office-hours:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /office-hours
     since: v2.0
     category: tool-slash-cmd
@@ -295,6 +316,7 @@ capabilities:
 
   gstack-plan-ceo-review:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /plan-ceo-review
     since: v2.0
     category: tool-slash-cmd
@@ -304,6 +326,7 @@ capabilities:
 
   gstack-review:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /review
     since: v2.0
     category: tool-slash-cmd
@@ -313,6 +336,7 @@ capabilities:
 
   gstack-qa:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /qa
     since: v2.0
     category: tool-slash-cmd
@@ -322,6 +346,7 @@ capabilities:
 
   gstack-cso:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /cso
     since: v2.0
     category: tool-slash-cmd
@@ -331,6 +356,7 @@ capabilities:
 
   gstack-design-review:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /design-review
     since: v2.0
     category: tool-slash-cmd
@@ -363,6 +389,7 @@ capabilities:
   # cmd `/plan` invocation → plugin 真生成 3 file 持久化, NOT fs.writeFile self-impl。
   planning-with-files:
     impl: claude-code-plugin
+    plugin_namespace: planning-with-files
     cmd: /plan
     since: v2.0
     category: tool-plugin
@@ -380,6 +407,7 @@ capabilities:
   # D-10: ralph-loop 真接 SDK wrapper (NOT mock reference; sister Phase 2.2 v0.2.0 ship)
   ralph-loop:
     impl: bundled-skill
+    plugin_namespace: ralph-loop
     cmd: ralph-loop
     since: v2.0
     category: tool-bundled-skill
@@ -521,6 +549,7 @@ capabilities:
 
   autoplan:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /autoplan
     since: v3.0
     category: tool-slash-cmd
@@ -530,6 +559,7 @@ capabilities:
 
   codex:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /codex
     since: v3.0
     category: tool-slash-cmd
@@ -539,6 +569,7 @@ capabilities:
 
   design-shotgun:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /design-shotgun
     since: v3.0
     category: tool-slash-cmd
@@ -548,6 +579,7 @@ capabilities:
 
   design-html:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /design-html
     since: v3.0
     category: tool-slash-cmd
@@ -557,6 +589,7 @@ capabilities:
 
   design-consultation:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /design-consultation
     since: v3.0
     category: tool-slash-cmd
@@ -566,6 +599,7 @@ capabilities:
 
   plan-design-review:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /plan-design-review
     since: v3.0
     category: tool-slash-cmd
@@ -575,6 +609,7 @@ capabilities:
 
   plan-devex-review:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /plan-devex-review
     since: v3.0
     category: tool-slash-cmd
@@ -584,6 +619,7 @@ capabilities:
 
   plan-eng-review:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /plan-eng-review
     since: v3.0
     category: tool-slash-cmd
@@ -593,6 +629,7 @@ capabilities:
 
   plan-tune:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /plan-tune
     since: v3.0
     category: tool-slash-cmd
@@ -602,6 +639,7 @@ capabilities:
 
   context-save:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /context-save
     since: v3.0
     category: tool-slash-cmd
@@ -611,6 +649,7 @@ capabilities:
 
   context-restore:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /context-restore
     since: v3.0
     category: tool-slash-cmd
@@ -620,6 +659,7 @@ capabilities:
 
   qa-only:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /qa-only
     since: v3.0
     category: tool-slash-cmd
@@ -629,6 +669,7 @@ capabilities:
 
   devex-review:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /devex-review
     since: v3.0
     category: tool-slash-cmd
@@ -638,6 +679,7 @@ capabilities:
 
   benchmark:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /benchmark
     since: v3.0
     category: tool-slash-cmd
@@ -647,6 +689,7 @@ capabilities:
 
   browse:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /browse
     since: v3.0
     category: tool-slash-cmd
@@ -656,6 +699,7 @@ capabilities:
 
   open-gstack-browser:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /open-gstack-browser
     since: v3.0
     category: tool-slash-cmd
@@ -665,6 +709,7 @@ capabilities:
 
   connect-chrome:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /connect-chrome
     since: v3.x
     category: tool-slash-cmd
@@ -674,6 +719,7 @@ capabilities:
 
   setup-browser-cookies:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /setup-browser-cookies
     since: v3.0
     category: tool-slash-cmd
@@ -683,6 +729,7 @@ capabilities:
 
   ship:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /ship
     since: v3.0
     category: tool-slash-cmd
@@ -693,6 +740,7 @@ capabilities:
 
   land-and-deploy:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /land-and-deploy
     since: v3.0
     category: tool-slash-cmd
@@ -702,6 +750,7 @@ capabilities:
 
   setup-deploy:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /setup-deploy
     since: v3.0
     category: tool-slash-cmd
@@ -711,6 +760,7 @@ capabilities:
 
   setup-gbrain:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /setup-gbrain
     since: v3.0
     category: tool-slash-cmd
@@ -720,6 +770,7 @@ capabilities:
 
   canary:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /canary
     since: v3.0
     category: tool-slash-cmd
@@ -729,6 +780,7 @@ capabilities:
 
   document-release:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /document-release
     since: v3.0
     category: tool-slash-cmd
@@ -738,6 +790,7 @@ capabilities:
 
   document-generate:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /document-generate
     since: v3.0
     category: tool-slash-cmd
@@ -747,6 +800,7 @@ capabilities:
 
   careful:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /careful
     since: v3.0
     category: tool-slash-cmd
@@ -757,6 +811,7 @@ capabilities:
 
   guard:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /guard
     since: v3.0
     category: tool-slash-cmd
@@ -766,6 +821,7 @@ capabilities:
 
   freeze:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /freeze
     since: v3.0
     category: tool-slash-cmd
@@ -775,6 +831,7 @@ capabilities:
 
   unfreeze:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /unfreeze
     since: v3.0
     category: tool-slash-cmd
@@ -784,6 +841,7 @@ capabilities:
 
   gstack-upgrade:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /gstack-upgrade
     since: v3.0
     category: tool-slash-cmd
@@ -793,6 +851,7 @@ capabilities:
 
   learn:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /learn
     since: v3.0
     category: tool-slash-cmd
@@ -802,6 +861,7 @@ capabilities:
 
   health:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /health
     since: v3.0
     category: tool-slash-cmd
@@ -811,6 +871,7 @@ capabilities:
 
   make-pdf:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /make-pdf
     since: v3.0
     category: tool-slash-cmd
@@ -821,6 +882,7 @@ capabilities:
   # 2 alias suffix `-gstack` (避免命名冲突 per Pattern A E.2)
   retro-gstack:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /retro
     since: v3.0
     category: tool-slash-cmd
@@ -832,6 +894,7 @@ capabilities:
 
   investigate-gstack:
     impl: gstack
+    plugin_namespace: gstack
     cmd: /investigate
     since: v3.0
     category: tool-slash-cmd
@@ -872,6 +935,7 @@ capabilities:
 
   gsd-research-phase:
     impl: gsd
+    plugin_namespace: gsd
     cmd: /gsd-research-phase
     since: v3.0
     category: tool-slash-cmd

package/workflows/disciplines/language.yaml

@@ -1,7 +1,7 @@
 # workflows/disciplines/language.yaml
-# 语言与输出规范 — 机器化 ~/.claude/CLAUDE.md 「语言与输出规范」 节
-# Phase v3.0-3.3 W0.4 ship per D-09
-# Snapshot of CLAUDE.md as of v3.0 ship date (K7 mitigation, verbatim)
+# 语言与输出规范 — universal "follow user conversation language" (v3.4.0 update)
+# Phase v3.0-3.3 W0.4 origin (zh-Hans default); v3.4.0 W1.1 semantic shift to
+# language-agnostic + env.HARNESSED_USER_LANG config consumption (D-04 Part D).
 
 schema_version: harnessed.discipline.v1
 discipline: language
@@ -9,20 +9,26 @@ enforcement_layer: output
 auto_enforce: true
 
 rules:
-  - id: default-language-zh-hans
-    description: 默认输出语言简体中文 (zh-Hans);所有解释/分析/计划/总结/提问/状态更新一律中文
-    enforcement: warn
-    trigger: user.lang_request == null
-    check_method: heuristic
-    # heuristic — response 中文 char 占比 > 60% (排除 code block);占比 < 30% → warn
+  - id: follow-user-language
+    description: |-
+      Response language follows env.HARNESSED_USER_LANG (set by `harnessed setup`
+      Step D — detected from OS locale or user override). If env not set,
+      fallback to the user's current conversation language (Claude Code
+      naturally mirrors user input; this discipline codifies the universal
+      intent). Output artifacts (findings.md / task_plan.md /
+      RETROSPECTIVE.md etc.) honor the same setting so workflow outputs
+      stay consistent with CLI tone.
+    enforcement: info
+    trigger: every Claude response
+    check_method: read ~/.claude/settings.json env.HARNESSED_USER_LANG, validate output lang matches
 
   - id: preserve-english-categories
-    description: 8 类强制保留英文原文,不翻译不音译
+    description: 8 类强制保留英文原文,不翻译不音译 (语言无关 — 任何 user_lang 都适用)
     enforcement: warn
     trigger: always-on
     check_method: heuristic
-    # 8 类 (verbatim CLAUDE.md):
-    #   1. 代码/命令/shell/配置/正则/SQL
+    # 8 类 (verbatim CLAUDE.md, language-agnostic):
+    #   1. 代码/命令/shell/配置/正则/SQL  /  code / cmd / shell / config / regex / SQL
     #   2. 文件/目录/路径名 (src/components/Button.tsx 等)
     #   3. 工具/框架/库/产品/公司名 (Claude Code / GSD / React 等)
     #   4. API/函数/类/变量/字段/环境变量/配置键
@@ -31,8 +37,22 @@ rules:
     #   7. 业内固定缩写与通用术语 (TDD / CRUD / API / MCP / token 等)
     #   8. 引用原文 verbatim
 
+  - id: cross-cultural-humor
+    description: |-
+      Cultural adaptation of idioms / wordplay. When translating humorous
+      content across language boundaries, prefer culturally-resonant
+      analogues over literal translation. Example sister README pattern:
+      中文借「鹦鹉学舌」成语 + 英文借 "parrot on shoulders / pirate trope"
+      — same concept, different cultural anchor. Avoid forced calques.
+    enforcement: info
+    trigger: humor_or_idiom_present
+    check_method: heuristic
+
   - id: lang-request-override
-    description: 用户明确"用英文回答"/"reply in English"/"翻译成 X" → 整段切换目标语言
+    description: |-
+      User explicit override — "用英文回答" / "reply in English" / "翻译成 X"
+      / `--lang en|zh` CLI flag → switch the entire response to the
+      target language regardless of env.HARNESSED_USER_LANG.
     enforcement: info
     trigger: user.lang_request != null
     check_method: regex

package/workflows/discuss/phase/SKILL.md

@@ -52,6 +52,14 @@ Sister `workflows/judgments/phase-gate.yaml`:
 - < 1 天工作量
 - bug 修复且已有最小复现
 
+## How to invoke
+
+Use the SlashCommand tool to run: `{{ capabilities.gsd-discuss-phase.cmd }}`
+
+(If the rendered cmd above is the bare `/gsd-discuss-phase` accompanied by a `⚠️ ... not installed`
+warning from `harnessed setup`, install the missing plugin first then re-run
+`harnessed setup` to re-render this SKILL.md with the full namespaced cmd.)
+
 ## References
 
 - D-04 Stage ① Discuss 三层 (战略 / phase / 子任务)

package/workflows/discuss/strategic/SKILL.md

@@ -56,6 +56,14 @@ Sister `workflows/judgments/strategic-gate.yaml`:
 - continuing 已有 phase 的执行
 - 用户已给明确 ticket / spec
 
+## How to invoke
+
+Use the SlashCommand tool to run: `{{ capabilities.gstack-office-hours.cmd }}`
+
+(If the rendered cmd above is the bare `/gstack-office-hours` accompanied by a `⚠️ ... not installed`
+warning from `harnessed setup`, install the missing plugin first then re-run
+`harnessed setup` to re-render this SKILL.md with the full namespaced cmd.)
+
 ## References
 
 - D-04 Stage ① Discuss 三层 (战略 / phase / 子任务)

package/workflows/discuss/subtask/SKILL.md

@@ -57,6 +57,14 @@ Sister `workflows/judgments/subtask-gate.yaml`:
 - 标准库直接调用
 - bug 修复且已知根因
 
+## How to invoke
+
+Use the SlashCommand tool to run: `{{ capabilities.superpowers-brainstorming.cmd }}`
+
+(If the rendered cmd above is the bare `/superpowers-brainstorming` accompanied by a `⚠️ ... not installed`
+warning from `harnessed setup`, install the missing plugin first then re-run
+`harnessed setup` to re-render this SKILL.md with the full namespaced cmd.)
+
 ## References
 
 - D-04 Stage ① Discuss 三层 (战略 / phase / 子任务)

package/workflows/plan/architecture/SKILL.md

@@ -53,6 +53,14 @@ trigger `is-complex-architecture` 重构 ref。
 - 性能 / scaling 关键路径
 - 引入显著技术债 / migration 风险
 
+## How to invoke
+
+Use the SlashCommand tool to run: `{{ capabilities.plan-eng-review.cmd }}`
+
+(If the rendered cmd above is the bare `/plan-eng-review` accompanied by a `⚠️ ... not installed`
+warning from `harnessed setup`, install the missing plugin first then re-run
+`harnessed setup` to re-render this SKILL.md with the full namespaced cmd.)
+
 ## References
 
 - D-04 Stage ② Plan 二层 (架构 / 计划)

package/workflows/plan/phase/SKILL.md

@@ -55,6 +55,14 @@ reframe)。
 - `progress.md` — phase 进度跟踪 + cross-session 恢复
 - (`findings.md` 由 discuss-* sub-workflow 产出, 此处不重复)
 
+## How to invoke
+
+Use the SlashCommand tool to run: `{{ capabilities.gsd-plan-phase.cmd }}`
+
+(If the rendered cmd above is the bare `/gsd-plan-phase` accompanied by a `⚠️ ... not installed`
+warning from `harnessed setup`, install the missing plugin first then re-run
+`harnessed setup` to re-render this SKILL.md with the full namespaced cmd.)
+
 ## References
 
 - D-04 Stage ② Plan 二层 (架构 / 计划)

package/workflows/retro/SKILL.md

@@ -57,6 +57,14 @@ harnessed retro --milestone <name> --dry-run --non-interactive
 harnessed retro --milestone <name> --apply
 ```
 
+## How to invoke
+
+Use the SlashCommand tool to run: `{{ capabilities.retro-gstack.cmd }}`
+
+(If the rendered cmd above is the bare `/retro-gstack` accompanied by a `⚠️ ... not installed`
+warning from `harnessed setup`, install the missing plugin first then re-run
+`harnessed setup` to re-render this SKILL.md with the full namespaced cmd.)
+
 ## References
 
 - D-04 NEW v3 standalone workflow (research v3 bump + retro NEW)