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
@@ -2,8 +2,8 @@
2
2
 
3
3
  > **Language**: English | [繁體中文](../locales/zh-TW/core/ai-response-navigation.md) | [简体中文](../locales/zh-CN/core/ai-response-navigation.md)
4
4
 
5
- **Version**: 1.3.0
6
- **Last Updated**: 2026-08-17
5
+ **Version**: 1.4.0
6
+ **Last Updated**: 2026-10-05
7
7
  **Applicability**: All projects using AI-assisted development
8
8
  **Scope**: universal
9
9
  **Industry Standards**: None (Emerging AI tool practice)
@@ -19,12 +19,15 @@ This standard defines navigation behavior for AI responses: every substantive AI
19
19
 
20
20
  **Solution**: A standard "Navigation Footer" appended to every substantive AI response, with contextual templates, recommendation marking, and adaptive option quantities.
21
21
 
22
- **Scope note (v1.2.0, extended in 1.3.0)**: Rules 1–6 govern what comes *after* the answer.
23
- Rules 7–11 — **all optional** — govern the answer itself: lead with the finding (R7), restate state
24
- across turns (R8), no preamble (R9), plain language as the subject (R10), and a trade-off on every
25
- option rather than only the recommended one (R11). They exist because a response can satisfy every
26
- one of Rules 1–6 while burying its conclusion, stating it in vocabulary only its author holds, or
27
- listing options the reader still has to compare themselves.
22
+ **Scope note (v1.2.0, extended in 1.3.0 and 1.4.0)**: Rules 1–6 govern what comes *after* the answer.
23
+ Rules 7–12 govern the answer itself: lead with the finding (R7), restate state
24
+ across turns (R8), no preamble (R9), plain language as the subject (R10), a trade-off on every
25
+ option rather than only the recommended one (R11), and controlled language (R12). Rules 7–11 are
26
+ **optional**. **Rule 12 is the one exception, and only in part**: its clause that a simplified text
27
+ must keep the writer's hedges is **required**; the rest of R12 is optional. They exist because a
28
+ response can satisfy every one of Rules 1–6 while burying its conclusion, stating it in vocabulary
29
+ only its author holds, listing options the reader still has to compare themselves, or being made
30
+ easy to read by being made more certain than the evidence.
28
31
 
29
32
  ---
30
33
 
@@ -104,11 +107,14 @@ Tier names are **vendor-neutral**. Each tool or platform maps these tiers to its
104
107
 
105
108
  ---
106
109
 
107
- ## The Answer Before the Navigation (Rules 7–11, Optional)
110
+ ## The Answer Before the Navigation (Rules 7–12)
108
111
 
109
112
  > **R7–R9 borrowed from**: [`ayghri/i-have-adhd`](https://github.com/ayghri/i-have-adhd) (MIT), 3 of its 10 rules.
110
113
  > **R10–R11 added in 1.3.0** from a different source — a user telling the author, twice in one session,
111
114
  > that a correct and complete answer was unreadable. R7–R9 had already shipped and were being followed.
115
+ > **R12 added in 1.4.0** from a third source: a public suggestion to ask an LLM to write at "about
116
+ > 80% of the way to" ASD-STE100, a controlled-English standard for technical documentation. Only its
117
+ > principles are taken; its English dictionary and tense rules are not (see Rule 12).
112
118
  > The other 7 were dropped: 2 are already covered by Rules 1–2 above, and 5 either conflict with
113
119
  > this standard (its "no recap / no closers" contradicts Rule 1's Navigation Footer; its
114
120
  > "cap lists at 5" would truncate evidence tables and traversal denominators) or duplicate
@@ -119,10 +125,12 @@ itself — a response could bury its conclusion under a wall of evidence and sti
119
125
  in this standard by appending a correct Navigation Footer. A reader who cannot find the answer is
120
126
  not helped by being told what to do next.
121
127
 
122
- **These five rules are optional**, in the same sense as Rule 6: adopting projects are not required
128
+ **Rules 7–11 are optional**, in the same sense as Rule 6: adopting projects are not required
123
129
  to enable them, and existing skills need no retroactive update. A project MAY promote any of them to
124
- required in its own configuration. What is *not* optional is that they have precise triggers — a rule
125
- phrased so loosely that it never fires is indistinguishable from not having the rule.
130
+ required in its own configuration. **Rule 12 has one required clause** (12.1) and an optional rest
131
+ (12.2); the split is argued inside the rule. What is *not* optional anywhere is that every rule has
132
+ a precise trigger — a rule phrased so loosely that it never fires is indistinguishable from not
133
+ having the rule.
126
134
 
127
135
  ### Rule 7: Lead With the Finding, Not the Process (Optional)
128
136
 
@@ -187,6 +195,11 @@ It governs which of the two is the subject of the sentence.
187
195
  response can lead with its finding and still state that finding in vocabulary only its author
188
196
  holds. Both failures leave the reader unable to act; they are different failures.
189
197
 
198
+ **Plain wording must not buy its plainness with certainty.** Putting an explanation in the
199
+ reader's words is a rewrite, and a rewrite is exactly where "might" quietly becomes "is". When R10
200
+ is applied to a claim the writer had hedged, [Rule 12](#rule-12-controlled-language-partly-required)
201
+ clause 12.1 (required) governs: the hedge stays.
202
+
190
203
  ### Rule 11: Every Option Carries Its Own Trade-off (Optional)
191
204
 
192
205
  **Trigger**: a response that asks the reader to choose between two or more courses of action.
@@ -214,6 +227,107 @@ worth stating, say so explicitly rather than leaving the column empty — an emp
214
227
  **Composes with Rule 4**: the option count stays bounded (1–5). Trade-offs make each option
215
228
  costlier to read, so this rule makes Rule 4's cap matter more, not less.
216
229
 
230
+ ### Rule 12: Controlled Language (Partly Required)
231
+
232
+ **Trigger**: writing, rewriting, shortening, simplifying or translating text for a reader who is
233
+ not its author — typically a non-specialist who has to judge or approve something from it.
234
+
235
+ Controlled languages (writing rules that trade variety for predictability) make text easier to
236
+ read. They have a known way of failing: the easiest sentence to read is a confident one, so
237
+ "simplification" drifts toward certainty. This rule takes the principles of controlled writing and
238
+ puts a hard stop on that drift.
239
+
240
+ #### 12.1 A simplified text keeps its hedges (Required)
241
+
242
+ A hedge is a word that tells the reader how far to trust a claim: *might, could, probably,
243
+ appears to, not yet confirmed* — 可能、推斷、大概、尚未確認. It is information, not padding.
244
+
245
+ When you shorten, simplify, rewrite or translate:
246
+
247
+ - **Do not turn an uncertain claim into a certain one.** If the source says "might", the result
248
+ says "might" (or the equivalent in the language of the result).
249
+ - **Do not drop the hedge to save words.** A shorter sentence is the goal; a more certain one is
250
+ not allowed.
251
+ - **Do not add facts the source did not state** — an invented cause or an invented "confirmed" is
252
+ the same failure in another form.
253
+ - A hedge may go only when the claim has since been verified, and then the verification (what was
254
+ checked, with what result) takes its place. Deleting the hedge alone is not verification.
255
+
256
+ **Why this one is required and the rest are not**: it is the only part whose failure misleads the
257
+ reader about what is true, rather than only making the text harder to read. It also needs no
258
+ calibration — the check is a comparison of the text before and after, which a person or a model
259
+ can do in any language — whereas every threshold below depends on language and audience.
260
+
261
+ #### 12.2 Plain-writing principles (Optional)
262
+
263
+ Apply these when the reader is a non-specialist. They are language-neutral: each is stated in the
264
+ unit the language itself uses, with no word list.
265
+
266
+ | Principle | What it asks for |
267
+ |-----------|------------------|
268
+ | **Short sentences, counted in the language's own unit** | One idea per sentence. As a *starting range*, not a limit: roughly 15–25 words in English, roughly 25–40 characters in Chinese. A sentence far beyond the range is a signal to split it, not a defect to count. Calibrate per language and per reader |
269
+ | **One thing, one name** | Pick one name for each thing and use it for the whole text. Do not vary it for style: a reader who sees a second name assumes a second thing |
270
+ | **A clear subject and the active voice** | Say who does what. The passive is acceptable when the actor is unknown or does not matter |
271
+ | **One step, one action** | A procedure is a numbered list with one action per item, not a paragraph |
272
+ | **Few semicolons** | A semicolon joins two ideas the reader must hold at once. Split into two sentences or a list |
273
+ | **Numbers carry units** | "30 seconds", "3 files", "NT$1,200" — never a bare "30" |
274
+
275
+ **Why optional**: the ranges above are starting points that have not been calibrated against
276
+ reader outcomes, and no checker enforces them. A *required* rule with a threshold nobody can
277
+ verify produces mechanical compliance — sentences split until they stop reading as sentences —
278
+ and an expert reader may be better served by denser text. These principles are guidance a writer
279
+ applies with judgment; 12.1 is the part that does not bend.
280
+
281
+ #### What this rule does not take from ASD-STE100
282
+
283
+ ASD-STE100's **approved dictionary** (one meaning per approved English word, with a closed list
284
+ of allowed words) and its **tense restrictions** depend on the English language. They do not apply
285
+ to Chinese or to other non-English text, and this standard ships **no word list of any kind**.
286
+ Only the principles in 12.2 are taken, restated so that each can be applied in any language.
287
+
288
+ For the same reason, do not use a counter that splits on whitespace or ASCII characters to gauge
289
+ non-English text: it reads a Chinese paragraph as one "word" and passes it however long it is. A
290
+ gauge that is always green on a language measures nothing in that language.
291
+
292
+ #### Example: one passage, three rewrites, and one that is not allowed
293
+
294
+ The example is in Chinese on purpose: the rule is language-neutral, and Chinese is where an
295
+ English-only approach does not carry over. The three valid versions keep the hedges 可能 (might),
296
+ 推斷 (inferred) and 尚未 (not yet) and add no fact the original lacks.
297
+
298
+ **Original**
299
+
300
+ ```text
301
+ 經過檢查,登入頁面在高流量時段回應變慢,這個問題可能是資料庫連線池被耗盡所造成的,我們推斷是因為上週的改版新增了一個會長時間佔用連線的查詢;目前尚未在測試環境重現,所以修復後的效果還需要被確認,建議在確認之前先不要對外宣布已經解決。
302
+ ```
303
+
304
+ **About 80%** — shorter sentences, still reads as prose
305
+
306
+ ```text
307
+ 登入頁面在高流量時段回應變慢。原因可能是資料庫連線池被耗盡。我們推斷,上週改版新增了一個查詢,它會長時間佔用連線。這一點尚未在測試環境重現,修復後有沒有效,也還沒確認。確認之前,建議先不要對外宣布已經解決。
308
+ ```
309
+
310
+ **Strict** — one idea per line, labelled, hedges kept
311
+
312
+ ```text
313
+ 登入頁面在高流量時段回應變慢。
314
+ 1. 原因:可能是資料庫連線池被耗盡。
315
+ 2. 推斷:上週改版新增了一個查詢,這個查詢可能長時間佔用連線。
316
+ 3. 狀態:尚未在測試環境重現。
317
+ 4. 修復效果:尚未確認。
318
+ 5. 建議:確認之前,不要對外宣布已解決。
319
+ ```
320
+
321
+ **Not a valid rewrite** — shortest of all, and wrong
322
+
323
+ ```text
324
+ 登入頁面變慢,原因是資料庫連線池被耗盡,已確認由上週改版造成。
325
+ ```
326
+
327
+ The last version is the shortest and the easiest to read, and it fails 12.1 twice: "可能" became
328
+ a flat statement of cause, and "尚未重現" became "已確認" (confirmed), a fact the original never
329
+ stated. A reader who approves a fix on the strength of it has been given something untrue.
330
+
217
331
  ---
218
332
 
219
333
  ## Contextual Templates
@@ -408,6 +522,7 @@ Each tool's integration layer is responsible for rendering the Navigation Footer
408
522
  | R9 | *(Optional)* No preamble. Closers still required — see R1 |
409
523
  | R10 | *(Optional)* Plain language is the subject; identifiers support it, after the claim |
410
524
  | R11 | *(Optional)* Every option states what it buys and costs — not only the recommended one |
525
+ | R12 | **12.1 *(Required)***: when simplifying, shortening or translating, keep the hedges — never turn "might" into "is". 12.2 *(Optional)*: short sentences in the language's own unit, one name per thing, active voice, one action per step, few semicolons, numbers with units. No English dictionary — it does not carry to other languages |
411
526
 
412
527
  | Exempt | Not Exempt |
413
528
  |--------|------------|
@@ -431,6 +546,7 @@ Each tool's integration layer is responsible for rendering the Navigation Footer
431
546
 
432
547
  | Version | Date | Changes |
433
548
  |---------|------|---------|
549
+ | 1.4.0 | 2026-10-05 | Add R12, controlled language, language-neutral. One clause is required (12.1: a simplified text keeps the writer's hedges — "might" does not become "is" and no unstated fact is added); the rest (12.2: sentence length in the language's own unit, one name per thing, active voice, one action per step, few semicolons, numbers with units) is optional, with the reason recorded. Takes the principles of ASD-STE100 and none of its English dictionary or tense rules, and says so in the standard. Ships a Chinese before/after example in three strictness levels plus one rewrite that is shorter and wrong. R10 now points to R12, because putting a claim in plain words is a rewrite and a rewrite is where hedges get lost |
434
550
  | 1.3.0 | 2026-08-17 | Add optional R10–R11. R10 governs register: plain language is the subject of the sentence and identifiers support it — distinct from R7, which orders finding before evidence, because a response can lead with its finding and still state it in vocabulary only its author holds. R11 extends Rule 2 from the recommended option to all of them: a list where only the recommendation is argued hands the comparison back to the reader, and an option shown without its cost reads as having none |
435
551
  | 1.2.0 | 2026-08-17 | Add optional R7–R9 governing the answer itself (lead with the finding, restate state, no preamble). Borrowed from `ayghri/i-have-adhd` (MIT), 3 of its 10 rules; the other 7 were dropped as duplicated by R1–R2, in conflict with R1, or covered by estimation-standards. Rules 1–6 could all be satisfied by a response that buries its conclusion — R7–R9 close that |
436
552
  | 1.1.0 | 2026-06-10 | Add R6 optional model tier annotation (`〔model: Fast\|Standard\|Capable〕`); vendor-neutral; no forced changes to existing skills |
@@ -2,8 +2,8 @@
2
2
 
3
3
  > **Language**: English | [繁體中文](../locales/zh-TW/core/code-review-checklist.md)
4
4
 
5
- **Version**: 1.5.0
6
- **Last Updated**: 2026-08-24
5
+ **Version**: 1.6.0
6
+ **Last Updated**: 2026-10-08
7
7
  **Applicability**: All software projects with code review processes
8
8
  **Scope**: universal
9
9
  **Industry Standards**: SWEBOK v4.0 Chapter 10
@@ -141,6 +141,7 @@ This standard provides a comprehensive checklist for reviewing code changes, ens
141
141
  - Test names describe scenarios
142
142
  - Assertions are clear
143
143
  - No flaky tests
144
+ - Expected values are independent of the code under test: a literal, a hand-computed example or the spec — not the same call repeated, not the same arithmetic typed again (see [Forbidden: Tautology Assertions](full-coverage-testing.md))
144
145
 
145
146
  - [ ] **Test coverage maintained**
146
147
  - Coverage not decreased
@@ -247,6 +248,19 @@ This standard provides a comprehensive checklist for reviewing code changes, ens
247
248
 
248
249
  ---
249
250
 
251
+ ### 11. Merge Danger (Reversibility)
252
+
253
+ - [ ] **The change states its door and its blast radius**
254
+ - **Two-way door**: after merging, it can be taken back easily
255
+ - **One-way door**: it cannot be undone, or only with difficulty — a data migration, a deletion, a changed default behavior, a changed exit code, a renamed public interface
256
+ - **Blast radius**: one word for how far it reaches (for example `docs`, `cli`, `adopters`)
257
+
258
+ - [ ] **A one-way door is known to the decision-maker before the merge**
259
+ - Whoever decides to merge has been told, in the PR description or the hand-off report, that this change cannot be easily undone
260
+ - If the field is missing, ask for it; do not infer the door from the diff alone
261
+
262
+ ---
263
+
250
264
  ## Review Comment Types
251
265
 
252
266
  Use these prefixes to clarify comment intent:
@@ -320,6 +334,7 @@ For teams preferring plain text labels without emojis:
320
334
  1. Read PR description and linked issues
321
335
  2. Understand WHY the change is needed
322
336
  3. Review design/spec documents if linked
337
+ 4. Read the Merge Danger field (door and blast radius); for a one-way door, confirm the decision-maker knows before merging
323
338
 
324
339
  #### Step 2: High-Level Review
325
340
 
@@ -357,6 +372,7 @@ For teams preferring plain text labels without emojis:
357
372
  2. **Run tests locally**
358
373
  3. **Check CI status**
359
374
  4. **Write clear PR description**
375
+ 5. **State the Merge Danger** — door (two-way or one-way) and blast radius, in one word
360
376
 
361
377
  #### During Review
362
378
 
@@ -650,6 +666,7 @@ All PRs must pass:
650
666
  │ ✓ Errors - Properly handled? │
651
667
  │ ✓ Docs - Updated? │
652
668
  │ ✓ Dependencies - Necessary? │
669
+ │ ✓ Merge danger - One-way door told? │
653
670
  └─────────────────────────────────────────┘
654
671
 
655
672
  Comment Prefixes:
@@ -666,6 +683,7 @@ Comment Prefixes:
666
683
 
667
684
  | Version | Date | Changes |
668
685
  |---------|------|---------|
686
+ | 1.6.0 | 2026-10-08 | Added: Merge Danger (door and blast radius) as checklist item 11 and in the reviewer/author steps — a one-way door must be known to the decision-maker before merge; added to "Tests are good quality" that expected values are independent of the code under test (XSPEC-470 R1, R2) |
669
687
  | 1.5.0 | 2026-08-24 | Added: pointer to `deferred-item-exit` for non-blocking comments accepted without a change (XSPEC-391 R5) |
670
688
  | 1.4.0 | 2026-06-18 | Added: source + configurability note for PR-size/response-time thresholds (SmartBear/Cisco study, Google practices) + bulk-change exception (XSPEC-292 T8) |
671
689
  | 1.3.0 | 2026-01-12 | Added: Comprehensive Refactoring PRs section with pre-review checklist, review focus areas, large refactoring guidelines, red flags, and best practices |
@@ -2,8 +2,8 @@
2
2
 
3
3
  > **Language**: English | [繁體中文](../locales/zh-TW/core/commit-message-guide.md)
4
4
 
5
- **Version**: 1.3.0
6
- **Last Updated**: 2025-12-24
5
+ **Version**: 1.4.0
6
+ **Last Updated**: 2026-10-12
7
7
  **Applicability**: All projects using Git version control
8
8
  **Scope**: universal
9
9
  **Industry Standards**: Conventional Commits 1.0.0
@@ -64,22 +64,24 @@ Use English types for international teams and maximum tool compatibility.
64
64
 
65
65
  ### Option B: Traditional Chinese (Taiwanese Teams)
66
66
 
67
- Use Traditional Chinese types for local teams preferring native language commits.
68
-
69
- | Type | When to Use | English Equivalent |
70
- | ------ | -------------------- | ------------------ |
71
- | `新增` | New feature | feat |
72
- | `修正` | Bug fix | fix |
73
- | `重構` | Refactoring | refactor |
74
- | `文件` | Documentation only | docs |
75
- | `樣式` | Formatting only | style |
76
- | `測試` | Adding/updating tests | test |
77
- | `效能` | Performance | perf |
78
- | `建置` | Build system | build |
79
- | `整合` | CI/CD changes | ci |
80
- | `維護` | Maintenance | chore |
81
- | `回退` | Revert commit | revert |
82
- | `安全` | Security fix | security |
67
+ Use the **English types of Option A** with a Traditional Chinese subject and body, for local teams preferring native language commits. The type stays English because tools read it (commitlint `type-enum`, changelog generators, `uds simulate`); only the subject and body are Chinese. A Chinese type such as `新增` is **not** allowed.
68
+
69
+ | Type | When to Use | Example |
70
+ | ---------- | --------------------- | --------------------------------- |
71
+ | `feat` | New feature | `feat(auth): 加入 OAuth2 登入` |
72
+ | `fix` | Bug fix | `fix(api): 處理空值回應` |
73
+ | `refactor` | Refactoring | `refactor(core): 簡化驗證邏輯` |
74
+ | `docs` | Documentation only | `docs(readme): 更新安裝指南` |
75
+ | `style` | Formatting only | `style(lint): 修正縮排` |
76
+ | `test` | Adding/updating tests | `test(auth): 新增登入單元測試` |
77
+ | `perf` | Performance | `perf(query): 最佳化資料庫查詢` |
78
+ | `build` | Build system | `build(deps): 升級 lodash` |
79
+ | `ci` | CI/CD changes | `ci(github): 新增覆蓋率工作流程` |
80
+ | `chore` | Maintenance | `chore(deps): 更新開發相依套件` |
81
+ | `revert` | Revert commit | `revert: feat(auth): 加入 OAuth2 登入` |
82
+ | `security` | Security fix | `security(auth): 修正 XSS 漏洞` |
83
+
84
+ > **Changed in 1.4.0** (XSPEC-475): earlier versions of this option listed Chinese types (`新增`, `修正`, ...). They are no longer allowed; a project that used them migrates by replacing the type with its English equivalent (`新增` → `feat`, `修正` → `fix`, `重構` → `refactor`, `文件` → `docs`, `樣式` → `style`, `測試` → `test`, `效能` → `perf`, `建置` → `build`, `整合` → `ci`, `維護` → `chore`, `回退` → `revert`, `安全` → `security`).
83
85
 
84
86
  ### Option C: Bilingual Mode (Recommended)
85
87
 
@@ -151,7 +153,7 @@ Use this guide to choose the appropriate commit message language for your projec
151
153
  This project uses **English** commit types (feat, fix, refactor, etc.)
152
154
 
153
155
  <!-- Option B: Traditional Chinese -->
154
- This project uses **Traditional Chinese** commit types (新增, 修正, 重構, etc.)
156
+ This project uses **English** commit types (feat, fix, refactor, etc.) with **Traditional Chinese** subjects and bodies
155
157
 
156
158
  <!-- Option C: Bilingual Mode -->
157
159
  This project uses **Bilingual Mode** with English types/scopes and bilingual subject/body.
@@ -936,6 +938,7 @@ Closes #123
936
938
 
937
939
  | Version | Date | Changes |
938
940
  | ------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
941
+ | 1.4.0 | 2026-10-12 | Changed: Option B (Traditional Chinese) uses English types with Traditional Chinese subject and body; Chinese types (新增, 修正, ...) are no longer allowed (XSPEC-475 OQ1). Migration table added |
939
942
  | 1.3.0 | 2026-03-16 | Added: Spec reference footer convention (Refs: SPEC-XXX) |
940
943
  | 1.2.3 | 2025-12-24 | Added: Related Standards section |
941
944
  | 1.2.2 | 2025-12-16 | Added: Language selection guide with decision matrix and quick selection tips |
@@ -2,8 +2,8 @@
2
2
 
3
3
  > **Language**: English | [繁體中文](../locales/zh-TW/core/developer-memory.md)
4
4
 
5
- **Version**: 1.2.0
6
- **Last Updated**: 2026-09-25
5
+ **Version**: 1.2.1
6
+ **Last Updated**: 2026-10-07
7
7
  **Applicability**: All software projects using AI assistants
8
8
  **Scope**: universal
9
9
  **Owning Spec**: XSPEC-291 (developer-memory has no dedicated feature XSPEC; XSPEC-291 owns it)
@@ -641,10 +641,20 @@ A tool without a session-start hook still satisfies this standard through either
641
641
 
642
642
  ---
643
643
 
644
+ ## Boundary: What This Standard Does Not Hold
645
+
646
+ Two kinds of information are outside this standard, and writing them here is a mistake:
647
+
648
+ - **Personal, cross-project, identifiable facts** (who owns what, how to reach a particular environment). De-identification (see the schema above) would strip exactly these, so they cannot live in a memory entry. They belong in the memory of the user's own AI tool, which is bound to that user and that machine and is not shared.
649
+ - **Coordination between projects** (which piece of work is waiting on which other). That is open work, not memory: see [Open Work Tracking](open-work-tracking.md) (OWT-027–OWT-029).
650
+
651
+ ---
652
+
644
653
  ## Version History
645
654
 
646
655
  | Version | Date | Changes |
647
656
  |---------|------|---------|
657
+ | 1.2.1 | 2026-10-07 | Added: a Boundary section — personal, cross-project, identifiable facts and coordination between projects are not memory entries (XSPEC-460 R5; patch, no behavioral change) |
648
658
  | 1.2.0 | 2026-09-25 | Added: `code-reference` staleness check to Review (§3.4) — a memory citing a moved/missing file path or symbol is flagged before surfacing; reuses Knowledge Graph Memory's degraded/engine dual mode instead of inventing a third; `unresolvable` may not be read as present or missing; scope is file paths and symbol names only (`file:line` explicitly out of scope, DEC-115 OQ-1); §11 adds a non-normative Claude Code adoption example (DEC-115-L1) |
649
659
  | 1.1.1 | 2026-06-18 | Added: `Owning Spec` header pointing to XSPEC-291 (patch, no behavioral change; XSPEC-291 §11 disposition) |
650
660
  | 1.1.0 | 2026-06-18 | Added: rationale column + configurable note to Retirement Suggestions thresholds (XSPEC-292 T8) |
@@ -1,7 +1,7 @@
1
1
  # Full Coverage Testing Standards
2
2
 
3
3
  > **AI-optimized version**: `ai/standards/full-coverage-testing.ai.yaml`
4
- > **XSPEC**: XSPEC-178
4
+ > **XSPEC**: XSPEC-178, XSPEC-444 (R2, R5 — pre-commit warnings and shipped gate scripts), XSPEC-470 (R1 — tautology means "expected value not independent")
5
5
  > **Replaces**: Pyramid threshold model (UT≥80%, IT≥70%, E2E happy-path-only)
6
6
 
7
7
  ## Overview
@@ -50,18 +50,58 @@ Coverage improved: 91.3% → 92.0%. New baseline set.
50
50
 
51
51
  ### Forbidden: Tautology Assertions
52
52
 
53
- Assertions that always pass regardless of behavior provide false coverage.
53
+ An assertion that cannot disagree with the implementation provides false coverage. There are two kinds:
54
+
55
+ 1. **Always true** — it passes whatever the code does: `expect(true).toBe(true)`, `assert 200 == 200`.
56
+ 2. **Not independent** — the expected value is produced by the code under test, or by the same logic written a second time inside the test. It passes when the implementation is right, and it passes just as well when the implementation and the copy are wrong in the same way.
57
+
58
+ The second kind is defined with the vocabulary of [`verification-oracle`](verification-oracle.md): an assertion's **oracle** is the source that says what the right answer is, and a tautology is an assertion whose oracle *is the implementation itself*. This standard does not define "independent source of truth" a second time; it uses that standard's: a registered ground-truth case, a known literal, a hand-computed example, or the specification (see its *Oracle-ability Spectrum*).
54
59
 
55
60
  ```typescript
56
61
  // ❌ FORBIDDEN — always passes, tests nothing
57
62
  expect(true).toBe(true)
58
63
  expect(result).toBeDefined() // without specific value
59
64
 
60
- // ✅ REQUIRED — verifies actual behavior
65
+ // ❌ FORBIDDEN — the oracle is the implementation
66
+ expect(countInstalled(manifest)).toBe(countInstalled(manifest)) // the same call on both sides
67
+ expect(countInstalled(manifest)).toBe(manifest.standards.filter(s => s.installed).length) // the same logic, typed again
68
+ // ^ a reviewer's call: the scanner catches only the subset listed under "What the shipped scanner decides" below, and this one is not in it
69
+
70
+ // ✅ REQUIRED — a value that was decided before the code ran
61
71
  expect(result).toBe(90)
62
72
  expect(result).toEqual({ discount: 10, total: 90 })
73
+ expect(countInstalled({ standards: [{ id: 'a', installed: true }, { id: 'b', installed: false }] })).toBe(1)
63
74
  ```
64
75
 
76
+ Not every comparison of two computed values is a tautology. These are fine, and are **not** reported:
77
+
78
+ | Looks similar | Why it is a real test |
79
+ |---------------|-----------------------|
80
+ | `expect(snapshot(dir)).toEqual(before)` after an action | Asks "did anything change?" — the two values are taken at different moments |
81
+ | `expect(parse(a)).toEqual(parseWithOldEngine(a))` | A second, independently written implementation is the oracle |
82
+ | `expect(hash(x)).toBe(hash(x))` in a test named for determinism | Comparing two calls is the point of the test |
83
+ | `expect(report.total).toBe(rows.reduce(...))` where `report` comes from a different data path than `rows` | A reconciliation between two sources |
84
+
85
+ #### What the shipped scanner decides, and what stays a reviewer's question
86
+
87
+ `scripts/check-anti-fake-tests.mjs` (see "The two scanners" below) names the two shapes that can be decided from the text alone. It reads **JavaScript/TypeScript** (`toBe`, `toEqual`, `toStrictEqual`, chai `to.equal`/`to.eql`, node `assert.equal`/`strictEqual`/`deepEqual`/`deepStrictEqual`):
88
+
89
+ | Shape | Example | Reported when |
90
+ |-------|---------|---------------|
91
+ | **same call** | `expect(total(items)).toBe(total(items))` | both sides are the same call with the same arguments (and no other call or `new` inside the call), written in one statement, and the test is not named for comparing two calls (determinism, idempotence, caching, identity) |
92
+ | **recomputed** | `expect(total(items)).toBe(items.reduce((s, i) => s + i.price, 0))` | the call under test takes an input, and the expected value runs that same input (named as the argument itself, e.g. `items.reduce`, not a field of it) through `reduce`, `map`, `flatMap` or `filter` with a callback that uses nothing but its own parameters (plus pure built-ins such as `Math`, `Number`, `String`), holds no literal and is not a mere copy (`(x) => x`, `(x) => ({ ...x })`); the call under test is one call with no other call or `new` inside it and nothing after it such as `.length`. Only the text of the assertion is read: a name set on an earlier line is never looked through |
93
+
94
+ These look similar and are **left alone on purpose**, because the text cannot tell them from a sound test: `expect(priceOf(ids)).toEqual(ids.map(id => KNOWN_PRICES[id]))` (the expected value is read from a fixed table, an independent source); `expect(activeOf(users)).toEqual(users.filter(u => u.id === 2))` (the literal is knowledge the test author supplied); `expect(render(now())).toBe(render(now()))` (two calls to `now()` are two values, so the two sides are not known to be equal); `expect(parse(serialize(rows))).toEqual(rows.map(r => r))` (a round trip: there is a call inside the call under test); `expect(clone(input)).toEqual(input.map(x => x))` (a callback that only hands its parameter back, or a shallow copy of it such as `u => ({ ...u })`, or a destructured parameter put straight back in the same shape such as `([k, v]) => [k, v]`, is a copy and not logic; a `filter(x => x)`, which selects by truthiness, is logic, but it is left alone with them because the text cannot tell it from a copy); `expect(sortUsers(users).length).toBe(users.filter(u => u.name).length)` (the value under test is a property of the result, and which side is right cannot be read from the text). `const before = items.map(i => i.price); freezeCart(items); expect(pricesOf(items)).toEqual(before)` (a name set on an earlier line holds a value from an earlier moment, and what happened in between is what the test asks about; the same-call shape is read the same way). The rule is: when in doubt, miss it rather than accuse it.
95
+
96
+ **Two costs that are accepted, not hidden.**
97
+
98
+ 1. **Differential tests are named.** A test that uses a reference implementation as its oracle, `expect(fastTotal(items)).toBe(items.reduce((s, i) => s + i.price, 0))`, looks exactly like the textbook example, so the scanner names it. Such a test is legitimate (see the table above, "a second, independently written implementation"); the ways to settle it are: put one assertion against a hand-computed literal in the same test (a test is reported only when none of its assertions is a real one), or list the file under `ignore` in `.standards/test-policy.json` (this removes the whole file from every check of this scanner, and `ignore` takes no reason, so say why in a comment). A test name such as "matches the reference implementation" does **not** exempt it, and the `exempt` list does not apply to this scanner (it belongs to the code-without-a-test check).
99
+ 2. **The rule is easy to get around.** Wrapping the **value under test** in `Number(...)`, adding `.valueOf()` or `[0]` to it, or passing `items.slice()` instead of `items` is enough to stop the scanner from seeing it. (Doing the same to the **expected** value changes nothing: that is still named.) It is a prompt for the reviewer, not a gate that holds against someone who means to avoid it, and that includes an AI agent writing the test: do not read a clean scan as evidence that the expected values are independent. The reviewer's questions below are the control; the script only points at the cheapest cases.
100
+
101
+ As with `expect(true).toBe(true)`, a test is reported only when **none** of its assertions is a real one; a self-comparison next to an assertion against a literal is left to the reviewer. When the text cannot decide, the scanner stays silent — a scanner that cries wolf is switched off.
102
+
103
+ Everything else is a **reviewer's question**, asked in code review (see [Code Review Checklist](code-review-checklist.md)): Where did this expected value come from? Could it be produced by running the code under test? Would the test still pass if the implementation were wrong in the way the test's own arithmetic is wrong? Typical cases the scanner does not judge: a hand-written loop that re-derives the answer, a helper that wraps the implementation, a snapshot generated from the implementation's own first output, and every language other than JavaScript/TypeScript.
104
+
65
105
  ### Forbidden: Mocking Core Business Logic
66
106
 
67
107
  Mocking your own code means the business logic is never actually executed.
@@ -228,6 +268,60 @@ Axis ⑨ is satisfied when this section declares all three: **derive** (Step 1 m
228
268
 
229
269
  ---
230
270
 
271
+ ## Pre-commit Warnings and Gate Scripts Shipped by UDS (XSPEC-444 R2, R5)
272
+
273
+ The rules above used to depend on scripts the standard told you to write yourself. `uds init` now writes the scanners for you, and `uds check` — the command UDS's pre-commit hook runs — prints what they and one more check find. **All of it warns by default and blocks nothing**; tightening is opt-in (see "Warn first, tighten later").
274
+
275
+ ### The two scanners (`uds init` writes them to `scripts/`)
276
+
277
+ | Script | Finds |
278
+ |--------|-------|
279
+ | `scripts/check-anti-fake-tests.mjs` | a test with **no assertion**; a test whose only assertions are **tautologies** (`expect(true).toBe(true)`, `assert 200 == 200`; in JavaScript/TypeScript also an expected value that is the same call as the code under test, or is recomputed from the same input with `reduce`/`map`/`filter` — see "Forbidden: Tautology Assertions"); a test file in which **every test is skipped or todo** |
280
+ | `scripts/check-stubs.mjs` | `// WARNING: STUB` markers; a body that says it is **not implemented** (`raise NotImplementedError`, `todo!()`, `TODO()` ...) with no marker beside it; a named function whose body is **empty** with no marker beside it |
281
+
282
+ - Pure Node, no dependencies, no test framework assumed. They are **your files**: edit them, wire them into CI. Run on its own, each exits non-zero when it finds something — `node scripts/check-stubs.mjs` is the pre-push/deploy gate this standard's deployment gates describe.
283
+ - `uds init` never overwrites a file that exists, and `uds update` never overwrites one either; for a project initialised earlier, `uds update` offers to write them (the prompt defaults to no; `uds update -y` answers it yes).
284
+ - With files staged they read only those files; with nothing staged (a CI run, a manual `uds check`) each walks the whole project — the walk stops at 200,000 files, and `uds check` gives each scanner 120 seconds (past that it reports "could not judge", never a pass) — so in a very large repository run them in CI rather than expecting them to be instant.
285
+ - A placeholder is *declared* by `STUB` or `COVERAGE_EXEMPT` on its line or the three above; a declared placeholder is reported once, as its marker.
286
+ - **Languages.** Test-file rules exist for JavaScript/TypeScript, Python, Java/Kotlin/Scala/C#, Go, Rust, Ruby, Elixir, PHP, Swift, Dart, Lua and C/C++. A test file in any **other** language is listed as "NOT scanned" — never counted as clean. Empty-function rules exist for JavaScript/TypeScript, Python, Go, Rust, Ruby and PHP; elsewhere markers and "not implemented" bodies are still found and the output says which languages had no empty-function rule.
287
+ - They read text; they do not run your tests. A helper that asserts under a name the scanner cannot recognise is reported as "no-assertion": name it `assert*` / `verify*` / `expect*`, or list its pattern under `assertionPatterns` in the policy file.
288
+ - Each run first checks itself against known fakes and known good tests; if that fails it exits `2` ("could not judge"), which is never a pass.
289
+
290
+ ### Code changed without a test (`uds check`, on staged changes)
291
+
292
+ When files are staged for commit, `uds check` compares what changed:
293
+
294
+ - code files changed and **no test file** changed in the same commit → a warning that lists the code files;
295
+ - a changed file of a type UDS does not recognise → a warning that lists it and says how to classify it (never assumed fine, never blocks);
296
+ - a deletion is not a change that needs a test; a **pure rename** (git's `R100`) and a path matching an `exempt` entry are exempt, and the output records the reason.
297
+
298
+ With nothing staged (a CI run, a manual `uds check`) the diff check says nothing; the two scanners then look at the whole project.
299
+
300
+ ### The policy file `.standards/test-policy.json` (optional)
301
+
302
+ Which paths are tests and which are code is data with defaults for the common ecosystems, not a list of frameworks. Every list **adds to** the defaults:
303
+
304
+ ```json
305
+ {
306
+ "mode": "warn",
307
+ "testDirs": ["integration"],
308
+ "testPatterns": ["*.itest.*"],
309
+ "sourceExtensions": ["zig"],
310
+ "nonCodeExtensions": ["gradle"],
311
+ "ignore": ["generated/**"],
312
+ "exempt": [{ "pattern": "src/gen/**", "reason": "generated by protoc" }],
313
+ "assertionPatterns": ["\\bmustMatch\\w*\\s*\\("]
314
+ }
315
+ ```
316
+
317
+ An `exempt` entry without a `reason` is not honored and is reported: an exemption must say why.
318
+
319
+ ### Warn first, tighten later
320
+
321
+ `"mode": "warn"` (the default) prints and lets the commit through. `"mode": "block"` makes `uds check` exit non-zero — and so stops the commit — when a scanner finds something, a scanner cannot judge, or code changed without a test. A file type UDS does not recognise never blocks. **Not implemented yet** (the specification does not say where a baseline would live or what it counts): a ratchet on the number of unpaired changes, and a per-commit exemption reason (a pre-commit hook cannot read the commit message).
322
+
323
+ ---
324
+
231
325
  ## Migration from Pyramid Model
232
326
 
233
327
  If your project previously used pyramid thresholds:
@@ -235,8 +329,8 @@ If your project previously used pyramid thresholds:
235
329
  1. **Delete** any hardcoded coverage thresholds from `jest.config.js` / `vitest.config.ts` (`coverageThreshold` option)
236
330
  2. **Install** `.coverage-baseline.json` with current coverage as the starting ratchet
237
331
  3. **Add** `scripts/check-coverage-ratchet.sh` to CI
238
- 4. **Add** `scripts/check-stubs.sh` to deploy.sh and pre-push hook
239
- 5. **Add** `scripts/check-anti-fake-tests.sh` to pre-commit or CI
332
+ 4. **Add** `scripts/check-stubs.mjs` to deploy.sh and pre-push hook (written by `uds init`; `uds update` offers it to an existing project)
333
+ 5. **Add** `scripts/check-anti-fake-tests.mjs` to pre-commit or CI (written by `uds init`; `uds check` already runs it and warns)
240
334
 
241
335
  The ratchet starts at your current coverage. From that point on, it can only increase.
242
336