universal-dev-standards 6.14.0-beta.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 (688) 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 +196 -11
  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/core/ai-response-navigation.md +128 -12
  15. package/bundled/core/code-review-checklist.md +20 -2
  16. package/bundled/core/commit-message-guide.md +22 -19
  17. package/bundled/core/developer-memory.md +12 -2
  18. package/bundled/core/full-coverage-testing.md +99 -5
  19. package/bundled/core/open-work-tracking.md +157 -17
  20. package/bundled/core/pipeline-security-gates.md +63 -0
  21. package/bundled/core/project-context-memory.md +10 -2
  22. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  23. package/bundled/extensions/languages/csharp-style.md +464 -0
  24. package/bundled/extensions/languages/php-style.md +700 -0
  25. package/bundled/extensions/locales/zh-cn.md +717 -0
  26. package/bundled/extensions/locales/zh-tw.md +717 -0
  27. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  28. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  29. package/bundled/locales/COVERAGE.md +5 -4
  30. package/bundled/locales/zh-CN/CHANGELOG.md +199 -3
  31. package/bundled/locales/zh-CN/README.md +3 -3
  32. package/bundled/locales/zh-CN/SECURITY.md +3 -2
  33. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  34. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  35. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  36. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  37. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  38. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  39. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  40. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  41. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  42. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  43. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  44. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  45. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  46. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  47. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  48. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  49. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  50. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  51. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  52. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  53. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  54. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  55. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  56. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  57. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  58. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  59. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  60. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  61. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  62. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  63. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  64. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  65. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  66. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  67. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  68. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  69. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  70. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  71. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  72. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  73. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  74. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  75. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  78. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  79. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  80. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  81. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  82. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  83. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  84. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  85. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  86. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  87. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  88. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  89. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  90. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  91. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  92. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  93. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  94. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  95. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  96. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  97. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  98. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  99. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  100. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  101. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +9 -3
  102. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  103. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +68 -33
  104. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +29 -15
  105. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  106. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  107. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  108. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  109. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  110. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  111. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  112. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  113. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  114. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  115. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  116. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  117. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  118. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  119. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  120. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  121. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  122. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  123. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  124. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  125. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  126. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  128. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  129. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  130. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  131. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  132. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  133. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  134. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  135. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  136. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  137. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  138. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  139. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  140. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  141. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  142. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  143. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  144. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  145. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  146. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  147. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  148. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  149. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  150. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  151. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  152. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  153. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  154. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  155. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  156. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  158. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  159. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  160. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  161. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  162. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  163. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  165. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  167. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  168. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  169. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  170. package/bundled/locales/zh-CN/skills/README.md +3 -1
  171. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  172. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  173. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  174. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  175. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  176. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  177. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  178. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  179. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  180. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  181. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  182. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  183. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  184. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  185. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  186. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  187. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  188. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  190. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  191. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  192. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  193. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  194. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  195. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  196. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  197. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  198. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  199. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  200. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  201. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  202. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  203. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  204. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  205. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  206. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  207. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  208. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  209. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  210. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  211. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  212. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  213. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  214. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  215. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  216. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  217. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  219. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  220. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  221. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  222. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  223. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  224. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  225. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  226. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  227. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  229. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  230. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  231. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  232. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  233. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  234. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  235. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  236. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  237. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  238. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  239. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  240. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  241. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  242. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  243. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  244. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  245. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  246. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  247. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  248. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  249. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  250. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  251. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  252. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  253. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  254. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  255. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  256. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  257. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  258. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  259. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  260. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  261. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  262. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  263. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  264. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  265. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  266. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  267. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  268. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  269. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  270. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  271. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  272. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  273. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  274. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  275. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  276. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  277. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  278. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  279. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  280. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  281. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  282. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  283. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  284. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  285. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  286. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  287. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  288. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  289. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  290. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  291. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  292. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  293. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  294. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  295. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  296. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  297. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  298. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  300. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  301. package/bundled/locales/zh-TW/CHANGELOG.md +199 -3
  302. package/bundled/locales/zh-TW/README.md +3 -3
  303. package/bundled/locales/zh-TW/SECURITY.md +3 -2
  304. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  305. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  306. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  307. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  308. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  309. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  310. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  311. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  312. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  313. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  314. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  315. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  316. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  317. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  318. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  319. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  320. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  321. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  322. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  323. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  324. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  325. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  326. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  327. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  328. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  329. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  330. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  331. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  332. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  333. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  334. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  335. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  336. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  337. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  338. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  339. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  340. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  341. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  342. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  343. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  344. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  345. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  346. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  347. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  348. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  349. package/bundled/locales/zh-TW/core/open-work-tracking.md +92 -16
  350. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  351. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  352. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  353. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  354. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  355. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  356. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  357. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  358. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  359. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  360. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  361. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  362. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  363. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  364. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  365. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  366. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  367. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  368. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  369. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  370. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  371. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  372. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  373. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  374. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  375. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  376. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  377. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  378. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  379. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  380. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  381. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  382. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  383. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  384. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  385. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +9 -3
  386. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  387. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +61 -26
  388. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  389. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +29 -15
  390. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  391. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  392. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  393. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  394. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  395. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  396. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  397. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  398. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  399. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  400. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  401. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  402. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  403. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  404. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  405. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  406. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  407. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  408. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  409. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  410. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  412. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  413. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  414. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  415. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  417. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  418. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  419. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  420. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  421. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  422. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  423. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  424. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  425. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  426. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  427. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  428. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  429. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  430. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  431. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  432. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  433. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  434. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  435. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  436. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  437. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  438. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  439. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  440. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  441. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  442. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  443. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  445. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  446. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  447. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  448. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  449. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  452. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  453. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  454. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  455. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  456. package/bundled/locales/zh-TW/skills/README.md +3 -1
  457. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  458. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  459. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  460. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  461. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  462. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  463. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  464. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  465. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  466. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  467. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  468. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  469. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  470. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  471. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  472. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  473. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  474. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  475. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  476. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  477. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  478. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  479. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  480. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  481. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  482. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  483. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  484. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  485. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  486. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  487. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  488. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  489. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  490. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  491. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  492. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  493. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  494. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  495. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  496. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  497. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  498. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  499. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  500. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  501. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  502. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  503. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  504. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  505. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  506. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  507. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  508. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  509. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  510. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  511. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  512. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  513. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  514. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  515. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  516. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  517. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  518. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  519. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  520. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  521. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  522. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  523. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  524. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  525. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  526. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  527. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  528. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  529. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  530. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  531. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  532. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  533. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  534. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  535. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  536. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  537. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  538. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  539. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  541. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  542. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  543. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  544. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  545. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  546. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  547. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  548. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  549. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  550. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  551. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  552. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  553. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  554. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  555. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  556. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  557. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  558. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  559. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  560. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  561. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  562. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  563. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  564. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  565. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  566. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  567. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  568. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  569. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  570. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  571. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  572. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  573. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  574. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  575. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  576. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  577. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  578. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  579. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  580. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  581. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  582. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  583. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  584. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  585. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  586. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  587. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  588. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  589. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  590. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  591. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  592. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  593. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  594. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  595. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  596. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  597. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  598. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  599. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  600. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  601. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  602. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  603. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  604. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  605. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  606. package/bundled/skills/README.md +1 -0
  607. package/bundled/skills/SKILL_NAMING.md +9 -0
  608. package/bundled/skills/commit-standards/SKILL.md +2 -2
  609. package/bundled/skills/commit-standards/guide.md +3 -2
  610. package/bundled/skills/commit-standards/language-options.md +19 -17
  611. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  612. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  613. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  614. package/bundled/templates/gates/check-stubs.mjs +644 -0
  615. package/package.json +5 -3
  616. package/src/commands/audit.js +20 -2
  617. package/src/commands/check.js +155 -28
  618. package/src/commands/deps.js +31 -1
  619. package/src/commands/hitl.js +3 -0
  620. package/src/commands/init.js +159 -48
  621. package/src/commands/list.js +12 -3
  622. package/src/commands/mcp.js +2 -3
  623. package/src/commands/open-work.js +123 -0
  624. package/src/commands/quickstart.js +29 -13
  625. package/src/commands/release.js +102 -19
  626. package/src/commands/run-intent.js +10 -0
  627. package/src/commands/simulate.js +20 -8
  628. package/src/commands/skills.js +59 -33
  629. package/src/commands/spec-split.js +30 -17
  630. package/src/commands/spec.js +55 -21
  631. package/src/commands/uninstall.js +146 -32
  632. package/src/commands/update.js +471 -93
  633. package/src/core/install-records.js +192 -0
  634. package/src/core/manifest.js +12 -10
  635. package/src/core/marketplace-sentinel.js +5 -0
  636. package/src/core/open-work-config.js +122 -0
  637. package/src/core/project-config.js +92 -38
  638. package/src/flows/init-flow.js +10 -0
  639. package/src/hitl/manager.js +4 -2
  640. package/src/i18n/messages.js +413 -78
  641. package/src/installers/hooks-installer.js +236 -27
  642. package/src/installers/integration-installer.js +5 -1
  643. package/src/installers/skills-installer.js +3 -1
  644. package/src/installers/standards-installer.js +16 -23
  645. package/src/mcp/__tests__/server.test.js +0 -1
  646. package/src/mcp/server.js +16 -4
  647. package/src/prompts/init.js +148 -13
  648. package/src/reconciler/backup-locations.js +80 -0
  649. package/src/reconciler/backup-manager.js +451 -123
  650. package/src/reconciler/index.js +86 -10
  651. package/src/reconciler/install-roots.js +90 -0
  652. package/src/reconciler/plan-executor.js +37 -15
  653. package/src/uninstallers/hook-uninstaller.js +220 -33
  654. package/src/uninstallers/integration-uninstaller.js +35 -5
  655. package/src/uninstallers/skills-uninstaller.js +95 -16
  656. package/src/uninstallers/standards-uninstaller.js +56 -7
  657. package/src/utils/agents-installer.js +10 -17
  658. package/src/utils/available-standards-report.js +144 -0
  659. package/src/utils/available-standards.js +216 -0
  660. package/src/utils/command-hash-ownership.js +103 -0
  661. package/src/utils/commit-message-judge.js +155 -0
  662. package/src/utils/copier.js +80 -2
  663. package/src/utils/deps-applicability.js +25 -0
  664. package/src/utils/detector.js +46 -1
  665. package/src/utils/friction-detector.js +27 -0
  666. package/src/utils/gate-scripts.js +141 -0
  667. package/src/utils/git-hooks.js +139 -7
  668. package/src/utils/hasher.js +36 -0
  669. package/src/utils/health-scorer.js +10 -7
  670. package/src/utils/installed-names-ownership.js +114 -0
  671. package/src/utils/integration-generator.js +36 -24
  672. package/src/utils/legacy-hook-migration.js +112 -0
  673. package/src/utils/locale.js +19 -0
  674. package/src/utils/open-work-tracking.mjs +1754 -0
  675. package/src/utils/prompt-closed.js +18 -0
  676. package/src/utils/sdd-header.js +66 -0
  677. package/src/utils/skill-frontmatter.js +102 -0
  678. package/src/utils/skill-hash-ownership.js +64 -0
  679. package/src/utils/skill-name-collision.js +169 -0
  680. package/src/utils/skills-install-paths.js +114 -0
  681. package/src/utils/skills-installer.js +75 -106
  682. package/src/utils/standard-validator.js +98 -27
  683. package/src/utils/test-change-check.js +160 -0
  684. package/src/utils/test-policy.js +214 -0
  685. package/src/utils/transient-fs.js +113 -0
  686. package/src/utils/update-summary.js +29 -0
  687. package/src/vibe/micro-spec.js +15 -0
  688. package/standards-registry.json +48 -9
@@ -1,5 +1,7 @@
1
- import { existsSync, readFileSync, writeFileSync, unlinkSync } from 'fs';
1
+ import { existsSync, readFileSync, writeFileSync, unlinkSync, readdirSync, rmdirSync } from 'fs';
2
2
  import { join, basename } from 'path';
3
+ import { proveUnchanged, RECORD_KINDS, RECORDS_KEY, isRealDirectory } from '../core/install-records.js';
4
+ import { stripUdsHookBlock } from '../utils/git-hooks.js';
3
5
  import {
4
6
  collectHookConfigs, standardsSourceDir, hooksSourceDir,
5
7
  CODEX_HOOK_SCRIPT, GEMINI_HOOK_SCRIPT, AGY_HOOK_SCRIPT,
@@ -88,7 +90,7 @@ function applyHooksMap(config, nextMap) {
88
90
  * difference is which file and which key they look at.
89
91
  */
90
92
  function uninstallHookConfigFile({ configPath, label, dryRun, deleteEmptyFile }) {
91
- const result = { removed: [], skipped: [], errors: [] };
93
+ const result = { removed: [], skipped: [], errors: [], deletedPaths: [] };
92
94
  if (!existsSync(configPath)) return result; // nothing installed here — nothing to report
93
95
 
94
96
  let config;
@@ -106,18 +108,21 @@ function uninstallHookConfigFile({ configPath, label, dryRun, deleteEmptyFile })
106
108
  }
107
109
 
108
110
  const entryLabel = `${label} (${removedCount} UDS hook ${removedCount === 1 ? 'entry' : 'entries'})`;
111
+ const updatedConfig = applyHooksMap(config, nextMap);
112
+ const willDeleteFile = deleteEmptyFile && Object.keys(updatedConfig).length === 0;
113
+ // Decided BEFORE the dry-run return: the preview must say the file goes away,
114
+ // and the folder-cleanup step needs to know the folder will be empty.
109
115
  if (dryRun) {
110
- result.removed.push(entryLabel);
116
+ result.removed.push(willDeleteFile ? `${entryLabel}, file removed — created by UDS, now empty` : entryLabel);
117
+ if (willDeleteFile) result.deletedPaths.push(label);
111
118
  return result;
112
119
  }
113
120
 
114
- const updatedConfig = applyHooksMap(config, nextMap);
115
- const isNowEmpty = Object.keys(updatedConfig).length === 0;
116
-
117
121
  try {
118
- if (deleteEmptyFile && isNowEmpty) {
122
+ if (willDeleteFile) {
119
123
  unlinkSync(configPath);
120
124
  result.removed.push(`${entryLabel}, file removed — created by UDS, now empty`);
125
+ result.deletedPaths.push(label);
121
126
  } else {
122
127
  writeFileSync(configPath, JSON.stringify(updatedConfig, null, 2) + '\n');
123
128
  result.removed.push(entryLabel);
@@ -186,7 +191,7 @@ export function uninstallAgyHooks(projectPath, options = {}) {
186
191
  const configPath = join(projectPath, '.agents', 'hooks.json');
187
192
  const label = '.agents/hooks.json';
188
193
  const dryRun = options.dryRun || false;
189
- const result = { removed: [], skipped: [], errors: [] };
194
+ const result = { removed: [], skipped: [], errors: [], deletedPaths: [] };
190
195
  if (!existsSync(configPath)) return result;
191
196
 
192
197
  let config;
@@ -242,14 +247,17 @@ export function uninstallAgyHooks(projectPath, options = {}) {
242
247
  }
243
248
 
244
249
  const entryLabel = `${label} (${removedCount} UDS hook ${removedCount === 1 ? 'entry' : 'entries'})`;
250
+ const willDeleteFile = Object.keys(next).length === 0;
245
251
  if (dryRun) {
246
- result.removed.push(entryLabel);
252
+ result.removed.push(willDeleteFile ? `${entryLabel}, file removed — created by UDS, now empty` : entryLabel);
253
+ if (willDeleteFile) result.deletedPaths.push(label);
247
254
  return result;
248
255
  }
249
256
  try {
250
- if (Object.keys(next).length === 0) {
257
+ if (willDeleteFile) {
251
258
  unlinkSync(configPath);
252
259
  result.removed.push(`${entryLabel}, file removed — created by UDS, now empty`);
260
+ result.deletedPaths.push(label);
253
261
  } else {
254
262
  writeFileSync(configPath, JSON.stringify(next, null, 2) + '\n');
255
263
  result.removed.push(entryLabel);
@@ -260,18 +268,114 @@ export function uninstallAgyHooks(projectPath, options = {}) {
260
268
  return result;
261
269
  }
262
270
 
271
+ // ─────────────────────────────────────────────────────────────────────────────
272
+ // Proof of authorship — "only delete what UDS can prove it wrote, unchanged".
273
+ //
274
+ // A record in `manifest.installedArtifacts` (core/install-records.js) says UDS
275
+ // wrote a file; a matching hash says nobody has changed it since. Both are
276
+ // required to delete a whole file. Anything else is KEPT, and the reason is
277
+ // printed, because "not provably ours" is the honest state of a file from an
278
+ // older UDS (no record) or one an adopter has edited (hash differs) — and
279
+ // guessing "probably ours" is how an adopter's own hook script gets deleted.
280
+ // ─────────────────────────────────────────────────────────────────────────────
281
+
282
+ /** Relative paths (forward slashes) of every file under `dir`, or [] if it is not there. */
283
+ function listFiles(dir, rel = '') {
284
+ if (!dir || !existsSync(dir)) return [];
285
+ const out = [];
286
+ for (const e of readdirSync(dir, { withFileTypes: true })) {
287
+ const r = rel ? `${rel}/${e.name}` : e.name;
288
+ if (e.isDirectory()) out.push(...listFiles(join(dir, e.name), r));
289
+ else out.push(r);
290
+ }
291
+ return out;
292
+ }
293
+
294
+ /**
295
+ * Remove the hook scripts UDS copied into `scripts/hooks/`.
296
+ *
297
+ * `scripts/hooks/` is a directory UDS scaffolds inside the adopter's project, so
298
+ * an adopter's own scripts can sit beside ours (a test in hook-uninstaller.test.js
299
+ * places one there and it must survive). Only files that have an install record
300
+ * AND still match it are deleted.
301
+ */
302
+ export function uninstallHookScripts(projectPath, manifest, { dryRun = false, blockedBy = null } = {}) {
303
+ const result = { removed: [], skipped: [], errors: [], deletedPaths: [] };
304
+ const files = manifest?.[RECORDS_KEY]?.files || {};
305
+ const recorded = Object.entries(files)
306
+ // gate-script: the scanners `uds init` writes to scripts/ (XSPEC-444 R5) — same proof rule as a hook script
307
+ .filter(([, rec]) => rec && (rec.kind === RECORD_KINDS.HOOK_SCRIPT || rec.kind === RECORD_KINDS.GATE_SCRIPT))
308
+ .map(([rel]) => rel)
309
+ .sort();
310
+
311
+ for (const rel of recorded) {
312
+ const abs = join(projectPath, rel);
313
+ if (!existsSync(abs)) continue; // already gone — nothing to remove, nothing to report
314
+ if (blockedBy) {
315
+ result.skipped.push(`${rel} (kept: ${blockedBy})`);
316
+ continue;
317
+ }
318
+ const proof = proveUnchanged(manifest, projectPath, rel);
319
+ if (proof.state !== 'proven') {
320
+ result.skipped.push(`${rel} (kept: ${proof.why})`);
321
+ continue;
322
+ }
323
+ try {
324
+ if (!dryRun) unlinkSync(abs);
325
+ result.removed.push(`${rel} (deleted — installed by UDS, ${proof.why})`);
326
+ result.deletedPaths.push(rel);
327
+ } catch (error) {
328
+ result.errors.push(`${rel} — ${error.message}`);
329
+ }
330
+ }
331
+
332
+ // Files that carry the name of a script UDS ships but have no record. Say so once,
333
+ // so a leftover `scripts/hooks/` is an explained decision and not a silent gap.
334
+ const recordedSet = new Set(recorded);
335
+ const shipped = listFiles(hooksSourceDir());
336
+ const unrecorded = shipped
337
+ .map((f) => `scripts/hooks/${f}`)
338
+ .filter((rel) => existsSync(join(projectPath, rel)) && !recordedSet.has(rel));
339
+ if (unrecorded.length > 0) {
340
+ result.skipped.push(
341
+ `scripts/hooks/ (kept: ${unrecorded.length} file${unrecorded.length === 1 ? '' : 's'} carry the name of a UDS hook script, ` +
342
+ 'but the manifest has no record that UDS wrote them — installed by an older UDS, or by hand. ' +
343
+ 'Delete them yourself if you no longer want them)'
344
+ );
345
+ }
346
+ return result;
347
+ }
348
+
349
+ // Line-level fallback, for the one-line form older UDS wrote and for a block whose
350
+ // end marker an adopter removed. The current block is removed whole, by its markers
351
+ // (stripUdsHookBlock) — its inner lines are not individually matchable.
352
+ const UDS_PRECOMMIT_LINE = /uds\s+check|universal-dev-standards\s+check|checkin-standards|^#\s*UDS Standard Check\s*$/;
353
+ const NATIVE_UDS_LINE = /uds\s+check|checkin-standards|UDS pre-commit hook/;
354
+
355
+ /** True when nothing is left but a shebang and blank lines. */
356
+ function nothingButShebang(lines) {
357
+ return lines.every((l) => !l.trim() || /^#!/.test(l.trim()));
358
+ }
359
+
263
360
  /**
264
361
  * Remove UDS-related lines from .husky/pre-commit, the native
265
362
  * .git/hooks/pre-commit fallback, and the enforcement-hook entries UDS wrote
266
363
  * into .claude/settings.json, .codex/hooks.json, .gemini/settings.json and
267
- * .agents/hooks.json.
364
+ * .agents/hooks.json; and the hook scripts copied into scripts/hooks/.
365
+ *
366
+ * Whole-file deletion (a hook file, a script) needs proof — see proveUnchanged.
367
+ * A hook file that is not provably wholly UDS's still has its UDS lines removed
368
+ * (each is a line UDS wrote, and the rest of the file is untouched) and the
369
+ * remainder is reported as kept, with the reason.
370
+ *
268
371
  * @param {string} projectPath - Project root path
269
- * @param {Object} options - { dryRun: boolean }
270
- * @returns {Object} { removed: string[], skipped: string[], errors: string[] }
372
+ * @param {Object} options - { dryRun: boolean, manifest: object|null }
373
+ * `manifest` must be read BEFORE `.standards/` is removed; it carries the install records.
374
+ * @returns {Object} { removed: string[], skipped: string[], errors: string[], deletedPaths: string[] }
271
375
  */
272
376
  export function uninstallHook(projectPath, options = {}) {
273
- const { dryRun = false } = options;
274
- const result = { removed: [], skipped: [], errors: [] };
377
+ const { dryRun = false, manifest = null } = options;
378
+ const result = { removed: [], skipped: [], errors: [], deletedPaths: [] };
275
379
  const hookPath = join(projectPath, '.husky', 'pre-commit');
276
380
 
277
381
  if (!existsSync(hookPath)) {
@@ -279,12 +383,23 @@ export function uninstallHook(projectPath, options = {}) {
279
383
  } else {
280
384
  try {
281
385
  const content = readFileSync(hookPath, 'utf-8');
386
+ const proof = proveUnchanged(manifest, projectPath, '.husky/pre-commit');
282
387
  const lines = content.split('\n');
283
- const udsPattern = /uds\s+check|checkin-standards/;
284
- const filteredLines = lines.filter(line => !udsPattern.test(line));
388
+ const filteredLines = stripUdsHookBlock(content).content.split('\n')
389
+ .filter(line => !UDS_PRECOMMIT_LINE.test(line));
285
390
 
286
- if (filteredLines.length === lines.length) {
391
+ if (proof.state === 'proven') {
392
+ // UDS created this file and nobody has touched it: nothing of the adopter's is in it.
393
+ if (!dryRun) unlinkSync(hookPath);
394
+ result.removed.push(`.husky/pre-commit (deleted — created by UDS, ${proof.why})`);
395
+ result.deletedPaths.push('.husky/pre-commit');
396
+ } else if (filteredLines.length === lines.length) {
287
397
  result.skipped.push('.husky/pre-commit (no UDS lines found)');
398
+ } else if (nothingButShebang(filteredLines)) {
399
+ // Only UDS's lines (and a shebang) were in it — removing them leaves nothing worth keeping.
400
+ if (!dryRun) unlinkSync(hookPath);
401
+ result.removed.push('.husky/pre-commit (UDS check lines; file removed — nothing else was in it)');
402
+ result.deletedPaths.push('.husky/pre-commit');
288
403
  } else if (dryRun) {
289
404
  result.removed.push('.husky/pre-commit (UDS check lines)');
290
405
  } else {
@@ -301,25 +416,32 @@ export function uninstallHook(projectPath, options = {}) {
301
416
  if (existsSync(nativeHookPath)) {
302
417
  try {
303
418
  const content = readFileSync(nativeHookPath, 'utf-8');
304
- const udsPattern = /uds\s+check|checkin-standards|UDS pre-commit hook/;
419
+ const proof = proveUnchanged(manifest, projectPath, '.git/hooks/pre-commit');
305
420
 
306
- if (!udsPattern.test(content)) {
421
+ if (proof.state === 'proven') {
422
+ // The whole script is what `uds init` wrote — including the parts no line
423
+ // pattern would ever match (its "Auto-generated by uds init" header, the
424
+ // linter fallbacks, the closing echo). Deleting only the matching lines
425
+ // used to leave that body behind, still executable, still claiming
426
+ // "Pre-commit checks passed".
427
+ if (!dryRun) unlinkSync(nativeHookPath);
428
+ result.removed.push(`.git/hooks/pre-commit (UDS native hook, file removed — ${proof.why})`);
429
+ result.deletedPaths.push('.git/hooks/pre-commit');
430
+ } else if (!NATIVE_UDS_LINE.test(content) && !stripUdsHookBlock(content).removed) {
307
431
  result.skipped.push('.git/hooks/pre-commit (no UDS lines found)');
308
- } else if (dryRun) {
309
- result.removed.push('.git/hooks/pre-commit (UDS native hook)');
310
432
  } else {
311
- // Remove only UDS-related lines, keep other hook content
312
- const lines = content.split('\n');
313
- const filtered = lines.filter(line => !udsPattern.test(line));
314
-
315
- // If only shebang remains, remove the file entirely; otherwise rewrite
316
- const nonEmpty = filtered.filter(l => l.trim() && l.trim() !== '#!/bin/sh');
317
- if (nonEmpty.length === 0) {
318
- unlinkSync(nativeHookPath);
433
+ // The block the native hook carries is removed whole, by its markers — its
434
+ // inner lines are not individually matchable (same as the husky path above).
435
+ const filtered = stripUdsHookBlock(content).content.split('\n')
436
+ .filter(line => !NATIVE_UDS_LINE.test(line));
437
+ if (nothingButShebang(filtered)) {
438
+ if (!dryRun) unlinkSync(nativeHookPath);
319
439
  result.removed.push('.git/hooks/pre-commit (UDS native hook, file removed)');
440
+ result.deletedPaths.push('.git/hooks/pre-commit');
320
441
  } else {
321
- writeFileSync(nativeHookPath, filtered.join('\n'), 'utf-8');
442
+ if (!dryRun) writeFileSync(nativeHookPath, filtered.join('\n'), 'utf-8');
322
443
  result.removed.push('.git/hooks/pre-commit (UDS lines removed)');
444
+ result.skipped.push(`.git/hooks/pre-commit (kept: the rest of the script — ${proof.why})`);
323
445
  }
324
446
  }
325
447
  } catch (error) {
@@ -329,16 +451,81 @@ export function uninstallHook(projectPath, options = {}) {
329
451
 
330
452
  // Enforcement hooks written by installHooks()/installCodexHooks()/installGeminiHooks()
331
453
  // — the gap this function used to have entirely (see module doc comment above).
332
- for (const sub of [
454
+ const configResults = [
333
455
  uninstallClaudeCodeHooks(projectPath, { dryRun }),
334
456
  uninstallCodexHooks(projectPath, { dryRun }),
335
457
  uninstallGeminiHooks(projectPath, { dryRun }),
336
458
  uninstallAgyHooks(projectPath, { dryRun }),
337
- ]) {
459
+ ];
460
+ for (const sub of configResults) {
338
461
  result.removed.push(...sub.removed);
339
462
  result.skipped.push(...sub.skipped);
340
463
  result.errors.push(...sub.errors);
464
+ result.deletedPaths.push(...sub.deletedPaths);
341
465
  }
342
466
 
467
+ // The scripts those entries ran. If a config file could not be cleaned (it still
468
+ // names a script), deleting the script would turn a working hook into a failing one.
469
+ const configFailed = configResults.some((r) => r.errors.length > 0);
470
+ const scripts = uninstallHookScripts(projectPath, manifest, {
471
+ dryRun,
472
+ blockedBy: configFailed ? 'a hook config file could not be cleaned (see the error above) and still runs this script' : null
473
+ });
474
+ result.removed.push(...scripts.removed);
475
+ result.skipped.push(...scripts.skipped);
476
+ result.errors.push(...scripts.errors);
477
+ result.deletedPaths.push(...scripts.deletedPaths);
478
+
479
+ return result;
480
+ }
481
+
482
+ /**
483
+ * Remove the folders UDS had to create for its files (`.codex/`, `scripts/hooks/`, ...),
484
+ * once they are empty.
485
+ *
486
+ * A folder is removed only if (a) the manifest recorded that UDS created it and
487
+ * (b) nothing is left in it. An empty `.codex/` that the adopter made themselves is
488
+ * indistinguishable by looking; the record is the only thing that tells them apart.
489
+ * A folder that still holds anything — `.agents/rules/style.md` — is kept and
490
+ * reported, so the adopter sees why it stayed.
491
+ *
492
+ * In a dry run nothing has been deleted yet, so `plannedDeletions` (relative paths
493
+ * the run WOULD delete) stands in for the missing deletions when judging "empty".
494
+ *
495
+ * @param {string} projectPath
496
+ * @param {Object|null} manifest - read before `.standards/` was removed
497
+ * @param {{ dryRun?: boolean, plannedDeletions?: string[] }} [options]
498
+ * @returns {{ removed: string[], skipped: string[], errors: string[], deletedPaths: string[] }}
499
+ */
500
+ export function pruneCreatedDirs(projectPath, manifest, { dryRun = false, plannedDeletions = [] } = {}) {
501
+ const result = { removed: [], skipped: [], errors: [], deletedPaths: [] };
502
+ const dirs = manifest?.[RECORDS_KEY]?.createdDirs || [];
503
+ const gone = new Set(plannedDeletions.map((p) => p.replace(/\\/g, '/')));
504
+ // Deepest first: `scripts/hooks` must go before `scripts` can be seen as empty.
505
+ const ordered = [...new Set(dirs)]
506
+ .filter((d) => d && !d.startsWith('..') && !d.startsWith('/'))
507
+ .sort((a, b) => b.split('/').length - a.split('/').length);
508
+
509
+ for (const rel of ordered) {
510
+ const abs = join(projectPath, rel);
511
+ if (!existsSync(abs)) continue;
512
+ if (!isRealDirectory(abs)) {
513
+ result.skipped.push(`${rel}/ (kept: not a plain directory)`);
514
+ continue;
515
+ }
516
+ try {
517
+ const left = readdirSync(abs).filter((name) => !gone.has(`${rel}/${name}`));
518
+ if (left.length > 0) {
519
+ result.skipped.push(`${rel}/ (kept: created by UDS but not empty — still holds ${left.slice(0, 3).join(', ')}${left.length > 3 ? ', ...' : ''}, which UDS did not write)`);
520
+ continue;
521
+ }
522
+ if (!dryRun) rmdirSync(abs);
523
+ gone.add(rel);
524
+ result.removed.push(`${rel}/ (empty folder created by UDS, removed)`);
525
+ result.deletedPaths.push(rel);
526
+ } catch (error) {
527
+ result.errors.push(`${rel}/ — ${error.message}`);
528
+ }
529
+ }
343
530
  return result;
344
531
  }
@@ -3,6 +3,7 @@ import { join } from 'path';
3
3
  import { extractMarkedContent } from '../utils/integration-generator.js';
4
4
  import { SUPPORTED_AI_TOOLS } from '../core/constants.js';
5
5
  import { resolveIntegrationFile } from '../core/constants.js';
6
+ import { proveUnchanged } from '../core/install-records.js';
6
7
 
7
8
  /**
8
9
  * Get the format for a given integration file name
@@ -29,7 +30,7 @@ function getFormatForFile(fileName) {
29
30
  */
30
31
  export async function uninstallIntegrations(projectPath, manifest, options = {}) {
31
32
  const { dryRun = false, interactive = false, promptFn = null } = options;
32
- const result = { removed: [], skipped: [], errors: [] };
33
+ const result = { removed: [], skipped: [], errors: [], deletedPaths: [] };
33
34
 
34
35
  const integrations = manifest?.integrations || [];
35
36
  if (integrations.length === 0) {
@@ -64,11 +65,27 @@ export async function uninstallIntegrations(projectPath, manifest, options = {})
64
65
  const userContent = (parts.before.trim() + parts.after.trim()).trim();
65
66
  const hasUserContent = userContent.length > 0;
66
67
 
68
+ // Text outside the UDS block is not automatically the adopter's. A file UDS
69
+ // creates from nothing carries generated text there — AGENTS.md's
70
+ // "> Auto-generated by ..." header and sections, CLAUDE.md's leading guidance —
71
+ // and treating all of it as "user content" left an orphaned file pointing at
72
+ // the `.standards/` this very command removes. It is only "not the adopter's"
73
+ // if UDS recorded a hash of it when it created the file and the text still
74
+ // matches; without that proof it stays, and the reason is printed.
75
+ const proof = hasUserContent ? proveUnchanged(manifest, projectPath, fileName) : null;
76
+ const outsideIsUdsOwn = hasUserContent && proof.state === 'proven';
77
+ const keptNote = () => `${fileName} (kept: the text outside the UDS block — ${proof.why})`;
78
+
67
79
  if (dryRun) {
68
- if (hasUserContent) {
69
- result.removed.push(`${fileName} (remove UDS block, keep user content)`);
70
- } else {
80
+ if (!hasUserContent) {
71
81
  result.removed.push(`${fileName} (delete file)`);
82
+ result.deletedPaths.push(fileName);
83
+ } else if (outsideIsUdsOwn) {
84
+ result.removed.push(`${fileName} (delete file — everything outside the UDS block was generated by UDS)`);
85
+ result.deletedPaths.push(fileName);
86
+ } else {
87
+ result.removed.push(`${fileName} (remove UDS block, keep user content)`);
88
+ result.skipped.push(keptNote());
72
89
  }
73
90
  continue;
74
91
  }
@@ -77,26 +94,39 @@ export async function uninstallIntegrations(projectPath, manifest, options = {})
77
94
  // 100% UDS-generated → delete entire file
78
95
  unlinkSync(filePath);
79
96
  result.removed.push(`${fileName} (deleted)`);
97
+ result.deletedPaths.push(fileName);
98
+ } else if (outsideIsUdsOwn) {
99
+ // UDS created this file and its non-block text is still exactly what UDS
100
+ // wrote: there is no adopter content to preserve, so no question to ask.
101
+ unlinkSync(filePath);
102
+ result.removed.push(`${fileName} (deleted — everything outside the UDS block was generated by UDS and is unchanged)`);
103
+ result.deletedPaths.push(fileName);
80
104
  } else if (interactive && promptFn) {
81
105
  // Ask user what to do
82
106
  const action = await promptFn(fileName, hasUserContent);
83
107
  if (action === 'delete-file') {
84
108
  unlinkSync(filePath);
85
109
  result.removed.push(`${fileName} (deleted)`);
110
+ result.deletedPaths.push(fileName);
86
111
  } else if (action === 'remove-block') {
87
112
  const cleaned = (parts.before + parts.after).trim() + '\n';
88
113
  writeFileSync(filePath, cleaned, 'utf-8');
89
114
  result.removed.push(`${fileName} (UDS block removed)`);
115
+ result.skipped.push(keptNote());
90
116
  } else {
91
117
  result.skipped.push(`${fileName} (user skipped)`);
92
118
  }
93
119
  } else {
94
- // Non-interactive (--yes): remove UDS block only, preserve user content
120
+ // Non-interactive (--yes): remove UDS block only, preserve everything else
95
121
  const cleaned = (parts.before + parts.after).trim() + '\n';
96
122
  writeFileSync(filePath, cleaned, 'utf-8');
97
123
  result.removed.push(`${fileName} (UDS block removed)`);
124
+ result.skipped.push(keptNote());
98
125
  }
99
126
  } catch (error) {
127
+ // A closed prompt is the user stopping the run, not a failure of this file:
128
+ // let the command report it (and exit non-zero) instead of retrying the next file.
129
+ if (error?.name === 'ExitPromptError') throw error;
100
130
  result.errors.push(`${fileName} — ${error.message}`);
101
131
  }
102
132
  }
@@ -1,13 +1,26 @@
1
- import { existsSync, rmSync } from 'fs';
1
+ import { existsSync, rmSync, rmdirSync, readdirSync, unlinkSync } from 'fs';
2
+ import { dirname, join, relative, isAbsolute } from 'path';
2
3
  import {
3
4
  getSkillsDirForAgent,
4
- getCommandsDirForAgent,
5
- getAgentsDirForAgent,
6
- getWorkflowsDirForAgent
5
+ getCommandsDirForAgent
7
6
  } from '../config/ai-agent-paths.js';
7
+ import { computeFileHash } from '../utils/hasher.js';
8
8
 
9
9
  /**
10
- * Uninstall skills, commands, agents, and workflows
10
+ * Uninstall skills and commands
11
+ *
12
+ * Skills and commands go into folders the adopter shares with other things
13
+ * (`.claude/skills/` holds their own skills too; `init` says so where it writes
14
+ * them). So this removes only what UDS can PROVE it wrote and nobody has changed
15
+ * since: a record in the manifest (`skillHashes` / `commandHashes`) plus a
16
+ * matching content hash. The same rule `uds uninstall` already applies to hook
17
+ * scripts and integration files. A file with no record, or edited since, is
18
+ * kept and said so. A folder UDS emptied is removed; a folder that still holds
19
+ * something else is left alone.
20
+ *
21
+ * This used to `rmSync` the whole skills folder, which took the adopter's own
22
+ * skills with it.
23
+ *
11
24
  * @param {string} projectPath - Project root path
12
25
  * @param {Object} manifest - Parsed manifest object
13
26
  * @param {Object} options - { dryRun, includeUserLevel }
@@ -26,30 +39,60 @@ export function uninstallSkills(projectPath, manifest, options = {}) {
26
39
  // Process skill installations
27
40
  const skillInstalls = manifest?.skills?.installations || [];
28
41
  for (const install of skillInstalls) {
29
- processInstallation(install, 'skills', projectPath, options, result);
42
+ processInstallation(install, 'skills', projectPath, manifest, options, result);
30
43
  }
31
44
 
32
45
  // Process command installations
33
46
  const cmdInstalls = manifest?.commands?.installations || [];
34
47
  for (const install of cmdInstalls) {
35
- processInstallation(install, 'commands', projectPath, options, result);
48
+ processInstallation(install, 'commands', projectPath, manifest, options, result);
36
49
  }
37
50
 
38
51
  return result;
39
52
  }
40
53
 
41
54
  /**
42
- * Process a single skill/command/agent/workflow installation for removal
55
+ * The files the manifest says UDS wrote into one installation's folder.
56
+ * Skill records are keyed `<agent>/<level>/<skill>/<file>`; command records
57
+ * `<agent>/<file>` (they carry no level).
58
+ * @returns {Array<{ rel: string, hash: string }>} path inside the folder (forward slashes) and recorded hash
43
59
  */
44
- function processInstallation(install, type, projectPath, options, result) {
60
+ function recordedFiles(manifest, type, agent, level) {
61
+ const table = (type === 'skills' ? manifest?.skillHashes : manifest?.commandHashes) || {};
62
+ const prefix = type === 'skills' ? `${agent}/${level}/` : `${agent}/`;
63
+ return Object.entries(table)
64
+ .filter(([key]) => key.startsWith(prefix))
65
+ .map(([key, info]) => ({ rel: key.slice(prefix.length), hash: info && info.hash }));
66
+ }
67
+
68
+ /** Remove `dir` if nothing is left in it. Returns whether it is gone. */
69
+ function removeIfEmpty(dir) {
70
+ try {
71
+ if (readdirSync(dir).length > 0) return false;
72
+ rmdirSync(dir);
73
+ return true;
74
+ } catch {
75
+ return false;
76
+ }
77
+ }
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
+
87
+ /**
88
+ * Process a single skill/command installation for removal
89
+ */
90
+ function processInstallation(install, type, projectPath, manifest, options, result) {
45
91
  const { dryRun = false, includeUserLevel = false } = options;
46
92
  const { agent, level } = install;
47
93
 
48
94
  // Determine directory getter
49
- const getDirFn = type === 'skills' ? getSkillsDirForAgent :
50
- type === 'commands' ? getCommandsDirForAgent :
51
- type === 'agents' ? getAgentsDirForAgent :
52
- getWorkflowsDirForAgent;
95
+ const getDirFn = type === 'skills' ? getSkillsDirForAgent : getCommandsDirForAgent;
53
96
 
54
97
  const dir = getDirFn(agent, level || 'project', projectPath);
55
98
  if (!dir) {
@@ -71,14 +114,50 @@ function processInstallation(install, type, projectPath, options, result) {
71
114
  return;
72
115
  }
73
116
 
117
+ const records = recordedFiles(manifest, type, agent, level || 'project');
118
+ if (records.length === 0) {
119
+ result.skipped.push(`${label} — kept ${dir}: the manifest records no file UDS wrote there, so UDS cannot prove which are its own`);
120
+ return;
121
+ }
122
+
123
+ const toRemove = [];
124
+ const changed = [];
125
+ for (const { rel, hash } of records) {
126
+ const file = join(dir, ...rel.split('/'));
127
+ if (!existsSync(file)) continue;
128
+ const now = computeFileHash(file);
129
+ if (now && hash && now.hash === hash) toRemove.push(file);
130
+ else changed.push(rel);
131
+ }
132
+
74
133
  if (dryRun) {
75
- result.removed.push(`${label} → ${dir}`);
134
+ result.removed.push(`${label} → ${dir} (${toRemove.length} file(s) UDS wrote)`);
135
+ if (changed.length > 0) result.skipped.push(`${label} — would keep ${changed.length} file(s) changed since UDS wrote them`);
76
136
  return;
77
137
  }
78
138
 
79
139
  try {
80
- rmSync(dir, { recursive: true, force: true });
81
- result.removed.push(`${label} → ${dir}`);
140
+ const touched = new Set();
141
+ for (const file of toRemove) {
142
+ unlinkSync(file);
143
+ touched.add(dirname(file));
144
+ }
145
+ // UDS's own bookkeeping for the folder (written by the skills installer, never hashed): go with the last of its files.
146
+ if (changed.length === 0) {
147
+ const marker = join(dir, '.manifest.json');
148
+ if (existsSync(marker)) rmSync(marker, { force: true });
149
+ }
150
+ // Folders UDS emptied, deepest first, then the installation folder itself.
151
+ for (const d of [...touched].sort((a, b) => b.length - a.length)) {
152
+ if (d !== dir) removeIfEmpty(d);
153
+ }
154
+ const gone = removeIfEmpty(dir);
155
+ // XSPEC-475 R5(d): the tool's own folder (`.claude/`, `.codex/` ...) that held only what UDS wrote is empty now; an
156
+ // empty `.claude/` left in the project is a trace of UDS. Only an EMPTY folder inside the project, never the project
157
+ // root, and never a user-level folder.
158
+ if (gone && !isUserLevel) removeEmptyParentInside(dir, projectPath);
159
+ result.removed.push(`${label} → ${dir} (${toRemove.length} file(s) UDS wrote${gone ? '' : '; folder kept: it still holds files that are not UDS\'s'})`);
160
+ if (changed.length > 0) result.skipped.push(`${label} — kept ${changed.length} file(s) changed since UDS wrote them`);
82
161
  } catch (error) {
83
162
  result.errors.push(`${label} — ${error.message}`);
84
163
  }