universal-dev-standards 6.13.1 → 6.14.0-beta.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (693) hide show
  1. package/README.md +13 -3
  2. package/bin/uds.js +75 -3
  3. package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
  4. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  5. package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
  6. package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
  7. package/bundled/ai/standards/code-review.ai.yaml +15 -2
  8. package/bundled/ai/standards/commit-message.ai.yaml +18 -4
  9. package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
  10. package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
  11. package/bundled/ai/standards/open-work-tracking.ai.yaml +254 -4
  12. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
  13. package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
  14. package/bundled/ai/standards/turn-completion-integrity.ai.yaml +14 -7
  15. package/bundled/core/ai-response-navigation.md +128 -12
  16. package/bundled/core/code-review-checklist.md +20 -2
  17. package/bundled/core/commit-message-guide.md +22 -19
  18. package/bundled/core/developer-memory.md +12 -2
  19. package/bundled/core/full-coverage-testing.md +99 -5
  20. package/bundled/core/open-work-tracking.md +251 -8
  21. package/bundled/core/pipeline-security-gates.md +63 -0
  22. package/bundled/core/project-context-memory.md +10 -2
  23. package/bundled/core/turn-completion-integrity.md +58 -11
  24. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  25. package/bundled/extensions/languages/csharp-style.md +464 -0
  26. package/bundled/extensions/languages/php-style.md +700 -0
  27. package/bundled/extensions/locales/zh-cn.md +717 -0
  28. package/bundled/extensions/locales/zh-tw.md +717 -0
  29. package/bundled/hooks/check-turn-completion-agy.mjs +147 -0
  30. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  31. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  32. package/bundled/locales/COVERAGE.md +5 -4
  33. package/bundled/locales/zh-CN/CHANGELOG.md +211 -3
  34. package/bundled/locales/zh-CN/README.md +3 -3
  35. package/bundled/locales/zh-CN/SECURITY.md +3 -1
  36. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  37. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  38. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  39. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  40. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  41. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  42. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  43. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  44. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  45. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  46. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  47. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  48. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  49. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  50. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  51. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  52. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  53. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  54. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  55. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  56. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  57. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  58. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  59. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  60. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  61. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  62. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  63. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  64. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  65. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  66. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  67. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  68. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  69. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  70. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  71. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  72. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  73. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  74. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  75. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  76. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  77. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  78. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  79. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  80. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  81. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  82. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  83. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  84. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  87. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  88. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  89. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  90. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  91. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  92. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  93. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  94. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  95. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  96. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  97. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  98. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  99. package/bundled/locales/zh-CN/core/turn-completion-integrity.md +46 -13
  100. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  101. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  102. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  103. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  104. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  105. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +11 -2
  106. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  107. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +76 -40
  108. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +32 -15
  109. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  110. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  111. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  112. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  113. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  114. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  115. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  116. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  117. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  118. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  119. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  120. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  121. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  122. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  123. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  124. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  125. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  126. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  128. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  129. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  130. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  133. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  135. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  136. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  137. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  138. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  139. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  140. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  141. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  142. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  143. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  144. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  145. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  146. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  147. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  148. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  149. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  150. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  151. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  152. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  153. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  154. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  155. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  156. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  158. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  159. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  160. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  161. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  162. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  163. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  165. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  167. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  168. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  171. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  172. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  173. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  174. package/bundled/locales/zh-CN/skills/README.md +3 -1
  175. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  176. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  177. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  178. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  179. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  180. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  181. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  182. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  183. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  184. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  185. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  186. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  187. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  188. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  190. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  191. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  192. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  193. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  194. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  195. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  196. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  197. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  198. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  199. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  200. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  201. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  202. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  203. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  204. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  205. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  206. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  207. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  208. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  209. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  210. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  211. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  212. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  213. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  215. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  216. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  217. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  219. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  220. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  221. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  222. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  223. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  224. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  225. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  226. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  227. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  229. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  230. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  231. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  232. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  233. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  234. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  235. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  236. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  237. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  238. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  239. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  240. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  241. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  242. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  244. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  245. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  246. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  247. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  248. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  249. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  250. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  251. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  252. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  253. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  254. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  255. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  256. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  257. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  258. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  259. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  260. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  261. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  262. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  263. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  264. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  265. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  266. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  267. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  268. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  269. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  270. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  271. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  272. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  273. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  274. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  275. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  276. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  277. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  278. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  279. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  280. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  281. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  282. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  283. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  284. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  285. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  286. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  287. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  288. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  289. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  290. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  291. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  292. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  293. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  294. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  295. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  296. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  297. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  298. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  300. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  301. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  302. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  303. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  304. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  305. package/bundled/locales/zh-TW/CHANGELOG.md +211 -3
  306. package/bundled/locales/zh-TW/README.md +3 -3
  307. package/bundled/locales/zh-TW/SECURITY.md +3 -1
  308. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  309. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  310. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  311. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  312. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  313. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  314. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  315. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  316. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  317. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  318. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  319. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  320. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  321. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  322. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  323. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  324. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  325. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  326. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  327. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  328. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  329. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  330. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  331. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  332. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  333. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  334. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  335. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  336. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  337. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  338. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  339. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  340. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  341. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  342. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  343. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  344. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  345. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  346. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  347. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  348. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  349. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  350. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  351. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  352. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  353. package/bundled/locales/zh-TW/core/open-work-tracking.md +164 -9
  354. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  355. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  356. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  357. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  358. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  359. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  360. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  361. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  362. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  363. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  364. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  365. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  366. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  367. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  368. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  369. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  370. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  371. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  372. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  373. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  374. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  375. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  376. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  377. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  378. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  379. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  380. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  381. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  382. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  383. package/bundled/locales/zh-TW/core/turn-completion-integrity.md +46 -13
  384. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  385. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  386. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  387. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  388. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  389. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  390. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +11 -2
  391. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  392. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +69 -33
  393. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  394. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +32 -15
  395. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  396. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  397. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  398. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  399. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  400. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  401. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  402. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  403. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  404. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  405. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  406. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  407. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  408. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  409. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  410. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  412. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  413. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  414. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  415. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  417. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  418. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  419. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  420. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  421. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  422. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  423. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  424. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  425. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  426. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  427. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  428. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  429. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  430. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  431. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  432. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  433. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  434. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  435. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  436. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  437. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  438. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  439. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  440. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  441. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  442. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  443. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  445. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  446. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  447. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  448. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  449. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  452. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  453. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  454. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  455. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  456. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  457. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  458. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  459. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  460. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  461. package/bundled/locales/zh-TW/skills/README.md +3 -1
  462. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  463. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  464. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  465. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  466. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  467. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  468. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  469. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  470. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  471. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  472. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  473. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  474. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  475. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  476. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  477. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  478. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  479. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  480. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  481. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  482. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  483. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  484. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  485. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  486. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  487. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  488. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  489. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  490. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  491. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  492. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  493. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  494. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  495. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  496. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  497. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  498. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  499. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  500. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  501. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  502. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  503. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  504. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  505. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  506. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  507. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  508. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  509. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  510. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  511. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  512. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  513. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  514. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  515. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  516. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  517. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  518. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  519. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  520. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  521. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  522. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  523. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  524. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  525. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  526. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  527. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  528. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  529. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  530. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  531. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  532. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  533. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  534. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  535. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  536. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  537. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  538. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  539. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  540. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  541. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  542. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  543. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  544. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  545. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  546. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  547. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  548. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  549. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  550. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  551. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  552. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  553. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  554. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  555. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  556. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  557. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  558. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  559. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  560. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  561. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  562. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  563. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  564. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  565. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  566. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  567. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  568. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  569. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  570. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  571. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  572. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  573. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  574. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  575. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  576. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  577. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  578. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  579. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  580. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  581. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  582. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  583. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  584. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  585. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  586. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  587. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  588. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  589. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  590. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  591. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  592. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  593. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  594. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  595. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  596. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  597. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  598. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  599. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  600. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  601. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  602. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  603. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  604. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  605. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  606. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  607. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  608. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  609. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  610. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  611. package/bundled/skills/README.md +1 -0
  612. package/bundled/skills/SKILL_NAMING.md +9 -0
  613. package/bundled/skills/commit-standards/SKILL.md +2 -2
  614. package/bundled/skills/commit-standards/guide.md +3 -2
  615. package/bundled/skills/commit-standards/language-options.md +19 -17
  616. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  617. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  618. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  619. package/bundled/templates/gates/check-stubs.mjs +644 -0
  620. package/package.json +5 -3
  621. package/src/commands/audit.js +20 -2
  622. package/src/commands/check.js +155 -28
  623. package/src/commands/deps.js +31 -1
  624. package/src/commands/hitl.js +3 -0
  625. package/src/commands/init.js +173 -49
  626. package/src/commands/list.js +12 -3
  627. package/src/commands/mcp.js +2 -3
  628. package/src/commands/open-work.js +123 -0
  629. package/src/commands/quickstart.js +29 -13
  630. package/src/commands/release.js +102 -19
  631. package/src/commands/run-intent.js +10 -0
  632. package/src/commands/simulate.js +20 -8
  633. package/src/commands/skills.js +59 -33
  634. package/src/commands/spec-split.js +30 -17
  635. package/src/commands/spec.js +55 -21
  636. package/src/commands/uninstall.js +146 -32
  637. package/src/commands/update.js +471 -93
  638. package/src/core/install-records.js +192 -0
  639. package/src/core/manifest.js +12 -10
  640. package/src/core/marketplace-sentinel.js +5 -0
  641. package/src/core/open-work-config.js +122 -0
  642. package/src/core/project-config.js +92 -38
  643. package/src/flows/init-flow.js +10 -0
  644. package/src/hitl/manager.js +4 -2
  645. package/src/i18n/messages.js +413 -78
  646. package/src/installers/hooks-installer.js +320 -24
  647. package/src/installers/integration-installer.js +5 -1
  648. package/src/installers/skills-installer.js +3 -1
  649. package/src/installers/standards-installer.js +16 -23
  650. package/src/mcp/__tests__/server.test.js +0 -1
  651. package/src/mcp/server.js +16 -4
  652. package/src/prompts/init.js +148 -13
  653. package/src/reconciler/backup-locations.js +80 -0
  654. package/src/reconciler/backup-manager.js +451 -123
  655. package/src/reconciler/index.js +86 -10
  656. package/src/reconciler/install-roots.js +90 -0
  657. package/src/reconciler/plan-executor.js +37 -15
  658. package/src/uninstallers/hook-uninstaller.js +323 -33
  659. package/src/uninstallers/integration-uninstaller.js +35 -5
  660. package/src/uninstallers/skills-uninstaller.js +95 -16
  661. package/src/uninstallers/standards-uninstaller.js +56 -7
  662. package/src/utils/agents-installer.js +10 -17
  663. package/src/utils/available-standards-report.js +144 -0
  664. package/src/utils/available-standards.js +216 -0
  665. package/src/utils/command-hash-ownership.js +103 -0
  666. package/src/utils/commit-message-judge.js +155 -0
  667. package/src/utils/copier.js +80 -2
  668. package/src/utils/deps-applicability.js +25 -0
  669. package/src/utils/detector.js +46 -1
  670. package/src/utils/friction-detector.js +27 -0
  671. package/src/utils/gate-scripts.js +141 -0
  672. package/src/utils/git-hooks.js +139 -7
  673. package/src/utils/hasher.js +36 -0
  674. package/src/utils/health-scorer.js +10 -7
  675. package/src/utils/installed-names-ownership.js +114 -0
  676. package/src/utils/integration-generator.js +36 -24
  677. package/src/utils/legacy-hook-migration.js +112 -0
  678. package/src/utils/locale.js +19 -0
  679. package/src/utils/open-work-tracking.mjs +1754 -0
  680. package/src/utils/prompt-closed.js +18 -0
  681. package/src/utils/sdd-header.js +66 -0
  682. package/src/utils/skill-frontmatter.js +102 -0
  683. package/src/utils/skill-hash-ownership.js +64 -0
  684. package/src/utils/skill-name-collision.js +169 -0
  685. package/src/utils/skills-install-paths.js +114 -0
  686. package/src/utils/skills-installer.js +75 -106
  687. package/src/utils/standard-validator.js +98 -27
  688. package/src/utils/test-change-check.js +160 -0
  689. package/src/utils/test-policy.js +214 -0
  690. package/src/utils/transient-fs.js +113 -0
  691. package/src/utils/update-summary.js +29 -0
  692. package/src/vibe/micro-spec.js +15 -0
  693. package/standards-registry.json +48 -9
@@ -1,7 +1,6 @@
1
1
  import chalk from 'chalk';
2
2
  import { createSpinner } from '../utils/spinner.js';
3
- import { execSync } from 'child_process';
4
- import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
3
+ import { existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync } from 'fs';
5
4
  import { join } from 'path';
6
5
  import {
7
6
  manifestExists as isInitialized,
@@ -15,20 +14,28 @@ import { runInitFlow } from '../flows/init-flow.js';
15
14
  import { installStandards } from '../installers/standards-installer.js';
16
15
  import { installIntegrations, generateUniversalAgentsMd } from '../installers/integration-installer.js';
17
16
  import { installSkills, installCommands } from '../installers/skills-installer.js';
17
+ import { printSkillNameCollisionWarning } from '../utils/skill-name-collision.js';
18
+ import { printDoubleInstallWarning } from '../utils/skills-install-paths.js';
18
19
  import { writeFinalManifest } from '../installers/manifest-installer.js';
19
20
  import {
20
21
  getInstalledSkillsInfo,
21
22
  getProjectInstalledSkillsInfo,
23
+ getMarketplaceSkillsInfo,
22
24
  getAgentConfig,
23
25
  getAgentDisplayName
24
26
  } from '../utils/github.js';
25
- import { displayLanguageToLocale } from '../utils/locale.js';
27
+ import { displayLanguageToLocale, normalizeRequestedLocale } from '../utils/locale.js';
28
+ import localeUtils from '../utils/locale.js';
29
+ const LOCALE_MAP_FOR_INIT = localeUtils.LOCALE_MAP;
26
30
  import { generateReleaseConfig, RELEASE_MODE_LABELS } from '../utils/release-config.js';
27
31
  import { guardAgainstSelfAdoption } from '../utils/detect-self-adoption.js';
28
32
  import { readInstallYaml } from '../utils/config-manager.js';
29
33
  import { resolveIntegrationTargetFile } from '../utils/integration-generator.js';
30
34
  import { withFileTransaction } from '../utils/transaction.js';
31
- import { wireGitHooksPath, getLocalHooksPathConfig, stripLegacyHuskyShLine, ensureShebang } from '../utils/git-hooks.js';
35
+ import { newRecorder, mkdirTracked, recordFile, persistRecorder, RECORD_KINDS } from '../core/install-records.js';
36
+ import { wireGitHooksPath, getLocalHooksPathConfig, stripLegacyHuskyShLine, ensureShebang, hookRunsUdsCheck, buildPreCommitBlock } from '../utils/git-hooks.js';
37
+ import { migrateLegacyHuskyHook } from '../utils/legacy-hook-migration.js';
38
+ import { installGateScripts } from '../utils/gate-scripts.js';
32
39
 
33
40
  /**
34
41
  * Init command - initialize standards in current project
@@ -52,6 +59,8 @@ export async function initCommand(options) {
52
59
  if (isInitialized(projectPath)) {
53
60
  console.log(chalk.yellow(msg.alreadyInitialized));
54
61
  console.log(chalk.gray(` ${msg.useUpdateOrDelete}`));
62
+ // `init` cannot run twice, so `--with-hooks` has no effect here; say where the door is.
63
+ if (options.withHooks) console.log(chalk.yellow(` ${msg.useUpdateWithHooks}`));
55
64
  return;
56
65
  }
57
66
 
@@ -211,7 +220,11 @@ export async function initCommand(options) {
211
220
  skillHashes: skillsResults.skillHashes,
212
221
  commandHashes: skillsResults.commandHashes,
213
222
  integrationBlockHashes: integrationResults.integrationBlockHashes,
214
- manifestIntegrationConfigs: integrationResults.manifestIntegrationConfigs
223
+ manifestIntegrationConfigs: integrationResults.manifestIntegrationConfigs,
224
+ createdIntegrationFiles: [
225
+ ...(integrationResults.createdFiles ?? []),
226
+ ...(agentsMdResult.created ? [agentsMdResult.path] : [])
227
+ ]
215
228
  };
216
229
  },
217
230
  // A half-installed project must never be committed: if any installer
@@ -256,9 +269,13 @@ export async function initCommand(options) {
256
269
  }
257
270
 
258
271
  // 4.6. Install enforcement hooks (if --with-hooks)
272
+ // What this step writes is recorded in the manifest (installedArtifacts) so
273
+ // `uds uninstall` can remove exactly it — hook scripts, and the folders UDS had
274
+ // to create for them — and leave everything the adopter put there alone.
275
+ const installRecorder = newRecorder();
259
276
  if (config.withHooks) {
260
277
  const { installHooks } = await import('../installers/hooks-installer.js');
261
- const hookResult = installHooks(projectPath);
278
+ const hookResult = installHooks(projectPath, { recorder: installRecorder });
262
279
  if (hookResult.installed) {
263
280
  console.log(chalk.green(
264
281
  ` ✓ Enforcement hooks installed (${hookResult.scriptsCount} scripts, `
@@ -281,8 +298,8 @@ export async function initCommand(options) {
281
298
  }
282
299
  }
283
300
 
284
- // turn-completion-integrity is also extended to Codex and Gemini CLI
285
- // (2026-09-25), each with its own config file and output contract — see
301
+ // turn-completion-integrity is also extended to Codex, Gemini CLI and
302
+ // Antigravity CLI (2026-09-25; agy 2026-09-29), each with its own config file and output contract — see
286
303
  // installCodexHooks/installGeminiHooks in hooks-installer.js. Gated on the
287
304
  // tools the adopter actually selected: writing a hooks.json into every
288
305
  // project's .codex/ regardless of whether Codex is used would be noise,
@@ -290,7 +307,7 @@ export async function initCommand(options) {
290
307
  const selectedTools = config.integrations || config.aiTools || [];
291
308
  if (selectedTools.includes('codex')) {
292
309
  const { installCodexHooks } = await import('../installers/hooks-installer.js');
293
- const codexResult = installCodexHooks(projectPath);
310
+ const codexResult = installCodexHooks(projectPath, { recorder: installRecorder });
294
311
  if (codexResult.installed) {
295
312
  console.log(chalk.green(' ✓ Codex Stop hook installed (turn-completion-integrity)'));
296
313
  // Measured 2026-09-28 (codex-cli 0.155.1): Codex skips a project hook
@@ -304,13 +321,72 @@ export async function initCommand(options) {
304
321
  }
305
322
  if (selectedTools.includes('gemini-cli')) {
306
323
  const { installGeminiHooks } = await import('../installers/hooks-installer.js');
307
- const geminiResult = installGeminiHooks(projectPath);
324
+ const geminiResult = installGeminiHooks(projectPath, { recorder: installRecorder });
308
325
  if (geminiResult.installed) {
309
326
  console.log(chalk.green(' ✓ Gemini CLI AfterAgent hook installed (turn-completion-integrity; Gemini CLI is legacy — see the standard)'));
310
327
  } else {
311
328
  console.log(chalk.yellow(` ⚠ Gemini CLI hook not installed — ${geminiResult.reason}`));
312
329
  }
313
330
  }
331
+ if (selectedTools.includes('antigravity')) {
332
+ const { installAgyHooks } = await import('../installers/hooks-installer.js');
333
+ const agyResult = installAgyHooks(projectPath, { recorder: installRecorder });
334
+ if (agyResult.installed) {
335
+ console.log(chalk.green(' ✓ Antigravity CLI Stop hook installed (turn-completion-integrity; .agents/hooks.json)'));
336
+ // Verified 2026-09-29 (agy 1.2.12): single turn, no tool calls, `agy -p`.
337
+ // Multi-turn, tool-call turns and interactive mode are not verified —
338
+ // say so here, where the adopter believes it now works everywhere.
339
+ console.log(chalk.yellow(' ⚠ Verified against a real agy session for a single turn without tool calls in `agy -p` mode only; multi-turn, tool-call turns and interactive mode are not yet verified.'));
340
+ } else {
341
+ console.log(chalk.yellow(` ⚠ Antigravity CLI hook not installed — ${agyResult.reason}`));
342
+ }
343
+ }
344
+ }
345
+
346
+ // 4.7. Record the integration files UDS created from nothing, and the hook
347
+ // files/folders written above. Their text outside the UDS marker block (the
348
+ // `> Auto-generated by ...` header, the generated sections) is what makes
349
+ // "delete the whole file" provable at uninstall time.
350
+ for (const created of combinedResults.createdIntegrationFiles ?? []) {
351
+ recordFile(installRecorder, projectPath, created, RECORD_KINDS.INTEGRATION_FILE);
352
+ }
353
+
354
+ // 4.8. Ship the fake-test and stub scanners the full-coverage-testing standard asks for
355
+ // (XSPEC-444 R5). They are written whether or not git is present — the hook step below
356
+ // needs a repository, the scanners do not — and recorded so `uds uninstall` removes
357
+ // exactly these files. A file that already exists is the adopter's and is left alone.
358
+ const gateResult = installGateScripts(projectPath, installRecorder);
359
+ for (const rel of gateResult.written) {
360
+ console.log(chalk.green(` ✓ ${rel} (fake-test / stub scanner — \`uds check\` runs it and warns; edit it freely)`));
361
+ }
362
+ for (const rel of gateResult.kept) {
363
+ console.log(chalk.gray(` · ${rel} already exists — kept as is`));
364
+ }
365
+ for (const file of gateResult.missingTemplate) {
366
+ console.log(chalk.yellow(` ⚠ scripts/${file} not installed — the template is missing from this UDS package`));
367
+ }
368
+ persistRecorder(projectPath, installRecorder);
369
+
370
+ // 4.9. XSPEC-465 R1: tell the adopter now if a personal skill of theirs has the same name as a UDS skill
371
+ // that was just installed (the personal one wins, with no error). Information only: it does not change
372
+ // what was installed or the exit code.
373
+ if ((combinedResults?.skills?.length ?? 0) > 0) {
374
+ // XSPEC-468 R1: skills now go into the project by default, so a project whose owner already has the UDS
375
+ // plugin would list every skill twice. Same warning `uds check` prints (XSPEC-462 R2); information only,
376
+ // it changes neither what was installed nor the exit code.
377
+ printDoubleInstallWarning(projectPath, getMarketplaceSkillsInfo());
378
+ printSkillNameCollisionWarning(projectPath);
379
+ }
380
+
381
+ // 4.95. XSPEC-468 R1: the adopter asked for the plugin by name, so no skill file was written. Say so at the
382
+ // end, where they look for the skills, and say where they come from and what the other way would do.
383
+ if (config.skillsConfig.location === 'marketplace') {
384
+ console.log();
385
+ console.log(chalk.cyan(msg.skillsFromPluginTitle));
386
+ for (const line of msg.skillsFromPluginLines) {
387
+ console.log(chalk.gray(` ${line}`));
388
+ }
389
+ console.log();
314
390
  }
315
391
 
316
392
  // 5. Setup Pre-commit Hook
@@ -324,7 +400,7 @@ export async function initCommand(options) {
324
400
  * - Node.js projects: use husky
325
401
  * - Non-Node.js projects: write native .git/hooks/pre-commit
326
402
  */
327
- export async function setupHuskyHook(projectPath, { allowInTest = false } = {}) {
403
+ export async function setupHuskyHook(projectPath, { allowInTest = false, platform = process.platform } = {}) {
328
404
  // 2026-07-30:本函式在跑測試時改寫了 universal-dev-standards 自己
329
405
  // ——`npm install --save-dev husky`、改 package.json、建 .husky/pre-commit。
330
406
  //
@@ -344,6 +420,9 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
344
420
 
345
421
  const isNodeProject = existsSync(join(projectPath, 'package.json'));
346
422
 
423
+ // What this function creates, for `uds uninstall` (see core/install-records.js).
424
+ const recorder = newRecorder();
425
+
347
426
  if (isNodeProject) {
348
427
  console.log(chalk.cyan('Configuring Pre-commit Hook...'));
349
428
 
@@ -421,7 +500,7 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
421
500
  // 3. Ensure .husky directory exists
422
501
  if (!existsSync(huskyDir)) {
423
502
  try {
424
- mkdirSync(huskyDir, { recursive: true });
503
+ mkdirTracked(recorder, projectPath, huskyDir);
425
504
  } catch (e) {
426
505
  console.log(chalk.red(` ✗ Failed to create .husky directory: ${e.message}`));
427
506
  return;
@@ -430,8 +509,10 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
430
509
 
431
510
  // 4. Add pre-commit hook content
432
511
  const preCommitPath = join(huskyDir, 'pre-commit');
433
- const udsCmd = 'npx uds check';
434
512
 
513
+ // Only a hook file UDS creates from nothing can later be proven to be wholly
514
+ // its own; one that already existed is appended to and stays the adopter's.
515
+ const preCommitExisted = existsSync(preCommitPath);
435
516
  try {
436
517
  // husky v9's own templates carry no shebang, no `_/husky.sh` sourcing
437
518
  // (that is v8 syntax, deprecated in v9 and removed in v10). Verified
@@ -449,6 +530,18 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
449
530
  // — cheap, harmless on POSIX, and required on Windows. Existing files
450
531
  // are appended to, never rewritten — their contents are the adopter's,
451
532
  // not ours; ensureShebang only ever prepends a missing first line.
533
+ // A hook an older UDS wrote asks npx for the bare name `uds`, which on the
534
+ // npm registry is an unrelated package (see buildPreCommitBlock). Swap the
535
+ // line UDS itself wrote for the current block before anything else reads
536
+ // the file; a line the adopter edited is left alone and reported below.
537
+ const legacy = existsSync(preCommitPath) ? migrateLegacyHuskyHook(projectPath) : null;
538
+ if (legacy?.state === 'migrated') {
539
+ console.log(chalk.green(' ✓ Replaced the pre-commit line an older UDS wrote (it asked npm to resolve the bare name "uds", which is not this project) with one that runs only the installed UDS CLI'));
540
+ }
541
+ for (const k of legacy?.kept ?? []) {
542
+ console.log(chalk.yellow(` ⚠ .husky/pre-commit line ${k.line} ("${k.text}") asks npm to resolve the bare name "uds", which on the npm registry is an unrelated package. UDS did not write this exact line, so it was left alone — change it to "universal-dev-standards check" (with the CLI installed in this project or on PATH).`));
543
+ }
544
+
452
545
  let content = existsSync(preCommitPath) ? readFileSync(preCommitPath, 'utf-8') : '';
453
546
 
454
547
  // A pre-existing file may still carry husky v8's `_/husky.sh` sourcing
@@ -464,10 +557,10 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
464
557
  const { content: destripped, removed: hadLegacyLine } = stripLegacyHuskyShLine(content);
465
558
  content = destripped;
466
559
 
467
- const needsAppend = !content.includes('uds check');
560
+ const needsAppend = !hookRunsUdsCheck(content);
468
561
  if (needsAppend) {
469
562
  const sep = content && !content.endsWith('\n') ? '\n' : '';
470
- content = `${content}${sep}\n# UDS Standard Check\n${udsCmd}\n`;
563
+ content = `${content}${sep}\n${buildPreCommitBlock()}`;
471
564
  }
472
565
 
473
566
  const { content: shebanged, added: addedShebang } = ensureShebang(content);
@@ -475,10 +568,22 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
475
568
 
476
569
  if (hadLegacyLine || needsAppend || addedShebang) {
477
570
  writeFileSync(preCommitPath, content, 'utf-8');
478
- try {
479
- execSync(`chmod +x ${preCommitPath}`);
480
- } catch {
481
- // Ignore chmod failures on systems that don't support it
571
+ if (!preCommitExisted) recordFile(recorder, projectPath, '.husky/pre-commit', RECORD_KINDS.GIT_HOOK);
572
+ // 🔴 Was `execSync(`chmod +x ...`)` inside try/catch. On Windows that
573
+ // spawned cmd.exe, which printed "'chmod' is not recognized as an
574
+ // internal or external command" straight to the user's terminal —
575
+ // execSync inherits the child's stderr by default, so the catch hid the
576
+ // failure from the code and left it loud for the human (adopter report,
577
+ // 6.14.0-beta.2, Windows 11). No shell is needed to change a mode, and
578
+ // Windows has no exec bit to set (git for Windows runs the hook through
579
+ // its own sh regardless), so it is skipped there.
580
+ if (platform !== 'win32') {
581
+ try {
582
+ chmodSync(preCommitPath, 0o755);
583
+ } catch {
584
+ // A filesystem that refuses the mode change (FAT, some mounts) is not
585
+ // a reason to fail the install; git reports a non-executable hook itself.
586
+ }
482
587
  }
483
588
  }
484
589
 
@@ -497,6 +602,8 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
497
602
  console.log(chalk.red(` ✗ Failed to configure pre-commit hook: ${e.message}`));
498
603
  }
499
604
 
605
+ persistRecorder(projectPath, recorder);
606
+
500
607
  // 5. Wire git so the hook ACTUALLY runs — this is the fix. Setting
501
608
  // `core.hooksPath` ourselves is what husky's own bootstrap does internally
502
609
  // (verified against husky ^9.1.7's source: `git config core.hooksPath
@@ -552,7 +659,7 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
552
659
 
553
660
  if (existsSync(hookPath)) {
554
661
  const existingContent = readFileSync(hookPath, 'utf-8');
555
- if (existingContent.includes('uds check')) {
662
+ if (hookRunsUdsCheck(existingContent)) {
556
663
  console.log(chalk.gray(' ✓ Pre-commit hook already configured'));
557
664
  } else {
558
665
  // Never clobber an adopter's own hook (this fix — it used to be
@@ -561,27 +668,42 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
561
668
  console.log(chalk.gray(' UDS will not overwrite it. Add "uds check" to it yourself, or remove it and re-run `uds init`.'));
562
669
  }
563
670
  } else {
671
+ // Fail-closed (XSPEC-444 R1 class sweep). This script used to run the linters
672
+ // as `... 2>/dev/null || true` and `uds check 2>/dev/null || true`, then print
673
+ // "Pre-commit checks passed" — it could not block a commit for any reason.
674
+ // Now: a linter that is installed and fails blocks the commit; one that is not
675
+ // installed is skipped. The UDS check is the same block the husky path writes
676
+ // (buildPreCommitBlock): its exit status stops the commit, and a missing CLI
677
+ // says so and blocks rather than being skipped in silence.
564
678
  const hookContent = `#!/bin/sh
565
679
  # UDS pre-commit hook
566
680
  # Auto-generated by uds init
567
681
 
568
682
  echo "Running UDS pre-commit checks..."
569
683
 
570
- # Run lint if available
684
+ # Lint, when the language's linter is installed. A failing linter blocks the commit.
571
685
  if [ -f pyproject.toml ] || [ -f requirements.txt ]; then
572
- python -m ruff check . 2>/dev/null || true
686
+ if python -m ruff --version >/dev/null 2>&1; then
687
+ python -m ruff check . || exit $?
688
+ fi
573
689
  elif [ -f go.mod ]; then
574
- go vet ./... 2>/dev/null || true
690
+ if command -v go >/dev/null 2>&1; then
691
+ go vet ./... || exit $?
692
+ fi
575
693
  elif [ -f Cargo.toml ]; then
576
- cargo clippy 2>/dev/null || true
694
+ if command -v cargo >/dev/null 2>&1; then
695
+ cargo clippy || exit $?
696
+ fi
577
697
  fi
578
698
 
579
- # UDS Standard Check
580
- uds check 2>/dev/null || true
581
-
699
+ ${buildPreCommitBlock({ hookFile: '.git/hooks/pre-commit' })}
582
700
  echo "Pre-commit checks passed"
583
701
  `;
584
702
  writeFileSync(hookPath, hookContent, { mode: 0o755 });
703
+ // Created from nothing (the branch above is "file does not exist"), so the
704
+ // whole file is UDS's — record its hash for `uds uninstall`.
705
+ recordFile(recorder, projectPath, '.git/hooks/pre-commit', RECORD_KINDS.GIT_HOOK);
706
+ persistRecorder(projectPath, recorder);
585
707
  console.log(chalk.green(' ✓ Installed .git/hooks/pre-commit (native git hook)'));
586
708
  }
587
709
  } catch (e) {
@@ -599,9 +721,16 @@ function buildNonInteractiveConfig(options, detected, projectPath) {
599
721
  // CLI --locale > .uds/install.yaml locale: > UDS_LOCALE env > LANG > 'en'
600
722
  // detectLanguage() handles UDS_LOCALE + LANG fallback internally (P1-CLI-3).
601
723
  const installYaml = readInstallYaml(projectPath);
602
- const displayLanguage = options.locale
724
+ const requestedLanguage = options.locale
603
725
  || installYaml.locale
604
726
  || detectLanguage(null);
727
+ // Case-insensitive, and an unsupported value is said out loud instead of silently becoming English
728
+ // (dev-platform XSPEC-451 follow-up: `--locale zh-CN` used to install English with exit 0).
729
+ const { displayLanguage: normalizedLanguage, supported } = normalizeRequestedLocale(requestedLanguage);
730
+ const displayLanguage = supported ? normalizedLanguage : 'en';
731
+ if (!supported) {
732
+ console.log(chalk.yellow(`⚠ Unsupported locale "${requestedLanguage}" — installing in English. Supported: ${Object.keys(LOCALE_MAP_FOR_INIT).join(', ')}.`));
733
+ }
605
734
 
606
735
  // Determine AI tools
607
736
  const detectedAiTools = Object.keys(detected.aiTools).filter(k => detected.aiTools[k]);
@@ -637,30 +766,21 @@ function buildNonInteractiveConfig(options, detected, projectPath) {
637
766
  return Boolean(config?.supportsSkills && config?.skills);
638
767
  });
639
768
  const hasSkillsCompatibleTool = skillsCapableTools.length > 0;
640
- // Marketplace is Claude Code's. A tool reaches it either by having one
641
- // (`supportsMarketplace`) or by reading Claude's directory (`fallbackSkillsPath`).
642
- // ⚠️ Those fallback claims are NOT all verified — `opencode`'s carries the bare
643
- // comment "Can read Claude skills" and no evidence. It is preserved here rather
644
- // than flipped, because changing behaviour on an unverified field in either
645
- // direction is a guess. Codex's identical claim WAS measured, and falsified, so
646
- // its field is now null (see `ai-agent-paths.js`) and it drops out here by data.
647
- // 🔴 The marketplace is all-or-nothing for a repo: it installs into Claude's
648
- // directory, so it serves a tool only if that tool has a marketplace of its own or
649
- // declares Claude's directory as its fallback. If ANY detected tool is not served
650
- // by it, file installs are used instead — every tool then gets its own path, and
651
- // nobody is left with a successful init and an empty directory.
652
- const reachesMarketplace = t => {
653
- const c = getAgentConfig(t);
654
- return Boolean(c?.supportsMarketplace || c?.fallbackSkillsPath);
655
- };
656
- const onlySkillsCompatibleTools =
657
- hasSkillsCompatibleTool && aiToolsNormalized.every(reachesMarketplace);
769
+ // XSPEC-468 R1: with no --skills-location, skills go INTO THE PROJECT (the main path, XSPEC-462).
770
+ // This used to pick 'marketplace' whenever every detected tool could reach Claude's plugin, which left
771
+ // `uds init --yes` with no `.claude/skills/` at all and told a new user to go and install a plugin: the
772
+ // opposite of the recommendation printed by `uds skills`. The plugin is still there for anyone who asks
773
+ // for it by name (`--skills-location marketplace`), and the plugin's limits are printed, not hidden.
774
+ //
775
+ // Two cases keep their old answer, and they are knowledge, not default:
776
+ // - tools were detected and none of them can take skills -> 'none' (nothing to install, said below);
777
+ // - nothing was detected at all -> 'project' with Claude Code's own project folder (the historical
778
+ // guess; see `noToolDetected` below).
779
+ const noToolDetected = aiToolsNormalized.length === 0;
658
780
 
659
781
  let skillsLocationFlag = options.skillsLocation;
660
782
  if (!skillsLocationFlag) {
661
- skillsLocationFlag = hasSkillsCompatibleTool
662
- ? (onlySkillsCompatibleTools ? 'marketplace' : 'project')
663
- : 'none';
783
+ skillsLocationFlag = (noToolDetected || hasSkillsCompatibleTool) ? 'project' : 'none';
664
784
  }
665
785
 
666
786
  // A detected tool that can take skills and is getting none must SAY SO. The worst
@@ -735,6 +855,10 @@ function buildNonInteractiveConfig(options, detected, projectPath) {
735
855
  // `installSkills()` takes its legacy branch, and every tool's skills land in
736
856
  // `.claude/skills/` — see the block above for what that measured.
737
857
  skillsInstallationsForYes = skillsCapableTools.map(agent => ({ agent, level: location }));
858
+ // Nothing detected: name Claude Code's folder explicitly. Leaving the list empty sent the install down
859
+ // the legacy branch of `installSkills()`, which does not take the locale (so `--locale zh-tw` in a
860
+ // project with no tool marker would have installed English and said nothing).
861
+ if (noToolDetected) skillsInstallationsForYes = [{ agent: 'claude-code', level: location }];
738
862
 
739
863
  // 🔴 Detected tools, none of which can take skills, is NOT the same as "no tools
740
864
  // detected". The first is knowledge — install nothing and say why. The second is
@@ -8,6 +8,14 @@ import {
8
8
  import { readManifest, isInitialized } from '../utils/copier.js';
9
9
  import { t, getLanguage, setLanguage, isLanguageExplicitlySet } from '../i18n/messages.js';
10
10
 
11
+ /**
12
+ * The order the listing shows its categories in. A category the registry holds standards for but that is not named
13
+ * here is still listed (after these, under its own key): the "Total" line counts every standard in the registry, so a
14
+ * category that was left out of the display used to make the total larger than the list (82 of 163 standards were
15
+ * counted and never shown, and `--category core` was refused as unknown).
16
+ */
17
+ const CATEGORY_ORDER = ['skill', 'reference', 'core', 'testing', 'security', 'deployment', 'operations', 'extension', 'integration', 'template'];
18
+
11
19
  /**
12
20
  * List command - displays available standards
13
21
  * @param {Object} options - Command options
@@ -44,7 +52,8 @@ export function listCommand(options) {
44
52
  const categoryInfo = getCategoryInfo(category);
45
53
  if (!categoryInfo) {
46
54
  console.log(chalk.red(`${msg.errorUnknownCategory} '${category}'`));
47
- console.log(chalk.gray(msg.validCategories));
55
+ const valid = CATEGORY_ORDER.filter((c) => getCategoryInfo(c));
56
+ console.log(chalk.gray(`${msg.validCategories} ${valid.join(', ')}`));
48
57
  process.exit(1);
49
58
  }
50
59
  standards = getStandardsByCategory(category);
@@ -65,13 +74,13 @@ export function listCommand(options) {
65
74
  }
66
75
 
67
76
  // Display each category
68
- const categoryOrder = ['skill', 'reference', 'extension', 'integration', 'template'];
77
+ const categoryOrder = [...CATEGORY_ORDER, ...Object.keys(grouped).filter((c) => !CATEGORY_ORDER.includes(c))];
69
78
 
70
79
  for (const cat of categoryOrder) {
71
80
  if (!grouped[cat] || grouped[cat].length === 0) continue;
72
81
 
73
82
  const catInfo = getCategoryInfo(cat);
74
- console.log(chalk.yellow.bold(`${catInfo.name} (${grouped[cat].length})`));
83
+ console.log(chalk.yellow.bold(`${catInfo?.name ?? cat} (${grouped[cat].length})`));
75
84
 
76
85
  for (const std of grouped[cat]) {
77
86
  const name = std.skillName
@@ -16,9 +16,8 @@ export function mcpCommand(program) {
16
16
  mcp
17
17
  .command('serve')
18
18
  .description('Start MCP Design Standards Server (stdio transport)')
19
- .option('--root <path>', 'UDS standards root path', process.cwd())
20
- .action((options) => {
21
- const server = new McpServer({ udsRoot: options.root });
19
+ .action(() => {
20
+ const server = new McpServer();
22
21
  server.start();
23
22
  // Log to stderr only — stdout is reserved for MCP JSON-RPC messages
24
23
  process.stderr.write('UDS MCP Design Standards Server started (stdio)\n');
@@ -0,0 +1,123 @@
1
+ /**
2
+ * `uds open-work` — the open-work-tracking reference checks (OWT-017 … OWT-028)
3
+ * as a command, so an adopter can run them from the npm package.
4
+ *
5
+ * This file holds no rules. The one body of them is
6
+ * `../utils/open-work-tracking.mjs`; this only turns commander's parsed
7
+ * arguments back into the argv that module's `main()` reads, so the command and
8
+ * `node scripts/check-open-work-tracking.mjs` cannot disagree.
9
+ *
10
+ * Exit codes are the module's and are not translated: 0 no violation, 1
11
+ * violation, 2 cannot decide (no structure found, git failed, or the checker's
12
+ * own self-test arms failed). 2 is NOT a pass. `process.exitCode` is set rather
13
+ * than calling `process.exit()`, so commander's post-action hook still runs.
14
+ *
15
+ * It is a reference decision procedure offered as evidence (OWT-015), not a
16
+ * gate, and its coverage is unknown and uncalibrated (OWT-011, OWT-016); the
17
+ * module prints both statements on every run.
18
+ *
19
+ * @module commands/open-work
20
+ */
21
+
22
+ import { main } from '../utils/open-work-tracking.mjs';
23
+ import { readOpenWorkDeclarations, rootArguments, wordArguments, commandArguments, fieldWordArguments } from '../core/open-work-config.js';
24
+
25
+ /** Append `--name value` when the option was given. */
26
+ function withOption(argv, name, value) {
27
+ if (value !== undefined && value !== null) argv.push(name, String(value));
28
+ return argv;
29
+ }
30
+
31
+ function run(argv) {
32
+ process.exitCode = main(argv);
33
+ }
34
+
35
+ /**
36
+ * What uds.project.yaml declares for open-work, or null after saying why the command stops.
37
+ * A file that cannot be read at all is a note and the command goes on without it (a project's
38
+ * unrelated YAML problem must not stop a check that never needed the file); a readable file whose
39
+ * open_work section is wrong stops it, because the check would otherwise run without what the
40
+ * project meant to declare and look cleaner than it is.
41
+ */
42
+ function declarationsOrStop() {
43
+ const declared = readOpenWorkDeclarations(process.cwd()); // wire:declarations
44
+ if (declared.note) console.error(`[owt] NOTE: ${declared.note}`);
45
+ if (declared.error) {
46
+ console.error(`[owt] CANNOT DECIDE: ${declared.error}. Exit 2 is not a pass.`);
47
+ process.exitCode = 2;
48
+ return null;
49
+ }
50
+ return declared;
51
+ }
52
+
53
+ /**
54
+ * uds open-work next-action [files...] [--root DIR] [--id-pattern RE] [--next-action-word WORD ...] [--command-word WORD ...] [--now DATE] [--stale-after DAYS] — OWT-019
55
+ * `--now` and `--stale-after` are what the fourth outcome (an asked-awaiting row, XSPEC-464) needs to show an age and to mark it old.
56
+ */
57
+ export function openWorkNextActionCommand(files = [], options = {}) {
58
+ const declared = declarationsOrStop();
59
+ if (!declared) return;
60
+ const argv = ['next-action'];
61
+ withOption(argv, '--root', options.root);
62
+ withOption(argv, '--id-pattern', options.idPattern);
63
+ withOption(argv, '--now', options.now);
64
+ withOption(argv, '--stale-after', options.staleAfter);
65
+ const wordArgv = wordArguments(options.nextActionWord, declared.nextActionWords); // wire:next-action-words
66
+ const commandArgv = commandArguments(options.commandWord, declared.commandWords); // wire:next-action-command-words
67
+ argv.push(...fieldWordArguments('--asked-at-word', options.askedAtWord, declared.askedAtWords)); // wire:next-action-asked-at-words
68
+ argv.push(...fieldWordArguments('--waiting-for-word', options.waitingForWord, declared.waitingForWords));
69
+ process.exitCode = main([...argv, ...wordArgv, ...commandArgv, ...files]); // wire:next-action
70
+ }
71
+
72
+ /** uds open-work revision (--file PATH --base REV | --before FILE --after FILE) — OWT-018 */
73
+ export function openWorkRevisionCommand(options = {}) {
74
+ const argv = ['revision'];
75
+ withOption(argv, '--file', options.file);
76
+ withOption(argv, '--base', options.base);
77
+ withOption(argv, '--before', options.before);
78
+ withOption(argv, '--after', options.after);
79
+ run(argv);
80
+ }
81
+
82
+ /** uds open-work separation [files...] [--next-action-word WORD ...] — OWT-017 */
83
+ export function openWorkSeparationCommand(files = [], options = {}) {
84
+ const declared = declarationsOrStop();
85
+ if (!declared) return;
86
+ const wordArgv = wordArguments(options.nextActionWord, declared.nextActionWords); // wire:separation-words
87
+ process.exitCode = main(['separation', ...wordArgv, ...files]); // wire:separation
88
+ }
89
+
90
+ /**
91
+ * uds open-work waiting [files...] [--root DIR] [--root NAME=DIR ...] [--id-pattern RE] [--now DATE] [--asked-at-word WORD ...] [--waiting-for-word WORD ...] — OWT-020 to OWT-022, OWT-027/028.
92
+ * Calls the imported `main` itself rather than the shared `run()`: the line that carries this
93
+ * command into the checker is then its own, and cutting it silences exactly this command.
94
+ * `--root` repeats: a plain DIR is what relative paths resolve against (as before), NAME=DIR says where
95
+ * another project lives (and uds.project.yaml's open_work.projects says the same, without typing it).
96
+ */
97
+ export function openWorkWaitingCommand(files = [], options = {}) {
98
+ const declared = declarationsOrStop();
99
+ if (!declared) return;
100
+ const argv = ['waiting'];
101
+ const rootArgv = rootArguments(options.root, declared.projects); // wire:roots
102
+ argv.push(...rootArgv);
103
+ withOption(argv, '--id-pattern', options.idPattern);
104
+ withOption(argv, '--now', options.now);
105
+ const commandArgv = commandArguments(options.commandWord, declared.commandWords); // wire:waiting-command-words
106
+ argv.push(...commandArgv);
107
+ argv.push(...fieldWordArguments('--asked-at-word', options.askedAtWord, declared.askedAtWords)); // wire:waiting-asked-at-words
108
+ argv.push(...fieldWordArguments('--waiting-for-word', options.waitingForWord, declared.waitingForWords)); // wire:waiting-waiting-for-words
109
+ process.exitCode = main([...argv, ...files]); // wire:waiting
110
+ }
111
+
112
+ /** uds open-work observations [files...] [--now DATE] [--stale-after DAYS] — OWT-023/024/025/026 (same reason as above) */
113
+ export function openWorkObservationsCommand(files = [], options = {}) {
114
+ const argv = ['observations'];
115
+ withOption(argv, '--now', options.now);
116
+ withOption(argv, '--stale-after', options.staleAfter);
117
+ process.exitCode = main([...argv, ...files]); // wire:observations
118
+ }
119
+
120
+ /** uds open-work self-test — run the checker's own arms and nothing else */
121
+ export function openWorkSelfTestCommand() {
122
+ run(['--self-test']);
123
+ }
@@ -21,6 +21,7 @@
21
21
 
22
22
  import chalk from 'chalk';
23
23
  import { select } from '@inquirer/prompts';
24
+ import { isPromptClosed } from '../utils/prompt-closed.js';
24
25
 
25
26
  export const WORKFLOWS = [
26
27
  {
@@ -64,6 +65,18 @@ export const WORKFLOWS = [
64
65
  },
65
66
  ];
66
67
 
68
+ /** Print one workflow: its name, what it is for, and its numbered commands. */
69
+ function printWorkflow(workflow) {
70
+ console.log(chalk.bold(`\n${workflow.name}\n`));
71
+ console.log(chalk.gray(`${workflow.description}\n`));
72
+
73
+ for (let i = 0; i < workflow.steps.length; i++) {
74
+ const step = workflow.steps[i];
75
+ console.log(` ${chalk.cyan(`${i + 1}.`)} ${chalk.yellow(step.cmd)}`);
76
+ console.log(` ${chalk.gray(step.desc)}\n`);
77
+ }
78
+ }
79
+
67
80
  /**
68
81
  * Execute the quickstart command
69
82
  */
@@ -77,20 +90,23 @@ export async function quickstartCommand() {
77
90
  description: w.description,
78
91
  }));
79
92
 
80
- const selected = await select({
81
- message: 'Which workflow do you want to follow?',
82
- choices,
83
- });
84
-
85
- const workflow = WORKFLOWS[selected];
86
- console.log(chalk.bold(`\n${workflow.name}\n`));
87
- console.log(chalk.gray(`${workflow.description}\n`));
88
-
89
- for (let i = 0; i < workflow.steps.length; i++) {
90
- const step = workflow.steps[i];
91
- console.log(` ${chalk.cyan(`${i + 1}.`)} ${chalk.yellow(step.cmd)}`);
92
- console.log(` ${chalk.gray(step.desc)}\n`);
93
+ let selected;
94
+ try {
95
+ selected = await select({
96
+ message: 'Which workflow do you want to follow?',
97
+ choices,
98
+ });
99
+ } catch (promptError) {
100
+ if (!isPromptClosed(promptError)) throw promptError;
101
+ // Nothing can answer (not a terminal: an AI assistant, CI, a pipe). The guide's whole job is to show the commands, so show all of them
102
+ // rather than a stack trace and an exit code of 0.
103
+ console.log(chalk.gray('Nothing here can answer the question (not a terminal), so every workflow is shown.'));
104
+ for (const workflow of WORKFLOWS) printWorkflow(workflow);
105
+ console.log(chalk.gray('Tip: Run "uds quickstart" in a terminal to pick one workflow.\n'));
106
+ return;
93
107
  }
94
108
 
109
+ printWorkflow(WORKFLOWS[selected]);
110
+
95
111
  console.log(chalk.gray('Tip: Run each command in order. Use "uds quickstart" anytime to see this guide again.\n'));
96
112
  }