universal-dev-standards 6.14.0-beta.8 → 6.14.0

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 (712) hide show
  1. package/bin/uds.js +12 -1
  2. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  3. package/bundled/ai/standards/commit-message.ai.yaml +12 -2
  4. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  5. package/bundled/core/commit-message-guide.md +22 -19
  6. package/bundled/core/secret-management-standards.md +13 -1
  7. package/bundled/extensions/locales/zh-tw.md +19 -19
  8. package/bundled/hooks/validate-commit-msg.mjs +52 -9
  9. package/bundled/locales/zh-CN/CHANGELOG.md +2312 -1102
  10. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  11. package/bundled/locales/zh-CN/README.md +3 -3
  12. package/bundled/locales/zh-CN/SECURITY.md +3 -3
  13. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  14. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  15. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  16. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  17. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  18. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  19. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  20. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  21. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  22. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  23. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  24. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  25. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  26. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  27. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  28. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  29. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  30. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  31. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  32. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  33. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  34. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  35. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  36. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  37. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  38. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  39. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  40. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  41. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  42. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  43. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  44. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  45. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  46. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  47. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  48. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  49. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  50. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  51. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  52. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  53. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  54. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  55. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  56. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  57. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  58. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  59. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  60. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  61. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  62. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  63. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  64. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  65. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  66. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  67. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  68. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  69. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  70. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  71. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  72. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  73. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  74. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  75. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  78. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  79. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  80. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  81. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  82. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  83. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  84. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  87. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  88. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  89. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  90. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  91. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  92. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  93. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  94. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  95. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  96. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  97. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  98. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  99. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  100. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  101. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  102. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  103. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  104. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  105. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  106. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  107. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  108. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  109. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  110. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  111. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  112. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  113. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  114. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  115. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  116. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  117. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  118. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  119. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  120. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  121. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  122. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  123. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  124. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  125. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  126. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  127. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  128. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  129. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  130. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  133. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  135. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  136. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  137. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  138. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  139. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  140. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  141. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  142. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  143. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  144. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  145. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  146. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  147. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  148. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  149. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  150. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  151. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  152. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  153. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  154. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  155. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  156. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  157. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  158. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  159. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  160. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  161. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  162. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  163. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  164. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  165. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  166. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  167. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  168. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  171. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  172. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  173. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  174. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  175. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  176. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  177. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  178. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  179. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  180. package/bundled/locales/zh-CN/skills/README.md +2 -1
  181. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  182. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  183. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  184. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  185. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  186. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  187. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  188. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  189. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  190. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  191. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  192. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  193. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  194. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  195. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  196. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  197. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  198. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  199. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  200. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  201. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  202. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  203. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  204. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  205. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  206. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  207. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  208. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  209. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  210. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  211. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  212. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  213. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  215. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  216. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  217. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  218. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  219. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  220. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  221. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  222. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  223. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  224. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  225. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  226. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  227. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  228. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  229. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  230. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  231. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  232. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  233. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  234. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  235. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  236. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  237. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  238. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  239. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  240. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  241. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  242. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  244. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  245. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  246. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  247. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  248. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  249. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  250. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  251. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  252. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  253. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  254. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  255. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  256. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  257. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  258. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  259. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  260. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  261. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  262. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  263. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  264. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  265. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  266. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  267. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  268. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  269. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  270. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  271. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  272. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  273. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  274. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  275. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  276. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  277. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  278. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  279. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  280. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  281. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  282. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  283. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  284. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  285. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  286. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  287. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  288. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  289. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  290. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  291. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  292. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  293. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  294. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  295. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  296. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  297. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  298. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  299. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  300. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  301. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  302. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  303. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  304. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  305. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  306. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  307. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  308. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  309. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  310. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  311. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  312. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  313. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  314. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  315. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  316. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  317. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  318. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  319. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  320. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  321. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  322. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  323. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  324. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  325. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  326. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  327. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  328. package/bundled/locales/zh-TW/CHANGELOG.md +2291 -1110
  329. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  330. package/bundled/locales/zh-TW/README.md +3 -3
  331. package/bundled/locales/zh-TW/SECURITY.md +3 -3
  332. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  333. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  334. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  335. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  336. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  337. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  338. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  339. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  340. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  341. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  342. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  343. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  344. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  345. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  346. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  347. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  348. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  349. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  350. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  351. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  352. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  353. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  354. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  355. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  356. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  357. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  358. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  359. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  360. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  361. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  362. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  363. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  364. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  365. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  366. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  367. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  368. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  369. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  370. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  371. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  372. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  373. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  374. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  375. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  376. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  377. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  378. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  379. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  380. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  381. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  382. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  383. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  384. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  385. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  386. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  387. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  388. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  389. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  390. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  391. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  392. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  393. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  394. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  395. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  396. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  397. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  398. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  399. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  400. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  401. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  402. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  403. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  404. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  405. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  406. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  407. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  408. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  409. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  410. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  411. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  412. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  413. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  414. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  415. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  416. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  417. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  418. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  419. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  420. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  421. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  422. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  423. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  424. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  425. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  426. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  427. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  428. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  429. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  430. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  431. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  432. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  433. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  434. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  435. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  436. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  437. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  438. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  439. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  440. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  441. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  442. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  443. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  444. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  445. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  446. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  447. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  448. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  449. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  450. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  451. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  452. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  453. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  454. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  455. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  456. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  457. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  458. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  459. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  460. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  461. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  462. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  464. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  465. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  467. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  468. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  469. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  470. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  471. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  472. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  473. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  474. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  475. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  476. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  477. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  478. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  479. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  480. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  481. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  482. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  483. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  484. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  485. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  486. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  487. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  488. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  489. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  490. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  491. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  492. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  493. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  494. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  495. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  496. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  497. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  498. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  499. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  500. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  501. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  502. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  503. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  504. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  505. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  506. package/bundled/locales/zh-TW/skills/README.md +2 -1
  507. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  508. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  509. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  510. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  511. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  512. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  513. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  514. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  515. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  516. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  517. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  518. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  519. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  520. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  521. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  522. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  523. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  524. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  525. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  526. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  527. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  528. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  529. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  530. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  531. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  532. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  533. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  534. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  535. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  536. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  537. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  538. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  539. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  541. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  542. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  543. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  544. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  545. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  546. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  547. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  548. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  549. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  550. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  551. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  552. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  553. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  555. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  556. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  557. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  558. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  559. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  560. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  561. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  562. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  563. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  565. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  566. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  567. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  568. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  569. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  570. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  571. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  572. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  573. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  574. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  575. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  576. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  577. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  578. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  579. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  580. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  581. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  582. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  583. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  584. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  585. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  586. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  587. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  588. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  589. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  590. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  591. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  592. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  593. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  594. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  595. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  596. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  597. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  598. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  599. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  600. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  601. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  602. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  603. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  604. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  605. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  606. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  607. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  608. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  609. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  610. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  611. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  612. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  613. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  614. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  615. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  616. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  617. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  618. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  619. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  620. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  621. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  622. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  623. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  624. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  625. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  626. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  627. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  628. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  629. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  630. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  631. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  632. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  633. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  634. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  635. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  636. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  637. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  638. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  639. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  640. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  641. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  642. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  643. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  644. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  645. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  646. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  647. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  648. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  649. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  650. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  651. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  652. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  653. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  654. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  655. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  656. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  657. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  658. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  659. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  660. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  661. package/bundled/skills/commit-standards/SKILL.md +2 -2
  662. package/bundled/skills/commit-standards/guide.md +3 -2
  663. package/bundled/skills/commit-standards/language-options.md +19 -17
  664. package/package.json +2 -2
  665. package/src/commands/audit.js +28 -1
  666. package/src/commands/check.js +77 -7
  667. package/src/commands/compile.js +37 -4
  668. package/src/commands/config.js +49 -24
  669. package/src/commands/init.js +78 -30
  670. package/src/commands/open-work.js +6 -2
  671. package/src/commands/release-messages.js +228 -0
  672. package/src/commands/release.js +127 -68
  673. package/src/commands/run-intent.js +11 -0
  674. package/src/commands/spec-split.js +2 -1
  675. package/src/commands/spec.js +11 -2
  676. package/src/commands/update.js +184 -30
  677. package/src/compilers/claude-code-compiler.js +9 -1
  678. package/src/config/ai-agent-paths.js +14 -1
  679. package/src/core/installed-formats.js +15 -0
  680. package/src/core/open-work-config.js +20 -1
  681. package/src/core/project-config.js +55 -0
  682. package/src/i18n/messages.js +160 -2
  683. package/src/installers/hooks-installer.js +1 -1
  684. package/src/installers/manifest-installer.js +1 -1
  685. package/src/installers/skills-installer.js +1 -1
  686. package/src/installers/standards-installer.js +3 -1
  687. package/src/mcp/server.js +9 -3
  688. package/src/prompts/init.js +26 -22
  689. package/src/reconciler/actual-state-scanner.js +2 -8
  690. package/src/reconciler/backup-locations.js +5 -0
  691. package/src/reconciler/backup-manager.js +19 -11
  692. package/src/reconciler/desired-state-calculator.js +89 -57
  693. package/src/reconciler/plan-executor.js +101 -8
  694. package/src/reconciler/recorded-versions.js +49 -0
  695. package/src/reconciler/relative-path.js +23 -0
  696. package/src/uninstallers/hook-uninstaller.js +9 -1
  697. package/src/uninstallers/skills-uninstaller.js +22 -3
  698. package/src/utils/available-standards-report.js +25 -4
  699. package/src/utils/available-standards.js +13 -3
  700. package/src/utils/build-manifest.js +1 -1
  701. package/src/utils/commit-message-judge.js +60 -13
  702. package/src/utils/friction-detector.js +23 -11
  703. package/src/utils/git-hooks.js +106 -4
  704. package/src/utils/integration-generator.js +95 -67
  705. package/src/utils/legacy-hook-migration.js +121 -2
  706. package/src/utils/open-work-tracking.mjs +105 -16
  707. package/src/utils/sdd-header.js +16 -4
  708. package/src/utils/skills-installer.js +2 -1
  709. package/src/utils/spinner.js +14 -4
  710. package/src/utils/standard-validator.js +3 -2
  711. package/standards-registry.json +10 -8
  712. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -9,6 +9,7 @@
9
9
 
10
10
  import { join, basename } from 'path';
11
11
  import { getAllStandards, getStandardSource, findOption, getOptionSource } from '../utils/registry.js';
12
+ import { getInstalledFormats } from '../core/installed-formats.js';
12
13
  import {
13
14
  resolveToolKey,
14
15
  SUPPORTED_AI_TOOLS,
@@ -25,6 +26,7 @@ import {
25
26
  buildAgentsMdSummaryConfig
26
27
  } from '../utils/integration-generator.js';
27
28
  import { PathResolver } from '../core/paths.js';
29
+ import { projectRelative } from './relative-path.js';
28
30
  import { computeFileHash } from '../utils/hasher.js';
29
31
  import { createHash } from 'crypto';
30
32
  import {
@@ -106,7 +108,7 @@ export function calculateDesiredState(projectPath, manifest) {
106
108
  * Calculate expected standard files.
107
109
  */
108
110
  function calculateStandards(state, manifest) {
109
- const format = manifest.format || 'ai';
111
+ const formats = getInstalledFormats(manifest.format); // wire:calculator-standards-formats
110
112
  const allStandards = getAllStandards();
111
113
 
112
114
  for (const standardId of (manifest.standards || [])) {
@@ -131,35 +133,39 @@ function calculateStandards(state, manifest) {
131
133
 
132
134
  if (!registryEntry) continue;
133
135
 
134
- const source = getStandardSource(registryEntry, format);
135
- if (!source) continue;
136
+ // `format: both` installs the human and the AI copy of every standard, so it expects both files. Reading
137
+ // `both` as if it were one format resolved only the human copy and planned to delete every AI copy (XSPEC-483).
138
+ for (const fileFormat of formats) {
139
+ const source = getStandardSource(registryEntry, fileFormat);
140
+ if (!source) continue;
136
141
 
137
- // Target path in .standards/
138
- const fileName = basename(source);
139
- const relativePath = `.standards/${fileName}`;
142
+ // Target path in .standards/
143
+ const fileName = basename(source);
144
+ const relativePath = `.standards/${fileName}`;
140
145
 
141
- // Resolve source to absolute path
142
- const absSource = PathResolver.getStandardSource(source);
146
+ // Resolve source to absolute path
147
+ const absSource = PathResolver.getStandardSource(source);
143
148
 
144
- // Compute hash from source if available
145
- let hash = null;
146
- let size = null;
147
- if (absSource) {
148
- const hashInfo = computeFileHash(absSource);
149
- if (hashInfo) {
150
- hash = hashInfo.hash;
151
- size = hashInfo.size;
149
+ // Compute hash from source if available
150
+ let hash = null;
151
+ let size = null;
152
+ if (absSource) {
153
+ const hashInfo = computeFileHash(absSource);
154
+ if (hashInfo) {
155
+ hash = hashInfo.hash;
156
+ size = hashInfo.size;
157
+ }
152
158
  }
153
- }
154
159
 
155
- state.standards.set(relativePath, {
156
- relativePath,
157
- hash,
158
- size,
159
- category: 'standard',
160
- sourcePath: absSource,
161
- metadata: { standardId, format, registryEntry }
162
- });
160
+ state.standards.set(relativePath, {
161
+ relativePath,
162
+ hash,
163
+ size,
164
+ category: 'standard',
165
+ sourcePath: absSource,
166
+ metadata: { standardId, format: fileFormat, registryEntry }
167
+ });
168
+ }
163
169
  }
164
170
  }
165
171
 
@@ -180,7 +186,7 @@ function calculateStandards(state, manifest) {
180
186
  * not into a `<standardId>/<categoryKey>/` tree.
181
187
  */
182
188
  function calculateOptions(state, manifest) {
183
- const format = manifest.format || 'ai';
189
+ const formats = getInstalledFormats(manifest.format); // wire:calculator-options-formats
184
190
  const allStandards = getAllStandards();
185
191
 
186
192
  if (!manifest.options) return;
@@ -201,30 +207,33 @@ function calculateOptions(state, manifest) {
201
207
  const option = findOption(registryEntry, binding.categoryKey, optionId);
202
208
  if (!option) continue;
203
209
 
204
- const source = getOptionSource(option, format);
205
- if (!source) continue;
206
-
207
- const relativePath = `${OPTIONS_INSTALL_DIR}/${basename(source)}`;
208
- const absSource = PathResolver.getStandardSource(source);
209
-
210
- let hash = null;
211
- let size = null;
212
- if (absSource) {
213
- const hashInfo = computeFileHash(absSource);
214
- if (hashInfo) {
215
- hash = hashInfo.hash;
216
- size = hashInfo.size;
210
+ // As for the standards: `format: both` installs each option in both formats (XSPEC-483).
211
+ for (const fileFormat of formats) {
212
+ const source = getOptionSource(option, fileFormat);
213
+ if (!source) continue;
214
+
215
+ const relativePath = `${OPTIONS_INSTALL_DIR}/${basename(source)}`;
216
+ const absSource = PathResolver.getStandardSource(source);
217
+
218
+ let hash = null;
219
+ let size = null;
220
+ if (absSource) {
221
+ const hashInfo = computeFileHash(absSource);
222
+ if (hashInfo) {
223
+ hash = hashInfo.hash;
224
+ size = hashInfo.size;
225
+ }
217
226
  }
218
- }
219
227
 
220
- state.options.set(relativePath, {
221
- relativePath,
222
- hash,
223
- size,
224
- category: 'option',
225
- sourcePath: absSource,
226
- metadata: { standardId: binding.standardId, categoryKey: binding.categoryKey, optionId, format }
227
- });
228
+ state.options.set(relativePath, {
229
+ relativePath,
230
+ hash,
231
+ size,
232
+ category: 'option',
233
+ sourcePath: absSource,
234
+ metadata: { standardId: binding.standardId, categoryKey: binding.categoryKey, optionId, format: fileFormat }
235
+ });
236
+ }
228
237
  }
229
238
  }
230
239
  }
@@ -357,12 +366,39 @@ function isToolGenuinelySelected(toolName, manifest) {
357
366
  return (manifest.aiTools || []).some((t) => (LEGACY_TOOL_MAPPINGS[t] || t) === toolName);
358
367
  }
359
368
 
369
+ /**
370
+ * Which integrations the manifest says are in use: tool keys or file paths.
371
+ *
372
+ * `manifest.integrations` is the declared list, but it is not the only record. An adopter manifest with
373
+ * `integrations: []`, `aiTools: ['claude-code']` and an `integrationBlockHashes` entry for CLAUDE.md produced
374
+ * an EMPTY desired set, so `uds update --plan` proposed "integration no longer configured, removing UDS block"
375
+ * while `uds check` called the same project compliant (issue #269; an empty array is a different shape from
376
+ * the file-name one XSPEC-343 R1 handled).
377
+ *
378
+ * When the list is empty or absent, fall back to the two other records of the same fact - `aiTools` (the
379
+ * declared configuration; update.js's orphan-hash pruning already treats it as the source of truth) and the
380
+ * files `integrationBlockHashes` says UDS wrote a block into. A non-empty `integrations` is used as written:
381
+ * this is a fallback for a missing declaration, not a second opinion on a present one. A genuinely removed
382
+ * integration has none of the three, so it is still proposed for removal.
383
+ *
384
+ * @param {Object} manifest
385
+ * @returns {string[]} tool keys or file paths, in the shapes `resolveToolKey` accepts
386
+ */
387
+ function integrationEntriesOf(manifest) {
388
+ const declared = manifest.integrations;
389
+ if (Array.isArray(declared) && declared.length > 0) return declared;
390
+ const fromAiTools = (manifest.aiTools || []).map((t) => LEGACY_TOOL_MAPPINGS[t] || t);
391
+ const fromBlockHashes = Object.keys(manifest.integrationBlockHashes || {});
392
+ return [...fromAiTools, ...fromBlockHashes];
393
+ }
394
+
360
395
  /**
361
396
  * Calculate expected integration files.
362
397
  * For integrations we track the UDS marker block, not the entire file.
363
398
  */
364
399
  function calculateIntegrations(state, manifest) {
365
- for (const entry of (manifest.integrations || [])) {
400
+ const seenTools = new Set();
401
+ for (const entry of integrationEntriesOf(manifest)) {
366
402
  // Accept both shapes. `manifest.integrations` is normalised to tool keys by
367
403
  // the v3.5.0 migration, but a repo whose manifest has not been re-read and
368
404
  // rewritten still holds file paths — and treating those as unknown tools
@@ -376,6 +412,9 @@ function calculateIntegrations(state, manifest) {
376
412
  const toolName = resolveToolKey(entry);
377
413
  const toolConfig = toolName ? SUPPORTED_AI_TOOLS[toolName] : null;
378
414
  if (!toolConfig) continue;
415
+ // Two entries can name the same tool (`aiTools: ['claude-code']` plus a recorded `CLAUDE.md` block hash).
416
+ if (seenTools.has(toolName)) continue;
417
+ seenTools.add(toolName);
379
418
 
380
419
  // XSPEC-418 R2/R3: the desired path is the tool's ACTUAL target, not always
381
420
  // its default file — a local-target claude-code install's desired state
@@ -564,12 +603,5 @@ function calculateCommands(state, projectPath, manifest) {
564
603
  * @returns {string}
565
604
  */
566
605
  function getRelativePath(projectPath, absPath) {
567
- if (absPath.startsWith(projectPath)) {
568
- let rel = absPath.slice(projectPath.length);
569
- if (rel.startsWith('/') || rel.startsWith('\\')) {
570
- rel = rel.slice(1);
571
- }
572
- return rel;
573
- }
574
- return absPath;
606
+ return projectRelative(projectPath, absPath); // `/` on every system (XSPEC-486 R4)
575
607
  }
@@ -11,7 +11,9 @@
11
11
  * Each action is executed independently — single failures don't block the rest.
12
12
  */
13
13
 
14
- import { existsSync, unlinkSync, mkdirSync, rmSync, copyFileSync, statSync } from 'fs';
14
+ import { existsSync, unlinkSync, mkdirSync, rmSync, copyFileSync, statSync, readFileSync, writeFileSync } from 'fs';
15
+ import { UDS_MARKERS } from '../core/constants.js';
16
+ import { tryLocateMarkerBlock } from '../utils/marker-locator.js';
15
17
  import { join, dirname } from 'path';
16
18
  import { copyStandard } from '../utils/copier.js';
17
19
  import {
@@ -24,12 +26,13 @@ import {
24
26
  installSkillsToMultipleAgents,
25
27
  installCommandsToMultipleAgents
26
28
  } from '../utils/skills-installer.js';
27
- import { writeManifest } from '../core/manifest.js';
29
+ import { writeManifest, mergeInstalledNames } from '../core/manifest.js';
28
30
  import { getRepositoryInfo } from '../utils/registry.js';
29
31
  import { displayLanguageToLocale } from '../utils/locale.js';
30
32
  import { computeFileHash, pruneIntegrationFileHashes } from '../utils/hasher.js';
31
33
  import { createBackup, cleanupBackups, finalizeBackup } from './backup-manager.js';
32
34
  import { bookkeepingFiles } from './install-roots.js';
35
+ import { alignRecordedVersions } from './recorded-versions.js';
33
36
 
34
37
  /**
35
38
  * @typedef {Object} ExecutionResult
@@ -56,6 +59,7 @@ export async function executePlan(projectPath, plan, manifest, options = {}) {
56
59
  const { backup = true, dryRun = false, onAction } = options;
57
60
  const results = [];
58
61
  let backupId = null;
62
+ let backupCleanup = null;
59
63
  const updatedManifest = { ...manifest };
60
64
 
61
65
  // Ensure hash containers exist
@@ -106,8 +110,8 @@ export async function executePlan(projectPath, plan, manifest, options = {}) {
106
110
  }
107
111
  backupId = backupResult.backupId;
108
112
 
109
- // Clean up old backups
110
- cleanupBackups(projectPath);
113
+ // Clean up old backups. The result is returned so the command can name what was removed (XSPEC-475 R2).
114
+ backupCleanup = cleanupBackups(projectPath);
111
115
  }
112
116
 
113
117
  // Execute actions
@@ -178,6 +182,9 @@ export async function executePlan(projectPath, plan, manifest, options = {}) {
178
182
  // the weekly staleness scout — which reads exactly `upstream.version` — kept
179
183
  // reporting the repo as stale after a fully successful reconcile. (XSPEC-343 R2)
180
184
  if (!dryRun && results.every(r => r.success)) {
185
+ // XSPEC-475 R6: a clean reconcile leaves the skills and commands exactly as this UDS ships them (the plan covers every
186
+ // difference), so the versions recorded for them move with it - also when no file needed rewriting.
187
+ alignRecordedVersions(updatedManifest); // wire:apply-aligns-versions
181
188
  const version = getRepositoryInfo()?.standards?.version;
182
189
  if (version) {
183
190
  updatedManifest.upstream = {
@@ -219,6 +226,7 @@ export async function executePlan(projectPath, plan, manifest, options = {}) {
219
226
  return {
220
227
  success: summary.failed === 0,
221
228
  backupId,
229
+ backupCleanup,
222
230
  results,
223
231
  updatedManifest,
224
232
  summary
@@ -324,6 +332,31 @@ async function executeCreateOrUpdate(projectPath, action, manifest) {
324
332
  return { action, success: false, error: `Unsupported create/update for category: ${action.category}` };
325
333
  }
326
334
 
335
+ /**
336
+ * Remove the UDS marker block from an integration file, keeping everything else.
337
+ * Deletes the file only when the block was all it held. A file with no UDS block is left alone:
338
+ * nothing in it is ours to delete.
339
+ * @param {string} targetPath
340
+ * @returns {{ok: true} | {ok: false, error: string}}
341
+ */
342
+ function removeUdsBlock(targetPath) {
343
+ const content = readFileSync(targetPath, 'utf-8');
344
+ for (const markers of [UDS_MARKERS.markdown, UDS_MARKERS.plaintext]) {
345
+ const found = tryLocateMarkerBlock(content, markers);
346
+ if (!found.ok) {
347
+ return { ok: false, error: `${found.error.message} — left ${targetPath} untouched` };
348
+ }
349
+ if (!found.block) continue;
350
+ let end = found.block.endIdx + markers.end.length;
351
+ if (content[end] === '\n') end += 1;
352
+ const rest = (content.slice(0, found.block.startIdx) + content.slice(end)).replace(/\n{3,}/g, '\n\n');
353
+ if (rest.trim() === '') unlinkSync(targetPath);
354
+ else writeFileSync(targetPath, rest, 'utf-8');
355
+ return { ok: true };
356
+ }
357
+ return { ok: true };
358
+ }
359
+
327
360
  /**
328
361
  * Execute a delete action.
329
362
  */
@@ -338,6 +371,12 @@ function executeDelete(projectPath, action, manifest) {
338
371
  const stat = statSync(targetPath);
339
372
  if (stat.isDirectory()) {
340
373
  rmSync(targetPath, { recursive: true, force: true });
374
+ } else if (action.category === 'integration') {
375
+ // An integration file (CLAUDE.md, AGENTS.md, ...) holds the user's own content around the UDS block.
376
+ // Removing the integration removes the block only; the file goes away only when nothing else is left.
377
+ // Unlinking the whole file deleted text the user wrote (found while fixing issue #269).
378
+ const removed = removeUdsBlock(targetPath);
379
+ if (!removed.ok) return { action, success: false, error: removed.error };
341
380
  } else {
342
381
  unlinkSync(targetPath);
343
382
  }
@@ -416,6 +455,50 @@ function executeMigrateBlock(projectPath, action, manifest) {
416
455
  return { action, success: false, error: result.error };
417
456
  }
418
457
 
458
+ /**
459
+ * After a batch install that succeeded, make the manifest say what the disk now holds: the version of the skills/commands
460
+ * this UDS ships, and the names installed (added to the ones already recorded). XSPEC-475 R6.
461
+ * @param {Object} manifest
462
+ * @param {'skills'|'commands'} kind
463
+ * @param {Object} installResult - from installSkills/CommandsToMultipleAgents
464
+ */
465
+ function recordInstalledSet(manifest, kind, installResult) {
466
+ const shipped = getRepositoryInfo()?.skills?.version;
467
+ manifest[kind] = { ...(manifest[kind] || {}) };
468
+ if (shipped) manifest[kind].version = shipped;
469
+ manifest[kind].names = mergeInstalledNames(manifest[kind].names, installResult);
470
+ }
471
+
472
+ /**
473
+ * The outcome of one skill or command action after its batch ran (XSPEC-482 R10).
474
+ *
475
+ * The batch installer answers once for all of them. The old code copied that one answer onto every action and gave
476
+ * no reason, so a read-only skills folder printed "8 failed" and then eight lines of "Unknown error" with neither a path nor a
477
+ * cause, and a skill that had installed fine was counted as failed too. Here each action is judged on its own: it fails when
478
+ * the installer recorded an error for its name (or for its whole agent), and the error says which path and why.
479
+ *
480
+ * @param {Object} action - plan action (category 'skill' or 'command')
481
+ * @param {Object} installResult - from installSkills/CommandsToMultipleAgents
482
+ * @param {'skill'|'command'} kind
483
+ * @returns {{ action: Object, success: boolean, error?: string }}
484
+ */
485
+ export function judgeBatchAction(action, installResult, kind) {
486
+ const meta = action.details?.metadata;
487
+ const name = kind === 'skill' ? meta?.skillName : meta?.commandName;
488
+ const installs = (installResult.installations || []).filter(i => !meta?.agent || i.agent === meta.agent);
489
+ const reasons = [];
490
+ for (const inst of installs) {
491
+ if (inst.error) reasons.push(inst.error);
492
+ for (const e of inst.errors || []) {
493
+ if (e && e[kind] === name && e.error) reasons.push(e.error);
494
+ }
495
+ }
496
+ if (reasons.length > 0) return { action, success: false, error: `${action.path}: ${reasons[0]}` };
497
+ if (installResult.success) return { action, success: true };
498
+ if (installs.some(i => (i.installed || []).includes(name))) return { action, success: true };
499
+ return { action, success: false, error: `${action.path}: the installer did not install ${kind} "${name}" and gave no reason` };
500
+ }
501
+
419
502
  /**
420
503
  * Batch execute skill installations.
421
504
  */
@@ -475,13 +558,20 @@ async function executeSkillBatch(projectPath, skillActions, manifest) {
475
558
  if (installResult.allFileHashes) {
476
559
  Object.assign(manifest.skillHashes, installResult.allFileHashes);
477
560
  }
561
+ // XSPEC-475 R6: the skill files were just rewritten to what this UDS ships, so the records that describe them
562
+ // are brought to match. They were left at the old version and name list (the 6.11.0 -> 6.14 upgrade rewrote about
563
+ // 200 files and still recorded 6.11.0 and no `comprehension-ladder`), and the second command `--skills` was the
564
+ // only way to make the manifest agree with the disk.
565
+ if (installResult.success) {
566
+ recordInstalledSet(manifest, 'skills', installResult); // wire:apply-records-skills
567
+ }
478
568
 
479
569
  for (const action of toInstall) {
480
- results.push({ action, success: installResult.success });
570
+ results.push(judgeBatchAction(action, installResult, 'skill')); // wire:skill-batch-names-its-failures
481
571
  }
482
572
  } catch (err) {
483
573
  for (const action of toInstall) {
484
- results.push({ action, success: false, error: err.message });
574
+ results.push({ action, success: false, error: `${action.path}: ${err.message}` });
485
575
  }
486
576
  }
487
577
  }
@@ -562,13 +652,16 @@ async function executeCommandBatch(projectPath, commandActions, manifest) {
562
652
  // neither line.
563
653
  Object.assign(manifest.commandHashes, installResult.allFileHashes);
564
654
  }
655
+ if (installResult.success) {
656
+ recordInstalledSet(manifest, 'commands', installResult); // wire:apply-records-commands (XSPEC-475 R6)
657
+ }
565
658
 
566
659
  for (const action of toInstall) {
567
- results.push({ action, success: installResult.success });
660
+ results.push(judgeBatchAction(action, installResult, 'command'));
568
661
  }
569
662
  } catch (err) {
570
663
  for (const action of toInstall) {
571
- results.push({ action, success: false, error: err.message });
664
+ results.push({ action, success: false, error: `${action.path}: ${err.message}` });
572
665
  }
573
666
  }
574
667
  }
@@ -0,0 +1,49 @@
1
+ /**
2
+ * The version the manifest records for the skills and the commands (XSPEC-475 R6).
3
+ *
4
+ * When a reconcile leaves nothing to do (or does everything cleanly), the skill and command files are exactly what this UDS
5
+ * ships, so the version recorded for them is the shipped one. It was left at the version of the UDS that installed them, and
6
+ * `uds check` went on saying "Commands: v6.11.0 -> v6.14..." for a project that was in fact current.
7
+ *
8
+ * @module reconciler/recorded-versions
9
+ */
10
+
11
+ import { getRepositoryInfo } from '../utils/registry.js';
12
+
13
+ /**
14
+ * Set `skills.version` and `commands.version` to the shipped version for each that is installed (not a marketplace install).
15
+ * Mutates and returns `manifest`; `changed` says whether anything differed.
16
+ * @param {Object} manifest
17
+ * @returns {{ manifest: Object, changed: boolean }}
18
+ */
19
+ export function alignRecordedVersions(manifest) {
20
+ const shipped = getRepositoryInfo()?.skills?.version;
21
+ let changed = false;
22
+ if (!shipped) return { manifest, changed };
23
+ for (const kind of ['skills', 'commands']) {
24
+ const record = manifest[kind];
25
+ if (record?.installed === true && record.location !== 'marketplace' && record.version !== shipped) {
26
+ manifest[kind] = { ...record, version: shipped }; // [mutation-anchor:align-version]
27
+ changed = true;
28
+ }
29
+ }
30
+ return { manifest, changed };
31
+ }
32
+
33
+ /**
34
+ * Set `upstream.version` (and the date it was recorded) to the standards version this UDS ships (XSPEC-482 R6).
35
+ *
36
+ * The same reasoning as for skills and commands above: when a reconcile finds nothing to do, every standard file is exactly
37
+ * what this UDS ships, so the version recorded for the standards is the shipped one. Only a reconcile that EXECUTED a plan
38
+ * recorded it, so a project whose files were already current kept the version of the UDS that installed them; it surfaced
39
+ * once `uds init` left a project with nothing for the first `--apply` to do (the XSPEC-382 R5 end-to-end test seeds an old
40
+ * version and expects `--apply` to move it).
41
+ * @param {Object} manifest
42
+ * @returns {{ manifest: Object, changed: boolean }}
43
+ */
44
+ export function alignUpstreamVersion(manifest) {
45
+ const shipped = getRepositoryInfo()?.standards?.version;
46
+ if (!shipped || !manifest?.upstream || manifest.upstream.version === shipped) return { manifest, changed: false };
47
+ manifest.upstream = { ...manifest.upstream, version: shipped, installed: new Date().toISOString().split('T')[0] };
48
+ return { manifest, changed: true };
49
+ }
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Project-relative paths as the user sees them (XSPEC-486 R4).
3
+ *
4
+ * The reconciler names every file it plans, writes or fails on by a path relative to the project. The standards rows
5
+ * were already written with `/`; the skill and command rows came from `path.join`, so on Windows they read
6
+ * `.claude\skills\x` next to `.standards/y` in the same plan and error list. One rule for all of them: `/`.
7
+ */
8
+
9
+ import path from 'path';
10
+
11
+ /**
12
+ * @param {string} projectPath - Project root
13
+ * @param {string} absPath - A path under the project (a path outside it is returned as it is: it is not "relative")
14
+ * @param {{ sep: string }} [pathModule] - The path flavour that built `absPath` (a test passes `path.win32`)
15
+ * @returns {string} The path relative to the project, with `/` between the parts
16
+ */
17
+ export function projectRelative(projectPath, absPath, pathModule = path) {
18
+ if (!absPath.startsWith(projectPath)) return absPath;
19
+ let rel = absPath.slice(projectPath.length);
20
+ if (rel.startsWith('/') || rel.startsWith('\\')) rel = rel.slice(1);
21
+ // Only where `\` is the separator: on POSIX a backslash is a legal character of a file name.
22
+ return pathModule.sep === '\\' ? rel.split('\\').join('/') : rel;
23
+ }
@@ -1,7 +1,7 @@
1
1
  import { existsSync, readFileSync, writeFileSync, unlinkSync, readdirSync, rmdirSync } from 'fs';
2
2
  import { join, basename } from 'path';
3
3
  import { proveUnchanged, RECORD_KINDS, RECORDS_KEY, isRealDirectory } from '../core/install-records.js';
4
- import { stripUdsHookBlock } from '../utils/git-hooks.js';
4
+ import { stripUdsHookBlock, classifyNativePreCommitHook } from '../utils/git-hooks.js';
5
5
  import {
6
6
  collectHookConfigs, standardsSourceDir, hooksSourceDir,
7
7
  CODEX_HOOK_SCRIPT, GEMINI_HOOK_SCRIPT, AGY_HOOK_SCRIPT,
@@ -427,6 +427,14 @@ export function uninstallHook(projectPath, options = {}) {
427
427
  if (!dryRun) unlinkSync(nativeHookPath);
428
428
  result.removed.push(`.git/hooks/pre-commit (UDS native hook, file removed — ${proof.why})`);
429
429
  result.deletedPaths.push('.git/hooks/pre-commit');
430
+ } else if (classifyNativePreCommitHook(content)) { // wire:uninstall-removes-known-native-hook
431
+ // XSPEC-482 R8: no install record (an older UDS wrote it, and old versions recorded nothing), but the file
432
+ // is byte for byte a hook UDS has written - the always-pass hook of 5.x to 6.13.1, or one of the later ones.
433
+ // Exact text is the proof; deleting only the matching lines used to leave a script behind that still
434
+ // printed "Pre-commit checks passed" and checked nothing.
435
+ if (!dryRun) unlinkSync(nativeHookPath);
436
+ result.removed.push('.git/hooks/pre-commit (UDS native hook, file removed - its text is exactly what UDS writes, so nothing of yours is in it)');
437
+ result.deletedPaths.push('.git/hooks/pre-commit');
430
438
  } else if (!NATIVE_UDS_LINE.test(content) && !stripUdsHookBlock(content).removed) {
431
439
  result.skipped.push('.git/hooks/pre-commit (no UDS lines found)');
432
440
  } else {
@@ -1,5 +1,5 @@
1
1
  import { existsSync, rmSync, rmdirSync, readdirSync, unlinkSync } from 'fs';
2
- import { dirname, join } from 'path';
2
+ import { dirname, join, relative, isAbsolute, resolve } from 'path';
3
3
  import {
4
4
  getSkillsDirForAgent,
5
5
  getCommandsDirForAgent
@@ -76,6 +76,14 @@ function removeIfEmpty(dir) {
76
76
  }
77
77
  }
78
78
 
79
+ /** Remove the folder that held `dir` when it is empty and strictly inside `projectPath`. */
80
+ function removeEmptyParentInside(dir, projectPath) {
81
+ const parent = dirname(dir);
82
+ const rel = relative(projectPath, parent);
83
+ if (rel === '' || rel.startsWith('..') || isAbsolute(rel)) return;
84
+ removeIfEmpty(parent);
85
+ }
86
+
79
87
  /**
80
88
  * Process a single skill/command installation for removal
81
89
  */
@@ -140,10 +148,21 @@ function processInstallation(install, type, projectPath, manifest, options, resu
140
148
  if (existsSync(marker)) rmSync(marker, { force: true });
141
149
  }
142
150
  // Folders UDS emptied, deepest first, then the installation folder itself.
151
+ // The installation folder is compared as a resolved path: `dir` carries the trailing slash the path table
152
+ // gives it (`.gemini/commands/`) and `dirname(file)` does not, so the old `d !== dir` was true for the
153
+ // installation folder itself. It was removed in this loop, `removeIfEmpty(dir)` below then found nothing to
154
+ // remove and answered "not gone": the line said "folder kept" for a folder that was deleted, and the tool's
155
+ // own parent (`.gemini/`, `.opencode/`) was never looked at, so an empty one stayed (XSPEC-482 R8).
156
+ const installDir = resolve(dir);
143
157
  for (const d of [...touched].sort((a, b) => b.length - a.length)) {
144
- if (d !== dir) removeIfEmpty(d);
158
+ if (resolve(d) !== installDir) removeIfEmpty(d);
145
159
  }
146
- const gone = removeIfEmpty(dir);
160
+ removeIfEmpty(dir);
161
+ const gone = !existsSync(dir); // wire:uninstall-folder-removed-is-reported
162
+ // XSPEC-475 R5(d): the tool's own folder (`.claude/`, `.codex/` ...) that held only what UDS wrote is empty now; an
163
+ // empty `.claude/` left in the project is a trace of UDS. Only an EMPTY folder inside the project, never the project
164
+ // root, and never a user-level folder.
165
+ if (gone && !isUserLevel) removeEmptyParentInside(dir, projectPath);
147
166
  result.removed.push(`${label} → ${dir} (${toRemove.length} file(s) UDS wrote${gone ? '' : '; folder kept: it still holds files that are not UDS\'s'})`);
148
167
  if (changed.length > 0) result.skipped.push(`${label} — kept ${changed.length} file(s) changed since UDS wrote them`);
149
168
  } catch (error) {
@@ -35,7 +35,7 @@ function breakdown(byCategory) {
35
35
  */
36
36
  export function printAvailableStandardsSection(manifest, { phase }) {
37
37
  const msg = t().availableStandards;
38
- const { offered, notOffered, notOfferedByCategory } = getAvailableStandards(manifest);
38
+ const { offered, notOffered, recommended } = getAvailableStandards(manifest);
39
39
 
40
40
  console.log();
41
41
  if (offered.length === 0) {
@@ -57,20 +57,41 @@ export function printAvailableStandardsSection(manifest, { phase }) {
57
57
  console.log(chalk.gray(` ${msg.installHint}`));
58
58
  }
59
59
 
60
- if (notOffered.length > 0) {
61
- console.log(chalk.gray(fill(msg.othersLine, { count: notOffered.length, breakdown: breakdown(notOfferedByCategory) })));
60
+ // XSPEC-475 R9: the recommended core standards, one by one, each with the command that installs it.
61
+ if (recommended.length > 0) {
62
+ if (phase === 'apply') {
63
+ console.log(chalk.cyan(fill(msg.recommendedApply, { count: recommended.length, ids: recommended.map((s) => s.id).join(', ') })));
64
+ } else {
65
+ console.log(chalk.cyan(fill(msg.recommendedTitle, { count: recommended.length })));
66
+ for (const std of recommended) {
67
+ console.log(` ${chalk.green(std.id)} ${chalk.gray(`— ${std.description}`)}`);
68
+ console.log(chalk.gray(` uds update --apply --add-standard ${std.id}`)); // [mutation-anchor:recommended-install-command]
69
+ }
70
+ }
71
+ }
72
+
73
+ // "Not listed above" counts what is NOT listed: the recommended ones were listed one by one, so they are taken out of the
74
+ // count and of the breakdown (XSPEC-475 R9; it said 95 when 2 of the 95 were on the lines above).
75
+ const unlisted = notOffered.filter((n) => !recommended.some((r) => r.id === n.id)); // [mutation-anchor:unlisted-count]
76
+ if (unlisted.length > 0) {
77
+ const byCategory = {};
78
+ for (const n of unlisted) byCategory[n.category] = (byCategory[n.category] || 0) + 1;
79
+ console.log(chalk.gray(fill(msg.othersLine, { count: unlisted.length, breakdown: breakdown(byCategory) })));
62
80
  }
63
81
  }
64
82
 
65
83
  /** `uds check`: one line, never part of the verdict. */
66
84
  export function printAvailableStandardsCheckLine(manifest) {
67
85
  const msg = t().availableStandards;
68
- const { offered } = getAvailableStandards(manifest);
86
+ const { offered, recommended } = getAvailableStandards(manifest);
69
87
  if (offered.length === 0) {
70
88
  console.log(chalk.gray(msg.checkNone));
71
89
  } else {
72
90
  console.log(chalk.cyan(fill(msg.checkLine, { count: offered.length })));
73
91
  }
92
+ if (recommended.length > 0) {
93
+ console.log(chalk.cyan(fill(msg.checkRecommended, { count: recommended.length, ids: recommended.map((s) => s.id).join(', ') })));
94
+ }
74
95
  }
75
96
 
76
97
  /**
@@ -23,6 +23,14 @@
23
23
  * "new upstream" — they were never in the offer. Why, per category, is in CATEGORY_NOTES.
24
24
  * They are still returned (with a reason) so no command can silently pretend they do not exist.
25
25
  *
26
+ * Recommended core standards (XSPEC-475 R9)
27
+ * -----------------------------------------
28
+ * 59 core standards are not installed by `uds init`, and listing all of them one by one in every `--plan` would bury the
29
+ * few an adopter asked about. A registry entry marked `"recommended": true` (today `turn-completion-integrity` and
30
+ * `pipeline-security-gates`, the two adopters named) is returned in `recommended` and listed one by one with its install
31
+ * command; the rest stay a count. `recommended` is information only: it is NOT in `offered`, so the old `uds update --yes`
32
+ * path, which installs whatever `offered` holds, does not install them (XSPEC-458: listing and installing stay apart).
33
+ *
26
34
  * Manifest fields that look like they should matter, and do not (measured 2026-10-07):
27
35
  * - `level` — a manifest written by 6.11.0 carries it only as a leftover snapshot inside
28
36
  * `integrationConfigs[<file>].level`; no code reads it to decide what to install, the generator
@@ -122,7 +130,8 @@ export function oneLineDescription(description, max = 100) {
122
130
  * @returns {{
123
131
  * offered: AvailableStandard[],
124
132
  * notOffered: Array<AvailableStandard & {reason: string, addable: boolean}>,
125
- * notOfferedByCategory: Object<string, number>
133
+ * notOfferedByCategory: Object<string, number>,
134
+ * recommended: AvailableStandard[]
126
135
  * }}
127
136
  */
128
137
  export function getAvailableStandards(manifest) {
@@ -138,7 +147,7 @@ export function getAvailableStandards(manifest) {
138
147
  const name = basename(source);
139
148
  if (installed.has(name)) continue;
140
149
 
141
- const item = { id: std.id, category: std.category, description: oneLineDescription(std.description), source, name };
150
+ const item = { id: std.id, category: std.category, description: oneLineDescription(std.description), source, name, recommended: std.recommended === true };
142
151
  if (OFFERED_CATEGORIES.includes(std.category)) {
143
152
  offered.push(item);
144
153
  } else {
@@ -152,7 +161,8 @@ export function getAvailableStandards(manifest) {
152
161
 
153
162
  const notOfferedByCategory = {};
154
163
  for (const n of notOffered) notOfferedByCategory[n.category] = (notOfferedByCategory[n.category] || 0) + 1;
155
- return { offered, notOffered, notOfferedByCategory };
164
+ const recommended = notOffered.filter((n) => n.addable && n.recommended); // [mutation-anchor:recommended-core]
165
+ return { offered, notOffered, notOfferedByCategory, recommended };
156
166
  }
157
167
 
158
168
  /** Plain edit distance, enough for "did you mean". */