universal-dev-standards 5.16.0 → 6.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (540) hide show
  1. package/bin/uds.js +13 -135
  2. package/bundled/ai/standards/acceptance-criteria-traceability.ai.yaml +13 -4
  3. package/bundled/ai/standards/accessibility-standards.ai.yaml +1 -1
  4. package/bundled/ai/standards/ai-response-navigation.ai.yaml +15 -2
  5. package/bundled/ai/standards/api-design-standards.ai.yaml +27 -4
  6. package/bundled/ai/standards/behavior-snapshot.ai.yaml +86 -9
  7. package/bundled/ai/standards/checkin-standards.ai.yaml +2 -2
  8. package/bundled/ai/standards/code-review.ai.yaml +2 -2
  9. package/bundled/ai/standards/context-aware-loading.ai.yaml +3 -3
  10. package/bundled/ai/standards/data-migration-testing.ai.yaml +79 -3
  11. package/bundled/ai/standards/deprecation-standards.ai.yaml +10 -2
  12. package/bundled/ai/standards/developer-memory.ai.yaml +4 -3
  13. package/bundled/ai/standards/flow-based-testing.ai.yaml +2 -2
  14. package/bundled/ai/standards/forward-derivation-standards.ai.yaml +26 -2
  15. package/bundled/ai/standards/full-coverage-testing.ai.yaml +34 -2
  16. package/bundled/ai/standards/git-worktree.ai.yaml +3 -3
  17. package/bundled/ai/standards/logging.ai.yaml +97 -3
  18. package/bundled/ai/standards/mock-boundary.ai.yaml +48 -2
  19. package/bundled/ai/standards/model-provenance.ai.yaml +297 -0
  20. package/bundled/ai/standards/model-selection.ai.yaml +11 -2
  21. package/bundled/ai/standards/observability-standards.ai.yaml +10 -0
  22. package/bundled/ai/standards/performance-standards.ai.yaml +46 -1
  23. package/bundled/ai/standards/pii-classification.ai.yaml +15 -1
  24. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +10 -0
  25. package/bundled/ai/standards/privacy-standards.ai.yaml +2 -2
  26. package/bundled/ai/standards/project-context-memory.ai.yaml +2 -2
  27. package/bundled/ai/standards/refactoring-standards.ai.yaml +68 -3
  28. package/bundled/ai/standards/resource-cost-boundary.ai.yaml +279 -0
  29. package/bundled/ai/standards/reverse-engineering-standards.ai.yaml +55 -2
  30. package/bundled/ai/standards/security-testing.ai.yaml +13 -2
  31. package/bundled/ai/standards/skill-standard-alignment-check.ai.yaml +37 -2
  32. package/bundled/ai/standards/user-journey-testing.ai.yaml +107 -0
  33. package/bundled/ai/standards/verification-oracle.ai.yaml +278 -0
  34. package/bundled/ai/standards/versioning.ai.yaml +32 -38
  35. package/bundled/core/acceptance-criteria-traceability.md +15 -5
  36. package/bundled/core/accessibility-standards.md +8 -4
  37. package/bundled/core/ai-friendly-architecture.md +1 -1
  38. package/bundled/core/ai-response-navigation.md +31 -3
  39. package/bundled/core/anti-sycophancy-prompting.md +1 -1
  40. package/bundled/core/api-design-standards.md +92 -7
  41. package/bundled/core/audit-trail.md +119 -0
  42. package/bundled/core/behavior-snapshot.md +94 -7
  43. package/bundled/core/browser-compatibility-standards.md +15 -2
  44. package/bundled/core/checkin-standards.md +9 -2
  45. package/bundled/core/code-review-checklist.md +10 -2
  46. package/bundled/core/container-image-standards.md +97 -0
  47. package/bundled/core/context-aware-loading.md +2 -2
  48. package/bundled/core/cost-budget-test.md +1 -1
  49. package/bundled/core/cross-flow-regression.md +3 -2
  50. package/bundled/core/data-contract.md +104 -0
  51. package/bundled/core/data-migration-testing.md +90 -0
  52. package/bundled/core/data-pipeline.md +113 -0
  53. package/bundled/core/deprecation-standards.md +16 -2
  54. package/bundled/core/developer-memory.md +13 -8
  55. package/bundled/core/documentation-writing-standards.md +1 -1
  56. package/bundled/core/error-code-standards.md +4 -3
  57. package/bundled/core/flaky-test-management.md +1 -1
  58. package/bundled/core/flow-based-testing.md +3 -3
  59. package/bundled/core/forward-derivation-standards.md +33 -5
  60. package/bundled/core/full-coverage-testing.md +72 -0
  61. package/bundled/core/git-worktree.md +4 -4
  62. package/bundled/core/guides/performance-guide.md +1 -1
  63. package/bundled/core/guides/security-guide.md +1 -1
  64. package/bundled/core/health-check-standards.md +2 -2
  65. package/bundled/core/iac-design-principles.md +97 -0
  66. package/bundled/core/incident-response.md +119 -0
  67. package/bundled/core/license-compliance.md +2 -0
  68. package/bundled/core/logging-standards.md +78 -2
  69. package/bundled/core/mock-boundary.md +54 -2
  70. package/bundled/core/model-provenance.md +181 -0
  71. package/bundled/core/model-selection.md +27 -2
  72. package/bundled/core/packaging-standards.md +1 -0
  73. package/bundled/core/performance-standards.md +96 -2
  74. package/bundled/core/pii-classification.md +148 -0
  75. package/bundled/core/pipeline-security-gates.md +22 -2
  76. package/bundled/core/postmortem-standards.md +2 -0
  77. package/bundled/core/prd-standards.md +91 -0
  78. package/bundled/core/privacy-standards.md +14 -3
  79. package/bundled/core/product-metrics-standards.md +100 -0
  80. package/bundled/core/project-context-memory.md +8 -2
  81. package/bundled/core/prompt-regression.md +1 -1
  82. package/bundled/core/refactoring-standards.md +44 -3
  83. package/bundled/core/replay-test.md +1 -1
  84. package/bundled/core/resource-cost-boundary.md +180 -0
  85. package/bundled/core/reverse-engineering-standards.md +66 -2
  86. package/bundled/core/runbook.md +113 -0
  87. package/bundled/core/schema-evolution.md +105 -0
  88. package/bundled/core/secret-management-standards.md +110 -0
  89. package/bundled/core/security-testing.md +26 -2
  90. package/bundled/core/self-review-protocol.md +2 -2
  91. package/bundled/core/skill-standard-alignment-check.md +53 -0
  92. package/bundled/core/slo-sli.md +109 -0
  93. package/bundled/core/smoke-test.md +1 -1
  94. package/bundled/core/spec-driven-development.md +21 -3
  95. package/bundled/core/tech-debt-standards.md +1 -1
  96. package/bundled/core/test-data-standards.md +2 -2
  97. package/bundled/core/user-journey-testing.md +102 -0
  98. package/bundled/core/user-story-mapping.md +96 -0
  99. package/bundled/core/verification-oracle.md +167 -0
  100. package/bundled/core/versioning.md +133 -109
  101. package/bundled/locales/COVERAGE.md +84 -73
  102. package/bundled/locales/zh-CN/CHANGELOG.md +81 -6
  103. package/bundled/locales/zh-CN/CLAUDE.md +1 -1
  104. package/bundled/locales/zh-CN/README.md +22 -9
  105. package/bundled/locales/zh-CN/SECURITY.md +1 -1
  106. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -2
  107. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +4 -6
  108. package/bundled/locales/zh-CN/core/accessibility-standards.md +1 -1
  109. package/bundled/locales/zh-CN/core/adversarial-test.md +226 -0
  110. package/bundled/locales/zh-CN/core/agent-behavior-discipline.md +187 -0
  111. package/bundled/locales/zh-CN/core/ai-response-navigation.md +32 -6
  112. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +1 -1
  113. package/bundled/locales/zh-CN/core/api-design-standards.md +1 -1
  114. package/bundled/locales/zh-CN/core/behavior-snapshot.md +335 -0
  115. package/bundled/locales/zh-CN/core/browser-compatibility-standards.md +229 -0
  116. package/bundled/locales/zh-CN/core/cd-deployment-strategies.md +135 -0
  117. package/bundled/locales/zh-CN/core/chaos-injection-tests.md +130 -0
  118. package/bundled/locales/zh-CN/core/checkin-standards.md +1 -1
  119. package/bundled/locales/zh-CN/core/code-review-checklist.md +1 -1
  120. package/bundled/locales/zh-CN/core/container-security.md +535 -0
  121. package/bundled/locales/zh-CN/core/context-aware-loading.md +1 -1
  122. package/bundled/locales/zh-CN/core/contract-testing-standards.md +191 -0
  123. package/bundled/locales/zh-CN/core/cost-budget-test.md +86 -0
  124. package/bundled/locales/zh-CN/core/cross-flow-regression.md +199 -0
  125. package/bundled/locales/zh-CN/core/data-migration-testing.md +217 -0
  126. package/bundled/locales/zh-CN/core/deployment-standards.md +328 -9
  127. package/bundled/locales/zh-CN/core/deprecation-standards.md +1 -1
  128. package/bundled/locales/zh-CN/core/developer-memory.md +2 -2
  129. package/bundled/locales/zh-CN/core/disaster-recovery-drill.md +87 -0
  130. package/bundled/locales/zh-CN/core/documentation-structure.md +1 -1
  131. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +1 -1
  132. package/bundled/locales/zh-CN/core/error-code-standards.md +2 -2
  133. package/bundled/locales/zh-CN/core/feature-manifest-standard.md +222 -0
  134. package/bundled/locales/zh-CN/core/flaky-test-management.md +87 -0
  135. package/bundled/locales/zh-CN/core/flow-based-testing.md +284 -0
  136. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +3 -4
  137. package/bundled/locales/zh-CN/core/full-coverage-testing.md +197 -0
  138. package/bundled/locales/zh-CN/core/git-worktree.md +1 -1
  139. package/bundled/locales/zh-CN/core/governance-layer.md +160 -0
  140. package/bundled/locales/zh-CN/core/guides/performance-guide.md +515 -0
  141. package/bundled/locales/zh-CN/core/guides/security-guide.md +494 -0
  142. package/bundled/locales/zh-CN/core/knowledge-graph-memory.md +128 -0
  143. package/bundled/locales/zh-CN/core/license-compliance.md +129 -0
  144. package/bundled/locales/zh-CN/core/llm-output-validation.md +192 -0
  145. package/bundled/locales/zh-CN/core/logging-standards.md +130 -8
  146. package/bundled/locales/zh-CN/core/mock-boundary.md +109 -0
  147. package/bundled/locales/zh-CN/core/model-selection.md +28 -5
  148. package/bundled/locales/zh-CN/core/mutation-testing.md +106 -0
  149. package/bundled/locales/zh-CN/core/no-cicd-deployment.md +219 -0
  150. package/bundled/locales/zh-CN/core/packaging-standards.md +76 -5
  151. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +126 -0
  152. package/bundled/locales/zh-CN/core/policy-as-code-testing.md +203 -0
  153. package/bundled/locales/zh-CN/core/privacy-standards.md +1 -1
  154. package/bundled/locales/zh-CN/core/project-context-memory.md +1 -1
  155. package/bundled/locales/zh-CN/core/prompt-regression.md +88 -0
  156. package/bundled/locales/zh-CN/core/property-based-testing.md +87 -0
  157. package/bundled/locales/zh-CN/core/release-quality-manifest.md +207 -0
  158. package/bundled/locales/zh-CN/core/release-readiness-gate.md +193 -0
  159. package/bundled/locales/zh-CN/core/replay-test.md +102 -0
  160. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +46 -1
  161. package/bundled/locales/zh-CN/core/rollback-standards.md +120 -0
  162. package/bundled/locales/zh-CN/core/sast-advanced.md +309 -0
  163. package/bundled/locales/zh-CN/core/secure-op.md +328 -0
  164. package/bundled/locales/zh-CN/core/security-testing.md +96 -0
  165. package/bundled/locales/zh-CN/core/self-review-protocol.md +167 -0
  166. package/bundled/locales/zh-CN/core/server-ops-security.md +507 -0
  167. package/bundled/locales/zh-CN/core/smoke-test.md +79 -0
  168. package/bundled/locales/zh-CN/core/spec-driven-development.md +55 -5
  169. package/bundled/locales/zh-CN/core/supply-chain-attestation.md +131 -0
  170. package/bundled/locales/zh-CN/core/versioning.md +1 -1
  171. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +31 -6
  172. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +61 -34
  173. package/bundled/locales/zh-CN/docs/MIGRATION-v6.md +88 -0
  174. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +2 -2
  175. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +14 -14
  176. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +105 -0
  177. package/bundled/locales/zh-CN/docs/user/FAQ.md +132 -0
  178. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +144 -0
  179. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +178 -0
  180. package/bundled/locales/zh-CN/docs/user/README.md +70 -0
  181. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +190 -0
  182. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +1 -1
  183. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +1 -1
  184. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +3 -3
  185. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +3 -3
  186. package/bundled/locales/zh-CN/methodologies/guides/sdd-guide.md +836 -0
  187. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +166 -0
  188. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +140 -0
  189. package/bundled/locales/zh-CN/options/code-review/automated-review.md +214 -0
  190. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +166 -0
  191. package/bundled/locales/zh-CN/options/code-review/pr-review.md +167 -0
  192. package/bundled/locales/zh-CN/options/documentation/api-docs.md +191 -0
  193. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +150 -0
  194. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +131 -0
  195. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +144 -0
  196. package/bundled/locales/zh-CN/options/project-structure/php.md +168 -0
  197. package/bundled/locales/zh-CN/options/project-structure/ruby.md +156 -0
  198. package/bundled/locales/zh-CN/options/project-structure/rust.md +136 -0
  199. package/bundled/locales/zh-CN/options/project-structure/swift.md +165 -0
  200. package/bundled/locales/zh-CN/options/testing/contract-testing.md +237 -0
  201. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +200 -0
  202. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +144 -0
  203. package/bundled/locales/zh-CN/options/testing/performance-testing.md +251 -0
  204. package/bundled/locales/zh-CN/options/testing/security-testing.md +192 -0
  205. package/bundled/locales/zh-CN/skills/README.md +89 -126
  206. package/bundled/locales/zh-CN/skills/ac-coverage/SKILL.md +5 -7
  207. package/bundled/locales/zh-CN/skills/adr-assistant/SKILL.md +1 -1
  208. package/bundled/locales/zh-CN/skills/agents/code-architect.md +263 -0
  209. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +410 -0
  210. package/bundled/locales/zh-CN/skills/agents/reviewer.md +357 -0
  211. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +410 -0
  212. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +368 -0
  213. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +2 -2
  214. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +2 -2
  215. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +1 -1
  216. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +1 -1
  217. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +3 -4
  218. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +2 -2
  219. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +1 -2
  220. package/bundled/locales/zh-CN/skills/brainstorm-assistant/SKILL.md +109 -13
  221. package/bundled/locales/zh-CN/skills/brainstorm-assistant/guide.md +30 -8
  222. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +1 -1
  223. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +50 -0
  224. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +5 -5
  225. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +1 -1
  226. package/bundled/locales/zh-CN/skills/commands/atdd.md +3 -3
  227. package/bundled/locales/zh-CN/skills/commands/bdd.md +2 -2
  228. package/bundled/locales/zh-CN/skills/commands/brainstorm.md +26 -17
  229. package/bundled/locales/zh-CN/skills/commands/{review.md → code-review.md} +4 -4
  230. package/bundled/locales/zh-CN/skills/commands/derive-all.md +1 -1
  231. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +1 -1
  232. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +2 -3
  233. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +1 -1
  234. package/bundled/locales/zh-CN/skills/commands/derive.md +1 -1
  235. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +2 -2
  236. package/bundled/locales/zh-CN/skills/commands/methodology.md +4 -4
  237. package/bundled/locales/zh-CN/skills/commands/pr.md +1 -1
  238. package/bundled/locales/zh-CN/skills/commands/tdd.md +1 -1
  239. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +1 -1
  240. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +1 -1
  241. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +1 -1
  242. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +456 -0
  243. package/bundled/locales/zh-CN/skills/dev-methodology/guide.md +6 -6
  244. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +296 -0
  245. package/bundled/locales/zh-CN/skills/dev-workflow-guide/SKILL.md +5 -5
  246. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +1 -1
  247. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +1 -1
  248. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +2 -2
  249. package/bundled/locales/zh-CN/skills/journey-test-assistant/SKILL.md +1 -1
  250. package/bundled/locales/zh-CN/skills/logging-guide/SKILL.md +146 -142
  251. package/bundled/locales/zh-CN/skills/migration-assistant/SKILL.md +1 -1
  252. package/bundled/locales/zh-CN/skills/observability-assistant/guide.md +1 -1
  253. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +1 -1
  254. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +2 -2
  255. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +1 -1
  256. package/bundled/locales/zh-CN/skills/runbook-assistant/guide.md +1 -1
  257. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +1 -1
  258. package/bundled/locales/zh-CN/skills/skill-builder/SKILL.md +3 -3
  259. package/bundled/locales/zh-CN/skills/slo-assistant/guide.md +1 -1
  260. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +1 -1
  261. package/bundled/locales/zh-CN/skills/spec-derivation/guide.md +8 -9
  262. package/bundled/locales/zh-CN/skills/spec-driven-dev/SKILL.md +2 -2
  263. package/bundled/locales/zh-CN/skills/sweep/SKILL.md +1 -1
  264. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +1 -1
  265. package/bundled/locales/zh-CN/skills/testing-guide/SKILL.md +2 -2
  266. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +2298 -0
  267. package/bundled/locales/zh-CN/skills/workflows/README.md +451 -0
  268. package/bundled/locales/zh-TW/CHANGELOG.md +81 -6
  269. package/bundled/locales/zh-TW/CLAUDE.md +1 -1
  270. package/bundled/locales/zh-TW/MAINTENANCE.md +25 -2
  271. package/bundled/locales/zh-TW/README.md +22 -9
  272. package/bundled/locales/zh-TW/SECURITY.md +1 -1
  273. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -2
  274. package/bundled/locales/zh-TW/ai/standards/versioning.ai.yaml +8 -48
  275. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +4 -6
  276. package/bundled/locales/zh-TW/core/accessibility-standards.md +1 -1
  277. package/bundled/locales/zh-TW/core/adversarial-test.md +226 -0
  278. package/bundled/locales/zh-TW/core/agent-behavior-discipline.md +187 -0
  279. package/bundled/locales/zh-TW/core/ai-response-navigation.md +32 -6
  280. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +1 -1
  281. package/bundled/locales/zh-TW/core/api-design-standards.md +91 -9
  282. package/bundled/locales/zh-TW/core/audit-trail.md +110 -0
  283. package/bundled/locales/zh-TW/core/behavior-snapshot.md +335 -0
  284. package/bundled/locales/zh-TW/core/browser-compatibility-standards.md +1 -0
  285. package/bundled/locales/zh-TW/core/cd-deployment-strategies.md +135 -0
  286. package/bundled/locales/zh-TW/core/chaos-injection-tests.md +130 -0
  287. package/bundled/locales/zh-TW/core/checkin-standards.md +1 -1
  288. package/bundled/locales/zh-TW/core/code-review-checklist.md +1 -1
  289. package/bundled/locales/zh-TW/core/container-image-standards.md +93 -0
  290. package/bundled/locales/zh-TW/core/container-security.md +535 -0
  291. package/bundled/locales/zh-TW/core/cost-budget-test.md +86 -0
  292. package/bundled/locales/zh-TW/core/cross-flow-regression.md +1 -0
  293. package/bundled/locales/zh-TW/core/data-contract.md +101 -0
  294. package/bundled/locales/zh-TW/core/data-migration-testing.md +217 -0
  295. package/bundled/locales/zh-TW/core/data-pipeline.md +105 -0
  296. package/bundled/locales/zh-TW/core/deployment-standards.md +363 -25
  297. package/bundled/locales/zh-TW/core/deprecation-standards.md +17 -4
  298. package/bundled/locales/zh-TW/core/developer-memory.md +2 -2
  299. package/bundled/locales/zh-TW/core/disaster-recovery-drill.md +87 -0
  300. package/bundled/locales/zh-TW/core/documentation-writing-standards.md +1 -1
  301. package/bundled/locales/zh-TW/core/error-code-standards.md +2 -2
  302. package/bundled/locales/zh-TW/core/feature-manifest-standard.md +222 -0
  303. package/bundled/locales/zh-TW/core/flaky-test-management.md +87 -0
  304. package/bundled/locales/zh-TW/core/flow-based-testing.md +284 -0
  305. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +3 -4
  306. package/bundled/locales/zh-TW/core/full-coverage-testing.md +250 -0
  307. package/bundled/locales/zh-TW/core/git-worktree.md +1 -1
  308. package/bundled/locales/zh-TW/core/guides/performance-guide.md +515 -0
  309. package/bundled/locales/zh-TW/core/guides/security-guide.md +494 -0
  310. package/bundled/locales/zh-TW/core/iac-design-principles.md +90 -0
  311. package/bundled/locales/zh-TW/core/incident-response.md +111 -0
  312. package/bundled/locales/zh-TW/core/license-compliance.md +129 -0
  313. package/bundled/locales/zh-TW/core/llm-output-validation.md +192 -0
  314. package/bundled/locales/zh-TW/core/logging-standards.md +208 -4
  315. package/bundled/locales/zh-TW/core/mock-boundary.md +161 -0
  316. package/bundled/locales/zh-TW/core/model-provenance.md +173 -0
  317. package/bundled/locales/zh-TW/core/model-selection.md +28 -5
  318. package/bundled/locales/zh-TW/core/mutation-testing.md +106 -0
  319. package/bundled/locales/zh-TW/core/no-cicd-deployment.md +219 -0
  320. package/bundled/locales/zh-TW/core/packaging-standards.md +76 -5
  321. package/bundled/locales/zh-TW/core/performance-standards.md +84 -5
  322. package/bundled/locales/zh-TW/core/pii-classification.md +102 -0
  323. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +126 -0
  324. package/bundled/locales/zh-TW/core/policy-as-code-testing.md +203 -0
  325. package/bundled/locales/zh-TW/core/prd-standards.md +88 -0
  326. package/bundled/locales/zh-TW/core/privacy-standards.md +1 -1
  327. package/bundled/locales/zh-TW/core/product-metrics-standards.md +96 -0
  328. package/bundled/locales/zh-TW/core/project-context-memory.md +1 -1
  329. package/bundled/locales/zh-TW/core/prompt-regression.md +88 -0
  330. package/bundled/locales/zh-TW/core/property-based-testing.md +87 -0
  331. package/bundled/locales/zh-TW/core/refactoring-standards.md +43 -6
  332. package/bundled/locales/zh-TW/core/release-quality-manifest.md +207 -0
  333. package/bundled/locales/zh-TW/core/replay-test.md +102 -0
  334. package/bundled/locales/zh-TW/core/resource-cost-boundary.md +175 -0
  335. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +64 -5
  336. package/bundled/locales/zh-TW/core/rollback-standards.md +120 -0
  337. package/bundled/locales/zh-TW/core/runbook.md +110 -0
  338. package/bundled/locales/zh-TW/core/sast-advanced.md +309 -0
  339. package/bundled/locales/zh-TW/core/schema-evolution.md +98 -0
  340. package/bundled/locales/zh-TW/core/secret-management-standards.md +101 -0
  341. package/bundled/locales/zh-TW/core/secure-op.md +328 -0
  342. package/bundled/locales/zh-TW/core/security-testing.md +96 -0
  343. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -2
  344. package/bundled/locales/zh-TW/core/server-ops-security.md +507 -0
  345. package/bundled/locales/zh-TW/core/slo-sli.md +108 -0
  346. package/bundled/locales/zh-TW/core/smoke-test.md +79 -0
  347. package/bundled/locales/zh-TW/core/spec-driven-development.md +39 -13
  348. package/bundled/locales/zh-TW/core/supply-chain-attestation.md +131 -0
  349. package/bundled/locales/zh-TW/core/user-journey-testing.md +111 -0
  350. package/bundled/locales/zh-TW/core/user-story-mapping.md +94 -0
  351. package/bundled/locales/zh-TW/core/verification-oracle.md +159 -0
  352. package/bundled/locales/zh-TW/core/versioning.md +112 -112
  353. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +31 -6
  354. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +6 -6
  355. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +61 -34
  356. package/bundled/locales/zh-TW/docs/MIGRATION-v6.md +88 -0
  357. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -2
  358. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +14 -14
  359. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +105 -0
  360. package/bundled/locales/zh-TW/docs/user/FAQ.md +132 -0
  361. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +144 -0
  362. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +178 -0
  363. package/bundled/locales/zh-TW/docs/user/README.md +70 -0
  364. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +190 -0
  365. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +1 -1
  366. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +1 -1
  367. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +3 -3
  368. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +3 -3
  369. package/bundled/locales/zh-TW/methodologies/guides/sdd-guide.md +523 -26
  370. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +166 -0
  371. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +140 -0
  372. package/bundled/locales/zh-TW/options/code-review/automated-review.md +214 -0
  373. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +166 -0
  374. package/bundled/locales/zh-TW/options/code-review/pr-review.md +167 -0
  375. package/bundled/locales/zh-TW/options/documentation/api-docs.md +191 -0
  376. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +150 -0
  377. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +131 -0
  378. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +144 -0
  379. package/bundled/locales/zh-TW/options/project-structure/php.md +168 -0
  380. package/bundled/locales/zh-TW/options/project-structure/ruby.md +156 -0
  381. package/bundled/locales/zh-TW/options/project-structure/rust.md +136 -0
  382. package/bundled/locales/zh-TW/options/project-structure/swift.md +165 -0
  383. package/bundled/locales/zh-TW/options/testing/contract-testing.md +237 -0
  384. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +200 -0
  385. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +144 -0
  386. package/bundled/locales/zh-TW/options/testing/performance-testing.md +251 -0
  387. package/bundled/locales/zh-TW/options/testing/security-testing.md +192 -0
  388. package/bundled/locales/zh-TW/skills/README.md +91 -128
  389. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +4 -6
  390. package/bundled/locales/zh-TW/skills/adr-assistant/SKILL.md +1 -1
  391. package/bundled/locales/zh-TW/skills/agents/code-architect.md +263 -0
  392. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +410 -0
  393. package/bundled/locales/zh-TW/skills/agents/reviewer.md +357 -0
  394. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +410 -0
  395. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +368 -0
  396. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +2 -2
  397. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +2 -2
  398. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +1 -1
  399. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +2 -0
  400. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +1 -1
  401. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +3 -4
  402. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +2 -2
  403. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +2 -0
  404. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +1 -2
  405. package/bundled/locales/zh-TW/skills/brainstorm-assistant/SKILL.md +110 -14
  406. package/bundled/locales/zh-TW/skills/brainstorm-assistant/guide.md +31 -7
  407. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +3 -1
  408. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +50 -0
  409. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +7 -5
  410. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +1 -1
  411. package/bundled/locales/zh-TW/skills/commands/atdd.md +3 -3
  412. package/bundled/locales/zh-TW/skills/commands/bdd.md +2 -2
  413. package/bundled/locales/zh-TW/skills/commands/brainstorm.md +26 -17
  414. package/bundled/locales/zh-TW/skills/commands/{review.md → code-review.md} +5 -5
  415. package/bundled/locales/zh-TW/skills/commands/derive-all.md +1 -1
  416. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +1 -1
  417. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +2 -3
  418. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +1 -1
  419. package/bundled/locales/zh-TW/skills/commands/derive.md +1 -1
  420. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +2 -2
  421. package/bundled/locales/zh-TW/skills/commands/methodology.md +4 -4
  422. package/bundled/locales/zh-TW/skills/commands/pr.md +1 -1
  423. package/bundled/locales/zh-TW/skills/commands/tdd.md +1 -1
  424. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +1 -1
  425. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +1 -1
  426. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +456 -0
  427. package/bundled/locales/zh-TW/skills/dev-methodology/guide.md +5 -5
  428. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +296 -0
  429. package/bundled/locales/zh-TW/skills/dev-workflow-guide/SKILL.md +5 -5
  430. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +1 -1
  431. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +1 -1
  432. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +2 -2
  433. package/bundled/locales/zh-TW/skills/logging-guide/SKILL.md +29 -27
  434. package/bundled/locales/zh-TW/skills/migration-assistant/SKILL.md +1 -1
  435. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +3 -1
  436. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +2 -2
  437. package/bundled/locales/zh-TW/skills/reverse-engineer/SKILL.md +1 -1
  438. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +1 -1
  439. package/bundled/locales/zh-TW/skills/spec-derivation/guide.md +7 -8
  440. package/bundled/locales/zh-TW/skills/spec-driven-dev/SKILL.md +2 -2
  441. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +1 -1
  442. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +3 -1
  443. package/bundled/locales/zh-TW/skills/testing-guide/SKILL.md +2 -2
  444. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +2298 -0
  445. package/bundled/locales/zh-TW/skills/workflows/README.md +451 -0
  446. package/bundled/skills/README.md +1 -1
  447. package/bundled/skills/ac-coverage/SKILL.md +17 -7
  448. package/bundled/skills/adr-assistant/SKILL.md +1 -1
  449. package/bundled/skills/agents/code-architect.md +1 -1
  450. package/bundled/skills/agents/doc-writer.md +1 -1
  451. package/bundled/skills/agents/reviewer.md +2 -2
  452. package/bundled/skills/agents/spec-analyst.md +1 -1
  453. package/bundled/skills/agents/test-specialist.md +1 -1
  454. package/bundled/skills/ai-collaboration-standards/SKILL.md +2 -2
  455. package/bundled/skills/ai-friendly-architecture/SKILL.md +2 -2
  456. package/bundled/skills/ai-instruction-standards/SKILL.md +1 -1
  457. package/bundled/skills/atdd-assistant/SKILL.md +7 -0
  458. package/bundled/skills/atdd-assistant/acceptance-criteria-guide.md +1 -1
  459. package/bundled/skills/atdd-assistant/atdd-workflow.md +6 -8
  460. package/bundled/skills/audit-assistant/SKILL.md +2 -2
  461. package/bundled/skills/bdd-assistant/SKILL.md +7 -0
  462. package/bundled/skills/bdd-assistant/guide.md +1 -2
  463. package/bundled/skills/brainstorm-assistant/SKILL.md +133 -11
  464. package/bundled/skills/brainstorm-assistant/guide.md +33 -5
  465. package/bundled/skills/checkin-assistant/SKILL.md +8 -1
  466. package/bundled/skills/ci-cd-assistant/SKILL.md +57 -0
  467. package/bundled/skills/code-review-assistant/SKILL.md +15 -8
  468. package/bundled/skills/commands/COMMAND-FAMILY-OVERVIEW.md +2 -2
  469. package/bundled/skills/commands/COMMAND-INDEX.json +3 -3
  470. package/bundled/skills/commands/README.md +2 -2
  471. package/bundled/skills/commands/ac-coverage.md +1 -1
  472. package/bundled/skills/commands/atdd.md +2 -2
  473. package/bundled/skills/commands/bdd.md +2 -2
  474. package/bundled/skills/commands/brainstorm.md +25 -14
  475. package/bundled/skills/commands/{review.md → code-review.md} +6 -6
  476. package/bundled/skills/commands/derive-all.md +1 -1
  477. package/bundled/skills/commands/derive-atdd.md +1 -1
  478. package/bundled/skills/commands/derive-bdd.md +2 -3
  479. package/bundled/skills/commands/derive-tdd.md +1 -1
  480. package/bundled/skills/commands/derive.md +1 -1
  481. package/bundled/skills/commands/dev-workflow.md +1 -1
  482. package/bundled/skills/commands/journey-test.md +45 -0
  483. package/bundled/skills/commands/methodology.md +4 -4
  484. package/bundled/skills/commands/pr.md +1 -1
  485. package/bundled/skills/commands/skill-builder.md +42 -0
  486. package/bundled/skills/commands/tdd.md +1 -1
  487. package/bundled/skills/dev-methodology/create-methodology.md +1 -1
  488. package/bundled/skills/dev-methodology/guide.md +1 -1
  489. package/bundled/skills/dev-methodology/runtime.md +1 -1
  490. package/bundled/skills/dev-workflow-guide/SKILL.md +3 -3
  491. package/bundled/skills/dev-workflow-guide/workflow-phases.md +3 -3
  492. package/bundled/skills/docs-generator/SKILL.md +3 -3
  493. package/bundled/skills/incident-response-assistant/SKILL.md +2 -2
  494. package/bundled/skills/logging-guide/SKILL.md +38 -2
  495. package/bundled/skills/migration-assistant/SKILL.md +226 -0
  496. package/bundled/skills/observability-assistant/SKILL.md +74 -0
  497. package/bundled/skills/pr-automation-assistant/SKILL.md +5 -1
  498. package/bundled/skills/project-discovery/guide.md +2 -2
  499. package/bundled/skills/push/SKILL.md +1 -1
  500. package/bundled/skills/release-standards/SKILL.md +19 -5
  501. package/bundled/skills/security-assistant/SKILL.md +1 -1
  502. package/bundled/skills/skill-builder/SKILL.md +1 -1
  503. package/bundled/skills/spec-derivation/guide.md +3 -4
  504. package/bundled/skills/spec-driven-dev/SKILL.md +27 -0
  505. package/bundled/skills/sweep/SKILL.md +1 -1
  506. package/bundled/skills/tdd-assistant/SKILL.md +8 -1
  507. package/bundled/skills/testing-guide/SKILL.md +1 -1
  508. package/bundled/skills/testing-guide/testing-theory.md +1 -1
  509. package/bundled/skills/workflows/README.md +2 -2
  510. package/package.json +3 -3
  511. package/src/commands/audit.js +30 -9
  512. package/src/commands/config.js +33 -2
  513. package/src/commands/hitl.js +14 -1
  514. package/src/commands/init.js +110 -58
  515. package/src/commands/quickstart.js +1 -2
  516. package/src/commands/release.js +51 -6
  517. package/src/commands/run-intent.js +9 -0
  518. package/src/commands/spec-split.js +27 -2
  519. package/src/commands/update.js +22 -6
  520. package/src/config/ai-agent-paths.js +3 -1
  521. package/src/i18n/messages.js +3 -102
  522. package/src/missions/MissionManager.js +44 -12
  523. package/src/utils/build-manifest.js +35 -3
  524. package/src/utils/friction-detector.js +71 -22
  525. package/src/utils/health-checker.js +29 -2
  526. package/src/utils/transaction.js +111 -0
  527. package/src/utils/version-promote.js +16 -0
  528. package/standards-registry.json +58 -146
  529. package/bundled/ai/standards/agent-communication-protocol.ai.yaml +0 -42
  530. package/bundled/ai/standards/agent-dispatch.ai.yaml +0 -42
  531. package/bundled/ai/standards/branch-completion.ai.yaml +0 -44
  532. package/bundled/ai/standards/change-batching-standards.ai.yaml +0 -44
  533. package/bundled/ai/standards/execution-history.ai.yaml +0 -42
  534. package/bundled/ai/standards/pipeline-integration-standards.ai.yaml +0 -42
  535. package/bundled/ai/standards/workflow-enforcement.ai.yaml +0 -44
  536. package/bundled/ai/standards/workflow-state-protocol.ai.yaml +0 -43
  537. package/src/commands/flow.js +0 -260
  538. package/src/commands/start.js +0 -372
  539. package/src/commands/sweep.js +0 -151
  540. package/src/commands/workflow.js +0 -681
@@ -1,23 +1,23 @@
1
1
  # UDS 功能參考手冊
2
2
 
3
3
  > Universal Development Standards - 完整功能文件
4
- > Auto-generated | Last updated: 2026-05-14
4
+ > Auto-generated | Last updated: 2026-06-20
5
5
 
6
- **Language**: [English](../../../docs/FEATURE-REFERENCE.md) | 繁體中文 | [简体中文](../../zh-CN/docs/FEATURE-REFERENCE.md)
6
+ **Language**: [English](../../../docs/reference/FEATURE-REFERENCE.md) | 繁體中文 | [简体中文](../../zh-CN/docs/FEATURE-REFERENCE.md)
7
7
 
8
8
  ---
9
9
 
10
10
  ## 目錄
11
11
 
12
12
  1. [CLI 指令](#cli-commands) (9)
13
- 2. [斜線命令](#slash-commands) (49)
14
- 3. [技能](#skills) (54)
13
+ 2. [斜線命令](#slash-commands) (51)
14
+ 3. [技能](#skills) (55)
15
15
  4. [代理](#agents) (5)
16
16
  5. [工作流程](#workflows) (5)
17
- 6. [核心規範](#core-standards) (125)
18
- 7. [腳本](#scripts) (55)
17
+ 6. [核心規範](#core-standards) (145)
18
+ 7. [腳本](#scripts) (57)
19
19
 
20
- **Total Features: 302**
20
+ **Total Features: 327**
21
21
 
22
22
  ---
23
23
 
@@ -89,6 +89,7 @@
89
89
  | `--migrate` | Migrate legacy manifest to hash-based tracking |
90
90
  | `--offline` | Skip npm registry check for CLI updates |
91
91
  | `--force` | Bypass UDS source-repo self-adoption guard (DEC-044 / XSPEC-071) |
92
+ | `--i18n` | Run i18n lint rules (XSPEC-239) across canonical + locale variants |
92
93
 
93
94
  ### `uds update`
94
95
 
@@ -109,6 +110,7 @@
109
110
  | `--plan` | Show reconciliation plan without executing (like terraform plan) |
110
111
  | `--force` | Force update all files, ignoring hash comparison |
111
112
  | `--rollback` | Rollback to the most recent backup |
113
+ | `--locale` | Override locale for skills install (zh-tw, zh-cn, en); also reads .uds/install.yaml + UDS_LOCALE env |
112
114
 
113
115
  ### `uds skills`
114
116
 
@@ -164,6 +166,7 @@
164
166
  | `/check` | [UDS] Verify standards adoption status |
165
167
  | `/checkin` | "[UDS] Pre-commit quality gates verification" |
166
168
  | `/ci-cd` | "[UDS] Guide CI/CD pipeline design, configuration and optimization" |
169
+ | `/code-review` | [UDS] Perform systematic code review with checklist |
167
170
  | `/commit` | [UDS] Generate commit messages following Conventional Commits standard |
168
171
  | `/config` | [UDS] Configure project development standards |
169
172
  | `/coverage` | [UDS] Analyze test coverage and provide recommendations |
@@ -182,6 +185,7 @@
182
185
  | `/guide` | [UDS] Access Universal Development Standards guides and references. |
183
186
  | `/incident` | "[UDS] Guide incident response, root cause analysis and post-mortem documentation" |
184
187
  | `/init` | [UDS] Initialize development standards in current project |
188
+ | `/journey-test` | [UDS] Generate coherent user journey test plans (TESTPLAN) and E2E skeletons from a project description. |
185
189
  | `/methodology` | [UDS] Manage development methodology workflow |
186
190
  | `/metrics` | "[UDS] Track development metrics, code quality indicators and project health" |
187
191
  | `/migrate` | "[UDS] Guide code migration, framework upgrades and technology modernization" |
@@ -194,12 +198,12 @@
194
198
  | `/reverse-sdd` | [UDS] Reverse engineer code into SDD specification document |
195
199
  | `/reverse-tdd` | [UDS] Analyze BDD-TDD coverage gaps |
196
200
  | `/reverse` | [UDS] Reverse engineer code to Specs, BDD, or TDD coverage. |
197
- | `/review` | [UDS] Perform systematic code review with checklist |
198
201
  | `/runbook` | "[UDS] Guide runbook creation, maintenance, drills, and coverage reporting" |
199
202
  | `/scan` | "[UDS] Guide automated security scanning, dependency auditing and secret detection" |
200
203
  | `/sdd-retro` | [UDS] Create retroactive specs for untracked feat/fix commits |
201
204
  | `/sdd` | [UDS] Create or review specification documents for Spec-Driven Development |
202
205
  | `/security` | "[UDS] Guide security review and vulnerability assessment following OWASP standards" |
206
+ | `/skill-builder` | [UDS] Identify repeated processes and build Skills with the right development depth. |
203
207
  | `/slo` | "[UDS] Guide SLI selection, SLO setting, and Error Budget management" |
204
208
  | `/tdd` | [UDS] Guide through Test-Driven Development workflow |
205
209
  | `/update` | [UDS] Update development standards to latest version |
@@ -217,7 +221,7 @@
217
221
  | `ai-instruction-standards` | Create and maintain AI instruction files (CLAUDE.md, AGENTS.md, .cursor/rules/, etc.) with proper structure. |
218
222
  | `api-design-assistant` | Guide API design following REST, GraphQL, and gRPC best practices. |
219
223
  | `atdd-assistant` | "[UDS] Guide through Acceptance Test-Driven Development workflow" |
220
- | `audit-assistant` | "[UDS] UDS Health & Feedback System \| UDS 健康檢查與回饋系統" |
224
+ | `audit-assistant` | "[UDS] UDS Health & Feedback System" |
221
225
  | `bdd-assistant` | "[UDS] Guide through Behavior-Driven Development workflow" |
222
226
  | `brainstorm-assistant` | "[UDS] Structured AI-assisted brainstorming before spec creation" |
223
227
  | `changelog-guide` | "[UDS] Generate and maintain CHANGELOG.md entries" |
@@ -237,7 +241,8 @@
237
241
  | `error-code-guide` | Design consistent error codes following the PREFIX_CATEGORY_NUMBER format. |
238
242
  | `git-workflow-guide` | Guide Git branching strategies, branch naming, and merge operations. |
239
243
  | `incident-response-assistant` | Guide incident response, root cause analysis, and post-mortem documentation. |
240
- | `journey-test-assistant` | "[UDS] 從專案描述生成連貫使用者旅程測試計畫(TESTPLAN)與 E2E 骨架" |
244
+ | `journey-test-assistant` | "[UDS] Generate coherent user journey test plans (TESTPLAN) and E2E skeletons from project description." |
245
+ | `knowledge-graph` | "[UDS] Trace spec/decision/code impact chains via a knowledge graph (engine or Markdown fallback)" |
241
246
  | `logging-guide` | Implement structured logging with proper log levels and sensitive data handling. |
242
247
  | `metrics-dashboard-assistant` | "[UDS] Track development metrics, code quality indicators, and project health" |
243
248
  | `migration-assistant` | "[UDS] Guide code migration, framework upgrades, and technology modernization" |
@@ -252,7 +257,7 @@
252
257
  | `release-standards` | "[UDS] Guide release process and changelogs" |
253
258
  | `requirement-assistant` | "[UDS] Write user stories and requirements following INVEST criteria" |
254
259
  | `retrospective-assistant` | [UDS] Guide structured team retrospectives for Sprint and Release cycles. |
255
- | `reverse-engineer` | "[UDS] System archeology reverse engineer code across Logic, Data, and Runtime dimensions" |
260
+ | `reverse-engineer` | "[UDS] System archeology - reverse engineer code across Logic, Data, and Runtime dimensions" |
256
261
  | `runbook-assistant` | Guide runbook creation, maintenance, and drill exercises. |
257
262
  | `security-assistant` | Guide security review and vulnerability assessment following OWASP standards. |
258
263
  | `security-scan-assistant` | Guide automated security scanning, dependency auditing, and secret detection. |
@@ -295,9 +300,9 @@
295
300
 
296
301
  | Standard | 版本 | 說明 |
297
302
  |----------|---------|-------------|
298
- | `acceptance-criteria-traceability` | - | |
303
+ | `acceptance-criteria-traceability` | 1.1.0 | |
299
304
  | `acceptance-test-driven-development` | 1.1.0 | |
300
- | `accessibility-standards` | 1.0.0 | This standard defines comprehensive guidelines for creating accessible software |
305
+ | `accessibility-standards` | 1.1.0 | This standard defines comprehensive guidelines for creating accessible software |
301
306
  | `adr-standards` | 1.0.0 | Architecture Decision Records capture the context, options, and rationale behind |
302
307
  | `adversarial-test` | - | |
303
308
  | `agent-behavior-discipline` | 1.0.0 | This standard defines four behavioral disciplines for AI agents that elevate per |
@@ -306,76 +311,88 @@
306
311
  | `ai-agreement-standards` | 1.0.0 | This standard formalizes the interaction between Human (Acquirer) and AI (Suppli |
307
312
  | `ai-command-behavior` | 1.0.0 | This standard defines a structure for specifying AI Agent runtime behavior in co |
308
313
  | `ai-friendly-architecture` | 1.0.0 | This standard defines architecture and documentation practices that maximize the |
309
- | `ai-instruction-standards` | 1.0.0 | This standard defines best practices for creating and maintaining AI instruction |
310
- | `ai-response-navigation` | 1.0.0 | This standard defines navigation behavior for AI responses: every substantive AI |
314
+ | `ai-instruction-standards` | 1.1.0 | This standard defines best practices for creating and maintaining AI instruction |
315
+ | `ai-response-navigation` | 1.1.0 | This standard defines navigation behavior for AI responses: every substantive AI |
311
316
  | `alerting-standards` | 1.0.0 | |
312
317
  | `anti-hallucination` | 1.5.1 | This standard defines strict guidelines for AI assistants to prevent hallucinati |
313
318
  | `anti-sycophancy-prompting` | 1.0.0 | This standard defines techniques and rules for designing prompts that elicit gen |
314
319
  | `api-design-standards` | 1.0.0 | This standard defines comprehensive guidelines for designing, building, and main |
320
+ | `audit-trail` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
315
321
  | `behavior-driven-development` | 1.1.0 | |
316
322
  | `behavior-snapshot` | - | |
317
323
  | `branch-completion` | 1.0.0 | Define a standardized workflow for completing development branches, including pr |
318
- | `browser-compatibility-standards` | 1.0.0 | This standard defines supported browser and device matrices, testing automation |
324
+ | `browser-compatibility-standards` | 1.0.2 | This standard defines supported browser and device matrices, testing automation |
319
325
  | `capability-declaration` | - | |
320
326
  | `cd-deployment-strategies` | - | |
321
327
  | `change-batching-standards` | - | |
322
328
  | `changelog-standards` | 1.0.2 | This standard defines how to write and maintain a CHANGELOG.md file to communica |
323
329
  | `chaos-engineering-standards` | 1.0.0 | |
324
330
  | `chaos-injection-tests` | - | |
325
- | `checkin-standards` | 1.6.0 | This standard defines quality gates that MUST be passed before committing code t |
331
+ | `checkin-standards` | 1.7.0 | This standard defines quality gates that MUST be passed before committing code t |
326
332
  | `circuit-breaker` | - | |
327
- | `code-review-checklist` | 1.3.0 | This standard provides a comprehensive checklist for reviewing code changes, ens |
333
+ | `code-review-checklist` | 1.4.0 | This standard provides a comprehensive checklist for reviewing code changes, ens |
328
334
  | `commit-message-guide` | 1.3.0 | Standardized commit messages improve code review efficiency, facilitate automate |
335
+ | `container-image-standards` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
329
336
  | `container-security` | - | |
330
337
  | `containerization-standards` | 1.0.0 | |
331
338
  | `context-aware-loading` | 1.0.0 | This standard defines a protocol for AI tools to selectively load development st |
332
339
  | `contract-testing-standards` | 1.0.0 | Contract testing verifies that a provider (API server) and its consumers (client |
333
340
  | `cost-budget-test` | - | |
334
- | `cross-flow-regression` | 1.0.0 | This standard defines cross-flow regression testing — verifying that changes to |
341
+ | `cross-flow-regression` | 1.0.1 | This standard defines cross-flow regression testing — verifying that changes to |
342
+ | `data-contract` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
335
343
  | `data-migration-testing` | - | |
344
+ | `data-pipeline` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
336
345
  | `database-standards` | 1.0.0 | This standard defines guidelines for database design, querying, migration, and o |
337
- | `deployment-standards` | 1.0.0 | This standard defines guidelines for safely deploying software to production, co |
346
+ | `deployment-standards` | 1.1.0 | This standard defines guidelines for safely deploying software to production, co |
338
347
  | `deprecation-standards` | 1.0.0 | |
339
348
  | `design-document-standards` | 1.0.0 | |
340
- | `developer-memory` | 1.0.0 | This standard defines a structured system for capturing, retrieving, and surfaci |
349
+ | `developer-memory` | 1.1.1 | This standard defines a structured system for capturing, retrieving, and surfaci |
341
350
  | `disaster-recovery-drill` | - | |
342
351
  | `documentation-lifecycle` | 1.0.0 | This standard defines **when** to update documentation, **when** to check it, an |
343
352
  | `documentation-structure` | 1.5.0 | This standard defines a consistent documentation structure for software projects |
344
353
  | `documentation-writing-standards` | 1.2.0 | This standard defines documentation requirements based on project types and prov |
345
354
  | `dual-phase-output` | - | |
346
355
  | `environment-standards` | 1.0.0 | |
347
- | `error-code-standards` | 1.2.0 | |
356
+ | `error-code-standards` | 1.2.1 | |
348
357
  | `estimation-standards` | 1.0.0 | |
349
358
  | `execution-history` | 1.0.0 | |
350
359
  | `failure-source-taxonomy` | - | |
351
360
  | `feature-flag-standards` | 1.0.0 | |
352
361
  | `feature-manifest-standard` | - | |
353
362
  | `flaky-test-management` | - | |
354
- | `flow-based-testing` | 1.3.0 | This document defines a systematic methodology for testing multi-step processes. |
355
- | `forward-derivation-standards` | 1.2.0 | This standard defines the principles and workflows for Forward Derivation—automa |
363
+ | `flow-based-testing` | 1.3.1 | This document defines a systematic methodology for testing multi-step processes. |
364
+ | `forward-derivation-standards` | 1.3.0 | This standard defines the principles and workflows for Forward Derivation—automa |
356
365
  | `frontend-design-standards` | 1.0.0 | This standard defines a machine-readable frontend design specification format (D |
357
366
  | `full-coverage-testing` | - | |
358
367
  | `git-workflow` | 1.4.0 | This standard defines Git branching strategies and workflows to ensure consisten |
359
- | `git-worktree` | 1.0.0 | Define a lifecycle for using Git worktrees to isolate development work, ensuring |
368
+ | `git-worktree` | 1.1.0 | Define a lifecycle for using Git worktrees to isolate development work, ensuring |
360
369
  | `governance-layer` | 1.0.0 | A governance layer provides a shared anchor for all agents and roles in a projec |
361
370
  | `health-check-standards` | - | |
371
+ | `iac-design-principles` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
362
372
  | `immutability-first` | - | |
373
+ | `incident-response` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
374
+ | `knowledge-graph-memory` | 1.0.0 | This standard defines a **relationship schema** so that specifications, decision |
363
375
  | `knowledge-transfer-standards` | 1.0.0 | |
376
+ | `license-compliance` | 2.1.0 | **Status**: Active | **Updated**: 2026-05-16 | |
364
377
  | `llm-output-validation` | - | |
365
- | `logging-standards` | 1.2.0 | |
378
+ | `logging-standards` | 1.4.0 | |
366
379
  | `mock-boundary` | 1.0.0 | This document defines rules for what can and cannot be mocked in tests. Its goal |
367
- | `model-selection` | 1.0.0 | Define a cost-effective strategy for selecting AI model tiers based on task comp |
380
+ | `model-provenance` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
381
+ | `model-selection` | 1.0.1 | Define a cost-effective strategy for selecting AI model tiers based on task comp |
368
382
  | `mutation-testing` | 1.0.0 | Mutation testing evaluates test suite effectiveness by injecting artificial bugs |
369
383
  | `no-cicd-deployment` | - | |
370
384
  | `observability-standards` | 1.0.0 | |
371
- | `packaging-standards` | 1.0.0 | This standard defines a Recipe-based packaging framework that enables user proje |
372
- | `performance-standards` | 1.1.0 | This standard defines comprehensive guidelines for software performance engineer |
385
+ | `packaging-standards` | 1.1.0 | This standard defines a Recipe-based packaging framework that enables user proje |
386
+ | `performance-standards` | 1.2.0 | This standard defines comprehensive guidelines for software performance engineer |
387
+ | `pii-classification` | 1.1.0 | **Status**: Active | **Updated**: 2026-06-19 | |
373
388
  | `pipeline-integration-standards` | - | |
374
389
  | `pipeline-security-gates` | - | |
375
390
  | `policy-as-code-testing` | - | |
376
391
  | `postmortem-standards` | 1.0.0 | |
377
- | `privacy-standards` | 1.0.0 | |
378
- | `project-context-memory` | 1.1.0 | This standard defines a structured system for capturing, retrieving, and enforci |
392
+ | `prd-standards` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
393
+ | `privacy-standards` | 1.1.0 | |
394
+ | `product-metrics-standards` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
395
+ | `project-context-memory` | 1.2.0 | This standard defines a structured system for capturing, retrieving, and enforci |
379
396
  | `project-structure` | 1.2.0 | This standard defines conventions for project directory structure beyond documen |
380
397
  | `prompt-regression` | - | |
381
398
  | `property-based-testing` | - | |
@@ -385,21 +402,27 @@
385
402
  | `release-readiness-gate` | 1.0.0 | This standard defines a **single, aggregated Release Readiness Gate** that unifi |
386
403
  | `replay-test` | - | |
387
404
  | `requirement-engineering` | 1.0.0 | |
405
+ | `resource-cost-boundary` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
388
406
  | `retrospective-standards` | 1.0.0 | Retrospectives are structured team reflections that identify what worked well, w |
389
407
  | `retry-standards` | - | |
390
- | `reverse-engineering-standards` | 1.0.0 | This standard defines the principles, workflows, and best practices for reverse |
408
+ | `reverse-engineering-standards` | 1.1.0 | This standard defines the principles, workflows, and best practices for reverse |
391
409
  | `rollback-standards` | - | |
392
410
  | `runbook-standards` | 1.0.0 | |
411
+ | `runbook` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
393
412
  | `sast-advanced` | 1.0.0 | This standard defines Advanced Static Application Security Testing (SAST) practi |
413
+ | `schema-evolution` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
414
+ | `secret-management-standards` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
394
415
  | `secure-op` | - | |
395
416
  | `security-decision` | - | |
396
417
  | `security-standards` | 1.1.0 | This standard defines comprehensive security guidelines for software development |
397
- | `security-testing` | 1.0.0 | This document defines the security testing methodology for software projects. It |
418
+ | `security-testing` | 1.1.0 | This document defines the security testing methodology for software projects. It |
419
+ | `self-review-protocol` | 1.0.0 | This standard mandates a **self-review pass** on large markdown edits before com |
398
420
  | `server-ops-security` | - | |
399
421
  | `skill-standard-alignment-check` | - | |
422
+ | `slo-sli` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
400
423
  | `slo-standards` | 1.0.0 | |
401
424
  | `smoke-test` | - | |
402
- | `spec-driven-development` | 2.2.0 | |
425
+ | `spec-driven-development` | 2.3.0 | |
403
426
  | `standard-admission-criteria` | - | |
404
427
  | `standard-lifecycle-management` | - | |
405
428
  | `structured-task-definition` | 1.0.0 | |
@@ -415,7 +438,9 @@
415
438
  | `timeout-standards` | - | |
416
439
  | `token-budget` | - | |
417
440
  | `translation-lifecycle-standards` | 1.0.0 | Translation lifecycle standards: MISSING vs OUTDATED distinction, semver-aware s |
441
+ | `user-story-mapping` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
418
442
  | `verification-evidence` | 1.0.0 | Establish an "Iron Law" that no task can be claimed as complete without verifica |
443
+ | `verification-oracle` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
419
444
  | `versioning` | 1.2.0 | This standard defines how to version software releases using Semantic Versioning |
420
445
  | `virtual-organization-standards` | 1.0.0 | This standard treats the AI ecosystem as a "Virtual Organization." It defines ho |
421
446
  | `workflow-enforcement` | - | |
@@ -472,6 +497,7 @@
472
497
  | `fix-manifest-paths.ps1` | Fix Manifest Paths |
473
498
  | `fix-manifest-paths.sh` | Manifest Path Fixer |
474
499
  | `generate-docs.mjs` | Generate Docs |
500
+ | `generate-locale-coverage.mjs` | Locale Coverage Generator |
475
501
  | `generate-version-manifest.mjs` | Generate Version Manifest (SPEC-SELFDIAG-001 REQ-9, AC-14) |
476
502
  | `install-hooks.mjs` | Install Hooks |
477
503
  | `install-hooks.sh` | DEPRECATED: Use 'node scripts/install-hooks.mjs' instead (cross-platform). |
@@ -480,6 +506,7 @@
480
506
  | `pre-release-check.sh` | Pre-release Check Script |
481
507
  | `pre-release.ps1` | Pre-Release Preparation Script for Universal Development Standards |
482
508
  | `pre-release.sh` | Pre-Release Preparation Script |
509
+ | `setup-hooks.sh` | setup-hooks.sh — Install git hooks for UDS repo |
483
510
  | `setup-husky.mjs` | Cross-platform Husky Setup Script |
484
511
  | `sync-manifest.mjs` | Sync Manifest |
485
512
 
@@ -0,0 +1,88 @@
1
+ # UDS 6.0.0 遷移指南
2
+
3
+ > **語言**: [English](../../../docs/MIGRATION-v6.md) | 繁體中文 | [简体中文](../../zh-CN/docs/MIGRATION-v6.md)
4
+
5
+ UDS 6.0.0 是 **major** 版本:包含一項 breaking 更名、移除 8 個已棄用的機器可讀標準與 4 個已棄用的 CLI 命令——以上皆自 5.4.0 起帶有「6.0.0 移除」預告。本指南涵蓋所有需要調整的事項。
6
+
7
+ **TL;DR 檢查清單:**
8
+
9
+ - [ ] 把所有 `/review` 呼叫改為 `/code-review`
10
+ - [ ] 若腳本用到 `uds start` / `uds mission*` / `uds workflow*` / `uds flow*` / `uds sweep`,依 §3 遷移
11
+ - [ ] 若採用層曾載入 8 個被移除的 `.ai.yaml` stub,改用自家 runtime 等效實作(§2)
12
+ - [ ] 升級:`npm install -g universal-dev-standards@6`,然後在各專案跑 `uds update`
13
+
14
+ ---
15
+
16
+ ## 1. Breaking 更名:`/review` → `/code-review`
17
+
18
+ `review` 命令/skill 更名為 `code-review`,使 skill frontmatter 名稱與其目錄(`code-review-assistant`)對齊。
19
+
20
+ | 更名前 | 更名後 |
21
+ |--------|--------|
22
+ | `/review` | `/code-review` |
23
+ | `skills/commands/review.md` | `skills/commands/code-review.md` |
24
+ | `.gemini/commands/review.toml` | `.gemini/commands/code-review.toml` |
25
+ | `flows/review.flow.yaml`(flow-id `review-flow`)| `flows/code-review.flow.yaml`(flow-id `code-review-flow`)|
26
+
27
+ **你需要做的:**
28
+
29
+ - 把自家 prompt、文件、CI 腳本、AI 指令檔(`CLAUDE.md`、`AGENTS.md`、`.cursor/rules/` 等)中的 `/review` 改為 `/code-review`。
30
+ - 若你的 flow 引用了 flow-id `review-flow`(如 `workflow-prerequisites`),改為 `code-review-flow`。
31
+ - 重跑 `uds update` 讓重生成的命令索引落進專案。
32
+
33
+ **不受影響**:指涉外部工具內建 review 命令(如 Codex)的 `/review` 字樣與 UDS 無關,刻意保留原樣。
34
+
35
+ ## 2. 移除:8 個已棄用的機器可讀標準(`.ai.yaml`)
36
+
37
+ 這 8 個標準的 runtime 已於 5.4.0 移交採用層(XSPEC-086/095;UDS 定義活動、採用層編排流程——DEC-049),其 `.ai.yaml` stub 如期移除:
38
+
39
+ | 移除的 `.ai.yaml` | 保留的人類可讀文件 |
40
+ |---|---|
41
+ | `agent-communication-protocol` | `core/agent-communication-protocol.md` |
42
+ | `agent-dispatch` | `core/agent-dispatch.md` |
43
+ | `branch-completion` | `core/branch-completion.md` |
44
+ | `change-batching-standards` | `core/change-batching-standards.md` |
45
+ | `execution-history` | `core/execution-history.md` |
46
+ | `pipeline-integration-standards` | `core/pipeline-integration-standards.md` |
47
+ | `workflow-enforcement` | `core/workflow-enforcement.md` |
48
+ | `workflow-state-protocol` | `core/workflow-state-protocol.md` |
49
+
50
+ **你需要做的:**
51
+
52
+ - 若從未直接載入這些 `.ai.yaml`:不需動作——人類可讀概念仍留在 `core/` 作為參考文件。
53
+ - 若採用層(agent runtime、orchestrator、CI)曾載入這些 stub:在自家工具鏈實作等效機制。這些 stub 自 5.4.0 起本身就是指向此方向的棄用告示。
54
+ - 這些標準不再由 `uds init` / `uds update` 發佈。專案 `.standards/` 中既有副本不會被自動刪除——想要乾淨樹的話請手動移除。
55
+
56
+ ## 3. 移除:4 個已棄用的 CLI 命令
57
+
58
+ 四者皆於 5.4.0 標記 `@deprecated`(XSPEC-095)並預告 6.0.0 移除。流程編排屬採用層職責(DEC-049)。
59
+
60
+ | 移除的命令 | 遷移路徑 |
61
+ |---|---|
62
+ | `uds start`、`uds mission:*`(status/pause/resume/cancel/list)| 用採用層的 mission runtime(如 VibeOps orchestrator)|
63
+ | `uds workflow:*`(list/install/info/execute/status)| workflow 定義在 `flows/`;執行歸採用層 |
64
+ | `uds flow:*`(create/list/validate/diff/export/import)| 直接撰寫 flow YAML;驗證/執行在採用層 |
65
+ | `uds sweep` | 用 `/sweep` skill(同能力、skill 形式)|
66
+
67
+ 保留的命令:`init`、`update`、`check`、`audit`、`config`、`skills`、`release`、`hitl`、`run` 及其餘非編排類 CLI。
68
+
69
+ ## 4. 已棄用但 6.0.0「未」移除
70
+
71
+ - **6 個 workflow skills** 標記為 `reference` 級並帶明顯棄用告示(XSPEC-291 §4)。它們仍隨版發佈;可按自己的節奏遷移。
72
+ - 其他已棄用 runtime 命令帶結構化 `@superseded-by` 指標。
73
+
74
+ ## 5. 升級步驟
75
+
76
+ ```bash
77
+ # 1. 升級 CLI
78
+ npm install -g universal-dev-standards@6
79
+
80
+ # 2. 在各消費專案
81
+ uds update
82
+
83
+ # 3. 掃自家設定的殘留引用
84
+ grep -rn "/review\b" . --include="*.md" --include="*.toml" | grep -v code-review
85
+ grep -rn "uds start\|uds workflow\|uds flow\|uds sweep" . --exclude-dir=node_modules
86
+ ```
87
+
88
+ `uds check` 通過且上述 grep 乾淨,即完成遷移。
@@ -103,7 +103,7 @@ status: current
103
103
  | 學習曲線 | 低 | 高 | 低 |
104
104
 
105
105
  **說明**:
106
- - Skills 提供 `/commit`、`/tdd`、`/review` 等命令進行互動引導
106
+ - Skills 提供 `/commit`、`/tdd`、`/code-review` 等命令進行互動引導
107
107
  - 規範文件需要開發者主動閱讀並應用
108
108
  - Skills 可自動偵測上下文(如 git status、專案語言)
109
109
 
@@ -177,7 +177,7 @@ status: current
177
177
  - Token 消耗最低
178
178
  - 互動體驗最佳
179
179
  - 無需管理額外文件
180
- - `/commit`、`/tdd`、`/review` 命令足夠日常使用
180
+ - `/commit`、`/tdd`、`/code-review` 命令足夠日常使用
181
181
 
182
182
  **配置方式**:
183
183
  ```bash
@@ -63,7 +63,7 @@ Universal Development Standards 是一套為 AI 時代設計的**語言無關、
63
63
  | 問題 | UDS 解決方案 |
64
64
  |------|-------------|
65
65
  | 團隊 commit message 格式不一致 | 透過 `/commit` 標準化 Conventional Commits |
66
- | Code review 漏看關鍵問題 | 透過 `/review` 執行 8 維度系統性審查 |
66
+ | Code review 漏看關鍵問題 | 透過 `/code-review` 執行 8 維度系統性審查 |
67
67
  | AI 工具給出不一致的建議 | 統一標準讓 AI 工具讀取並遵循 |
68
68
  | 新人加入團隊需要數週上手 | 清晰的標準和引導式工作流程 |
69
69
  | 測試覆蓋率期望不明確 | 測試金字塔定義明確比例(70/20/7/3) |
@@ -71,10 +71,10 @@ Universal Development Standards 是一套為 AI 時代設計的**語言無關、
71
71
 
72
72
  ### 設計哲學
73
73
 
74
- **「碰一點,保護一點」** — 你不需要一次導入全部 48 個標準。UDS 專為漸進式導入設計:
74
+ **「碰一點,保護一點」** — 你不需要一次導入全部 140+ 個標準。UDS 專為漸進式導入設計:
75
75
 
76
76
  - 先只用 `/commit` — 零成本,立即見效
77
- - 接著加入 `/review` — 在合併前捕捉問題
77
+ - 接著加入 `/code-review` — 在合併前捕捉問題
78
78
  - 團隊適應後,逐步引入 `/tdd` 和 `/sdd`
79
79
 
80
80
  > **Boy Scout Rule**:讓程式碼比你找到它時更好。每次碰到程式碼,順手加一點保護(測試、文件)。
@@ -142,7 +142,7 @@ npx universal-dev-standards init
142
142
 
143
143
  ```
144
144
  your-project/
145
- ├── .standards/ # 48 個 AI 標準(.ai.yaml 檔案)
145
+ ├── .standards/ # AI 標準(.ai.yaml 檔案)
146
146
  │ ├── testing.ai.yaml
147
147
  │ ├── commit-message.ai.yaml
148
148
  │ ├── code-review.ai.yaml
@@ -458,14 +458,14 @@ Refs: SPEC-001
458
458
  | `test` | 測試 | `test(auth): 新增登入測試` |
459
459
  | `chore` | 維護 | `chore(deps): 更新相依套件` |
460
460
 
461
- ### `/review` — 程式碼審查
461
+ ### `/code-review` — 程式碼審查
462
462
 
463
- 提交前,用 `/review` 進行系統性審查:
463
+ 提交前,用 `/code-review` 進行系統性審查:
464
464
 
465
465
  ```bash
466
- /review # 審查當前分支所有變更
467
- /review src/auth.js # 審查特定檔案
468
- /review feature/login # 審查特定分支
466
+ /code-review # 審查當前分支所有變更
467
+ /code-review src/auth.js # 審查特定檔案
468
+ /code-review feature/login # 審查特定分支
469
469
  ```
470
470
 
471
471
  **8 個審查維度:**
@@ -504,7 +504,7 @@ Refs: SPEC-001
504
504
  | **規格** | `/sdd`, `/requirement`, `/brainstorm` | 規格驅動開發 |
505
505
  | **推演** | `/derive-all`, `/derive-bdd`, `/derive-tdd`, `/derive-atdd` | 從規格生成測試 |
506
506
  | **開發** | `/tdd`, `/bdd`, `/atdd` | 方法論工作流程 |
507
- | **品質** | `/commit`, `/review`, `/checkin`, `/coverage`, `/ac-coverage` | 日常品質管理 |
507
+ | **品質** | `/commit`, `/code-review`, `/checkin`, `/coverage`, `/ac-coverage` | 日常品質管理 |
508
508
  | **文件** | `/docs`, `/docgen`, `/changelog`, `/release` | 文件與發布 |
509
509
  | **反向** | `/reverse`, `/reverse-sdd`, `/reverse-bdd`, `/reverse-tdd` | Legacy Code 反向工程 |
510
510
  | **重構** | `/refactor` | 重構指導 |
@@ -522,7 +522,7 @@ Refs: SPEC-001
522
522
 
523
523
  ```bash
524
524
  /commit # 標準化 commit message
525
- /review # 提交前自我審查
525
+ /code-review # 提交前自我審查
526
526
  ```
527
527
 
528
528
  > 只需要這兩個指令,就能立即提升程式碼品質。
@@ -569,7 +569,7 @@ Refs: SPEC-001
569
569
  12:00 /commit # 標準化提交
570
570
  → feat(auth): 新增雙因素認證
571
571
 
572
- 12:05 /review # 最終審查
572
+ 12:05 /code-review # 最終審查
573
573
  → 0 BLOCKING, 1 SUGGESTION
574
574
  ```
575
575
 
@@ -599,7 +599,7 @@ A: 不會。UDS 是語言無關、框架無關的。它定義的是流程和品
599
599
  A: 不用。核心標準是 Markdown 文件,人類直接閱讀也完全適用。AI 工具只是讓流程更順暢。
600
600
 
601
601
  **Q: 團隊中只有我用可以嗎?**
602
- A: 可以。漸進式導入的設計就是為了這個情境。先自己用 `/commit` 和 `/review`,等團隊看到效果再推廣。
602
+ A: 可以。漸進式導入的設計就是為了這個情境。先自己用 `/commit` 和 `/code-review`,等團隊看到效果再推廣。
603
603
 
604
604
  **Q: 和 ESLint / Prettier 衝突嗎?**
605
605
  A: 互補關係。ESLint/Prettier 處理程式碼格式,UDS 處理更高層次的開發流程和品質標準。
@@ -624,7 +624,7 @@ uds init
624
624
 
625
625
  ### 推薦學習路徑
626
626
 
627
- 1. 先用 `/commit` + `/review` 養成習慣
627
+ 1. 先用 `/commit` + `/code-review` 養成習慣
628
628
  2. 遇到新功能時試試 `/sdd`
629
629
  3. 不確定下一步時,輸入 `/dev-workflow`
630
630
 
@@ -0,0 +1,105 @@
1
+ ---
2
+ source: docs/specs/system/memory-adoption-strategy.md
3
+ source_version: 1.0.0
4
+ translation_version: 1.0.0
5
+ status: current
6
+ ---
7
+
8
+ # 記憶採用策略
9
+
10
+ **狀態**: Archived
11
+
12
+ > **語言**: [English](../../../../../docs/specs/system/memory-adoption-strategy.md) | 繁體中文
13
+
14
+ 本文件提供策略指引,協助跨不同團隊規模與營運模式採用 Universal Development Standards (UDS) 的記憶系統。它幫助使用者決定如何架構自身的 **Project Context Memory (PCM)** 與 **Developer Persistent Memory (DPM)**,以發揮最大效益。
15
+
16
+ ---
17
+
18
+ ## 1. 決策矩陣
19
+
20
+ 選擇最適合你營運模式的策略:
21
+
22
+ | 策略 | 目標對象 | 儲存位置 | 知識流向 | 主要效益 |
23
+ | :--- | :--- | :--- | :--- | :--- |
24
+ | **數位花園 (Digital Garden)** | 獨立開發者、自由工作者 | 本機全域 (`~/.uds/memory`) | Project → User | **可攜性**:你的經驗隨你而行。 |
25
+ | **倉庫中心 (Repo-Centric)** | 新創公司、小型團隊 | 專案本地 (`.project-context/`) | User → Project | **一致性**:為新成員提供「開箱即用」的上手體驗。 |
26
+ | **軸輻式 (Hub-and-Spoke)** | 企業、多專案組織 | Git Submodule/Registry | Hub ↔ Spoke | **標準化**:在嚴格邊界內強制落實合規。 |
27
+
28
+ ---
29
+
30
+ ## 2. 策略 A:數位花園 (獨立/自由工作者)
31
+
32
+ **理念**:「我是知識的載體。」
33
+
34
+ 目標是在許多臨時專案之間累積個人經驗。AI 扮演你的個人結對程式設計夥伴,學習 *你的* 偏好。
35
+
36
+ ### 配置
37
+ - **全域 memory**:啟用。將特定技術堆疊的洞見(例如「React Tips」、「Python Tricks」)儲存於 `~/.uds/memory/`。
38
+ - **專案 memory**:最小化。僅儲存憑證、特定路徑或臨時性的商業邏輯。
39
+
40
+ ### 工作流程
41
+ 1. **遇到問題**:在專案 A 中解決一個棘手的 React 渲染錯誤。
42
+ 2. **提升 (Promote)**:告訴 AI:「將這個存成通用的 React 模式到我的全域 memory。」
43
+ 3. **重複使用**:開啟專案 B。當你撰寫類似程式碼時,AI 會立即建議該模式,因為它讀取了 `~/.uds/memory`。
44
+
45
+ ### 設定
46
+ ```bash
47
+ # 1. Create global directory
48
+ mkdir -p ~/.uds/memory
49
+
50
+ # 2. (Optional) Initialize as git repo for backup
51
+ cd ~/.uds/memory && git init
52
+ ```
53
+
54
+ ---
55
+
56
+ ## 3. 策略 B:倉庫中心 (小型團隊)
57
+
58
+ **理念**:「倉庫即真實來源 (Source of Truth)。」
59
+
60
+ 目標是確保每位團隊成員(以及他們的 AI Agent)擁有完全相同的脈絡。個人偏好不應凌駕於專案慣例之上。
61
+
62
+ ### 配置
63
+ - **全域 memory**:**停用** 或唯讀。避免「在我的機器/AI 上可以運作」的問題。
64
+ - **專案 memory**:完整。所有架構決策、程式撰寫風格與領域術語皆存放於 `.project-context/`,並提交至 Git。
65
+
66
+ ### 工作流程
67
+ 1. **上手 (Onboarding)**:新成員 clone 倉庫。
68
+ 2. **即時脈絡**:他們的 AI 讀取 `.project-context/`,立即得知:「我們採用 Hexagonal Architecture」與「變數必須使用 snake_case」。
69
+ 3. **共識**:當團隊在 Code Review 中對新規則達成共識時,由一人指示 AI:「將這條規則加入 Project Context。」
70
+ 4. **同步**:新的 `.md` 檔案被提交並推送。每個人在下次 `git pull` 時取得更新。
71
+
72
+ ---
73
+
74
+ ## 4. 策略 C:軸輻式 (企業)
75
+
76
+ **理念**:「治理與合規。」
77
+
78
+ 目標是在數百個專案之間共享共通標準,同時允許在地的彈性。
79
+
80
+ ### 配置
81
+ - **核心層(軸 The Hub)**:一個專用的 Git 倉庫(例如 `acme-corp/standard-memory`),內含全公司的安全規則與架構模式。
82
+ - **專案層(輻 The Spoke)**:本地 `.project-context/`,用於應用程式專屬的邏輯。
83
+
84
+ ### 實作:Git Submodules
85
+ 每個專案將中央 memory 作為 submodule 掛載。
86
+
87
+ ```bash
88
+ # In Project A, B, and C:
89
+ git submodule add git@github.com:acme-corp/standard-memory.git .standards/shared
90
+ ```
91
+
92
+ ### 工作流程
93
+ 1. **政策更新**:安全團隊在 Hub 倉庫中更新「Auth Standards」。
94
+ 2. **傳播 (Propagation)**:各專案更新其 submodule,以拉取新標準。
95
+ 3. **驗證**:CI/CD 管線檢查專案程式碼是否符合 `.standards/shared` 中更新後的規則。
96
+
97
+ ---
98
+
99
+ ## 5. 總結
100
+
101
+ | 如果你想要… | 採用策略… |
102
+ | :--- | :--- |
103
+ | 在不同接案工作之間停止重複造輪子 | **數位花園 (Digital Garden)** |
104
+ | 讓新進人員在第一天就能產出 | **倉庫中心 (Repo-Centric)** |
105
+ | 確保 50+ 個微服務遵循安全規格 | **軸輻式 (Hub-and-Spoke)** |