specdojo 0.1.0 → 0.2.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 (531) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +82 -38
  3. package/dist/agent-response.js +27 -0
  4. package/dist/agent.js +124 -0
  5. package/dist/build-command.js +149 -0
  6. package/dist/build-if-stale.js +35 -0
  7. package/dist/catalog-build.js +1079 -0
  8. package/dist/catalog-generate.js +226 -0
  9. package/dist/catalog-paths.js +31 -0
  10. package/dist/catalog-plan-generate.js +301 -0
  11. package/dist/catalog-plan-prompt.js +73 -0
  12. package/dist/catalog-plan.js +471 -0
  13. package/dist/catalog-scaffold.js +255 -0
  14. package/dist/catalog-types.js +4 -0
  15. package/dist/catalog.js +606 -0
  16. package/dist/dashboard.js +980 -0
  17. package/dist/deliverable-trash.js +148 -0
  18. package/dist/deliverable.js +97 -0
  19. package/dist/dist-freshness.js +150 -0
  20. package/dist/doc-index.js +424 -0
  21. package/dist/exec-agent-config.js +172 -0
  22. package/dist/exec-agent-git-state.js +136 -0
  23. package/dist/exec-agent-protected-config.js +276 -0
  24. package/dist/exec-events.js +250 -112
  25. package/dist/exec-evidence.js +317 -0
  26. package/dist/exec-format.js +45 -0
  27. package/dist/exec-limit.js +202 -0
  28. package/dist/exec-parent-validation.js +169 -0
  29. package/dist/exec-pipeline-state.js +160 -0
  30. package/dist/exec-plans.js +1016 -0
  31. package/dist/exec-project.js +25 -11
  32. package/dist/exec-protection-handoff.js +169 -0
  33. package/dist/exec-provider-scaffold.js +99 -0
  34. package/dist/exec-register-resume.js +196 -0
  35. package/dist/exec-register.js +281 -0
  36. package/dist/exec-reporter.js +329 -0
  37. package/dist/exec-results.js +510 -0
  38. package/dist/exec-run-lock.js +149 -0
  39. package/dist/exec-run.js +4953 -0
  40. package/dist/exec-schedule-calendar.js +86 -9
  41. package/dist/exec-schedule-cpm.js +30 -12
  42. package/dist/exec-schedule-gantt-chart-render.js +428 -0
  43. package/dist/exec-schedule-gantt-chart-scope.js +111 -0
  44. package/dist/exec-schedule-gantt-chart.js +2 -0
  45. package/dist/exec-schedule-hash.js +34 -25
  46. package/dist/exec-schedule-index.js +200 -67
  47. package/dist/exec-schedule-initial.js +100 -0
  48. package/dist/exec-schedule-progress.js +51 -26
  49. package/dist/exec-schedule-ready.js +71 -27
  50. package/dist/exec-schedule.js +171 -93
  51. package/dist/exec-shared.js +146 -25
  52. package/dist/exec-strategy.js +547 -0
  53. package/dist/exec-task-view.js +64 -0
  54. package/dist/exec-trial.js +895 -0
  55. package/dist/exec-worktree-command.js +426 -0
  56. package/dist/exec-worktree-ops.js +847 -0
  57. package/dist/exec-worktree.js +359 -0
  58. package/dist/exec.js +744 -192
  59. package/dist/frontmatter-namespace.js +48 -0
  60. package/dist/git-environment.js +23 -0
  61. package/dist/grade-result.js +137 -0
  62. package/dist/grade.js +2456 -0
  63. package/dist/index-command.js +103 -0
  64. package/dist/job.js +1081 -0
  65. package/dist/kata-command.js +303 -0
  66. package/dist/kata.js +187 -0
  67. package/dist/package-paths.js +15 -0
  68. package/dist/practice-id.js +24 -0
  69. package/dist/register-date.js +122 -0
  70. package/dist/register-events.js +363 -0
  71. package/dist/register-history.js +323 -0
  72. package/dist/register-item.js +455 -0
  73. package/dist/register-migrate-timestamps.js +176 -0
  74. package/dist/register.js +2199 -0
  75. package/dist/review-plan.js +199 -0
  76. package/dist/review-types.js +1 -0
  77. package/dist/role-types.js +1 -0
  78. package/dist/routine.js +814 -0
  79. package/dist/schedule-approach.js +252 -0
  80. package/dist/schedule-build.js +552 -0
  81. package/dist/schedule-phase-sets.js +73 -0
  82. package/dist/schedule-strategy-generate.js +812 -0
  83. package/dist/schedule-strategy-profiles.js +276 -0
  84. package/dist/schedule.js +420 -0
  85. package/dist/spawn-self.js +28 -0
  86. package/dist/specdojo-config.js +133 -39
  87. package/dist/specdojo.js +55 -7
  88. package/dist/template-frontmatter.js +89 -0
  89. package/dist/template-resolution.js +92 -0
  90. package/dist/timeline-build.js +334 -0
  91. package/dist/timeline.js +107 -0
  92. package/dist/watch.js +313 -0
  93. package/dist/yaml-pages-command.js +28 -0
  94. package/dist/yaml-pages.js +180 -0
  95. package/dist/yaml-schema-modeline.js +49 -0
  96. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +600 -0
  97. package/docs/ja/specdojo/exec-templates/xep-bootstrap-template.md +120 -0
  98. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +37 -0
  99. package/docs/ja/specdojo/exec-templates/xep-cross-deliverable-dedup-template.md +51 -0
  100. package/docs/ja/specdojo/exec-templates/xep-freeform-template.md +74 -0
  101. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +109 -0
  102. package/docs/ja/specdojo/exec-templates/xep-job-template.md +43 -0
  103. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +82 -0
  104. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +86 -0
  105. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +42 -0
  106. package/docs/ja/specdojo/exec-templates/xep-register-template.md +49 -0
  107. package/docs/ja/specdojo/exec-templates/xep-retrofit-template.md +98 -0
  108. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +86 -0
  109. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +86 -0
  110. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +86 -0
  111. package/docs/ja/specdojo/exec-templates/xep-template.md +66 -0
  112. package/docs/ja/specdojo/exec-templates/xer-cross-deliverable-dedup-template.md +31 -0
  113. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +40 -0
  114. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +30 -0
  115. package/docs/ja/specdojo/exec-templates/xer-template.md +19 -0
  116. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +70 -0
  117. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +97 -0
  118. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +76 -0
  119. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +73 -0
  120. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +74 -0
  121. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +74 -0
  122. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +73 -0
  123. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +73 -0
  124. package/docs/ja/specdojo/exec-templates/xrp-template.md +67 -0
  125. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +7 -0
  126. package/docs/ja/specdojo/exec-templates/xrr-template.md +21 -0
  127. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +7 -0
  128. package/docs/ja/specdojo/guides/branch-workflow-guide.md +354 -0
  129. package/docs/ja/specdojo/guides/docs-editing-guide.md +327 -0
  130. package/docs/ja/specdojo/guides/docs-structure-guide.md +519 -0
  131. package/docs/ja/specdojo/guides/exec-config-guide.md +589 -0
  132. package/docs/ja/specdojo/guides/exec-operation-guide.md +440 -0
  133. package/docs/ja/specdojo/guides/exec-worktree-guide.md +318 -0
  134. package/docs/ja/specdojo/guides/kata-guide.md +89 -0
  135. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +127 -0
  136. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +228 -0
  137. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +111 -0
  138. package/docs/ja/specdojo/guides/quick-start-guide.md +473 -0
  139. package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
  140. package/docs/ja/specdojo/guides/review-guide.md +428 -0
  141. package/docs/ja/specdojo/guides/routine-operation-guide.md +282 -0
  142. package/docs/ja/specdojo/guides/ryu-guide.md +230 -0
  143. package/docs/ja/specdojo/guides/schedule-design-guide.md +429 -0
  144. package/docs/ja/specdojo/guides/schedule-operation-guide.md +151 -0
  145. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +257 -0
  146. package/docs/ja/specdojo/guides/timeline-design-guide.md +160 -0
  147. package/docs/ja/specdojo/guides/track-design-guide.md +215 -0
  148. package/docs/ja/specdojo/guides/use-case-guide.md +133 -0
  149. package/docs/ja/specdojo/guides/waza-guide.md +224 -0
  150. package/docs/ja/specdojo/index.md +33 -0
  151. package/docs/ja/specdojo/philosophy/needs-to-implementation-philosophy.md +212 -0
  152. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +242 -0
  153. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +198 -0
  154. package/docs/ja/specdojo/recipes/cdfd-recipe.md +218 -0
  155. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +198 -0
  156. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +100 -0
  157. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +148 -0
  158. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +97 -0
  159. package/docs/ja/specdojo/recipes/pm-members-recipe.md +149 -0
  160. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +96 -0
  161. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +98 -0
  162. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +97 -0
  163. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +96 -0
  164. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +136 -0
  165. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +162 -0
  166. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +187 -0
  167. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +235 -0
  168. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +205 -0
  169. package/docs/ja/specdojo/recipes/prj-overview-recipe.md +289 -0
  170. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +201 -0
  171. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +168 -0
  172. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +179 -0
  173. package/docs/ja/specdojo/recipes/stsd-recipe.md +138 -0
  174. package/docs/ja/specdojo/references/command-reference.md +718 -0
  175. package/docs/ja/specdojo/references/deliverables-reference.md +407 -0
  176. package/docs/ja/specdojo/references/directory-layout-reference.md +280 -0
  177. package/docs/ja/specdojo/references/specdojo-config-reference.md +133 -0
  178. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +372 -0
  179. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +302 -0
  180. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +331 -0
  181. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +134 -0
  182. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +207 -0
  183. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +102 -0
  184. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +131 -0
  185. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +269 -0
  186. package/docs/ja/specdojo/rulebooks/br-rulebook.md +187 -0
  187. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +279 -0
  188. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +219 -0
  189. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +233 -0
  190. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +182 -0
  191. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +171 -0
  192. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +105 -0
  193. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +195 -0
  194. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +285 -0
  195. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +292 -0
  196. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +171 -0
  197. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +325 -0
  198. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +266 -0
  199. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +294 -0
  200. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +21 -0
  201. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +401 -0
  202. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +311 -0
  203. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +158 -0
  204. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +287 -0
  205. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +62 -0
  206. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +100 -0
  207. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +298 -0
  208. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +379 -0
  209. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +310 -0
  210. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +86 -0
  211. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +297 -0
  212. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +79 -0
  213. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +213 -0
  214. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +311 -0
  215. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +94 -0
  216. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +81 -0
  217. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +117 -0
  218. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +118 -0
  219. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +116 -0
  220. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +116 -0
  221. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +116 -0
  222. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +421 -0
  223. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +307 -0
  224. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +312 -0
  225. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +63 -0
  226. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +353 -0
  227. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +184 -0
  228. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +179 -0
  229. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +184 -0
  230. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +183 -0
  231. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +185 -0
  232. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +185 -0
  233. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +186 -0
  234. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +186 -0
  235. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +184 -0
  236. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +61 -0
  237. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +84 -0
  238. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +357 -0
  239. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +80 -0
  240. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +484 -0
  241. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +120 -0
  242. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +293 -0
  243. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +211 -0
  244. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +94 -0
  245. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +116 -0
  246. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +93 -0
  247. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +190 -0
  248. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +108 -0
  249. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +122 -0
  250. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +117 -0
  251. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +116 -0
  252. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +93 -0
  253. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +146 -0
  254. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +65 -0
  255. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +178 -0
  256. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +232 -0
  257. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +235 -0
  258. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +242 -0
  259. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +187 -0
  260. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +201 -0
  261. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +165 -0
  262. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +165 -0
  263. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +202 -0
  264. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +139 -0
  265. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +63 -0
  266. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +93 -0
  267. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +93 -0
  268. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +329 -0
  269. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +297 -0
  270. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +132 -0
  271. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +215 -0
  272. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +376 -0
  273. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +313 -0
  274. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +246 -0
  275. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +119 -0
  276. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +188 -0
  277. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +114 -0
  278. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +117 -0
  279. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +101 -0
  280. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +103 -0
  281. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +396 -0
  282. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +207 -0
  283. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +387 -0
  284. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +303 -0
  285. package/docs/ja/specdojo/samples/atc-index-sample.md +38 -0
  286. package/docs/ja/specdojo/samples/atc-sample.md +41 -0
  287. package/docs/ja/specdojo/samples/bac-sample.md +38 -0
  288. package/docs/ja/specdojo/samples/bdd-sample.yaml +71 -0
  289. package/docs/ja/specdojo/samples/bds-sample.md +38 -0
  290. package/docs/ja/specdojo/samples/bes-index-sample.md +38 -0
  291. package/docs/ja/specdojo/samples/bes-sample.md +38 -0
  292. package/docs/ja/specdojo/samples/bps-sample.md +38 -0
  293. package/docs/ja/specdojo/samples/br-sample.md +40 -0
  294. package/docs/ja/specdojo/samples/ccd-sample.md +38 -0
  295. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +284 -0
  296. package/docs/ja/specdojo/samples/cdfd-sample.md +229 -0
  297. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +146 -0
  298. package/docs/ja/specdojo/samples/cdsd-sample.md +38 -0
  299. package/docs/ja/specdojo/samples/cld-sample.md +38 -0
  300. package/docs/ja/specdojo/samples/cnd-sample.md +38 -0
  301. package/docs/ja/specdojo/samples/cop-index-sample.md +38 -0
  302. package/docs/ja/specdojo/samples/cop-sample.md +38 -0
  303. package/docs/ja/specdojo/samples/cpd-sample.md +38 -0
  304. package/docs/ja/specdojo/samples/cstd-sample.md +11 -0
  305. package/docs/ja/specdojo/samples/cxd-sample.md +38 -0
  306. package/docs/ja/specdojo/samples/dct-index-sample.yaml +39 -0
  307. package/docs/ja/specdojo/samples/dct-sample.yaml +91 -0
  308. package/docs/ja/specdojo/samples/dec-sample.md +39 -0
  309. package/docs/ja/specdojo/samples/dmd-index-sample.md +50 -0
  310. package/docs/ja/specdojo/samples/dmd-sample.md +74 -0
  311. package/docs/ja/specdojo/samples/etc-index-sample.md +38 -0
  312. package/docs/ja/specdojo/samples/etc-sample.md +38 -0
  313. package/docs/ja/specdojo/samples/gl-sample.yaml +37 -0
  314. package/docs/ja/specdojo/samples/ifd-sample.md +38 -0
  315. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +102 -0
  316. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +107 -0
  317. package/docs/ja/specdojo/samples/ifx-file-sample.md +38 -0
  318. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +89 -0
  319. package/docs/ja/specdojo/samples/imp-business-sample.md +66 -0
  320. package/docs/ja/specdojo/samples/imp-data-sample.md +60 -0
  321. package/docs/ja/specdojo/samples/imp-interface-sample.md +60 -0
  322. package/docs/ja/specdojo/samples/imp-operations-sample.md +60 -0
  323. package/docs/ja/specdojo/samples/imp-test-sample.md +60 -0
  324. package/docs/ja/specdojo/samples/itc-index-sample.md +38 -0
  325. package/docs/ja/specdojo/samples/itc-sample.md +38 -0
  326. package/docs/ja/specdojo/samples/mip-index-sample.md +38 -0
  327. package/docs/ja/specdojo/samples/mm-sample.md +35 -0
  328. package/docs/ja/specdojo/samples/mtp-sample.md +38 -0
  329. package/docs/ja/specdojo/samples/nfr-availability-sample.md +38 -0
  330. package/docs/ja/specdojo/samples/nfr-index-sample.md +38 -0
  331. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +38 -0
  332. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +38 -0
  333. package/docs/ja/specdojo/samples/nfr-operations-sample.md +38 -0
  334. package/docs/ja/specdojo/samples/nfr-performance-sample.md +38 -0
  335. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +38 -0
  336. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +38 -0
  337. package/docs/ja/specdojo/samples/nfr-usability-sample.md +38 -0
  338. package/docs/ja/specdojo/samples/ntp-sample.md +38 -0
  339. package/docs/ja/specdojo/samples/opd-access-control-sample.md +29 -0
  340. package/docs/ja/specdojo/samples/opd-incident-management-sample.md +31 -0
  341. package/docs/ja/specdojo/samples/opd-index-sample.md +41 -0
  342. package/docs/ja/specdojo/samples/opd-monitoring-sample.md +32 -0
  343. package/docs/ja/specdojo/samples/opd-sample.md +38 -0
  344. package/docs/ja/specdojo/samples/opr-access-control-sample.md +24 -0
  345. package/docs/ja/specdojo/samples/opr-backup-restore-sample.md +27 -0
  346. package/docs/ja/specdojo/samples/opr-batch-sample.md +23 -0
  347. package/docs/ja/specdojo/samples/opr-change-sample.md +24 -0
  348. package/docs/ja/specdojo/samples/opr-incident-sample.md +38 -0
  349. package/docs/ja/specdojo/samples/opr-index-sample.md +43 -0
  350. package/docs/ja/specdojo/samples/opr-monitoring-sample.md +27 -0
  351. package/docs/ja/specdojo/samples/opr-sample.md +38 -0
  352. package/docs/ja/specdojo/samples/opr-support-sample.md +23 -0
  353. package/docs/ja/specdojo/samples/otp-index-sample.md +66 -0
  354. package/docs/ja/specdojo/samples/otp-sample.md +68 -0
  355. package/docs/ja/specdojo/samples/pm-change-request-log-sample.md +47 -0
  356. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +46 -0
  357. package/docs/ja/specdojo/samples/pm-issue-log-sample.md +45 -0
  358. package/docs/ja/specdojo/samples/pm-members-sample.yaml +103 -0
  359. package/docs/ja/specdojo/samples/pm-organization-sample.md +46 -0
  360. package/docs/ja/specdojo/samples/pm-plan-sample.md +57 -0
  361. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +52 -0
  362. package/docs/ja/specdojo/samples/pm-raci-sample.md +57 -0
  363. package/docs/ja/specdojo/samples/pm-risk-register-sample.md +43 -0
  364. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +41 -0
  365. package/docs/ja/specdojo/samples/pr-sample.md +39 -0
  366. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +57 -0
  367. package/docs/ja/specdojo/samples/prj-charter-sample.md +121 -0
  368. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +105 -0
  369. package/docs/ja/specdojo/samples/prj-issues-and-approach-sample.md +78 -0
  370. package/docs/ja/specdojo/samples/prj-overview-sample.md +95 -0
  371. package/docs/ja/specdojo/samples/prj-scope-sample.md +71 -0
  372. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +60 -0
  373. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +62 -0
  374. package/docs/ja/specdojo/samples/sac-sample.md +38 -0
  375. package/docs/ja/specdojo/samples/sf-index-sample.md +38 -0
  376. package/docs/ja/specdojo/samples/sf-sample.md +38 -0
  377. package/docs/ja/specdojo/samples/sld-sample.md +38 -0
  378. package/docs/ja/specdojo/samples/stc-index-sample.md +38 -0
  379. package/docs/ja/specdojo/samples/stc-sample.md +38 -0
  380. package/docs/ja/specdojo/samples/stsd-sample.md +58 -0
  381. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +38 -0
  382. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +38 -0
  383. package/docs/ja/specdojo/samples/sysd-index-sample.md +38 -0
  384. package/docs/ja/specdojo/samples/trc-requirements-to-specs-sample.md +56 -0
  385. package/docs/ja/specdojo/samples/trc-requirements-to-tests-sample.md +56 -0
  386. package/docs/ja/specdojo/samples/tsd-index-sample.md +29 -0
  387. package/docs/ja/specdojo/samples/tsd-sample.md +38 -0
  388. package/docs/ja/specdojo/samples/tsp-index-sample.md +38 -0
  389. package/docs/ja/specdojo/samples/uis-sample.md +38 -0
  390. package/docs/ja/specdojo/samples/utc-index-sample.md +38 -0
  391. package/docs/ja/specdojo/samples/utc-sample.md +38 -0
  392. package/docs/ja/specdojo/schemas/v1/guide-content.schema.yaml +20 -0
  393. package/docs/ja/specdojo/schemas/v1/philosophy-content.schema.yaml +21 -0
  394. package/docs/ja/specdojo/schemas/v1/reference-content.schema.yaml +21 -0
  395. package/docs/ja/specdojo/standards/document-metadata-standard.md +323 -0
  396. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +75 -0
  397. package/docs/ja/specdojo/standards/git-branching-standard.md +227 -0
  398. package/docs/ja/specdojo/standards/guide-authoring-standard.md +124 -0
  399. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +929 -0
  400. package/docs/ja/specdojo/standards/job-definition-standard.md +148 -0
  401. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +431 -0
  402. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +113 -0
  403. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +143 -0
  404. package/docs/ja/specdojo/standards/reference-authoring-standard.md +99 -0
  405. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +140 -0
  406. package/docs/ja/specdojo/standards/sample-authoring-standard.md +151 -0
  407. package/docs/ja/specdojo/standards/standard-authoring-standard.md +108 -0
  408. package/docs/ja/specdojo/standards/template-authoring-standard.md +101 -0
  409. package/docs/ja/specdojo/standards/test-document-scope-standard.md +176 -0
  410. package/docs/ja/specdojo/templates/cdfd-overview-template.md +199 -0
  411. package/docs/ja/specdojo/templates/cdfd-template.md +173 -0
  412. package/docs/ja/specdojo/templates/cdfd-uc-template.md +148 -0
  413. package/docs/ja/specdojo/templates/dct-architecture-template.yaml +136 -0
  414. package/docs/ja/specdojo/templates/dct-business-acceptance-criteria-template.yaml +34 -0
  415. package/docs/ja/specdojo/templates/dct-business-model-bes-template.yaml +75 -0
  416. package/docs/ja/specdojo/templates/dct-business-model-bps-template.yaml +49 -0
  417. package/docs/ja/specdojo/templates/dct-business-model-br-template.yaml +50 -0
  418. package/docs/ja/specdojo/templates/dct-data-flow-template.yaml +40 -0
  419. package/docs/ja/specdojo/templates/dct-data-model-bdd-template.yaml +46 -0
  420. package/docs/ja/specdojo/templates/dct-data-model-ccd-template.yaml +46 -0
  421. package/docs/ja/specdojo/templates/dct-data-model-cdsd-template.yaml +41 -0
  422. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +38 -0
  423. package/docs/ja/specdojo/templates/dct-data-model-sld-template.yaml +38 -0
  424. package/docs/ja/specdojo/templates/dct-data-model-stsd-template.yaml +46 -0
  425. package/docs/ja/specdojo/templates/dct-external-interface-specs-template.yaml +114 -0
  426. package/docs/ja/specdojo/templates/dct-glossary-template.yaml +35 -0
  427. package/docs/ja/specdojo/templates/dct-impact-analysis-template.yaml +138 -0
  428. package/docs/ja/specdojo/templates/dct-index-template.md +40 -0
  429. package/docs/ja/specdojo/templates/dct-migration-planning-template.yaml +148 -0
  430. package/docs/ja/specdojo/templates/dct-non-functional-requirements-template.yaml +222 -0
  431. package/docs/ja/specdojo/templates/dct-operations-template.yaml +108 -0
  432. package/docs/ja/specdojo/templates/dct-project-definition-template.yaml +210 -0
  433. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +423 -0
  434. package/docs/ja/specdojo/templates/dct-system-acceptance-criteria-template.yaml +37 -0
  435. package/docs/ja/specdojo/templates/dct-system-design-template.yaml +82 -0
  436. package/docs/ja/specdojo/templates/dct-system-functions-template.yaml +58 -0
  437. package/docs/ja/specdojo/templates/dct-test-specs-template.yaml +261 -0
  438. package/docs/ja/specdojo/templates/dct-user-interface-model-template.yaml +60 -0
  439. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +88 -0
  440. package/docs/ja/specdojo/templates/opr-template.md +85 -0
  441. package/docs/ja/specdojo/templates/pjr-change-request-template.md +60 -0
  442. package/docs/ja/specdojo/templates/pjr-decision-template.md +61 -0
  443. package/docs/ja/specdojo/templates/pjr-index-template.md +49 -0
  444. package/docs/ja/specdojo/templates/pjr-issue-template.md +50 -0
  445. package/docs/ja/specdojo/templates/pjr-note-template.md +35 -0
  446. package/docs/ja/specdojo/templates/pjr-question-template.md +53 -0
  447. package/docs/ja/specdojo/templates/pjr-risk-template.md +49 -0
  448. package/docs/ja/specdojo/templates/pjr-todo-template.md +41 -0
  449. package/docs/ja/specdojo/templates/pjr-views-by-owner-template.md +22 -0
  450. package/docs/ja/specdojo/templates/pjr-views-by-priority-template.md +22 -0
  451. package/docs/ja/specdojo/templates/pjr-views-by-status-template.md +22 -0
  452. package/docs/ja/specdojo/templates/pm-change-request-log-template.md +20 -0
  453. package/docs/ja/specdojo/templates/pm-communication-plan-template.md +46 -0
  454. package/docs/ja/specdojo/templates/pm-decision-log-template.md +20 -0
  455. package/docs/ja/specdojo/templates/pm-issue-log-template.md +20 -0
  456. package/docs/ja/specdojo/templates/pm-members-template.yaml +105 -0
  457. package/docs/ja/specdojo/templates/pm-organization-template.md +44 -0
  458. package/docs/ja/specdojo/templates/pm-plan-template.md +52 -0
  459. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +46 -0
  460. package/docs/ja/specdojo/templates/pm-raci-template.md +51 -0
  461. package/docs/ja/specdojo/templates/pm-risk-register-template.md +20 -0
  462. package/docs/ja/specdojo/templates/pm-roles-template.yaml +53 -0
  463. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +59 -0
  464. package/docs/ja/specdojo/templates/prj-charter-template.md +116 -0
  465. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +116 -0
  466. package/docs/ja/specdojo/templates/prj-issues-and-approach-template.md +89 -0
  467. package/docs/ja/specdojo/templates/prj-overview-template.md +85 -0
  468. package/docs/ja/specdojo/templates/prj-scope-template.md +75 -0
  469. package/docs/ja/specdojo/templates/prj-stakeholder-register-template.md +64 -0
  470. package/docs/ja/specdojo/templates/prj-success-criteria-and-acceptance-criteria-template.md +60 -0
  471. package/docs/ja/specdojo/templates/stsd-template.md +57 -0
  472. package/docs/specdojo/schemas/v1/bdd.schema.yaml +230 -0
  473. package/docs/specdojo/schemas/v1/common-frontmatter.schema.yaml +77 -0
  474. package/docs/specdojo/schemas/v1/dct-index.schema.yaml +85 -0
  475. package/docs/specdojo/schemas/v1/dct-plan.schema.yaml +324 -0
  476. package/docs/specdojo/schemas/v1/dct.schema.yaml +368 -0
  477. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +91 -0
  478. package/docs/specdojo/schemas/v1/esil.schema.yaml +142 -0
  479. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +101 -0
  480. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +272 -0
  481. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +162 -0
  482. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +126 -0
  483. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +151 -0
  484. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +144 -0
  485. package/docs/specdojo/schemas/v1/grade-done-criteria.schema.yaml +79 -0
  486. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +60 -0
  487. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +118 -0
  488. package/docs/specdojo/schemas/v1/guide-frontmatter.schema.yaml +19 -0
  489. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +293 -0
  490. package/docs/specdojo/schemas/v1/job-run.schema.yaml +90 -0
  491. package/docs/specdojo/schemas/v1/job.schema.yaml +198 -0
  492. package/docs/specdojo/schemas/v1/philosophy-frontmatter.schema.yaml +19 -0
  493. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +56 -0
  494. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +252 -0
  495. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +387 -0
  496. package/docs/specdojo/schemas/v1/pm-roles.schema.yaml +106 -0
  497. package/docs/specdojo/schemas/v1/recipe-frontmatter.schema.yaml +27 -0
  498. package/docs/specdojo/schemas/v1/reference-frontmatter.schema.yaml +18 -0
  499. package/docs/specdojo/schemas/v1/register-events.schema.yaml +106 -0
  500. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +204 -0
  501. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +36 -0
  502. package/docs/specdojo/schemas/v1/routine.schema.yaml +87 -0
  503. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +61 -0
  504. package/docs/specdojo/schemas/v1/sch-common.schema.yaml +258 -0
  505. package/docs/specdojo/schemas/v1/sch-defaults.schema.yaml +48 -0
  506. package/docs/specdojo/schemas/v1/sch-milestones.schema.yaml +64 -0
  507. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +772 -0
  508. package/docs/specdojo/schemas/v1/sch-track.schema.yaml +66 -0
  509. package/docs/specdojo/schemas/v1/standard-frontmatter.schema.yaml +18 -0
  510. package/docs/specdojo/schemas/v1/tml-index.schema.yaml +103 -0
  511. package/package.json +120 -24
  512. package/templates/claude/README.md +46 -0
  513. package/templates/claude/agents/claude-expert-review-executor.md +14 -0
  514. package/templates/claude/agents/claude-review-executor.md +14 -0
  515. package/templates/claude/settings.edit.json +6 -0
  516. package/templates/claude/settings.report.json +6 -0
  517. package/templates/claude/settings.review.json +7 -0
  518. package/templates/codex/README.md +61 -0
  519. package/templates/codex/agents/codex-executor.toml +12 -0
  520. package/templates/codex/agents/codex-expert-executor.toml +12 -0
  521. package/templates/codex/agents/codex-expert-review-executor.toml +10 -0
  522. package/templates/codex/agents/codex-review-executor.toml +10 -0
  523. package/templates/copilot/README.md +41 -0
  524. package/templates/copilot/exec-defaults-snippet.yaml +28 -0
  525. package/templates/copilot/pm-members-snippet.yaml +44 -0
  526. package/templates/opencode/README.md +41 -0
  527. package/templates/opencode/agents/opencode-executor.md +59 -0
  528. package/templates/opencode/agents/opencode-reporter.md +26 -0
  529. package/templates/opencode/agents/opencode-review-executor.md +48 -0
  530. package/dist/exec-schedule-timeline-render.js +0 -201
  531. package/dist/exec-schedule-timeline.js +0 -2
@@ -0,0 +1,178 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:prj-assumptions-constraints-dependencies-rulebook
4
+ type: rulebook
5
+ status: ready
6
+ target_format: markdown
7
+ recipe: specdojo:prj-assumptions-constraints-dependencies-recipe
8
+ sample: specdojo:prj-assumptions-constraints-dependencies-sample
9
+ template: specdojo:prj-assumptions-constraints-dependencies-template
10
+ based_on:
11
+ - specdojo:rulebook-authoring-standard
12
+ supersedes: []
13
+ ---
14
+
15
+ # 前提・制約・依存関係 作成ルール
16
+
17
+ Assumptions, Constraints and Dependencies Documentation Rulebook
18
+
19
+ 本書は、プロジェクトの成立条件、守るべき境界、外部または先行成果物への依存を、変更時に判断できる形で整理する規約である。構造・必須項目・禁止事項は本書を正とし、作り方は recipe、粒度は sample、記入の骨組みは template を参照する。
20
+
21
+ ## 1. 全体方針
22
+
23
+ - 対象は、プロジェクトの前提条件、制約事項、依存関係、およびそれらの変化に対する影響評価と変更管理である。
24
+ - 各項目は、条件だけで終わらせず、影響、確認方法、変化または逸脱のトリガー、所有者、対応方針を一組で記載する。
25
+ - 前提は「成立するものとして置く条件」、制約は「守るべき限界」、依存関係は「他者・外部サービス・先行成果物などから受ける条件」として分離する。
26
+ - スコープなど上位文書で確定済みの決定事項(対象外、境界の判断基準、責務境界)は行として再掲しない。該当章の冒頭で参照先を明示して委譲し、本書には上位文書に現れない成立条件・限界・依存だけを登録する。
27
+ - 上位文書がすでに継続的な監視・記録先を持つ事項(判断ゲートの記録先が明示された章など)は、内容を要約して再登録せず参照にとどめる。上位文書が結論だけを示し継続監視の仕組みを持たない場合は、監視方法・トリガー・所有者・対応方針を付与して運用可能な形に展開してよいが、その場合は展開元の上位文書と章を明示する。
28
+ - 文書は計画・設計・実装の詳細やリスク登録簿を代替しない。必要な詳細はそれぞれの成果物に委譲する。
29
+ - AI Agent は作成・確認を支援できるが、承認、公開可否、エスカレーションなどの最終判断を委ねない。
30
+
31
+ ## 2. 位置づけと用語定義
32
+
33
+ ### 2.1. 位置づけ
34
+
35
+ 本書はスコープで定めた境界を受け、実行上の成立条件と変更時の判断材料を明示する。前提・制約・依存が変化した結果としてリスク、変更要求、計画へ影響を伝える。
36
+
37
+ ```mermaid
38
+ flowchart LR
39
+ SCOPE["プロジェクトスコープ"]
40
+ ACD["前提・制約・依存関係"]
41
+ IMPACT["影響評価"]
42
+ CHANGE["変更管理"]
43
+
44
+ SCOPE --> ACD --> IMPACT --> CHANGE
45
+
46
+ classDef target stroke-width:4px
47
+ class ACD target
48
+ ```
49
+
50
+ ### 2.2. 用語定義
51
+
52
+ | 用語 | 定義 |
53
+ | -------- | -------------------------------------------------------------------------------------------- |
54
+ | 前提条件 | プロジェクトの計画または進行が成立するものとして置く条件。崩れた場合の影響と確認方法を伴う。 |
55
+ | 制約事項 | 予算、期限、公開範囲、技術選択、責務境界など、逸脱してはならない限界。 |
56
+ | 依存関係 | 外部組織、サービス、先行成果物、意思決定などが提供または確定することを必要とする関係。 |
57
+ | トリガー | 前提の崩壊、制約の逸脱、依存先の変化を検知して見直しを始める条件。 |
58
+ | 所有者 | 項目の状態確認と一次対応を担うロールまたは責任者。最終判断者とは区別する。 |
59
+
60
+ ## 3. ファイル命名・ID規則
61
+
62
+ ### 3.1. 配置
63
+
64
+ - 成果物は `docs/ja/projects/<project-id>/020-project-definition/prj-assumptions-constraints-dependencies.md` に配置する。
65
+ - rulebook は `docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md` に配置する。
66
+ - recipe、sample、template は、それぞれ `docs/ja/specdojo/recipes/`、`samples/`、`templates/` の同じ prefix を持つファイルに配置する。
67
+
68
+ ### 3.2. ドキュメント ID
69
+
70
+ - 成果物 ID: `<project-id>:prj-assumptions-constraints-dependencies`
71
+ - rulebook ID: `specdojo:prj-assumptions-constraints-dependencies-rulebook`
72
+ - 実践の型 ID: `specdojo:prj-assumptions-constraints-dependencies-recipe`、`specdojo:prj-assumptions-constraints-dependencies-sample`、`specdojo:prj-assumptions-constraints-dependencies-template`
73
+
74
+ ### 3.3. ファイル名
75
+
76
+ - 成果物: `prj-assumptions-constraints-dependencies.md`
77
+ - 実践の型: `prj-assumptions-constraints-dependencies-{rulebook,recipe,sample,template}.md`
78
+ - 日本語の表示名を使う場合も、ID とファイル名は一意で検索可能な英小文字・ハイフン区切りを維持する。
79
+
80
+ ## 4. 推奨 Frontmatter 項目
81
+
82
+ ### 4.1. 設定内容
83
+
84
+ | 項目 | 説明 | 必須 |
85
+ | ---------- | ------------------------------------------------------------ | ---- |
86
+ | id | `<project-id>:prj-assumptions-constraints-dependencies` | ○ |
87
+ | type | `project` | ○ |
88
+ | status | `draft` / `ready` / `deprecated` | ○ |
89
+ | rulebook | `specdojo:prj-assumptions-constraints-dependencies-rulebook` | ○ |
90
+ | based_on | 直接参照した上位成果物の ID 配列 | 任意 |
91
+ | supersedes | 置き換える旧成果物の ID 配列 | 任意 |
92
+
93
+ ### 4.2. 推奨ルール
94
+
95
+ - `based_on` には、内容の根拠として直接参照した文書だけを記載する。
96
+ - 未確定事項は _TODO_:、意思決定待ちは _UNDECIDED_:、仮置きの前提は _ASSUMPTION_: で明示する。
97
+ - H1 には成果物の表示名を置き、frontmatter に `title` を重複して持たせない。
98
+
99
+ ## 5. 本文構成(標準テンプレ)
100
+
101
+ 本文は以下の見出しを順序どおりに置く。
102
+
103
+ | 番号 | 見出し | 必須 | 内容 |
104
+ | ---- | ------------------ | ---- | ------------------------------------------ |
105
+ | 1 | 前提条件 | ○ | 成立条件、根拠、影響、監視、変化時の対応 |
106
+ | 2 | 制約事項 | ○ | 守るべき限界、適用範囲、逸脱の検知、対応 |
107
+ | 3 | 依存関係 | ○ | 依存先、必要な理由、成立条件、変化時の対応 |
108
+ | 4 | 影響評価と対応方針 | ○ | 前提・制約・依存の変化に共通する評価と対応 |
109
+ | 5 | 監視・変更管理 | ○ | 見直す契機、記録する情報、判断責任の扱い |
110
+
111
+ ## 6. 記述ガイド
112
+
113
+ ### 6.1. 前提条件
114
+
115
+ - 前提には、なぜその条件を置くかを示す根拠と、崩れた場合の影響を記載する。
116
+ - 確認方法は「誰が何を見れば変化を検知できるか」が分かる表現にする。
117
+ - 根拠が不足する場合は事実として断定せず、_ASSUMPTION_: または _TODO_: として確認先を残す。
118
+ - スコープで定義済みの境界に該当する前提は再掲せず、章冒頭でスコープの該当章へ委譲する。追加する前提がない場合は、その旨と追加時の記載条件を明記する(章は省略しない)。
119
+
120
+ - リポジトリ、作業環境、外部ツールなど、外部から継続的に提供される基盤の可用性は、前提条件ではなく依存関係(6.3.)として扱う。
121
+
122
+ 推奨表:
123
+
124
+ | ID | 内容 | 根拠 | 影響 | 監視・確認方法 | 変化のトリガー | 所有者 | 対応方針 |
125
+ | --- | ---- | ---- | ---- | -------------- | -------------- | ------ | -------- |
126
+
127
+ ### 6.2. 制約事項
128
+
129
+ - 制約には、適用範囲と、逸脱したと判断する条件を記載する。
130
+ - 技術制約は、特定製品名の列挙ではなく、選択の自由度、互換性、公開適性、運用上の限界として書く。
131
+ - 公開情報の制約は、個人情報・機密情報・非公開情報を扱わない方針と、検知時の除去または判断手順を併記する。
132
+ - スコープの対象外・境界の判断基準と同内容の制約は再掲しない。本章では、上位文書に現れない運用上の制約だけを扱う。
133
+
134
+ 推奨表:
135
+
136
+ | ID | 内容 | 適用範囲 | 影響 | 監視・確認方法 | 逸脱のトリガー | 所有者 | 対応方針 |
137
+ | --- | ---- | -------- | ---- | -------------- | -------------- | ------ | -------- |
138
+
139
+ ### 6.3. 依存関係
140
+
141
+ - 依存先は、外部サービスだけでなく、先行成果物、承認、意思決定、提供物も含めて明示する。
142
+ - 依存が満たされた状態を、受領物、確認条件、期限または判断イベントで書く。
143
+ - 依存先の詳細な契約条件や実装方式は、必要な管理・設計成果物へ委譲する。
144
+ - 意思決定待ちの依存は、プロジェクト登録簿の項目として登録し、本書からは登録項目 ID を参照する。決定後に本書へ影響がある場合は該当項目へ反映する。
145
+
146
+ 推奨表:
147
+
148
+ | ID | 内容または依存先 | 影響・必要な理由 | 確認方法または成立条件 | トリガー | 所有者 | 対応方針 |
149
+ | --- | ---------------- | ---------------- | ---------------------- | -------- | ------ | -------- |
150
+
151
+ ### 6.4. 影響評価と対応方針
152
+
153
+ - 影響は、スコープ、期日、費用、品質、公開適性、運用責任など、該当する領域を具体的に示す。
154
+ - 対応方針には、除去、軽減、受容、再判断のいずれを行うかと、次に判断する人を記載する。
155
+ - 一次対応を担うロールと最終判断者を区別し、人間の判断が必要な範囲を明示する。
156
+
157
+ 推奨表:
158
+
159
+ | 変化の種別 | 主な影響領域 | 最初に確認すること | 一次対応・判断 | 対応方針 |
160
+ | ---------- | ------------ | ------------------ | -------------- | -------- |
161
+
162
+ ### 6.5. 監視・変更管理
163
+
164
+ - 「定期的に確認する」ではなく、スコープまたは実践の型一式が変わったときなど、具体的な見直しの契機を記載する。
165
+ - 変更記録には、項目 ID、変化内容、影響範囲、判断者、対応状況を残す。記録先はプロジェクト登録簿を第一候補とし、未定なら _TODO_: とする。
166
+ - 文書構造・配置・命名・技術制約・参照資料の整合確認を担うロールと、公開可否やスコープ変更などの最終判断を行う人間の責任者を区別して明示する。
167
+
168
+ ## 7. 禁止事項
169
+
170
+ | 禁止事項 | 理由 |
171
+ | ------------------------------------------------ | ---------------------------------------------- |
172
+ | スコープ等の上位文書の決定事項を行として再掲する | 正本との二重管理になり、更新漏れと矛盾を招く。 |
173
+ | 前提・制約・依存を種別なしに混在させる | 条件の性質と対応方法を区別できない。 |
174
+ | 影響、トリガー、所有者、対応方針のない登録 | 変化時に判断・対応へ使えない。 |
175
+ | 根拠のない確定値や外部環境の断定 | 誤った前提を固定し、更新漏れを招く。 |
176
+ | Agent に最終判断、承認、公開可否を委ねる | 人間の判断責任を代替してしまう。 |
177
+ | API、DB、契約書全文などの詳細を記載する | 本書の責務を越え、詳細成果物と重複する。 |
178
+ | 個人情報、非公開情報、機密情報を記載する | 公開・再利用の前提を損なう。 |
@@ -0,0 +1,232 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:prj-charter-rulebook
4
+ type: rulebook
5
+ status: ready
6
+ target_format: markdown
7
+ recipe: specdojo:prj-charter-recipe
8
+ sample: specdojo:prj-charter-sample
9
+ template: specdojo:prj-charter-template
10
+ ---
11
+
12
+ # プロジェクト憲章 作成ルール
13
+
14
+ Project Charter Documentation Rulebook
15
+
16
+ 本書は、プロジェクトの立ち上げ認可、権限委譲、後続判断条件を一貫して記録するための規約である。関係者が「誰が、何を、どの範囲まで承認したか」を監査可能な粒度で確認できる状態にする。
17
+
18
+ ## 1. 全体方針
19
+
20
+ - 対象は、プロジェクトの存在を正式に認可し、詳細計画の策定と初期準備へ進む権限を委譲するプロジェクト憲章である。
21
+ - 目的は、プロジェクトの目的、認可対象、権限範囲、主要前提、予算枠、承認事項を、PO またはスポンサーが判断できる形で明示することである。
22
+ - 憲章の承認は、本格実行開始、外部公開、主要投資、主要スコープ変更を自動的に承認するものではない。これらは後続の GO / Not GO 判断または変更判断で扱う。
23
+ - 背景、目的、期待効果はプロジェクト概要を根拠に要約し、詳細本文を二重管理しない。
24
+ - 関係者、期待、懸念、必要な合意はステークホルダー登録簿を根拠に要約し、個人情報や非公開情報を持ち込まない。
25
+ - 詳細なスコープ、成功基準、前提・制約、体制、スケジュール、リスク、コミュニケーションは後続文書へ委譲する。
26
+
27
+ ## 2. 位置づけと用語定義
28
+
29
+ ### 2.1. 位置づけ
30
+
31
+ プロジェクト憲章は、プロジェクト概要とステークホルダー登録簿を根拠として、立ち上げ認可と権限委譲を記録する文書である。後続のプロジェクト定義文書とプロジェクト管理文書は、本書の認可対象、権限範囲、未決事項を入力として詳細化する。
32
+
33
+ ```mermaid
34
+ flowchart LR
35
+ POV["prj-overview<br/>プロジェクト概要"]
36
+ STH["prj-stakeholder-register<br/>ステークホルダー登録簿"]
37
+ PCH["prj-charter<br/>プロジェクト憲章"]
38
+ PSC["prj-scope<br/>プロジェクトスコープ"]
39
+ SAC["prj-success-criteria-and-acceptance-criteria<br/>成功基準と受入条件"]
40
+ PMP["pm-plan<br/>プロジェクト管理計画"]
41
+
42
+ POV --> PCH
43
+ STH --> PCH
44
+ PCH --> PSC
45
+ PCH --> SAC
46
+ PCH --> PMP
47
+
48
+ classDef target stroke-width:4px
49
+ class PCH target
50
+ ```
51
+
52
+ ### 2.2. 用語定義
53
+
54
+ | 用語 | 定義 |
55
+ | ---------------- | -------------------------------------------------------------------------------- |
56
+ | プロジェクト憲章 | プロジェクトの立ち上げを正式に認可し、詳細計画策定と初期準備の権限を委譲する文書 |
57
+ | 立ち上げ認可 | プロジェクトとして扱い、後続の定義・計画・準備へ進むことを認める判断 |
58
+ | 権限委譲 | PO またはスポンサーが、PM などの実行責任者に付与する意思決定・実行の範囲 |
59
+ | 本格実行開始 | 承認された計画に基づき、主要成果物作成や公開準備を本格的に進める段階 |
60
+ | GO / Not GO 判断 | 本格実行、公開、継続、再計画、中止のいずれへ進むかを判定する判断 |
61
+ | 予算枠 | プロジェクトに許容する費用、外部支出、運用負担、または追加支出を行わない制約 |
62
+ | 証跡 | 承認、判定、変更理由を追跡できる記録。議事録、Issue、Pull Request、決定記録など |
63
+
64
+ ## 3. ファイル命名・ID規則
65
+
66
+ ### 3.1. 配置(推奨)
67
+
68
+ - `docs/ja/projects/<project-id>/020-project-definition/prj-charter.md` に配置する。
69
+ - 承認議事録、決定記録、変更記録は、実際に管理する文書またはツールへ残し、本文から参照できる状態にする。
70
+ - 公開前提のリポジトリでは、個人名、連絡先、非公開組織情報、秘密情報を本文に含めない。
71
+
72
+ ### 3.2. ドキュメントID(推奨)
73
+
74
+ - 推奨: `<project-id>:prj-charter`
75
+ - 例: `prj-0001:prj-charter`
76
+ - ID はプロジェクト内で一意にし、チケット ID と混同しない。
77
+
78
+ ### 3.3. ファイル名(推奨)
79
+
80
+ - 推奨: `prj-charter.md`
81
+ - 日本語ファイル名を使う場合も、Frontmatter の `id` は推奨形式で一意にする。
82
+
83
+ ## 4. 推奨 Frontmatter 項目
84
+
85
+ ### 4.1. 設定内容
86
+
87
+ | 項目 | 説明 | 必須 |
88
+ | ---------- | ------------------------------------------------------------ | ---- |
89
+ | id | `<project-id>:prj-charter` 形式の文書 ID | ○ |
90
+ | type | `project` | ○ |
91
+ | status | `draft` / `ready` / `deprecated` | ○ |
92
+ | rulebook | `specdojo:prj-charter-rulebook` | ○ |
93
+ | based_on | 立ち上げ認可の直接根拠にした概要、ステークホルダー登録簿など | 任意 |
94
+ | supersedes | 置き換えた旧文書 ID | 任意 |
95
+
96
+ ### 4.2. 推奨ルール
97
+
98
+ - `based_on` は、認可対象、目的、関係者、権限委譲を判断する直接根拠だけを列挙する。
99
+ - 初版では、原則として `prj-overview` と `prj-stakeholder-register` を中心にする。
100
+ - `pm-plan`、`pm-organization`、詳細スコープ、成功基準などは、憲章承認後に作成または詳細化する文書であり、初版憲章の直接根拠として扱う場合は理由を明記する。
101
+ - 改訂時は `supersedes` に旧文書 ID を設定し、差し替え関係を追跡可能にする。
102
+ - H1 にはプロジェクト名を含め、Frontmatter にはタイトルを重複管理しない。
103
+
104
+ ## 5. 本文構成(標準テンプレ)
105
+
106
+ プロジェクト憲章は次の順序で構成する。
107
+
108
+ | 番号 | 見出し | 必須 | 内容(要点) |
109
+ | ---- | ------------------------------- | ---- | ---------------------------------------------------------------------- |
110
+ | 1 | 認可対象 | ○ | プロジェクト名、ID、認可対象、認可しない範囲、直接根拠、承認責任 |
111
+ | 2 | プロジェクトの目的 | ○ | プロジェクト概要に基づく目的と期待効果の要約、成功基準文書への委譲 |
112
+ | 3 | ハイレベルスコープ | ○ | 認可する対象範囲、対象外、未確定事項。成果物群は成果物カタログへ委譲 |
113
+ | 4 | 初期ステークホルダー | ○ | 初期関係者、関与区分、Role code、認可判断上の責任 |
114
+ | 5 | 権限委譲 | ○ | 委譲する権限、PO 承認が必要な事項、証跡 |
115
+ | 6 | 主要前提・制約 | ○ | 認可判断に直結する前提、制約、予算枠。全量は前提・制約・依存文書へ委譲 |
116
+ | 7 | 本格実行開始の GO / Not GO 判断 | ○ | 本格実行前に確認する観点と記録先 |
117
+ | 8 | 承認 | ○ | 承認日、承認者、承認対象、証跡リンク |
118
+ | 9 | 未決事項 | 任意 | 今後の意思決定が必要な論点、期限、担当、対応方針 |
119
+
120
+ 立ち上げ認可文書であること、委譲する範囲、本格実行開始を承認しないことは、専用の章を設けず H1 直下の冒頭文に書く。
121
+
122
+ ## 6. 記述ガイド
123
+
124
+ ### 6.1. 共通
125
+
126
+ - H1 直下の冒頭文に、立ち上げ認可と権限委譲の文書であること、承認責任者、本格実行開始・外部公開を承認しないことを 2〜3 文で書く。
127
+ - 立ち上げ認可と権限委譲に集中し、詳細計画や設計の本文を先取りしない。後続文書は根拠として先取りせず、詳細化先として参照する。
128
+
129
+ - 後続文書への参照(`詳細化先` 列や記録先)は、参照先が未作成の間は ID をバッククォートで仮置きし(例: `prj-scope`)、作成後に `[[<project-id>:prj-scope|プロジェクトスコープ]]` のような wikilink へ更新する。
130
+ - 事実、判断、未決事項を分ける。未確定は _TODO_:、_UNDECIDED_:、_ASSUMPTION_: を用いる。
131
+ - 認可しない範囲を明記し、憲章承認と本格実行開始を混同しない。
132
+
133
+ - 公開文書では、公開してよい情報だけを記載し、最終判断と説明責任を人間の PO が担う前提を崩さない。
134
+
135
+ ### 6.2. 認可対象
136
+
137
+ - プロジェクト名、プロジェクト ID、認可対象、認可しない範囲、直接根拠、承認責任を表で示す。
138
+ - 認可対象は、原則として立ち上げ、詳細計画策定、初期準備に限定する。
139
+ - 本格実行や公開まで認可する場合は、計画、体制、予算枠、品質条件が確認済みであることを明記する。
140
+ - 承認に条件が付く場合は、`認可条件` を補足として 1 行追加してよい。ただし、承認章の代替にはせず、承認日・承認者・証跡リンクの管理は別途必要とする。
141
+
142
+ 推奨表:
143
+
144
+ | 項目 | 内容 |
145
+ | --------------- | ---- |
146
+ | プロジェクト名 | |
147
+ | プロジェクト ID | |
148
+ | 認可対象 | |
149
+ | 認可しない範囲 | |
150
+ | 直接根拠 | |
151
+ | 承認責任 | |
152
+
153
+ ### 6.3. プロジェクトの目的
154
+
155
+ - 冒頭は 1〜2 文の要約に留め、背景、必要性、目的の詳細はプロジェクト概要を正として参照する。
156
+ - 期待効果は、PO が承認または保留を判断できる観点に分解し、`観点` と `期待効果` の表で示す。
157
+ - 数値目標、測定方法、中長期指標はプロジェクト概要の期待効果を正とし、憲章では再掲しない。
158
+ - 成功判定の観点と受入条件は成功基準文書を正とし、専用の章を設けず本章から参照する。
159
+
160
+ 推奨表:
161
+
162
+ | 観点 | 認可判断で確認する期待効果 |
163
+ | ---- | -------------------------- |
164
+
165
+ ### 6.4. ハイレベルスコープ
166
+
167
+ - 立ち上げ時点で認可する大まかな対象範囲だけを示す。
168
+ - 対象外と未確定を同じ表で明示し、後続のスコープ詳細化へ渡す。
169
+
170
+ - AI Agent の支援範囲、人間の判断責任、公開情報の範囲など、責任境界に関わる事項を含める。
171
+ - 成果物群の一覧・配置・派生関係と、憲章承認後に作成する文書の一覧は成果物カタログを正とし、専用の章を設けず本章から参照する。
172
+
173
+ 推奨表:
174
+
175
+ | 区分 | 内容 | 詳細化先 |
176
+ | ------ | ---- | ----------- |
177
+ | 対象 | | `prj-scope` |
178
+ | 対象外 | | `prj-scope` |
179
+ | 未確定 | | 未決事項 |
180
+
181
+ ### 6.5. 初期ステークホルダー
182
+
183
+ - ステークホルダー登録簿のうち、認可判断と権限委譲に関係する主要関係者だけを要約する。
184
+ - 個人名や連絡先ではなく、役割名、集団名、Role code で識別する。
185
+ - AI Agent は支援者として扱い、承認者または説明責任者として扱わない。
186
+
187
+ ### 6.6. 権限委譲
188
+
189
+ - 決裁者、実行責任者、協議先、証跡を表で示す。
190
+ - 委譲する権限と、PO 承認が必要な事項を分けて書く。
191
+ - 予算枠、公開可否、ライセンス、主要スコープ変更、GO / Not GO 判断は、PO 承認事項として明示する。
192
+
193
+ 推奨表:
194
+
195
+ | 項目 | 決裁者 | 実行責任者 | 協議先 | 証跡 |
196
+ | ------------ | ------ | ---------- | ------ | ---- |
197
+ | 立ち上げ認可 | | | | |
198
+ | 詳細計画策定 | | | | |
199
+ | 本格実行開始 | | | | |
200
+
201
+ ### 6.7. 主要前提・制約
202
+
203
+ - 前提・制約の全量は前提・制約・依存関係文書を正とし、認可判断に直結する事項(予算枠、公開適性、人間の判断責任)だけを載せる。
204
+ - 予算枠が未確定の場合は、未確定であること、追加支出を認めるかどうか、確定タイミングを明記する。
205
+ - 公開文書では秘密情報を含めない制約を明示する。
206
+
207
+ ### 6.8. 本格実行開始の GO / Not GO 判断
208
+
209
+ - 本格実行開始、外部公開、主要投資へ進む前に確認する観点を定義する。
210
+ - 判断観点には、目的整合、公開適性、予算枠、体制、品質を含める。
211
+ - 判断結果の記録先を明記し、口頭合意だけで完了扱いにしない。
212
+
213
+ ### 6.9. 承認と未決事項
214
+
215
+ - 承認履歴は、承認日、承認者、承認対象、証跡リンクを必須とする。版番号は管理せず、承認対象の文書状態は証跡リンクで特定する(文書の状態は frontmatter の `status` と Git の履歴が正本)。
216
+ - 証跡リンクには、承認の意思表示と承認対象の文書状態の両方を特定できる記録(決定記録、Pull Request、Issue、議事録など)を記載する。
217
+ - PO 承認事項(目的、主要スコープ、権限委譲範囲、予算枠など)に触れる改訂を反映した場合は、承認履歴へ行を追加して再承認を受ける。軽微な修正は Git の履歴に委ね、再承認を要しない。
218
+ - 承認者または証跡が未確定の場合は、正式認可済みと書かない。
219
+ - 未決事項には、論点、期限、担当、対応方針を記載し、GO / Not GO 判断までに解消が必要なものを識別できるようにする。
220
+
221
+ ## 7. 禁止事項
222
+
223
+ | 項目 | 理由 |
224
+ | ---------------------------------------------------- | -------------------------------------------- |
225
+ | 憲章承認を本格実行開始や外部公開の承認と混同する | 立ち上げ認可と後続判断の責任境界が崩れるため |
226
+ | 認可対象または認可しない範囲を記載しない | PO が承認範囲を判断できないため |
227
+ | 予算枠または追加支出の扱いを記載しない | 承認判断に必要なコスト境界が不明になるため |
228
+ | 承認者、承認日、証跡が未確定なのに正式認可済みと書く | 説明責任と監査可能性が失われるため |
229
+ | 詳細スコープ、受入条件、設計詳細を憲章に過剰記載する | 後続文書との二重管理を招くため |
230
+ | AI Agent を最終判断者または承認者として扱う | 人間の説明責任と公開判断の前提に反するため |
231
+ | 個人情報、秘密情報、非公開組織情報を記載する | 公開時の情報管理リスクを高めるため |
232
+ | 曖昧語だけで成功基準や GO / Not GO 条件を書く | 判断可能性と再現性が下がるため |
@@ -0,0 +1,235 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:prj-comparison-of-alternatives-rulebook
4
+ type: rulebook
5
+ status: ready
6
+ target_format: markdown
7
+ recipe: specdojo:prj-comparison-of-alternatives-recipe
8
+ sample: specdojo:prj-comparison-of-alternatives-sample
9
+ template: specdojo:prj-comparison-of-alternatives-template
10
+ based_on:
11
+ - specdojo:rulebook-authoring-standard
12
+ supersedes: []
13
+ ---
14
+
15
+ # 代替案比較 作成ルール
16
+
17
+ Comparison of Alternatives Documentation Rulebook
18
+
19
+ 本ドキュメントは、複数の実行案を比較し、採択理由を説明可能な形で残すためのルールです。
20
+ 意思決定の再現性と説明責任を担保します。
21
+
22
+ ## 1. 全体方針
23
+
24
+ - 本ルールの対象は、代替案比較(比較対象、評価軸、採択理由)です。
25
+ - 目的は、選択肢の比較過程を可視化し、採択判断を再現可能にすることです。
26
+ - 最低 2 案以上を比較し、採択しない案の理由も記載します。
27
+ - 比較対象は、同じ課題を解決できる一式の案として構成し、業務方式、製品、開発方式など抽象度が異なる候補を同じ表で混在させません。
28
+ - 前段文書からは課題、制約、必要能力、評価条件を引き継ぎ、候補集合は外部調査を含めて独立に構成します。
29
+ - 候補名を先に決めず、比較レイヤーごとに候補カテゴリ、選定基準、具体候補の順で絞ります。
30
+ - 比較レイヤーは対象プロジェクトの課題から定めます。業務運用、解決方式、購入 / 構築、製品、アーキテクチャ、運営・開発戦略など、必要な判断だけを扱います。
31
+ - プロジェクトの業務課題や利用者課題を解く案の比較を優先し、開発戦略や作業管理は、それ自体が明示的な決定対象である場合だけ扱います。
32
+ - 抽象度が異なる判断を一つの文書で扱う場合は、決定 ID を分けて順序を明示します。
33
+ - 標準・方法論と製品・ツールを区別し、製品を標準または唯一の代表とみなす場合は客観的根拠を示します。
34
+ - 外部ツールを扱う場合は、正本、導入時期、試行条件、移行・撤退可能性を比較します。
35
+ - PMBOK 観点では、意思決定記録、リスク比較、制約下でのトレードオフ評価を含めます。
36
+ - 評価軸は固定し、案ごとに評価基準を変えません。
37
+ - 採択案の最終判断は人間の `PO` が行うことを明記する。AI Agent は比較分析の支援を担ってよい。
38
+ - 技術的・方針的な代替案では、実現可能性、外部依存、後続成果物への影響を比較結果に含めます。
39
+ - 公開リポジトリに配置する場合は、個人名、個人連絡先、非公開の組織情報を記載しない。
40
+
41
+ ## 2. 位置づけと用語定義
42
+
43
+ ### 2.1. 位置づけ(他ドキュメントとの関係)
44
+
45
+ ```mermaid
46
+ flowchart LR
47
+ PSC["プロジェクトスコープ"]
48
+ PIA["プロジェクト課題と解決アプローチ"]
49
+ ACD["前提・制約・依存関係"]
50
+ COA["代替案比較"]
51
+ DEC["決定記録"]
52
+
53
+ PSC --> COA
54
+ PIA --> COA --> DEC
55
+ ACD --> COA
56
+
57
+ classDef target stroke-width:4px
58
+ class COA target
59
+ ```
60
+
61
+ ### 2.2. 用語定義(本ルール内)
62
+
63
+ | 用語 | 定義 |
64
+ | ------------ | ----------------------------------------------------------------------------------- |
65
+ | 代替案 | 同一の意思決定を代替でき、単独でも目的達成への道筋を説明できる一式の候補案 |
66
+ | 比較レイヤー | 業務運用、解決方式、購入 / 構築、製品、開発方式など、同じ抽象度で比較する判断の単位 |
67
+ | 候補カテゴリ | 同種の責務・統合範囲を持つ方式をまとめ、具体候補を探索する単位 |
68
+ | 支援方式 | 採択した案を実行するための製品、ツール、台帳、タスク・状態管理など |
69
+ | 正本 | 現在の状態または判断根拠について、最終的に正しいものとして参照する情報源 |
70
+ | 比較試行 | 正式採用前に、入力、評価軸、完了条件を固定して適合性と可逆性を確認する活動 |
71
+ | 評価軸 | 比較に使用する観点(効果、コスト、期間、リスク等) |
72
+ | 評価基準 | 評価軸ごとの判定ルールや配点規則 |
73
+ | 採択案 | 評価結果に基づいて選択した案 |
74
+ | トレードオフ | 採択に伴って受容する不利条件 |
75
+
76
+ ## 3. ファイル命名・ID規則
77
+
78
+ ### 3.1. 配置(推奨)
79
+
80
+ - `docs/ja/projects/<project-id>/020-project-definition/` 配下への配置を推奨します。
81
+ - 評価根拠となる見積、リスク分析、検証結果を参照リンクで接続します。
82
+
83
+ ### 3.2. ドキュメントID(推奨)
84
+
85
+ - 推奨: `<project-id>:prj-comparison-of-alternatives`
86
+ - 例: `prj-0001:prj-comparison-of-alternatives`
87
+
88
+ ### 3.3. ファイル名(推奨)
89
+
90
+ - 推奨: `prj-comparison-of-alternatives.md`
91
+ - 日本語ファイル名の場合: `代替案比較.md`
92
+
93
+ ## 4. 推奨 Frontmatter 項目
94
+
95
+ ### 4.1. 設定内容
96
+
97
+ - 参照スキーマ: [docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml)
98
+ - メタ情報標準: [document-metadata-standard.md](../standards/document-metadata-standard.md)
99
+
100
+ | 項目 | 説明 | 必須 |
101
+ | ---------- | ----------------------------------------------------------------------------- | ---- |
102
+ | id | `<project-id>:prj-comparison-of-alternatives` | ○ |
103
+ | type | `project` 固定 | ○ |
104
+ | status | `draft` / `ready` / `deprecated` | ○ |
105
+ | rulebook | `specdojo:prj-comparison-of-alternatives-rulebook` | ○ |
106
+ | based_on | 比較判断に直接使用するスコープ、課題と解決アプローチ、前提・制約などの文書 ID | 任意 |
107
+ | supersedes | 置き換え対象の旧文書 ID | 任意 |
108
+
109
+ ### 4.2. 推奨ルール
110
+
111
+ - `based_on` は、比較判断に直接使う根拠文書だけを列挙します。
112
+ - 評価軸は固定し、案ごとに評価基準を変えません。
113
+ - 配点や重みを使う場合は、判定への使い方を明示します。
114
+
115
+ ## 5. 本文構成(標準テンプレ)
116
+
117
+ ### 5.1. 代替案比較(Comparison of Alternatives)
118
+
119
+ | 番号 | 見出し | 必須 | 内容(要点) |
120
+ | ---- | -------------------- | ---- | --------------------------------------- |
121
+ | 1 | 比較目的と前提条件 | ○ | 決定 ID、比較順序、対象外、候補選定基準 |
122
+ | 2 | 比較対象案 | ○ | レイヤー別の候補カテゴリと具体候補 |
123
+ | 3 | 評価軸と評価基準 | ○ | レイヤー別の観点、配点、判定基準 |
124
+ | 4 | 比較結果と採択理由 | ○ | 採択、試行、保留、非採択とその理由 |
125
+ | 5 | リスクとトレードオフ | ○ | 採択による不利益、軽減策 |
126
+ | 6 | 決定と見直し | 任意 | 現時点の採択方針、再評価条件 |
127
+
128
+ ## 6. 記述ガイド
129
+
130
+ ### 6.1. 共通
131
+
132
+ - 比較対象案は最低 2 案以上記載します。
133
+ - 章参照は章番号ではなく章タイトルで記述します。
134
+ - 評価結果には定量情報と定性理由の両方を含めます。
135
+ - 根拠資料は、前段のスコープ、課題と解決アプローチ、前提・制約など、比較判断に直接必要な文書に限定します。
136
+ - 根拠資料との整合は、候補案を前段文書の案に限定することを意味しません。前段文書から課題と評価条件を導き、候補案は外部調査を含めて展開します。
137
+ - 複数の判断を扱う場合は `D-01` などの決定 ID を付け、上位の解決方式から製品・実装方式などへ判断する順序と、各決定で扱わない範囲を示します。
138
+ - 同じ採択理由、非採択理由、見直し条件を複数の章や表に重複記載せず、評価結果に集約します。
139
+
140
+ ### 6.2. 比較対象案
141
+
142
+ - 各案は、単独で課題解決への道筋、適用範囲、主要な構成を説明できる一式の解決案にします。
143
+ - 相互に組み合わせる要素を別案として並べず、業務運用を含む解決パッケージとして比較します。
144
+ - 現行案に有利な候補だけで閉じず、現行運用の改善、汎用ツール、既存製品・サービス、個別構築、外部委託など、課題に応じた有力案を含めます。
145
+ - 購入 / 構築を決める比較と、購入製品を選ぶ比較は分けます。上位判断で既存製品の採用可能性が残った場合に、具体製品を別レイヤーで比較します。
146
+ - 開発戦略やタスク管理方式は、業務・システム解決案と分離します。プロジェクト運営そのものが比較目的の場合だけ主レイヤーとして扱います。
147
+ - 具体候補を列挙する前に、非システム対応、汎用ツール、既存製品、個別構築など、比較目的に合う候補カテゴリと選定基準を定義します。
148
+ - 各カテゴリから、公式資料で責務、データ保管、対応環境、移行可能性を確認できる候補を選びます。市場占有率を調べていない場合は「市場を代表する」と断定しません。
149
+ - 現行・内製方式、専用ツールを採用しない案、外部の直接競合を必要に応じて含め、特定製品に有利な候補集合にしません。
150
+
151
+ 推奨表(比較対象案):
152
+
153
+ | 案ID | 比較レイヤー | 案 | 目的達成への道筋 | 主な構成要素 | 対象範囲 |
154
+ | ---- | ------------ | --- | ---------------- | ------------ | -------- |
155
+
156
+ 推奨表(候補カテゴリ):
157
+
158
+ | 決定ID | 候補カテゴリ | 候補に含める基準 |
159
+ | ------ | ------------ | ---------------- |
160
+
161
+ ### 6.3. 評価軸と評価基準
162
+
163
+ - 評価軸は効果、コスト、期間、リスク、運用適合、技術実現性の 6 観点を最低ラインとします。
164
+
165
+ - 観点を省略する場合は省略理由を記載します。
166
+ - 技術実現性は、既存環境、データ移行、外部依存、運用継続、後続成果物への影響を見ます。
167
+ - 不確実性への適応、トレーサビリティ、人間の判断責任、AI Agent の長期作業と検証可能性が判断に影響する場合は、独立した評価軸として追加します。
168
+ - 抽象度が異なる比較レイヤーには同じ評価軸を強制せず、各レイヤー内では候補ごとに同じ軸を使用します。
169
+ - 製品・サービスには、業務適合、データ移行、ロックイン、可逆性、成熟度を必要に応じて追加します。
170
+
171
+ 推奨表(評価基準):
172
+
173
+ | 評価軸 | 重み | 判定基準 | 備考 |
174
+ | ------ | ---- | -------- | ---- |
175
+
176
+ ### 6.4. 比較結果と採択理由
177
+
178
+ - 各候補を `採択` / `一部採択` / `比較試行` / `保留` / `非採択` などに判定し、その理由と再評価条件を記載します。
179
+ - 判断過程を追跡できるよう、根拠資料へのリンクを記載します。
180
+ - 採択案の最終判断は `PO` が行い、判断者を明記する。
181
+ - 技術的実現性と影響は、決定または案ごとに表で明示します。
182
+ - 比較試行は、同じ入力、評価軸、完了条件、記録先、採用・撤退判定を定義し、試行前に特定ツールを標準扱いしません。
183
+ - 外部ツールを採択する場合は、仕様や状態の正本、同期方向、利用停止時の移行方法を明記します。
184
+
185
+ 推奨表(比較結果):
186
+
187
+ | 案ID | 効果 | コスト | 期間 | リスク | 運用適合 | 技術実現性 | 総合評価 | 判定 |
188
+ | ---- | ---- | ------ | ---- | ------ | -------- | ---------- | -------- | ---- |
189
+
190
+ 推奨表(非採択または一部採択の理由):
191
+
192
+ | 案ID | 理由 | 再評価条件 |
193
+ | ---- | ---- | ---------- |
194
+
195
+ 推奨表(技術的実現性と影響):
196
+
197
+ | 案ID | 技術的実現性 | 主な影響 |
198
+ | ---- | ------------ | -------- |
199
+
200
+ ### 6.5. リスクとトレードオフ
201
+
202
+ - 案ごとのリスクとトレードオフを、採択判断に必要な粒度で記載します。
203
+
204
+ - リスクは「起きうること」と「軽減策」をセットにします。
205
+ - トレードオフは、先送りする範囲、受容する負荷、後続成果物への影響を明示します。
206
+
207
+ 推奨表(リスクとトレードオフ):
208
+
209
+ | 区分 | 内容 | 軽減策 |
210
+ | ---- | ---- | ------ |
211
+
212
+ ### 6.6. 決定と見直し
213
+
214
+ - 現時点の採択方針と再評価トリガーを明記する。
215
+ - 複数レイヤーを扱う場合は、各決定の採択、試行、保留を短く要約する。
216
+ - 方針変更時は変更理由と影響範囲をプロジェクト登録簿または決定記録に残す。
217
+
218
+ ## 7. 禁止事項
219
+
220
+ | 項目 | 理由 |
221
+ | -------------------------------------------------------------- | ---------------------------------------------------- |
222
+ | 単一案のみの比較 | 意思決定の妥当性が検証できないため |
223
+ | 同じ戦略の構成要素を別々の代替案として比較する | 単独で目的を達成できず、比較結果が全案採択に偏るため |
224
+ | 業務の解決案と開発戦略・作業管理ツールを同じ表で採点する | 解く課題と抽象度が異なり、評価結果を解釈できないため |
225
+ | 対象プロジェクトの課題と無関係な開発・管理方式を比較する | 成果物が利用者の意思決定に使えないため |
226
+ | 候補カテゴリと選定基準を定めず、知っている製品だけを比較する | 候補集合が恣意的になり、有力な代替案を見落とすため |
227
+ | 標準・方法論と製品・ツールを同じ意味で扱う | 成熟度と適用範囲を誤って評価するため |
228
+ | 根拠なく特定製品を市場の代表または標準と断定する | 比較対象の妥当性を説明できないため |
229
+ | 正本と移行・撤退方法を定めず外部ツールを採択する | 二重管理とベンダーロックインを招くため |
230
+ | 前段文書の候補案を名称変更して再掲するだけで外部案を調査しない | 結論の追認となり、有力な代替手段を見落とすため |
231
+ | 評価軸なしの採択結論 | 判断根拠が不透明になるため |
232
+ | 非採択理由の未記載 | 将来再評価時に経緯追跡できないため |
233
+ | 根拠資料リンクなし | 説明責任を果たせないため |
234
+ | Agent に採択案の最終判断を委ねる | 人間の判断責任を代替してしまうため |
235
+ | 公開リポジトリに個人名・個人連絡先・非公開の組織情報を記載する | 公開範囲とプライバシーに反するため |