universal-dev-standards 4.2.0 → 5.0.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 (542) hide show
  1. package/README.md +3 -3
  2. package/bin/uds.js +165 -5
  3. package/bundled/core/acceptance-test-driven-development.md +19 -721
  4. package/bundled/core/accessibility-standards.md +862 -0
  5. package/bundled/core/ai-agreement-standards.md +95 -0
  6. package/bundled/core/ai-friendly-architecture.md +2 -0
  7. package/bundled/core/ai-instruction-standards.md +2 -0
  8. package/bundled/core/anti-hallucination.md +90 -637
  9. package/bundled/core/behavior-driven-development.md +20 -735
  10. package/bundled/core/changelog-standards.md +4 -0
  11. package/bundled/core/checkin-standards.md +21 -4
  12. package/bundled/core/code-review-checklist.md +3 -0
  13. package/bundled/core/commit-message-guide.md +14 -3
  14. package/bundled/core/deployment-standards.md +296 -0
  15. package/bundled/core/developer-memory.md +568 -0
  16. package/bundled/core/documentation-structure.md +114 -18
  17. package/bundled/core/documentation-writing-standards.md +272 -2
  18. package/bundled/core/error-code-standards.md +3 -0
  19. package/bundled/core/forward-derivation-standards.md +134 -8
  20. package/bundled/core/git-workflow.md +72 -686
  21. package/bundled/core/guides/anti-hallucination-guide.md +517 -0
  22. package/bundled/core/guides/git-workflow-guide.md +954 -0
  23. package/bundled/core/guides/performance-guide.md +508 -0
  24. package/bundled/core/guides/refactoring-guide.md +608 -0
  25. package/bundled/core/guides/security-guide.md +485 -0
  26. package/bundled/core/logging-standards.md +337 -2
  27. package/bundled/core/performance-standards.md +231 -0
  28. package/bundled/core/project-context-memory.md +180 -0
  29. package/bundled/core/project-structure.md +315 -2
  30. package/bundled/core/refactoring-standards.md +81 -761
  31. package/bundled/core/requirement-engineering.md +39 -0
  32. package/bundled/core/reverse-engineering-standards.md +6 -4
  33. package/bundled/core/security-standards.md +244 -0
  34. package/bundled/core/spec-driven-development.md +20 -319
  35. package/bundled/core/test-completeness-dimensions.md +213 -11
  36. package/bundled/core/test-driven-development.md +22 -978
  37. package/bundled/core/testing-standards.md +222 -2903
  38. package/bundled/core/versioning.md +16 -55
  39. package/bundled/core/virtual-organization-standards.md +85 -0
  40. package/bundled/locales/README.md +4 -4
  41. package/bundled/locales/zh-CN/CHANGELOG.md +18 -18
  42. package/bundled/locales/zh-CN/CLAUDE.md +3 -3
  43. package/bundled/locales/zh-CN/MAINTENANCE.md +7 -7
  44. package/bundled/locales/zh-CN/README.md +2 -2
  45. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +1 -1
  46. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +3 -3
  47. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +66 -7
  48. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +22 -22
  49. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +5 -5
  50. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +4 -4
  51. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +5 -5
  52. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +13 -13
  53. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +1 -1
  54. package/bundled/locales/zh-CN/core/anti-hallucination.md +39 -3
  55. package/bundled/locales/zh-CN/core/checkin-standards.md +18 -5
  56. package/bundled/locales/zh-CN/core/commit-message-guide.md +1 -1
  57. package/bundled/locales/zh-CN/core/developer-memory.md +576 -0
  58. package/bundled/locales/zh-CN/core/documentation-structure.md +43 -5
  59. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +146 -5
  60. package/bundled/locales/zh-CN/core/git-workflow.md +179 -4
  61. package/bundled/locales/zh-CN/core/logging-standards.md +177 -4
  62. package/bundled/locales/zh-CN/core/project-structure.md +117 -5
  63. package/bundled/locales/zh-CN/core/refactoring-standards.md +3 -3
  64. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +6 -6
  65. package/bundled/locales/zh-CN/core/spec-driven-development.md +516 -14
  66. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +155 -24
  67. package/bundled/locales/zh-CN/core/test-driven-development.md +71 -20
  68. package/bundled/locales/zh-CN/core/testing-standards.md +4 -4
  69. package/bundled/locales/zh-CN/core/versioning.md +1 -1
  70. package/bundled/locales/zh-CN/docs/AI-AGENT-ROADMAP.md +90 -51
  71. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +184 -0
  72. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +239 -0
  73. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +320 -0
  74. package/bundled/locales/zh-CN/docs/OPERATION-WORKFLOW.md +43 -43
  75. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +440 -0
  76. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +1 -1
  77. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +1 -1
  78. package/bundled/locales/zh-CN/integrations/codex/README.md +3 -3
  79. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +3 -3
  80. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +5 -5
  81. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +9 -9
  82. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +18 -6
  83. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +2 -2
  84. package/bundled/locales/zh-CN/integrations/opencode/README.md +3 -3
  85. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +22 -10
  86. package/bundled/locales/zh-CN/integrations/openspec/README.md +1 -1
  87. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +3 -3
  88. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +1 -1
  89. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +1 -1
  90. package/bundled/locales/zh-CN/options/commit-message/english.md +1 -1
  91. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +1 -1
  92. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +1 -1
  93. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +1 -1
  94. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +1 -1
  95. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +1 -1
  96. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +1 -1
  97. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +1 -1
  98. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +1 -1
  99. package/bundled/locales/zh-CN/options/project-structure/go.md +1 -1
  100. package/bundled/locales/zh-CN/options/project-structure/java.md +1 -1
  101. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +1 -1
  102. package/bundled/locales/zh-CN/options/project-structure/python.md +1 -1
  103. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +1 -1
  104. package/bundled/locales/zh-CN/options/testing/integration-testing.md +1 -1
  105. package/bundled/locales/zh-CN/options/testing/system-testing.md +1 -1
  106. package/bundled/locales/zh-CN/options/testing/unit-testing.md +1 -1
  107. package/bundled/locales/zh-CN/skills/{claude-code/CONTRIBUTING.template.md → CONTRIBUTING.template.md} +2 -2
  108. package/bundled/locales/zh-CN/skills/README.md +131 -81
  109. package/bundled/locales/zh-CN/skills/agents/README.md +281 -0
  110. package/bundled/locales/zh-CN/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/SKILL.md +10 -10
  111. package/bundled/locales/zh-CN/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/anti-hallucination.md +8 -8
  112. package/bundled/locales/zh-CN/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/certainty-labels.md +8 -8
  113. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +221 -0
  114. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +214 -0
  115. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +71 -0
  116. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +428 -0
  117. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +484 -0
  118. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +368 -0
  119. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +68 -0
  120. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +406 -0
  121. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +454 -0
  122. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +324 -0
  123. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +64 -0
  124. package/bundled/locales/zh-CN/skills/{claude-code/changelog-guide/SKILL.md → changelog-guide/guide.md} +6 -7
  125. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +56 -0
  126. package/bundled/locales/zh-CN/skills/{claude-code/checkin-assistant/SKILL.md → checkin-assistant/guide.md} +6 -7
  127. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +56 -0
  128. package/bundled/locales/zh-CN/skills/{claude-code/code-review-assistant → code-review-assistant}/checkin-checklist.md +4 -4
  129. package/bundled/locales/zh-CN/skills/{claude-code/code-review-assistant/SKILL.md → code-review-assistant/guide.md} +5 -6
  130. package/bundled/locales/zh-CN/skills/{claude-code/code-review-assistant → code-review-assistant}/review-checklist.md +4 -4
  131. package/bundled/locales/zh-CN/skills/{claude-code/commands → commands}/bdd.md +2 -2
  132. package/bundled/locales/zh-CN/skills/{claude-code/commands → commands}/methodology.md +3 -3
  133. package/bundled/locales/zh-CN/skills/{claude-code/commands → commands}/refactor.md +3 -3
  134. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +61 -0
  135. package/bundled/locales/zh-CN/skills/{claude-code/commit-standards → commit-standards}/conventional-commits.md +4 -4
  136. package/bundled/locales/zh-CN/skills/{claude-code/commit-standards/SKILL.md → commit-standards/guide.md} +5 -6
  137. package/bundled/locales/zh-CN/skills/{claude-code/commit-standards → commit-standards}/language-options.md +3 -3
  138. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +59 -0
  139. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +262 -0
  140. package/bundled/locales/zh-CN/skills/{claude-code/documentation-guide → documentation-guide}/SKILL.md +7 -8
  141. package/bundled/locales/zh-CN/skills/{claude-code/documentation-guide → documentation-guide}/documentation-structure.md +4 -4
  142. package/bundled/locales/zh-CN/skills/{claude-code/documentation-guide → documentation-guide}/readme-template.md +3 -3
  143. package/bundled/locales/zh-CN/skills/{claude-code/error-code-guide → error-code-guide}/SKILL.md +6 -6
  144. package/bundled/locales/zh-CN/skills/forward-derivation/SKILL.md +62 -0
  145. package/bundled/locales/zh-CN/skills/forward-derivation/guide.md +130 -0
  146. package/bundled/locales/zh-CN/skills/{claude-code/git-workflow-guide → git-workflow-guide}/SKILL.md +6 -6
  147. package/bundled/locales/zh-CN/skills/{claude-code/git-workflow-guide → git-workflow-guide}/branch-naming.md +3 -3
  148. package/bundled/locales/zh-CN/skills/{claude-code/git-workflow-guide → git-workflow-guide}/git-workflow.md +4 -4
  149. package/bundled/locales/zh-CN/skills/{claude-code/logging-guide → logging-guide}/SKILL.md +6 -6
  150. package/bundled/locales/zh-CN/skills/methodology-system/SKILL.md +78 -0
  151. package/bundled/locales/zh-CN/skills/{claude-code/methodology-system → methodology-system}/create-methodology.md +2 -2
  152. package/bundled/locales/zh-CN/skills/{claude-code/methodology-system/SKILL.md → methodology-system/guide.md} +2 -2
  153. package/bundled/locales/zh-CN/skills/{claude-code/methodology-system → methodology-system}/runtime.md +3 -3
  154. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +66 -0
  155. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +371 -0
  156. package/bundled/locales/zh-CN/skills/{claude-code/project-structure-guide → project-structure-guide}/SKILL.md +4 -4
  157. package/bundled/locales/zh-CN/skills/{claude-code/project-structure-guide → project-structure-guide}/language-patterns.md +1 -1
  158. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +67 -0
  159. package/bundled/locales/zh-CN/skills/{claude-code/refactoring-assistant/SKILL.md → refactoring-assistant/guide.md} +7 -8
  160. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +64 -0
  161. package/bundled/locales/zh-CN/skills/{claude-code/release-standards → release-standards}/changelog-format.md +3 -3
  162. package/bundled/locales/zh-CN/skills/{claude-code/release-standards/SKILL.md → release-standards/guide.md} +5 -6
  163. package/bundled/locales/zh-CN/skills/{claude-code/release-standards → release-standards}/release-workflow.md +7 -7
  164. package/bundled/locales/zh-CN/skills/{claude-code/release-standards → release-standards}/semantic-versioning.md +3 -3
  165. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +67 -0
  166. package/bundled/locales/zh-CN/skills/{claude-code/requirement-assistant/SKILL.md → requirement-assistant/guide.md} +4 -5
  167. package/bundled/locales/zh-CN/skills/{claude-code/requirement-assistant → requirement-assistant}/requirement-checklist.md +3 -3
  168. package/bundled/locales/zh-CN/skills/{claude-code/requirement-assistant → requirement-assistant}/requirement-writing.md +3 -3
  169. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +67 -0
  170. package/bundled/locales/zh-CN/skills/{claude-code/reverse-engineer → reverse-engineer}/bdd-extraction.md +2 -2
  171. package/bundled/locales/zh-CN/skills/{claude-code/reverse-engineer/SKILL.md → reverse-engineer/guide.md} +17 -18
  172. package/bundled/locales/zh-CN/skills/{claude-code/reverse-engineer → reverse-engineer}/tdd-analysis.md +2 -2
  173. package/bundled/locales/zh-CN/skills/{claude-code/reverse-engineer → reverse-engineer}/workflow.md +3 -3
  174. package/bundled/locales/zh-CN/skills/spec-driven-dev/SKILL.md +75 -0
  175. package/bundled/locales/zh-CN/skills/{claude-code/spec-driven-dev/SKILL.md → spec-driven-dev/guide.md} +10 -11
  176. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +66 -0
  177. package/bundled/locales/zh-CN/skills/{claude-code/tdd-assistant/SKILL.md → tdd-assistant/guide.md} +12 -16
  178. package/bundled/locales/zh-CN/skills/{claude-code/tdd-assistant → tdd-assistant}/language-examples.md +3 -3
  179. package/bundled/locales/zh-CN/skills/{claude-code/tdd-assistant → tdd-assistant}/tdd-workflow.md +3 -3
  180. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +65 -0
  181. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +284 -0
  182. package/bundled/locales/zh-CN/skills/{claude-code/testing-guide → testing-guide}/SKILL.md +8 -8
  183. package/bundled/locales/zh-CN/skills/{claude-code/testing-guide → testing-guide}/testing-pyramid.md +4 -4
  184. package/bundled/locales/zh-CN/skills/{cline → tools/cline}/README.md +1 -1
  185. package/bundled/locales/zh-CN/skills/{copilot → tools/copilot}/README.md +1 -1
  186. package/bundled/locales/zh-CN/skills/{copilot → tools/copilot}/copilot-instructions.md +1 -1
  187. package/bundled/locales/zh-CN/skills/{cursor → tools/cursor}/README.md +1 -1
  188. package/bundled/locales/zh-CN/skills/{windsurf → tools/windsurf}/README.md +1 -1
  189. package/bundled/locales/zh-TW/CHANGELOG.md +16 -16
  190. package/bundled/locales/zh-TW/CLAUDE.md +3 -3
  191. package/bundled/locales/zh-TW/MAINTENANCE.md +7 -7
  192. package/bundled/locales/zh-TW/README.md +13 -7
  193. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +1 -1
  194. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +4 -4
  195. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +66 -7
  196. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +22 -22
  197. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +5 -5
  198. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +4 -4
  199. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +5 -5
  200. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +13 -13
  201. package/bundled/locales/zh-TW/ai/standards/anti-hallucination.ai.yaml +3 -2
  202. package/bundled/locales/zh-TW/ai/standards/git-workflow.ai.yaml +4 -3
  203. package/bundled/locales/zh-TW/ai/standards/spec-driven-development.ai.yaml +3 -3
  204. package/bundled/locales/zh-TW/ai/standards/testing.ai.yaml +1 -0
  205. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +1 -1
  206. package/bundled/locales/zh-TW/core/anti-hallucination.md +38 -701
  207. package/bundled/locales/zh-TW/core/changelog-standards.md +1 -1
  208. package/bundled/locales/zh-TW/core/checkin-standards.md +18 -5
  209. package/bundled/locales/zh-TW/core/code-review-checklist.md +1 -1
  210. package/bundled/locales/zh-TW/core/commit-message-guide.md +1 -1
  211. package/bundled/locales/zh-TW/core/developer-memory.md +576 -0
  212. package/bundled/locales/zh-TW/core/documentation-structure.md +115 -22
  213. package/bundled/locales/zh-TW/core/documentation-writing-standards.md +126 -5
  214. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +2 -2
  215. package/bundled/locales/zh-TW/core/git-workflow.md +38 -812
  216. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +779 -0
  217. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +1016 -0
  218. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +864 -0
  219. package/bundled/locales/zh-TW/core/guides/testing-guide.md +2280 -0
  220. package/bundled/locales/zh-TW/core/logging-standards.md +159 -4
  221. package/bundled/locales/zh-TW/core/project-structure.md +102 -9
  222. package/bundled/locales/zh-TW/core/refactoring-standards.md +37 -823
  223. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +6 -6
  224. package/bundled/locales/zh-TW/core/spec-driven-development.md +17 -268
  225. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +128 -14
  226. package/bundled/locales/zh-TW/core/test-driven-development.md +20 -983
  227. package/bundled/locales/zh-TW/core/testing-standards.md +120 -2105
  228. package/bundled/locales/zh-TW/core/versioning.md +13 -55
  229. package/bundled/locales/zh-TW/docs/AI-AGENT-ROADMAP.md +90 -51
  230. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +184 -0
  231. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +239 -0
  232. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +320 -0
  233. package/bundled/locales/zh-TW/docs/MIGRATION-V5.md +71 -0
  234. package/bundled/locales/zh-TW/docs/OPERATION-WORKFLOW.md +42 -42
  235. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +440 -0
  236. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +1 -1
  237. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +1 -1
  238. package/bundled/locales/zh-TW/integrations/claude-code/README.md +44 -0
  239. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +3 -3
  240. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +18 -6
  241. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +22 -10
  242. package/bundled/locales/zh-TW/methodologies/guides/sdd-guide.md +338 -0
  243. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +1055 -0
  244. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +1 -1
  245. package/bundled/locales/zh-TW/options/commit-message/english.md +1 -1
  246. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +1 -1
  247. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +1 -1
  248. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +1 -1
  249. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +1 -1
  250. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +1 -1
  251. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +1 -1
  252. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +1 -1
  253. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +1 -1
  254. package/bundled/locales/zh-TW/options/project-structure/go.md +1 -1
  255. package/bundled/locales/zh-TW/options/project-structure/java.md +1 -1
  256. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +1 -1
  257. package/bundled/locales/zh-TW/options/project-structure/python.md +1 -1
  258. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +1 -1
  259. package/bundled/locales/zh-TW/options/testing/integration-testing.md +1 -1
  260. package/bundled/locales/zh-TW/options/testing/system-testing.md +1 -1
  261. package/bundled/locales/zh-TW/options/testing/unit-testing.md +1 -1
  262. package/bundled/locales/zh-TW/skills/{claude-code/CONTRIBUTING.template.md → CONTRIBUTING.template.md} +2 -2
  263. package/bundled/locales/zh-TW/skills/README.md +131 -79
  264. package/bundled/locales/zh-TW/skills/agents/README.md +281 -0
  265. package/bundled/locales/zh-TW/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/SKILL.md +7 -7
  266. package/bundled/locales/zh-TW/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/anti-hallucination.md +8 -8
  267. package/bundled/locales/zh-TW/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/certainty-labels.md +8 -8
  268. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +221 -0
  269. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +214 -0
  270. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +71 -0
  271. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +428 -0
  272. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +484 -0
  273. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +368 -0
  274. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +68 -0
  275. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +406 -0
  276. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +454 -0
  277. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +324 -0
  278. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +64 -0
  279. package/bundled/locales/zh-TW/skills/{claude-code/changelog-guide/SKILL.md → changelog-guide/guide.md} +6 -7
  280. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +56 -0
  281. package/bundled/locales/zh-TW/skills/{claude-code/checkin-assistant/SKILL.md → checkin-assistant/guide.md} +6 -7
  282. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +56 -0
  283. package/bundled/locales/zh-TW/skills/{claude-code/code-review-assistant → code-review-assistant}/checkin-checklist.md +4 -4
  284. package/bundled/locales/zh-TW/skills/{claude-code/code-review-assistant/SKILL.md → code-review-assistant/guide.md} +2 -3
  285. package/bundled/locales/zh-TW/skills/{claude-code/code-review-assistant → code-review-assistant}/review-checklist.md +4 -4
  286. package/bundled/locales/zh-TW/skills/{claude-code/commands → commands}/bdd.md +2 -2
  287. package/bundled/locales/zh-TW/skills/{claude-code/commands → commands}/methodology.md +3 -3
  288. package/bundled/locales/zh-TW/skills/{claude-code/commands → commands}/refactor.md +3 -3
  289. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +61 -0
  290. package/bundled/locales/zh-TW/skills/{claude-code/commit-standards → commit-standards}/conventional-commits.md +4 -4
  291. package/bundled/locales/zh-TW/skills/{claude-code/commit-standards/SKILL.md → commit-standards/guide.md} +5 -6
  292. package/bundled/locales/zh-TW/skills/{claude-code/commit-standards → commit-standards}/language-options.md +3 -3
  293. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +59 -0
  294. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +262 -0
  295. package/bundled/locales/zh-TW/skills/{claude-code/documentation-guide → documentation-guide}/SKILL.md +7 -8
  296. package/bundled/locales/zh-TW/skills/{claude-code/documentation-guide → documentation-guide}/documentation-structure.md +4 -4
  297. package/bundled/locales/zh-TW/skills/{claude-code/documentation-guide → documentation-guide}/readme-template.md +3 -3
  298. package/bundled/locales/zh-TW/skills/{claude-code/error-code-guide → error-code-guide}/SKILL.md +6 -6
  299. package/bundled/locales/zh-TW/skills/forward-derivation/SKILL.md +62 -0
  300. package/bundled/locales/zh-TW/skills/{claude-code/forward-derivation/SKILL.md → forward-derivation/guide.md} +24 -19
  301. package/bundled/locales/zh-TW/skills/{claude-code/git-workflow-guide → git-workflow-guide}/SKILL.md +3 -3
  302. package/bundled/locales/zh-TW/skills/{claude-code/git-workflow-guide → git-workflow-guide}/branch-naming.md +3 -3
  303. package/bundled/locales/zh-TW/skills/{claude-code/git-workflow-guide → git-workflow-guide}/git-workflow.md +4 -4
  304. package/bundled/locales/zh-TW/skills/{claude-code/logging-guide → logging-guide}/SKILL.md +6 -6
  305. package/bundled/locales/zh-TW/skills/methodology-system/SKILL.md +78 -0
  306. package/bundled/locales/zh-TW/skills/{claude-code/methodology-system → methodology-system}/create-methodology.md +2 -2
  307. package/bundled/locales/zh-TW/skills/{claude-code/methodology-system/SKILL.md → methodology-system/guide.md} +2 -2
  308. package/bundled/locales/zh-TW/skills/{claude-code/methodology-system → methodology-system}/runtime.md +3 -3
  309. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +66 -0
  310. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +371 -0
  311. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +574 -0
  312. package/bundled/locales/zh-TW/skills/{claude-code/project-structure-guide → project-structure-guide}/SKILL.md +4 -4
  313. package/bundled/locales/zh-TW/skills/{claude-code/project-structure-guide → project-structure-guide}/language-patterns.md +1 -1
  314. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +67 -0
  315. package/bundled/locales/zh-TW/skills/{claude-code/refactoring-assistant/SKILL.md → refactoring-assistant/guide.md} +7 -8
  316. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +64 -0
  317. package/bundled/locales/zh-TW/skills/{claude-code/release-standards → release-standards}/changelog-format.md +3 -3
  318. package/bundled/locales/zh-TW/skills/{claude-code/release-standards/SKILL.md → release-standards/guide.md} +2 -3
  319. package/bundled/locales/zh-TW/skills/{claude-code/release-standards → release-standards}/release-workflow.md +60 -28
  320. package/bundled/locales/zh-TW/skills/{claude-code/release-standards → release-standards}/semantic-versioning.md +3 -3
  321. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +67 -0
  322. package/bundled/locales/zh-TW/skills/{claude-code/requirement-assistant/SKILL.md → requirement-assistant/guide.md} +2 -3
  323. package/bundled/locales/zh-TW/skills/{claude-code/requirement-assistant → requirement-assistant}/requirement-checklist.md +3 -3
  324. package/bundled/locales/zh-TW/skills/{claude-code/requirement-assistant → requirement-assistant}/requirement-writing.md +3 -3
  325. package/bundled/locales/zh-TW/skills/reverse-engineer/SKILL.md +67 -0
  326. package/bundled/locales/zh-TW/skills/{claude-code/reverse-engineer → reverse-engineer}/bdd-extraction.md +2 -2
  327. package/bundled/locales/zh-TW/skills/{claude-code/reverse-engineer/SKILL.md → reverse-engineer/guide.md} +17 -18
  328. package/bundled/locales/zh-TW/skills/{claude-code/reverse-engineer → reverse-engineer}/tdd-analysis.md +2 -2
  329. package/bundled/locales/zh-TW/skills/{claude-code/reverse-engineer → reverse-engineer}/workflow.md +3 -3
  330. package/bundled/locales/zh-TW/skills/spec-driven-dev/SKILL.md +75 -0
  331. package/bundled/locales/zh-TW/skills/{claude-code/spec-driven-dev/SKILL.md → spec-driven-dev/guide.md} +9 -10
  332. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +66 -0
  333. package/bundled/locales/zh-TW/skills/{claude-code/tdd-assistant/SKILL.md → tdd-assistant/guide.md} +9 -10
  334. package/bundled/locales/zh-TW/skills/{claude-code/tdd-assistant → tdd-assistant}/language-examples.md +3 -3
  335. package/bundled/locales/zh-TW/skills/{claude-code/tdd-assistant → tdd-assistant}/tdd-workflow.md +3 -3
  336. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +65 -0
  337. package/bundled/locales/zh-TW/skills/{claude-code/test-coverage-assistant/SKILL.md → test-coverage-assistant/guide.md} +27 -24
  338. package/bundled/locales/zh-TW/skills/{claude-code/testing-guide → testing-guide}/SKILL.md +6 -6
  339. package/bundled/locales/zh-TW/skills/{claude-code/testing-guide → testing-guide}/testing-pyramid.md +4 -4
  340. package/bundled/locales/zh-TW/skills/{cline → tools/cline}/README.md +1 -1
  341. package/bundled/locales/zh-TW/skills/{copilot → tools/copilot}/README.md +1 -1
  342. package/bundled/locales/zh-TW/skills/{copilot → tools/copilot}/copilot-instructions.md +1 -1
  343. package/bundled/locales/zh-TW/skills/{cursor → tools/cursor}/README.md +1 -1
  344. package/bundled/locales/zh-TW/skills/{windsurf → tools/windsurf}/README.md +1 -1
  345. package/bundled/skills/INTEGRATION-GUIDE.md +210 -0
  346. package/bundled/skills/README.md +95 -0
  347. package/bundled/skills/_shared/README.md +60 -0
  348. package/bundled/skills/{claude-code/agents → agents}/README.md +2 -2
  349. package/bundled/skills/{claude-code/agents → agents}/code-architect.md +1 -1
  350. package/bundled/skills/{claude-code/agents → agents}/doc-writer.md +1 -1
  351. package/bundled/skills/{claude-code/agents → agents}/reviewer.md +1 -1
  352. package/bundled/skills/{claude-code/agents → agents}/spec-analyst.md +1 -1
  353. package/bundled/skills/{claude-code/agents → agents}/test-specialist.md +1 -1
  354. package/bundled/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/SKILL.md +28 -5
  355. package/bundled/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/anti-hallucination.md +24 -5
  356. package/bundled/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/certainty-labels.md +31 -6
  357. package/bundled/skills/ai-friendly-architecture/SKILL.md +216 -0
  358. package/bundled/skills/ai-instruction-standards/SKILL.md +209 -0
  359. package/bundled/skills/atdd-assistant/SKILL.md +74 -0
  360. package/bundled/skills/{claude-code/atdd-assistant → atdd-assistant}/acceptance-criteria-guide.md +1 -1
  361. package/bundled/skills/{claude-code/atdd-assistant → atdd-assistant}/atdd-workflow.md +1 -1
  362. package/bundled/skills/{claude-code/atdd-assistant/SKILL.md → atdd-assistant/guide.md} +11 -11
  363. package/bundled/skills/bdd-assistant/SKILL.md +70 -0
  364. package/bundled/skills/{claude-code/bdd-assistant → bdd-assistant}/bdd-workflow.md +1 -1
  365. package/bundled/skills/{claude-code/bdd-assistant → bdd-assistant}/gherkin-guide.md +1 -1
  366. package/bundled/skills/{claude-code/bdd-assistant/SKILL.md → bdd-assistant/guide.md} +11 -11
  367. package/bundled/skills/changelog-guide/SKILL.md +66 -0
  368. package/bundled/skills/{claude-code/changelog-guide/SKILL.md → changelog-guide/guide.md} +8 -6
  369. package/bundled/skills/checkin-assistant/SKILL.md +52 -0
  370. package/bundled/skills/{claude-code/checkin-assistant/SKILL.md → checkin-assistant/guide.md} +6 -6
  371. package/bundled/skills/code-review-assistant/SKILL.md +53 -0
  372. package/bundled/skills/{claude-code/code-review-assistant → code-review-assistant}/checkin-checklist.md +3 -3
  373. package/bundled/skills/{claude-code/code-review-assistant/SKILL.md → code-review-assistant/guide.md} +7 -5
  374. package/bundled/skills/{claude-code/code-review-assistant → code-review-assistant}/review-checklist.md +3 -3
  375. package/bundled/skills/commands/COMMAND-FAMILY-OVERVIEW.md +290 -0
  376. package/bundled/skills/{claude-code/commands → commands}/README.md +13 -3
  377. package/bundled/skills/{claude-code/commands → commands}/atdd.md +3 -3
  378. package/bundled/skills/{claude-code/commands → commands}/bdd.md +2 -2
  379. package/bundled/skills/commands/changelog.md +58 -0
  380. package/bundled/skills/{claude-code/commands → commands}/check.md +1 -1
  381. package/bundled/skills/commands/checkin.md +53 -0
  382. package/bundled/skills/{claude-code/commands → commands}/commit.md +3 -3
  383. package/bundled/skills/{claude-code/commands → commands}/config.md +1 -1
  384. package/bundled/skills/{claude-code/commands → commands}/coverage.md +5 -4
  385. package/bundled/skills/commands/derive-all.md +53 -0
  386. package/bundled/skills/commands/derive-atdd.md +49 -0
  387. package/bundled/skills/commands/derive-bdd.md +47 -0
  388. package/bundled/skills/commands/derive-tdd.md +48 -0
  389. package/bundled/skills/commands/derive.md +72 -0
  390. package/bundled/skills/commands/discover.md +80 -0
  391. package/bundled/skills/commands/docgen.md +61 -0
  392. package/bundled/skills/commands/docs.md +59 -0
  393. package/bundled/skills/commands/guide.md +44 -0
  394. package/bundled/skills/{claude-code/commands → commands}/init.md +2 -2
  395. package/bundled/skills/{claude-code/commands → commands}/methodology.md +32 -16
  396. package/bundled/skills/{claude-code/commands → commands}/refactor.md +2 -2
  397. package/bundled/skills/commands/release.md +56 -0
  398. package/bundled/skills/{claude-code/commands → commands}/requirement.md +3 -3
  399. package/bundled/skills/commands/reverse-bdd.md +47 -0
  400. package/bundled/skills/commands/reverse-sdd.md +51 -0
  401. package/bundled/skills/commands/reverse-tdd.md +51 -0
  402. package/bundled/skills/commands/reverse.md +63 -0
  403. package/bundled/skills/{claude-code/commands → commands}/review.md +3 -3
  404. package/bundled/skills/commands/sdd.md +135 -0
  405. package/bundled/skills/{claude-code/commands → commands}/tdd.md +3 -3
  406. package/bundled/skills/{claude-code/commands → commands}/update.md +2 -2
  407. package/bundled/skills/commit-standards/SKILL.md +60 -0
  408. package/bundled/skills/{claude-code/commit-standards → commit-standards}/conventional-commits.md +3 -3
  409. package/bundled/skills/{claude-code/commit-standards/SKILL.md → commit-standards/guide.md} +17 -5
  410. package/bundled/skills/{claude-code/commit-standards → commit-standards}/language-options.md +2 -2
  411. package/bundled/skills/docs-generator/SKILL.md +69 -0
  412. package/bundled/skills/docs-generator/guide.md +258 -0
  413. package/bundled/skills/{claude-code/documentation-guide → documentation-guide}/SKILL.md +7 -7
  414. package/bundled/skills/{claude-code/documentation-guide → documentation-guide}/documentation-structure.md +3 -3
  415. package/bundled/skills/{claude-code/documentation-guide → documentation-guide}/readme-template.md +2 -2
  416. package/bundled/skills/{claude-code/error-code-guide → error-code-guide}/SKILL.md +7 -5
  417. package/bundled/skills/forward-derivation/SKILL.md +61 -0
  418. package/bundled/skills/{claude-code/forward-derivation/SKILL.md → forward-derivation/guide.md} +44 -29
  419. package/bundled/skills/{claude-code/git-workflow-guide → git-workflow-guide}/SKILL.md +7 -5
  420. package/bundled/skills/{claude-code/git-workflow-guide → git-workflow-guide}/branch-naming.md +2 -2
  421. package/bundled/skills/{claude-code/git-workflow-guide → git-workflow-guide}/git-workflow.md +3 -3
  422. package/bundled/skills/{claude-code/logging-guide → logging-guide}/SKILL.md +7 -5
  423. package/bundled/skills/methodology-system/SKILL.md +75 -0
  424. package/bundled/skills/{claude-code/methodology-system → methodology-system}/create-methodology.md +1 -1
  425. package/bundled/skills/{claude-code/methodology-system/SKILL.md → methodology-system/guide.md} +51 -16
  426. package/bundled/skills/methodology-system/integrated-flow.md +454 -0
  427. package/bundled/skills/{claude-code/methodology-system → methodology-system}/runtime.md +2 -2
  428. package/bundled/skills/project-discovery/SKILL.md +63 -0
  429. package/bundled/skills/project-discovery/guide.md +367 -0
  430. package/bundled/skills/project-discovery/workflow.md +566 -0
  431. package/bundled/skills/{claude-code/project-structure-guide → project-structure-guide}/SKILL.md +14 -4
  432. package/bundled/skills/refactoring-assistant/SKILL.md +78 -0
  433. package/bundled/skills/{claude-code/refactoring-assistant/SKILL.md → refactoring-assistant/guide.md} +7 -7
  434. package/bundled/skills/release-standards/SKILL.md +61 -0
  435. package/bundled/skills/{claude-code/release-standards → release-standards}/changelog-format.md +2 -2
  436. package/bundled/skills/{claude-code/release-standards/SKILL.md → release-standards/guide.md} +7 -5
  437. package/bundled/skills/{claude-code/release-standards → release-standards}/release-workflow.md +59 -24
  438. package/bundled/skills/{claude-code/release-standards → release-standards}/semantic-versioning.md +2 -2
  439. package/bundled/skills/requirement-assistant/SKILL.md +66 -0
  440. package/bundled/skills/{claude-code/requirement-assistant/SKILL.md → requirement-assistant/guide.md} +14 -6
  441. package/bundled/skills/{claude-code/requirement-assistant → requirement-assistant}/requirement-checklist.md +2 -2
  442. package/bundled/skills/{claude-code/requirement-assistant → requirement-assistant}/requirement-writing.md +2 -2
  443. package/bundled/skills/reverse-engineer/SKILL.md +64 -0
  444. package/bundled/skills/{claude-code/reverse-engineer → reverse-engineer}/bdd-extraction.md +1 -1
  445. package/bundled/skills/{claude-code/reverse-engineer/SKILL.md → reverse-engineer/guide.md} +21 -18
  446. package/bundled/skills/{claude-code/reverse-engineer → reverse-engineer}/tdd-analysis.md +1 -1
  447. package/bundled/skills/{claude-code/reverse-engineer → reverse-engineer}/workflow.md +2 -2
  448. package/bundled/skills/spec-driven-dev/SKILL.md +80 -0
  449. package/bundled/skills/{claude-code/spec-driven-dev/SKILL.md → spec-driven-dev/guide.md} +50 -8
  450. package/bundled/skills/tdd-assistant/SKILL.md +65 -0
  451. package/bundled/skills/{claude-code/tdd-assistant/SKILL.md → tdd-assistant/guide.md} +10 -10
  452. package/bundled/skills/{claude-code/tdd-assistant → tdd-assistant}/language-examples.md +3 -3
  453. package/bundled/skills/{claude-code/tdd-assistant → tdd-assistant}/tdd-workflow.md +2 -2
  454. package/bundled/skills/test-coverage-assistant/SKILL.md +63 -0
  455. package/bundled/skills/{claude-code/test-coverage-assistant/SKILL.md → test-coverage-assistant/guide.md} +39 -24
  456. package/bundled/skills/{claude-code/testing-guide → testing-guide}/SKILL.md +12 -7
  457. package/bundled/skills/{claude-code/testing-guide → testing-guide}/testing-pyramid.md +3 -3
  458. package/bundled/skills/testing-guide/testing-theory.md +2291 -0
  459. package/bundled/skills/tools/cline/.clinerules +79 -0
  460. package/bundled/skills/tools/cline/README.md +50 -0
  461. package/bundled/skills/tools/copilot/README.md +99 -0
  462. package/bundled/skills/tools/copilot/copilot-instructions.md +71 -0
  463. package/bundled/skills/tools/cursor/.cursorrules +101 -0
  464. package/bundled/skills/tools/cursor/README.md +50 -0
  465. package/bundled/skills/tools/windsurf/.windsurfrules +76 -0
  466. package/bundled/skills/tools/windsurf/README.md +51 -0
  467. package/bundled/skills/{claude-code/workflows → workflows}/README.md +1 -1
  468. package/bundled/skills/workflows/release.workflow.yaml +893 -0
  469. package/package.json +4 -1
  470. package/src/commands/check.js +195 -130
  471. package/src/commands/config.js +1262 -0
  472. package/src/commands/configure.js +3 -950
  473. package/src/commands/fix.js +53 -0
  474. package/src/commands/hitl.js +19 -0
  475. package/src/commands/init.js +320 -1030
  476. package/src/commands/list.js +1 -1
  477. package/src/commands/simulate.js +61 -0
  478. package/src/commands/spec.js +288 -0
  479. package/src/commands/start.js +373 -0
  480. package/src/commands/sweep.js +142 -0
  481. package/src/commands/update.js +136 -19
  482. package/src/commands/workflow.js +265 -1
  483. package/src/config/ai-agent-paths.js +89 -29
  484. package/src/core/constants.js +7 -1
  485. package/src/core/manifest.js +1 -0
  486. package/src/flows/init-flow.js +243 -0
  487. package/src/hitl/checkpoint.js +80 -0
  488. package/src/hitl/classifier.js +54 -0
  489. package/src/hitl/manager.js +88 -0
  490. package/src/i18n/messages.js +907 -99
  491. package/src/index.js +1 -0
  492. package/src/installers/integration-installer.js +237 -0
  493. package/src/installers/manifest-installer.js +131 -0
  494. package/src/installers/skills-installer.js +286 -0
  495. package/src/installers/standards-installer.js +193 -0
  496. package/src/missions/MissionManager.js +501 -0
  497. package/src/prompts/init.js +228 -130
  498. package/src/prompts/integrations.js +13 -1
  499. package/src/schemas/standard.schema.json +117 -0
  500. package/src/utils/agents-installer.js +2 -2
  501. package/src/utils/config-loader.js +47 -0
  502. package/src/utils/config-manager.js +108 -0
  503. package/src/utils/config-merger.js +47 -0
  504. package/src/utils/github.js +22 -18
  505. package/src/utils/inquirer-patch.js +98 -0
  506. package/src/utils/integration-generator.js +392 -58
  507. package/src/utils/reference-sync.js +69 -19
  508. package/src/utils/skills-installer.js +6 -3
  509. package/src/utils/standard-fixer.js +141 -0
  510. package/src/utils/standard-validator.js +329 -0
  511. package/src/utils/workflow-executor.js +886 -0
  512. package/src/utils/workflow-state.js +404 -0
  513. package/src/utils/workflows-installer.js +2 -2
  514. package/src/vibe/auto-sweep.js +349 -0
  515. package/src/vibe/micro-spec.js +428 -0
  516. package/standards-registry.json +278 -102
  517. package/bundled/locales/zh-CN/skills/claude-code/README.md +0 -174
  518. package/bundled/locales/zh-CN/skills/claude-code/test-coverage-assistant/SKILL.md +0 -282
  519. package/bundled/locales/zh-TW/skills/claude-code/README.md +0 -174
  520. package/bundled/skills/claude-code/README.md +0 -215
  521. package/bundled/skills/claude-code/commands/changelog.md +0 -57
  522. package/bundled/skills/claude-code/commands/derive-all.md +0 -214
  523. package/bundled/skills/claude-code/commands/derive-atdd.md +0 -177
  524. package/bundled/skills/claude-code/commands/derive-bdd.md +0 -158
  525. package/bundled/skills/claude-code/commands/derive-tdd.md +0 -259
  526. package/bundled/skills/claude-code/commands/docs.md +0 -75
  527. package/bundled/skills/claude-code/commands/release.md +0 -50
  528. package/bundled/skills/claude-code/commands/reverse-bdd.md +0 -264
  529. package/bundled/skills/claude-code/commands/reverse-spec.md +0 -185
  530. package/bundled/skills/claude-code/commands/reverse-tdd.md +0 -351
  531. package/bundled/skills/claude-code/commands/spec.md +0 -69
  532. package/bundled/skills/claude-code/methodology-system/integrated-flow.md +0 -322
  533. /package/bundled/skills/{claude-code/CONTRIBUTING.template.md → CONTRIBUTING.template.md} +0 -0
  534. /package/bundled/skills/{claude-code/ai → ai}/standards/checkin.ai.yaml +0 -0
  535. /package/bundled/skills/{claude-code/ai → ai}/standards/commit.ai.yaml +0 -0
  536. /package/bundled/skills/{claude-code/ai → ai}/standards/refactoring.ai.yaml +0 -0
  537. /package/bundled/skills/{claude-code/ai → ai}/standards/testing.ai.yaml +0 -0
  538. /package/bundled/skills/{claude-code/project-structure-guide → project-structure-guide}/language-patterns.md +0 -0
  539. /package/bundled/skills/{claude-code/workflows → workflows}/code-review.workflow.yaml +0 -0
  540. /package/bundled/skills/{claude-code/workflows → workflows}/feature-dev.workflow.yaml +0 -0
  541. /package/bundled/skills/{claude-code/workflows → workflows}/integrated-flow.workflow.yaml +0 -0
  542. /package/bundled/skills/{claude-code/workflows → workflows}/large-codebase-analysis.workflow.yaml +0 -0
@@ -0,0 +1,39 @@
1
+ # Requirement Engineering Standards
2
+
3
+ **Version**: 1.0.0
4
+ **Last Updated**: 2026-01-28
5
+ **Applicability**: All software projects
6
+ **Scope**: universal
7
+ **Industry Standards**: IEEE 830-1998, IEEE 29148-2018, SWEBOK v4.0
8
+ **References**: [computer.org](https://www.computer.org/education/bodies-of-knowledge/software-engineering/v4)
9
+
10
+ ---
11
+
12
+ ## Summary
13
+
14
+ Requirements Engineering is the systematic process of eliciting, analyzing, specifying, and validating software requirements throughout the development lifecycle. It provides the theoretical foundation for writing, managing, and validating requirements based on industry standards including IEEE 830-1998, IEEE 29148-2018, SWEBOK v4.0, and ISO/IEC 25010.
15
+
16
+ The process encompasses Functional Requirements (what the system should DO), Non-Functional Requirements (quality attributes like performance, security, usability), and Constraints. User Stories (Agile format) with Acceptance Criteria (Given-When-Then) serve as the primary specification format, validated through INVEST criteria (Independent, Negotiable, Valuable, Estimable, Small, Testable).
17
+
18
+ ---
19
+
20
+ **Full Guide: [Requirement Engineering Guide](../methodologies/guides/requirement-engineering-guide.md)**
21
+
22
+ ---
23
+
24
+ ## Quick Reference
25
+
26
+ | Aspect | Description |
27
+ |--------|-------------|
28
+ | **Core Process** | Elicitation → Analysis → Specification → Validation |
29
+ | **Requirement Types** | Functional (FR), Non-Functional (NFR), Constraints |
30
+ | **Prioritization** | MoSCoW, P0-P3, Kano Model |
31
+ | **Quality Model** | ISO/IEC 25010 (8 characteristics) |
32
+ | **Standards** | IEEE 830, IEEE 29148, SWEBOK v4.0 |
33
+
34
+ ## Related Standards
35
+
36
+ - [Spec-Driven Development](spec-driven-development.md)
37
+ - [Forward Derivation Standards](forward-derivation-standards.md)
38
+ - [Behavior-Driven Development](behavior-driven-development.md)
39
+ - [Testing Standards](testing-standards.md)
@@ -3,6 +3,8 @@
3
3
  **Version**: 1.0.0
4
4
  **Last Updated**: 2026-01-19
5
5
  **Applicability**: All projects requiring code-to-specification transformation
6
+ **Scope**: uds-specific
7
+ **Industry Standards**: IEEE 830-1998, SWEBOK v4.0 Chapter 9
6
8
 
7
9
  > **Language**: [English](../core/reverse-engineering-standards.md) | [繁體中文](../locales/zh-TW/core/reverse-engineering-standards.md)
8
10
 
@@ -359,10 +361,10 @@ Use reverse-engineered specifications to identify test coverage gaps:
359
361
 
360
362
  ### Skill References
361
363
 
362
- - [Reverse Engineer Skill](../skills/claude-code/reverse-engineer/SKILL.md) - Detailed workflow implementation
363
- - [Spec-Driven Development Skill](../skills/claude-code/spec-driven-dev/SKILL.md) - SDD integration
364
- - [BDD Assistant Skill](../skills/claude-code/bdd-assistant/SKILL.md) - Gherkin formulation
365
- - [TDD Assistant Skill](../skills/claude-code/tdd-assistant/SKILL.md) - Test coverage analysis
364
+ - [Reverse Engineer Skill](../skills/reverse-engineer/SKILL.md) - Detailed workflow implementation
365
+ - [Spec-Driven Development Skill](../skills/spec-driven-dev/SKILL.md) - SDD integration
366
+ - [BDD Assistant Skill](../skills/bdd-assistant/SKILL.md) - Gherkin formulation
367
+ - [TDD Assistant Skill](../skills/tdd-assistant/SKILL.md) - Test coverage analysis
366
368
 
367
369
  ---
368
370
 
@@ -0,0 +1,244 @@
1
+ # Security Standards
2
+
3
+ > **Language**: English | [繁體中文](../locales/zh-TW/core/security-standards.md)
4
+
5
+ **Version**: 1.1.0
6
+ **Last Updated**: 2026-01-29
7
+ **Applicability**: All software projects
8
+ **Scope**: universal
9
+ **Industry Standards**: OWASP Top 10 (2021), OWASP ASVS v4.0, NIST SP 800-53
10
+ **References**: [owasp.org](https://owasp.org/Top10/), [owasp.org](https://owasp.org/www-project-application-security-verification-standard/)
11
+
12
+ > **For detailed explanations and examples, see [Security Guide](guides/security-guide.md)**
13
+
14
+ ---
15
+
16
+ ## Purpose
17
+
18
+ This standard defines comprehensive security guidelines for software development, covering secure coding practices, vulnerability prevention, authentication/authorization, and security testing.
19
+
20
+ **Reference Standards**:
21
+ - [OWASP Top 10 (2021)](https://owasp.org/Top10/)
22
+ - [OWASP ASVS v4.0](https://owasp.org/www-project-application-security-verification-standard/)
23
+ - [NIST SP 800-53](https://csrc.nist.gov/publications/detail/sp/800-53/rev-5/final)
24
+
25
+ ---
26
+
27
+ ## Core Security Principles
28
+
29
+ | Principle | Implementation |
30
+ |-----------|----------------|
31
+ | **Least Privilege** | Role-based access, time-limited tokens |
32
+ | **Fail Securely** | Deny access on auth error, don't expose stack traces |
33
+ | **Separation of Duties** | Different roles for dev/deploy/admin |
34
+ | **Defense in Depth** | Don't rely on single control |
35
+ | **Security by Default** | Secure defaults, opt-in for less secure options |
36
+ | **Zero Trust** | Verify every request, assume breach |
37
+
38
+ ---
39
+
40
+ ## OWASP Top 10 Prevention Checklist
41
+
42
+ | Vulnerability | Prevention |
43
+ |---------------|------------|
44
+ | **A01: Broken Access Control** | Deny by default, server-side checks, validate ownership |
45
+ | **A02: Cryptographic Failures** | Encrypt PII, use TLS 1.3, use secrets management |
46
+ | **A03: Injection** | Parameterized queries, validated input, use ORMs |
47
+ | **A04: Insecure Design** | Threat modeling, security requirements in specs |
48
+ | **A05: Security Misconfiguration** | Remove defaults, disable unused features, security headers |
49
+ | **A06: Vulnerable Components** | Maintain SBOM, scan with npm audit/Snyk, patch quickly |
50
+ | **A07: Auth Failures** | Strong passwords, MFA, secure sessions |
51
+ | **A08: Integrity Failures** | Code signing, verify checksums, secure CI/CD |
52
+ | **A09: Logging Failures** | Log security events, protect log integrity |
53
+ | **A10: SSRF** | Allowlist URLs, block internal IPs |
54
+
55
+ ---
56
+
57
+ ## Required Security Headers
58
+
59
+ ```http
60
+ Content-Security-Policy: default-src 'self'; script-src 'self'
61
+ X-Content-Type-Options: nosniff
62
+ X-Frame-Options: DENY
63
+ Strict-Transport-Security: max-age=31536000; includeSubDomains
64
+ X-XSS-Protection: 0
65
+ Referrer-Policy: strict-origin-when-cross-origin
66
+ Permissions-Policy: geolocation=(), camera=(), microphone=()
67
+ ```
68
+
69
+ ---
70
+
71
+ ## Cryptography Requirements
72
+
73
+ ### Algorithm Selection
74
+
75
+ | Purpose | Required | Avoid |
76
+ |---------|----------|-------|
77
+ | **Symmetric Encryption** | AES-256-GCM | DES, 3DES, AES-ECB |
78
+ | **Asymmetric Encryption** | RSA-2048+, ECDSA P-256+ | RSA-1024 |
79
+ | **Hashing** | SHA-256, SHA-3, BLAKE3 | MD5, SHA-1 |
80
+ | **Password Hashing** | Argon2id, bcrypt, scrypt | SHA-256, PBKDF2 |
81
+ | **TLS Version** | TLS 1.3, TLS 1.2 | TLS 1.0, TLS 1.1, SSL |
82
+
83
+ ### Password Hashing Configuration
84
+
85
+ | Algorithm | Configuration |
86
+ |-----------|---------------|
87
+ | **Argon2id** | Memory: 64 MB, Iterations: 3, Parallelism: 4, Salt: 16 bytes |
88
+ | **bcrypt** | Cost factor ≥ 12 |
89
+ | **scrypt** | N=2^17, r=8, p=1 |
90
+
91
+ ---
92
+
93
+ ## Authentication Requirements
94
+
95
+ ### Password Policy
96
+
97
+ | Requirement | Minimum | Recommended |
98
+ |-------------|---------|-------------|
99
+ | **Length** | 8 characters | 12+ characters |
100
+ | **Breached Password Check** | Required | HaveIBeenPwned API |
101
+ | **History** | Last 5 passwords | Last 10 passwords |
102
+
103
+ ### Session Management
104
+
105
+ | Parameter | Recommended Value |
106
+ |-----------|-------------------|
107
+ | **Session ID Length** | ≥ 128 bits |
108
+ | **Session Timeout (idle)** | 15-30 minutes |
109
+ | **Session Timeout (absolute)** | 8-24 hours |
110
+ | **Cookie Flags** | `Secure; HttpOnly; SameSite=Strict` |
111
+
112
+ ### MFA Requirements
113
+
114
+ - **Required for**: Admin access, sensitive operations, account recovery
115
+ - **Recommended for**: All user accounts
116
+ - **Preferred**: WebAuthn (phishing resistant)
117
+
118
+ ---
119
+
120
+ ## Authorization Checklist
121
+
122
+ - [ ] Implement authorization on server-side (never trust client)
123
+ - [ ] Check permissions on every request
124
+ - [ ] Use deny by default
125
+ - [ ] Log authorization failures
126
+ - [ ] Implement rate limiting per user/role
127
+ - [ ] Review permissions periodically
128
+
129
+ ---
130
+
131
+ ## Input Validation Rules
132
+
133
+ | Data Type | Validation |
134
+ |-----------|------------|
135
+ | **Email** | RFC 5322 regex + domain check |
136
+ | **URL** | Protocol allowlist, no internal IPs |
137
+ | **Phone** | E.164 format |
138
+ | **Date** | ISO 8601, reasonable range |
139
+ | **Integer** | Type check, min/max bounds |
140
+ | **String** | Length limits, character allowlist |
141
+ | **File** | Type, size, magic bytes |
142
+
143
+ ---
144
+
145
+ ## API Security Requirements
146
+
147
+ ### Rate Limiting
148
+
149
+ | Endpoint Type | Limit | Window |
150
+ |---------------|-------|--------|
151
+ | **Login** | 5 attempts | 15 minutes |
152
+ | **API (authenticated)** | 1000 requests | 1 hour |
153
+ | **API (unauthenticated)** | 100 requests | 1 hour |
154
+ | **Password reset** | 3 requests | 1 hour |
155
+
156
+ ---
157
+
158
+ ## Security Testing Requirements
159
+
160
+ | Test Type | Frequency | Purpose |
161
+ |-----------|-----------|---------|
162
+ | **SAST** | Every commit | Find vulnerabilities in source code |
163
+ | **DAST** | Weekly/Release | Test running application |
164
+ | **SCA** | Daily | Check dependency vulnerabilities |
165
+ | **Penetration Testing** | Quarterly/Annually | Manual security testing |
166
+ | **Security Code Review** | Critical changes | Manual code review |
167
+
168
+ ### Recommended Tools
169
+
170
+ | Category | Tools |
171
+ |----------|-------|
172
+ | **SAST** | SonarQube, Semgrep, CodeQL |
173
+ | **DAST** | OWASP ZAP, Burp Suite |
174
+ | **SCA** | Snyk, npm audit, Dependabot |
175
+ | **Secrets Scanning** | GitLeaks, TruffleHog |
176
+
177
+ ---
178
+
179
+ ## Incident Response Severity
180
+
181
+ | Level | Description | Response Time |
182
+ |-------|-------------|---------------|
183
+ | **P1 Critical** | Active breach, data exfiltration | < 15 min |
184
+ | **P2 High** | Vulnerability exploited, no data loss | < 1 hour |
185
+ | **P3 Medium** | Vulnerability discovered, not exploited | < 24 hours |
186
+ | **P4 Low** | Minor security issue | < 1 week |
187
+
188
+ ---
189
+
190
+ ## Pre-Deployment Security Checklist
191
+
192
+ ### Authentication & Authorization
193
+ - [ ] Passwords hashed with Argon2id/bcrypt
194
+ - [ ] MFA available for all users
195
+ - [ ] Session management secure (HttpOnly, Secure, SameSite)
196
+ - [ ] Authorization checked server-side on every request
197
+
198
+ ### Input/Output
199
+ - [ ] All input validated server-side
200
+ - [ ] Output encoded for context (HTML, JS, URL)
201
+ - [ ] Parameterized queries for all database operations
202
+ - [ ] File uploads validated (type, size, content)
203
+
204
+ ### Cryptography
205
+ - [ ] TLS 1.2+ enforced everywhere
206
+ - [ ] Strong algorithms used (AES-256, RSA-2048+)
207
+ - [ ] No secrets in code or version control
208
+ - [ ] Keys stored in secrets manager
209
+
210
+ ### Configuration
211
+ - [ ] Security headers configured
212
+ - [ ] CORS restricted to allowed origins
213
+ - [ ] Debug mode disabled in production
214
+ - [ ] Default credentials changed
215
+
216
+ ### Monitoring
217
+ - [ ] Security events logged
218
+ - [ ] Alerts configured for suspicious activity
219
+ - [ ] Incident response plan documented
220
+
221
+ ---
222
+
223
+ ## Related Standards
224
+
225
+ - [Code Review Checklist](code-review-checklist.md) - Security review section
226
+ - [Testing Standards](testing-standards.md) - Security testing integration
227
+ - [Logging Standards](logging-standards.md) - Security logging
228
+ - [Error Code Standards](error-code-standards.md) - AUTH error codes
229
+ - [Deployment Standards](deployment-standards.md) - Pre-deployment security checklist
230
+
231
+ ---
232
+
233
+ ## Version History
234
+
235
+ | Version | Date | Changes |
236
+ |---------|------|---------|
237
+ | 1.1.0 | 2026-01-29 | Refactored: Split into Rules + Guide, moved explanations to guide |
238
+ | 1.0.0 | 2026-01-29 | Initial release |
239
+
240
+ ---
241
+
242
+ ## License
243
+
244
+ This standard is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
@@ -1,338 +1,39 @@
1
1
  # Spec-Driven Development (SDD) Standards
2
2
 
3
- **Version**: 1.3.0
4
- **Last Updated**: 2026-01-19
3
+ **Version**: 2.1.0
4
+ **Last Updated**: 2026-01-26
5
5
  **Applicability**: All projects adopting Spec-Driven Development
6
-
7
- > **Language**: [English](../core/spec-driven-development.md) | [繁體中文](../locales/zh-TW/core/spec-driven-development.md)
8
-
9
- ---
10
-
11
- ## Purpose
12
-
13
- This standard defines the principles and workflows for Spec-Driven Development (SDD), ensuring that changes are planned, documented, and approved via specifications before implementation.
14
-
15
- **Key Benefits**:
16
- - Reduced miscommunication between stakeholders and developers
17
- - Clear audit trail for all changes
18
- - Easier onboarding for new team members
19
-
20
- ---
21
-
22
- ## SDD Workflow
23
-
24
- ```
25
- ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
26
- │ Proposal │───▶│ Review │───▶│Implementation│
27
- └──────────────┘ └──────────────┘ └──────────────┘
28
-
29
-
30
- ┌──────────────┐ ┌──────────────┐
31
- │ Archive │◀───│ Verification │
32
- └──────────────┘ └──────────────┘
33
- ```
34
-
35
- ### Workflow Stages
36
-
37
- | Stage | Description | Artifacts |
38
- |-------|-------------|-----------|
39
- | **Proposal** | Define what to change and why | `proposal.md` |
40
- | **Review** | Stakeholder approval | Review comments, approval record |
41
- | **Implementation** | Execute the approved spec | Code, tests, docs |
42
- | **Verification** | Confirm implementation matches spec | Test results, review |
43
- | **Archive** | Close and archive the spec | Archived spec with links to commits/PRs |
44
-
45
- ---
46
-
47
- ## Core Principles
48
-
49
- ### 1. Priority of SDD Tool Commands
50
-
51
- **Rule**: When an SDD tool (such as OpenSpec, Spec Kit, etc.) is integrated and provides specific commands (e.g., slash commands like `/openspec` or `/spec`), AI assistants MUST prioritize using these commands over manual file editing.
52
-
53
- **Rationale**:
54
- - **Consistency**: Tools ensure the spec structure follows strict schemas.
55
- - **Traceability**: Commands often handle logging, IDs, and linking automatically.
56
- - **Safety**: Tools may have built-in validation preventing invalid states.
57
-
58
- **Example**:
59
- - ✅ Use `/openspec proposal "Add Login"` instead of manually creating `changes/add-login/proposal.md`.
60
-
61
- ---
62
-
63
- ### 2. Methodology Over Tooling
64
-
65
- **Rule**: SDD is a methodology, not bound to a single tool. While OpenSpec is a common implementation, these standards apply to any SDD tool (e.g., Spec Kit).
66
-
67
- **Guidelines**:
68
- - **Universal Flow**: Proposal -> Review -> Implementation -> Verification -> Archive.
69
- - **Tool Adaptation**: Adapt to the specific commands and patterns of the active SDD tool in the workspace.
70
-
71
- ---
72
-
73
- ### 3. Spec First, Code Second
74
-
75
- **Rule**: No functional code changes shall be made without a corresponding approved specification or change proposal.
76
-
77
- **Exceptions**:
78
- - Critical hotfixes (restore service immediately, document later).
79
- - Trivial changes (typos, comments, formatting).
6
+ **Scope**: universal
7
+ **Industry Standards**: None (Emerging 2025+ methodology)
8
+ **References**: [specmatic.io](https://specmatic.io/)
80
9
 
81
10
  ---
82
11
 
83
- ## Spec Document Template
84
-
85
- ### Proposal Template
86
-
87
- ```markdown
88
- # [SPEC-ID] Feature Title
89
-
90
12
  ## Summary
91
- Brief description of the proposed change.
92
-
93
- ## Motivation
94
- Why is this change needed? What problem does it solve?
95
-
96
- ## Detailed Design
97
- Technical approach, affected components, data flow.
98
-
99
- ## Acceptance Criteria
100
- - [ ] Criterion 1
101
- - [ ] Criterion 2
102
-
103
- ## Dependencies
104
- List any dependencies on other specs or external systems.
105
-
106
- ## Risks
107
- Potential risks and mitigation strategies.
108
- ```
109
-
110
- ---
111
-
112
- ## Integration with Other Standards
113
-
114
- ### With Commit Message Guide
115
-
116
- When implementing an approved spec, reference the spec ID in commit messages:
117
-
118
- ```
119
- feat(auth): implement login feature
120
-
121
- Implements SPEC-001 login functionality with OAuth2 support.
122
-
123
- Refs: SPEC-001
124
- ```
125
-
126
- ### With Check-in Standards
127
13
 
128
- Before checking in code for a spec:
14
+ Spec-Driven Development (SDD) is an AI-era methodology (2025+) distinct from traditional TDD/BDD/ATDD. It ensures that changes are planned, documented, and approved via specifications before implementation. The core principle is **"Spec First, Code Second"** - no functional code changes without a corresponding approved specification.
129
15
 
130
- 1. Spec is approved
131
- 2. ✅ Implementation matches spec
132
- 3. ✅ Tests cover acceptance criteria
133
- 4. ✅ Spec ID referenced in PR
134
-
135
- ### With Code Review Checklist
136
-
137
- Reviewers should verify:
138
-
139
- - [ ] Change matches approved spec
140
- - [ ] No scope creep beyond spec
141
- - [ ] Spec acceptance criteria met
142
-
143
- ---
144
-
145
- ## Common SDD Tools
146
-
147
- | Tool | Description | Command Examples |
148
- |------|-------------|------------------|
149
- | **OpenSpec** | Specification management | `/openspec proposal`, `/openspec approve` |
150
- | **Spec Kit** | Lightweight spec tracking | `/spec create`, `/spec close` |
151
- | **Manual** | No tool, file-based | Create `specs/SPEC-XXX.md` manually |
16
+ SDD operates at different maturity levels: Spec-first (discard after completion), Spec-anchored (maintain throughout evolution), and Spec-as-source (spec is only source, code auto-generated). The methodology uses Forward Derivation to generate test artifacts (BDD scenarios, TDD skeletons, contracts) from specifications.
152
17
 
153
18
  ---
154
19
 
155
- ## Best Practices
156
-
157
- ### Do's
158
-
159
- - ✅ Keep specs focused and atomic (one change per spec)
160
- - ✅ Include clear acceptance criteria
161
- - ✅ Link specs to implementation PRs
162
- - ✅ Archive specs after completion
163
-
164
- ### Don'ts
165
-
166
- - ❌ Start coding before spec approval
167
- - ❌ Modify scope during implementation without updating spec
168
- - ❌ Leave specs in limbo (always close or archive)
169
- - ❌ Skip verification step
170
-
171
- ---
172
-
173
- ## Integration with Reverse Engineering
174
-
175
- ### Overview
176
-
177
- For existing codebases without specifications, use [Reverse Engineering Standards](reverse-engineering-standards.md) to generate SDD-compatible proposal drafts.
178
-
179
- ### Reverse Engineering → SDD Pipeline
180
-
181
- ```
182
- ┌─────────────────────────────────────────────────────────────────────────┐
183
- │ Reverse Engineering → SDD Pipeline │
184
- ├─────────────────────────────────────────────────────────────────────────┤
185
- │ │
186
- │ Existing Code │
187
- │ │ │
188
- │ ▼ │
189
- │ ┌────────────────────────────────────────────────────────────┐ │
190
- │ │ /reverse-spec │ │
191
- │ │ • Code scanning → Technical inventory [Confirmed] │ │
192
- │ │ • Test analysis → Acceptance criteria [Confirmed/Inferred]│ │
193
- │ │ • Gap identification → [Unknown] items │ │
194
- │ └────────────────────────────────────────────────────────────┘ │
195
- │ │ │
196
- │ ▼ │
197
- │ DRAFT SPEC (Reverse-Engineered) │
198
- │ │ │
199
- │ ▼ │
200
- │ ┌────────────────────────────────────────────────────────────┐ │
201
- │ │ SDD Review Process │ │
202
- │ │ • Human fills [Unknown] sections (motivation, risks) │ │
203
- │ │ • Stakeholder validation of [Inferred] items │ │
204
- │ │ • Formal approval │ │
205
- │ └────────────────────────────────────────────────────────────┘ │
206
- │ │ │
207
- │ ▼ │
208
- │ APPROVED SPEC → Normal SDD workflow continues │
209
- │ │
210
- └─────────────────────────────────────────────────────────────────────────┘
211
- ```
212
-
213
- ### Requirements for Reverse-Engineered Specs
214
-
215
- When a specification is generated via reverse engineering:
216
-
217
- 1. **Mark Status**: Include `Status: Draft (Reverse-Engineered)` in metadata
218
- 2. **Fill Unknowns**: All `[Unknown]` sections MUST be filled by humans before approval
219
- 3. **Validate Inferences**: All `[Inferred]` items must be reviewed and confirmed
220
- 4. **Standard Review**: Follow normal SDD review process before implementation
221
- 5. **Source Citations**: Maintain file:line references for traceability
222
-
223
- ### When to Use Reverse Engineering
224
-
225
- | Scenario | Approach |
226
- |----------|----------|
227
- | Legacy system modernization | Start with reverse engineering |
228
- | Documenting undocumented code | Generate specs from code |
229
- | New team onboarding | Extract specifications for knowledge transfer |
230
- | Pre-refactoring documentation | Create specs before major changes |
231
-
232
- ### Related Commands
233
-
234
- | Command | Purpose |
235
- |---------|---------|
236
- | `/reverse-spec` | Generate SDD specification from existing code |
237
- | `/reverse-bdd` | Convert acceptance criteria to Gherkin scenarios |
238
- | `/reverse-tdd` | Analyze test coverage against BDD scenarios |
20
+ **Full Guide: [SDD Guide](../methodologies/guides/sdd-guide.md)**
239
21
 
240
22
  ---
241
23
 
242
- ## Integration with Forward Derivation
243
-
244
- ### Overview
245
-
246
- After a specification is approved, use [Forward Derivation Standards](forward-derivation-standards.md) to automatically generate BDD scenarios, TDD test skeletons, and ATDD acceptance tests from the Acceptance Criteria.
247
-
248
- ### Forward Derivation → SDD Pipeline
249
-
250
- ```
251
- ┌─────────────────────────────────────────────────────────────────────────┐
252
- │ Approved Spec → Forward Derivation Pipeline │
253
- ├─────────────────────────────────────────────────────────────────────────┤
254
- │ │
255
- │ APPROVED SPEC-XXX.md │
256
- │ │ │
257
- │ ▼ │
258
- │ ┌────────────────────────────────────────────────────────────┐ │
259
- │ │ /derive-all specs/SPEC-XXX.md │ │
260
- │ │ • Parse Acceptance Criteria │ │
261
- │ │ • Transform AC → Gherkin scenarios [Generated] │ │
262
- │ │ • Generate TDD test skeletons [Generated] │ │
263
- │ │ • Create ATDD acceptance tables [Generated] │ │
264
- │ └────────────────────────────────────────────────────────────┘ │
265
- │ │ │
266
- │ ▼ │
267
- │ OUTPUT FILES │
268
- │ ├── features/SPEC-XXX.feature (BDD) │
269
- │ ├── tests/SPEC-XXX.test.ts (TDD) │
270
- │ └── acceptance/SPEC-XXX-acceptance.md (ATDD) │
271
- │ │ │
272
- │ ▼ │
273
- │ HUMAN REVIEW → BDD/TDD workflow continues │
274
- │ │
275
- └─────────────────────────────────────────────────────────────────────────┘
276
- ```
24
+ ## Quick Reference
277
25
 
278
- ### When to Use Forward Derivation
279
-
280
- | Scenario | Approach |
281
- |----------|----------|
282
- | Spec approved, starting implementation | Use `/derive-all` to generate test structures |
283
- | Need BDD scenarios quickly | Use `/derive-bdd` for Gherkin generation |
284
- | Starting TDD workflow | Use `/derive-tdd` for test skeletons |
285
- | Manual acceptance testing | Use `/derive-atdd` for test tables |
286
-
287
- ### Related Commands
288
-
289
- | Command | Input | Output | Purpose |
290
- |---------|-------|--------|---------|
291
- | `/derive-bdd` | SPEC-XXX.md | .feature | AC → Gherkin scenarios |
292
- | `/derive-tdd` | SPEC-XXX.md | .test.ts | AC → Test skeletons |
293
- | `/derive-atdd` | SPEC-XXX.md | acceptance.md | AC → Test tables |
294
- | `/derive-all` | SPEC-XXX.md | All above | Full derivation pipeline |
295
-
296
- ---
26
+ | Aspect | Description |
27
+ |--------|-------------|
28
+ | **Core Workflow** | Proposal → Review → Implementation → Verification → Archive |
29
+ | **Key Principle** | Spec First, Code Second |
30
+ | **Test Generation** | Forward Derivation (/derive-bdd, /derive-tdd, /derive-all) |
31
+ | **Maturity Levels** | Spec-first, Spec-anchored, Spec-as-source |
32
+ | **Tools** | OpenSpec, Spec Kit, Manual (file-based) |
297
33
 
298
34
  ## Related Standards
299
35
 
300
- - [Forward Derivation Standards](forward-derivation-standards.md) - Specification-to-test transformation (Spec → BDD/TDD/ATDD)
301
- - [Reverse Engineering Standards](reverse-engineering-standards.md) - Code-to-specification transformation (Code → Spec)
302
- - [Test-Driven Development](test-driven-development.md) - TDD workflow and SDD integration
303
- - [Behavior-Driven Development](behavior-driven-development.md) - BDD workflow with Given-When-Then scenarios
304
- - [Acceptance Test-Driven Development](acceptance-test-driven-development.md) - ATDD workflow for business acceptance
305
- - [Testing Standards](testing-standards.md) - Testing framework and best practices (or use `/testing-guide` skill)
306
- - [Test Completeness Dimensions](test-completeness-dimensions.md) - 7-dimension test coverage
307
- - [Commit Message Guide](commit-message-guide.md) - Commit message conventions
308
- - [Code Check-in Standards](checkin-standards.md) - Code check-in requirements
309
- - [Code Review Checklist](code-review-checklist.md) - Code review guidelines
310
- - [Documentation Structure](documentation-structure.md) - Documentation structure standards
311
-
312
- ---
313
-
314
- ## Version History
315
-
316
- | Version | Date | Changes |
317
- |---------|------|---------|
318
- | 1.4.0 | 2026-01-19 | Added: Integration with Forward Derivation section, derive commands |
319
- | 1.3.0 | 2026-01-19 | Added: Integration with Reverse Engineering section, related commands |
320
- | 1.2.0 | 2026-01-05 | Added: IEEE 830-1998 and SWEBOK v4.0 Chapter 1 (Software Requirements) to References |
321
- | 1.1.0 | 2025-12-24 | Added: Workflow diagram, Spec template, Integration guide, Best practices, Related standards, License |
322
- | 1.0.0 | 2025-12-23 | Initial SDD standard definition |
323
-
324
- ---
325
-
326
- ## References
327
-
328
- - [OpenSpec Documentation](https://github.com/openspec)
329
- - [Design Documents Best Practices](https://www.industrialempathy.com/posts/design-docs-at-google/)
330
- - [ADR (Architecture Decision Records)](https://adr.github.io/)
331
- - [IEEE 830-1998 - Software Requirements Specifications](https://standards.ieee.org/ieee/830/1222/) - Requirements documentation standard
332
- - [SWEBOK v4.0 - Chapter 1: Software Requirements](https://www.computer.org/education/bodies-of-knowledge/software-engineering) - IEEE Computer Society
333
-
334
- ---
335
-
336
- ## License
337
-
338
- This standard is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
36
+ - [Forward Derivation Standards](forward-derivation-standards.md)
37
+ - [Reverse Engineering Standards](reverse-engineering-standards.md)
38
+ - [Test-Driven Development](test-driven-development.md)
39
+ - [Behavior-Driven Development](behavior-driven-development.md)