specdojo 0.8.0 → 0.9.1

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 (292) hide show
  1. package/.github/agents/specdojo-orchestrator.md +4 -1
  2. package/CHANGELOG.md +77 -0
  3. package/dist/catalog/catalog.js +16 -14
  4. package/dist/commands/agent.js +5 -3
  5. package/dist/commands/build.js +69 -10
  6. package/dist/commands/git.js +206 -0
  7. package/dist/commands/init.js +4 -2
  8. package/dist/commands/orchestrator.js +5 -77
  9. package/dist/commands/where.js +25 -0
  10. package/dist/dashboard/dashboard.js +5 -3
  11. package/dist/dashboard/routines.js +4 -7
  12. package/dist/dashboard/shared.js +2 -2
  13. package/dist/dashboard/timeline.js +14 -14
  14. package/dist/deliverable/trash.js +2 -1
  15. package/dist/docs/index-command.js +2 -2
  16. package/dist/docs/yaml-business-tables.js +243 -0
  17. package/dist/docs/yaml-interface-tables.js +106 -0
  18. package/dist/docs/yaml-pages-command.js +5 -3
  19. package/dist/docs/yaml-pages.js +146 -3
  20. package/dist/docs/yaml-table-shared.js +70 -0
  21. package/dist/docs/yaml-tables.js +39 -0
  22. package/dist/exec/agent-config.js +9 -0
  23. package/dist/exec/agent-protected-config.js +2 -0
  24. package/dist/exec/commands.js +31 -18
  25. package/dist/exec/events.js +34 -14
  26. package/dist/exec/evidence.js +13 -3
  27. package/dist/exec/opencode-permissions.js +117 -0
  28. package/dist/exec/parent-validation.js +56 -3
  29. package/dist/exec/plans-core.js +21 -2
  30. package/dist/exec/plans-generation.js +6 -7
  31. package/dist/exec/post-integration.js +162 -0
  32. package/dist/exec/queue-command.js +166 -0
  33. package/dist/exec/queue.js +285 -0
  34. package/dist/exec/register-foreign-wait.js +82 -0
  35. package/dist/exec/repo-integration-sync.js +17 -5
  36. package/dist/exec/repo-trace.js +2 -1
  37. package/dist/exec/reporter.js +2 -2
  38. package/dist/exec/results.js +24 -4
  39. package/dist/exec/review-kata.js +4 -1
  40. package/dist/exec/run/agent-pipeline.js +3 -2
  41. package/dist/exec/run/agent.js +12 -6
  42. package/dist/exec/run/change-scope.js +365 -0
  43. package/dist/exec/run/deferred-cleanup.js +31 -0
  44. package/dist/exec/run/in-place.js +5 -2
  45. package/dist/exec/run/job-lock.js +66 -0
  46. package/dist/exec/run/job-sequence.js +137 -0
  47. package/dist/exec/run/job.js +56 -19
  48. package/dist/exec/run/lifecycle-commands.js +1 -1
  49. package/dist/exec/run/lock.js +22 -1
  50. package/dist/exec/run/register-command.js +8 -5
  51. package/dist/exec/run/register-mode.js +68 -8
  52. package/dist/exec/run/register-resume.js +68 -14
  53. package/dist/exec/run/register-state.js +13 -8
  54. package/dist/exec/run/register-worktree.js +140 -125
  55. package/dist/exec/run/schedule-mode.js +75 -14
  56. package/dist/exec/run/schedule-prepare.js +3 -0
  57. package/dist/exec/run/schedule-task.js +88 -38
  58. package/dist/exec/run/shared.js +5 -0
  59. package/dist/exec/schedule/schedule.js +116 -4
  60. package/dist/exec/shared.js +2 -2
  61. package/dist/exec/smoke.js +190 -0
  62. package/dist/exec/strategy.js +13 -3
  63. package/dist/exec/task-repos.js +19 -4
  64. package/dist/exec/task-view.js +6 -4
  65. package/dist/exec/trial-commands.js +5 -2
  66. package/dist/exec/trial-core.js +6 -1
  67. package/dist/exec/validation-metrics.js +181 -0
  68. package/dist/exec/worktree-cleanup-lock.js +26 -0
  69. package/dist/exec/worktree-command.js +12 -2
  70. package/dist/exec/worktree-ops-commit.js +2 -2
  71. package/dist/exec/worktree.js +13 -2
  72. package/dist/grade/command-apply.js +3 -3
  73. package/dist/grade/command-inspect.js +5 -3
  74. package/dist/grade/command-plan.js +1 -1
  75. package/dist/grade/command-run.js +5 -1
  76. package/dist/grade/run.js +64 -8
  77. package/dist/job/definition.js +84 -8
  78. package/dist/job/job.js +79 -23
  79. package/dist/register/authoring-sources.js +22 -16
  80. package/dist/register/maintenance-commands.js +2 -2
  81. package/dist/register/register.js +31 -7
  82. package/dist/register/renumber.js +1 -3
  83. package/dist/routine/definition.js +9 -0
  84. package/dist/routine/routine.js +137 -43
  85. package/dist/routine/status.js +62 -0
  86. package/dist/schedule/schedule.js +38 -39
  87. package/dist/shared/agent-types.js +5 -0
  88. package/dist/shared/cross-process-lock.js +9 -1
  89. package/dist/shared/dist-freshness.js +8 -2
  90. package/dist/shared/git-environment.js +2 -1
  91. package/dist/shared/git.js +44 -1
  92. package/dist/shared/lefthook-scaffold.js +3 -0
  93. package/dist/shared/local-config.js +244 -0
  94. package/dist/shared/specdojo-config.js +34 -20
  95. package/dist/shared/specdojo-gitignore.js +1 -0
  96. package/dist/shared/text.js +17 -1
  97. package/dist/shared/where-alias.js +13 -0
  98. package/dist/specdojo.js +4 -0
  99. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  100. package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
  101. package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
  102. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  103. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +1 -1
  104. package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
  105. package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
  106. package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
  107. package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
  108. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  109. package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
  110. package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
  111. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  112. package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
  113. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  114. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  115. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
  116. package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
  117. package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
  118. package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
  119. package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
  120. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
  121. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
  122. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  123. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  124. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
  125. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
  126. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
  127. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
  128. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
  129. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
  130. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  131. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
  132. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  133. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  134. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  135. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  136. package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
  137. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
  138. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
  139. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
  140. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  141. package/docs/ja/specdojo/references/command-reference.md +258 -118
  142. package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
  143. package/docs/ja/specdojo/references/specdojo-config-reference.md +47 -10
  144. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  145. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  146. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
  147. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
  148. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
  149. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
  150. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
  151. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  152. package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
  153. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
  154. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  155. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  156. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  157. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  158. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
  159. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  160. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
  161. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
  162. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
  163. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  164. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
  165. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  166. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  167. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  168. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
  169. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  170. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
  171. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
  172. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
  173. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
  174. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  175. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  176. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
  177. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  178. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  179. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
  180. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
  181. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  182. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
  183. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
  184. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
  185. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  186. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
  187. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  188. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
  189. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  190. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  191. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  192. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  193. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  194. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
  195. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  196. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  197. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  198. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  199. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  200. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  201. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  202. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  203. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  204. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  205. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  206. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  207. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  208. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  209. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  210. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  211. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
  212. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  213. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  214. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  215. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  216. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
  217. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
  218. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
  219. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
  220. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  221. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
  222. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
  223. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
  224. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  225. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
  226. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  227. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  228. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  229. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  230. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  231. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
  232. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
  233. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
  234. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  235. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  236. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
  237. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
  238. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
  239. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
  240. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
  241. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  242. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
  243. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  244. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  245. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  246. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  247. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
  248. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  249. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  250. package/docs/ja/specdojo/samples/bds-sample.md +58 -71
  251. package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
  252. package/docs/ja/specdojo/samples/bes-sample.md +43 -53
  253. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  254. package/docs/ja/specdojo/samples/br-sample.md +40 -52
  255. package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
  256. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  257. package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
  258. package/docs/ja/specdojo/samples/clis-sample.md +70 -77
  259. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  260. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  261. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  262. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  263. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  264. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  265. package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
  266. package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
  267. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
  268. package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
  269. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
  270. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  271. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
  272. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  273. package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
  274. package/docs/ja/specdojo/samples/sf-sample.md +73 -85
  275. package/docs/ja/specdojo/samples/sld-sample.md +60 -79
  276. package/docs/ja/specdojo/samples/uis-sample.md +98 -121
  277. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  278. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  279. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  280. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
  281. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
  282. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  283. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  284. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  285. package/package.json +9 -6
  286. package/templates/antigravity/orchestrator.md +4 -1
  287. package/templates/claude/agents/specdojo-orchestrator.md +4 -1
  288. package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
  289. package/templates/codex/orchestrator.md +4 -1
  290. package/templates/init-exec-defaults.yaml +13 -0
  291. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  292. package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
@@ -17,21 +17,17 @@ specdojo:
17
17
 
18
18
  Assumptions, Constraints and Dependencies Documentation Rulebook
19
19
 
20
- 本書は、プロジェクトの成立条件、守るべき境界、外部または先行成果物への依存を、変更時に判断できる形で整理する規約である。各項目から計画への影響、確認責任、変更時の記録先を追跡できることを目的とする。
20
+ プロジェクトの成立条件、守るべき限界、外部・先行成果物への依存を整理し、変化時の影響と対応の判断基準を定める。
21
21
 
22
22
  ## 1. 全体方針
23
23
 
24
- - 対象は、プロジェクトの前提条件、制約事項、依存関係、およびそれらの変化に対する影響評価と変更管理である。
25
- - 各項目は、条件だけで終わらせず、影響、確認方法、変化または逸脱のトリガー、所有者、対応方針を一組で記載する。
24
+ - 各項目には影響・確認方法・トリガー・所有者・対応方針を記載する。
26
25
  - 前提は「成立するものとして置く条件」、制約は「守るべき限界」、依存関係は「他者・外部サービス・先行成果物などから受ける条件」として分離する。
27
- - スコープなど上位文書で確定済みの決定事項(対象外、境界の判断基準、責務境界)は行として再掲しない。該当章の冒頭で参照先を明示して委譲し、本書には上位文書に現れない成立条件・限界・依存だけを登録する。
28
- - 上位文書がすでに継続的な監視・記録先を持つ事項(判断ゲートの記録先が明示された章など)は、内容を要約して再登録せず参照にとどめる。上位文書が結論だけを示し継続監視の仕組みを持たない場合は、監視方法・トリガー・所有者・対応方針を付与して運用可能な形に展開してよいが、その場合は展開元の上位文書と章を明示する。
26
+ - 上位文書で確定済みの対象外・境界・責務や、継続監視・記録先を持つ事項は再登録せず、該当章の冒頭で正本へ委譲する。結論だけで監視の仕組みがない条件は、展開元の文書・章を示し、確認方法・トリガー・所有者・対応方針を補って登録できる。委譲先に条件が実在することを確認する。
29
27
  - 文書は計画・設計・実装の詳細やリスク登録簿を代替しない。必要な詳細はそれぞれの成果物に委譲する。
30
- - AI Agent は作成・確認を支援できるが、承認、公開可否、エスカレーションなどの最終判断を委ねない。
28
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めない。
31
29
 
32
- ## 2. 位置づけと用語定義
33
-
34
- ### 2.1. 位置づけ
30
+ ## 2. 位置づけ
35
31
 
36
32
  ```mermaid
37
33
  flowchart LR
@@ -46,26 +42,19 @@ flowchart LR
46
42
  class ACD target
47
43
  ```
48
44
 
49
- ### 2.2. 用語定義
50
-
51
- | 用語 | 定義 |
52
- | -------- | -------------------------------------------------------------------------- |
53
- | トリガー | 前提の崩壊、制約の逸脱、依存先の変化を検知して見直しを始める条件。 |
54
- | 所有者 | 項目の状態確認と一次対応を担うロールまたは責任者。最終判断者とは区別する。 |
55
-
56
45
  ## 3. ファイル命名・ID規則
57
46
 
58
47
  ### 3.1. 成果物の配置と文書 ID
59
48
 
60
49
  - 配置・命名の共通規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従う。
61
50
  - 本系統の成果物は `020-project-definition/prj-assumptions-constraints-dependencies.md` に配置し、文書 ID を `<project-id>:prj-assumptions-constraints-dependencies` とする。
62
- - 文書 ID と、表の行を識別する項目 ID は区別する。別文書から行を追跡するときは、文書 ID と項目 ID の組で識別する。
51
+ - 文書 ID と項目 ID は区別し、別文書からの行参照には両者を使う。
63
52
 
64
53
  ### 3.2. 項目 ID
65
54
 
66
- - 各登録行の必須キーは、前提条件では `ACD-A01`、制約事項では `ACD-C01`、依存関係では `ACD-D01` から始める。接頭辞に続く正の整数を種別ごとに既採番の最大値から順に増やし、2 桁未満はゼロ埋めする。100 件目以降は桁を増やす。
55
+ - 項目 ID は前提条件 `ACD-A01`、制約事項 `ACD-C01`、依存関係 `ACD-D01` から種別ごとに既採番の最大値に続ける。整数部は 2 桁未満をゼロ埋めし、100 件目以降は桁を増やす。
67
56
  - 項目 ID は文書内で一意とし、採番後は内容の修正や並べ替えで変更しない。廃止した ID を別の条件に再利用しない。
68
- - 種別を変更する場合は、旧項目を廃止して変更先の種別で新規採番し、変更記録に新旧 ID の対応と理由を残す。変更記録や登録簿でも同じ項目 ID を追跡キーに使う。
57
+ - 種別変更は旧項目を廃止して新規採番し、変更記録に新旧 ID と理由を残す。
69
58
 
70
59
  ## 4. 推奨 Frontmatter 項目
71
60
 
@@ -89,10 +78,8 @@ flowchart LR
89
78
 
90
79
  ### 6.1. 前提条件
91
80
 
92
- - 前提には、なぜその条件を置くかを示す根拠と、崩れた場合の影響を記載する。
93
81
  - 確認方法は「誰が何を見れば変化を検知できるか」が分かる表現にする。
94
- - 根拠が不足する場合は事実として断定せず、_ASSUMPTION_: または _TODO_: として確認先を残す。
95
- - スコープで定義済みの境界に該当する前提は、章冒頭でスコープの該当章へ委譲する。委譲先に条件が実在することを確認し、参照だけで未定義の条件を補ったことにしない。
82
+ - 仮置きの前提には `_ASSUMPTION_`、根拠の確認待ちには `_TODO_` を付け、確認先を残す。
96
83
  - リポジトリ、端末、作業環境、外部ツールなど、外部から継続的に提供される基盤の可用性は「依存関係」として扱う。人の参加見込みを前提とする場合も、特定の助言・承認・成果物を受け取る条件は依存関係として分ける。
97
84
 
98
85
  良い例: 「代表試行への協力者を確保できる」に、募集の根拠、試行前の確認者、未確保時の延期判断を添える。悪い例: 「店頭で使う端末を利用できる」を前提に登録する、またはスコープで確定済みの単一店舗運用を再掲する。
@@ -104,10 +91,8 @@ flowchart LR
104
91
 
105
92
  ### 6.2. 制約事項
106
93
 
107
- - 制約には、適用範囲と、逸脱したと判断する条件を記載する。
108
94
  - 技術制約は、特定製品名の列挙ではなく、選択の自由度、互換性、公開適性、運用上の限界として書く。
109
95
  - 公開情報の制約は、個人情報・機密情報・非公開情報を扱わない方針と、検知時の除去または判断手順を併記する。
110
- - スコープの対象外・境界の判断基準と同内容の制約は再掲しない。本章では、追加の運用制約、または「全体方針」に従って監視・対応を補う制約を扱う。
111
96
 
112
97
  良い例: 「承認済み予算枠がない間は追加支出を開始しない」に、発注前の承認証跡確認と、未承認時に人間の責任者へ判断を求める対応を添える。悪い例: 「予算に注意する」とだけ書き、適用範囲と逸脱条件を示さない。
113
98
 
@@ -121,8 +106,7 @@ flowchart LR
121
106
  - 依存先は、外部サービスだけでなく、先行成果物、承認、意思決定、提供物も含めて明示する。
122
107
  - 「受領・成立条件」には、成立したと判定する状態と、誰が何の証跡をいつ確認するかの両方を記載する。期限または判断イベントを示し、検証手順が別文書にある場合はその正本を参照する。
123
108
  - 成果物の作成・受入を依存とする場合は、対象成果物 ID、適用する受入条件・品質ゲート、証跡の正本を参照できるようにする。単に本書の根拠として読んだ文書は、その理由だけで依存先にしない。
124
- - 依存先の詳細な契約条件や実装方式は、必要な管理・設計成果物へ委譲する。
125
- - 意思決定待ちの依存は、プロジェクト登録簿の項目として登録し、本書からは登録項目 ID を参照する。決定後に本書へ影響がある場合は該当項目へ反映する。
109
+ - 意思決定待ちの依存には `_UNDECIDED_` を付け、論点、不成立時の影響、当面の扱いを示す。
126
110
  - 複数の判断を含む依存では、決定記録で確定した部分と未決部分を分離する。一部の決定だけで依存全体を成立済みとしない。
127
111
 
128
112
  良い例: 店頭端末を依存先とし、「営業時間中に利用者代表が記録できることを、営業開始前の動作確認で確かめる」と書く。悪い例: 「端末がある」「承認済み」とだけ書き、利用可能性や承認対象を確かめる証跡を示さない。
@@ -138,9 +122,9 @@ flowchart LR
138
122
 
139
123
  - 影響は、スコープ、期日、費用、品質、公開適性、運用責任など、該当する領域を具体的に示す。
140
124
  - 対応方針には、除去、軽減、受容、再判断のいずれを行うかと、次に判断する人を記載する。
141
- - 一次対応を担うロールと最終判断者を区別し、人間の判断が必要な範囲を明示する。
125
+ - 所有者は状態確認と一次対応を担う者とし、最終判断者と判断を求める範囲を区別する。
142
126
 
143
- 良い例: 「依存先の受入が遅れたら、所有者が影響する成果物と作業を特定し、PM が順序・期日の変更案をまとめ、人間の責任者が開始可否を判断する」と書く。悪い例: 「遅れたら調整する」とだけ書き、影響先と次の判断者を示さない。
127
+ 良い例: 「依存先の受入が遅れたら、所有者が影響する成果物と作業を特定し、順序・期日の変更案を判断者へ提示して開始可否を確認する」と書く。悪い例: 「遅れたら調整する」とだけ書き、影響先と次の判断者を示さない。
144
128
 
145
129
  推奨表:
146
130
 
@@ -150,12 +134,10 @@ flowchart LR
150
134
  ### 6.5. 監視・変更管理
151
135
 
152
136
  - 「定期的に確認する」ではなく、スコープまたは実践の型一式が変わったときなど、具体的な見直しの契機を記載する。
153
- - 変更記録には、項目 ID、変化内容、影響範囲、判断者、対応状況、再確認時期を残す。記録先はプロジェクト登録簿を第一候補とし、未定なら _TODO_: とする。
154
- - 発生済みの支障は課題、将来の不確実な影響はリスク、承認済み範囲・計画の変更提案は変更要求、判断結果は決定記録へ接続する。PM が記録先・報告先を明示し、関連する Schedule の作業や PJR 項目から項目 ID を追跡できるようにする。
155
- - 文書構造・配置・命名・技術制約・参照資料の整合確認を担うロールと、公開可否やスコープ変更などの最終判断を行う人間の責任者を区別して明示する。
156
- - 改訂・廃止時の共通手順は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文書の改訂・廃止とライフサイクル変更管理」に従う。本系統では PM が計画・Schedule・PJR の追従作業を管理し、ARC が参照と技術制約、QE が受入条件・検証への影響を確認する。
137
+ - 変更記録には、項目 ID、変化内容、影響範囲、判断者、対応状況、再確認時期を残す。
138
+ - 条件の変化が影響するスコープ・計画・Schedule・受入条件を特定し、変更記録と追従作業を項目 ID で結ぶ。
157
139
 
158
- 良い例: 「端末の利用不能を検知したら、所有者が対象 ID と影響作業を課題に記録し、PM が代替策と再確認時期を報告する。開始条件が変わる場合は変更要求として人間の責任者へ上げる」と書く。悪い例: 「必要に応じて更新する」とだけ書き、記録先と判断責任を示さない。
140
+ 良い例: 「端末の利用不能を検知したら、対象 ID と影響作業、代替策、再確認時期を変更記録に残す。復旧確認を Schedule の試用開始の先行作業にする」と書く。悪い例: 「必要に応じて更新する」とだけ書き、追従対象を示さない。
159
141
 
160
142
  ## 7. 禁止事項
161
143
 
@@ -164,7 +146,4 @@ flowchart LR
164
146
  | スコープ等の上位文書の決定事項を行として再掲する | 正本との二重管理になり、更新漏れと矛盾を招く。 |
165
147
  | 前提・制約・依存を種別なしに混在させる | 条件の性質と対応方法を区別できない。 |
166
148
  | 影響、トリガー、所有者、対応方針のない登録 | 変化時に判断・対応へ使えない。 |
167
- | 根拠のない確定値や外部環境の断定 | 誤った前提を固定し、更新漏れを招く。 |
168
- | Agent に最終判断、承認、公開可否を委ねる | 人間の判断責任を代替してしまう。 |
169
- | API、DB、契約書全文などの詳細を記載する | 本書の責務を越え、詳細成果物と重複する。 |
170
- | 個人情報、非公開情報、機密情報を記載する | 公開・再利用の前提を損なう。 |
149
+ | 部分決定だけで依存全体を成立済みとする | 未成立の条件に依存する作業を開始してしまう。 |
@@ -14,22 +14,19 @@ specdojo:
14
14
 
15
15
  Project Charter Documentation Rulebook
16
16
 
17
- 本書は、プロジェクトの立ち上げ認可、権限委譲、後続判断条件を一貫して記録するための規約である。関係者が「誰が、何を、どの範囲まで承認したか」を監査可能な粒度で確認できる状態にする。
17
+ 立ち上げ認可、権限委譲、後続判断条件を記録し、関係者が「誰が、何を、どの範囲まで承認したか」を確認できる憲章の記述基準を定める。
18
18
 
19
19
  ## 1. 全体方針
20
20
 
21
21
  - 対象は、プロジェクトの存在を正式に認可し、詳細計画の策定と初期準備へ進む権限を委譲するプロジェクト憲章である。
22
- - 目的は、プロジェクトの目的、認可対象、権限範囲、主要前提、予算枠、承認事項を、PO またはスポンサーが判断できる形で明示することである。
22
+ - 目的は、プロジェクトの目的、認可対象、権限範囲、主要前提、予算枠を、承認責任者が判断できる形で明示することである。
23
23
  - 憲章の承認は、本格実行開始、外部公開、主要投資、主要スコープ変更を自動的に承認するものではない。これらは後続の GO / Not GO 判断または変更判断で扱う。
24
24
  - 背景、目的、期待効果はプロジェクト概要を根拠に要約し、詳細本文を二重管理しない。
25
- - 関係者、期待、懸念、必要な合意はステークホルダー登録簿を根拠に要約し、個人情報や非公開情報を持ち込まない。
25
+ - 関係者、期待、懸念、必要な合意はステークホルダー登録簿を根拠に要約する。
26
26
  - 詳細なスコープ、成功基準、前提・制約、体制、スケジュール、リスク、コミュニケーションは後続文書へ委譲する。
27
+ - **共通の運用**: 役割の割り当て(スポンサーと PO の対応を含む)は適用先のメンバー定義に従い、本文では認可権限を持つ役割を「承認責任者」と呼ぶ。`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めない。
27
28
 
28
- ## 2. 位置づけと用語定義
29
-
30
- ### 2.1. 位置づけ
31
-
32
- プロジェクト憲章は、プロジェクト概要とステークホルダー登録簿を根拠として、立ち上げ認可と権限委譲を記録する文書である。後続のプロジェクト定義文書とプロジェクト管理文書は、本書の認可対象、権限範囲、未決事項を入力として詳細化する。
29
+ ## 2. 位置づけ
33
30
 
34
31
  ```mermaid
35
32
  flowchart LR
@@ -50,57 +47,32 @@ flowchart LR
50
47
  class PCH target
51
48
  ```
52
49
 
53
- ### 2.2. 用語定義
54
-
55
- | 用語 | 定義 |
56
- | ---------------- | -------------------------------------------------------------------------------- |
57
- | プロジェクト憲章 | プロジェクトの立ち上げを正式に認可し、詳細計画策定と初期準備の権限を委譲する文書 |
58
- | 立ち上げ認可 | プロジェクトとして扱い、後続の定義・計画・準備へ進むことを認める判断 |
59
- | 権限委譲 | PO またはスポンサーが、PM などの実行責任者に付与する意思決定・実行の範囲 |
60
- | 本格実行開始 | 承認された計画に基づき、主要成果物作成や公開準備を本格的に進める段階 |
61
- | GO / Not GO 判断 | 本格実行、公開、継続、再計画、中止のいずれへ進むかを判定する判断 |
62
- | 予算枠 | プロジェクトに許容する費用、外部支出、運用負担、または追加支出を行わない制約 |
63
- | 証跡 | 承認、判定、変更理由を追跡できる記録。議事録、Issue、Pull Request、決定記録など |
64
-
65
50
  ## 3. ファイル命名・ID規則
66
51
 
67
52
  ### 3.1. 配置(推奨)
68
53
 
69
54
  - `docs/ja/projects/<project-id>/020-project-definition/prj-charter.md` に配置する。
70
- - 承認議事録、決定記録、変更記録は、実際に管理する文書またはツールへ残し、本文から参照できる状態にする。
71
- - 公開前提のリポジトリでは、個人名、連絡先、非公開組織情報、秘密情報を本文に含めない。
72
55
 
73
56
  ### 3.2. ドキュメントID(推奨)
74
57
 
75
58
  - 推奨: `<project-id>:prj-charter`
76
59
  - 例: `prj-0001:prj-charter`
77
- - ID はプロジェクト内で一意にし、チケット ID と混同しない。
78
60
 
79
61
  ### 3.3. ファイル名(推奨)
80
62
 
81
63
  - 推奨: `prj-charter.md`
82
- - 日本語ファイル名を使う場合も、Frontmatter の `id` は推奨形式で一意にする。
83
64
 
84
65
  ## 4. 推奨 Frontmatter 項目
85
66
 
86
67
  ### 4.1. 設定内容
87
68
 
88
- | 項目 | 説明 | 必須 |
89
- | ---------- | ------------------------------------------------------------ | ---- |
90
- | id | `<project-id>:prj-charter` 形式の文書 ID | ○ |
91
- | type | `project` | ○ |
92
- | status | `draft` / `ready` / `deprecated` | ○ |
93
- | rulebook | `specdojo:prj-charter-rulebook` | ○ |
94
- | based_on | 立ち上げ認可の直接根拠にした概要、ステークホルダー登録簿など | 任意 |
95
- | supersedes | 置き換えた旧文書 ID | 任意 |
69
+ 共通項目・値制約はドキュメントメタ情報標準を正とし、`type` は `project`、`rulebook` は `specdojo:prj-charter-rulebook` とする。
96
70
 
97
71
  ### 4.2. 推奨ルール
98
72
 
99
73
  - `based_on` は、認可対象、目的、関係者、権限委譲を判断する直接根拠だけを列挙する。
100
74
  - 初版では、原則として `prj-overview` と `prj-stakeholder-register` を中心にする。
101
75
  - `pm-plan`、`pm-organization`、詳細スコープ、成功基準などは、憲章承認後に作成または詳細化する文書であり、初版憲章の直接根拠として扱う場合は理由を明記する。
102
- - 改訂時は `supersedes` に旧文書 ID を設定し、差し替え関係を追跡可能にする。
103
- - H1 にはプロジェクト名を含め、Frontmatter にはタイトルを重複管理しない。
104
76
 
105
77
  ## 5. 本文構成(標準テンプレ)
106
78
 
@@ -112,122 +84,76 @@ flowchart LR
112
84
  | 2 | プロジェクトの目的 | ○ | プロジェクト概要に基づく目的と期待効果の要約、成功基準文書への委譲 |
113
85
  | 3 | ハイレベルスコープ | ○ | 認可する対象範囲、対象外、未確定事項。成果物群は成果物カタログへ委譲 |
114
86
  | 4 | 初期ステークホルダー | ○ | 初期関係者、関与区分、Role code、認可判断上の責任 |
115
- | 5 | 権限委譲 | ○ | 委譲する権限、PO 承認が必要な事項、証跡 |
87
+ | 5 | 権限委譲 | ○ | 委譲する権限、承認責任者に留保する判断、証跡 |
116
88
  | 6 | 主要前提・制約 | ○ | 認可判断に直結する前提、制約、予算枠。全量は前提・制約・依存文書へ委譲 |
117
89
  | 7 | 本格実行開始の GO / Not GO 判断 | ○ | 本格実行前に確認する観点と記録先 |
118
90
  | 8 | 承認 | ○ | 承認日、承認者、承認対象、証跡リンク |
119
- | 9 | 未決事項 | 任意 | 今後の意思決定が必要な論点、期限、担当、対応方針 |
120
-
121
- 立ち上げ認可文書であること、委譲する範囲、本格実行開始を承認しないことは、専用の章を設けず H1 直下の冒頭文に書く。
91
+ | 9 | 未決事項 | 任意 | 意思決定が必要な論点、認可や後続判断への影響、当面の扱い |
122
92
 
123
93
  ## 6. 記述ガイド
124
94
 
125
95
  ### 6.1. 共通
126
96
 
127
- - H1 直下の冒頭文に、立ち上げ認可と権限委譲の文書であること、承認責任者、本格実行開始・外部公開を承認しないことを 2〜3 文で書く。
97
+ - H1 にプロジェクト名を含める。直下の冒頭文には、立ち上げ認可の対象、誰にどの権限を委譲するか、承認責任者、本格実行開始・外部公開を承認しないことを 2〜3 文で書く。
128
98
  - 立ち上げ認可と権限委譲に集中し、詳細計画や設計の本文を先取りしない。後続文書は根拠として先取りせず、詳細化先として参照する。
129
99
 
130
- - 後続文書への参照(`詳細化先` 列や記録先)は、参照先が未作成の間は ID をバッククォートで仮置きし(例: `prj-scope`)、作成後に `[[<project-id>:prj-scope|プロジェクトスコープ]]` のような wikilink へ更新する。
131
- - 事実、判断、未決事項を分ける。未確定は _TODO_:、_UNDECIDED_:、_ASSUMPTION_: を用いる。
132
- - 認可しない範囲を明記し、憲章承認と本格実行開始を混同しない。
133
-
134
- - 公開文書では、公開してよい情報だけを記載し、最終判断と説明責任を人間の PO が担う前提を崩さない。
135
-
136
100
  ### 6.2. 認可対象
137
101
 
138
102
  - プロジェクト名、プロジェクト ID、認可対象、認可しない範囲、直接根拠、承認責任を表で示す。
139
103
  - 認可対象は、原則として立ち上げ、詳細計画策定、初期準備に限定する。
140
104
  - 本格実行や公開まで認可する場合は、計画、体制、予算枠、品質条件が確認済みであることを明記する。
141
- - 承認に条件が付く場合は、`認可条件` を補足として 1 行追加してよい。ただし、承認章の代替にはせず、承認日・承認者・証跡リンクの管理は別途必要とする。
142
-
143
- 推奨表:
144
-
145
- | 項目 | 内容 |
146
- | --------------- | ---- |
147
- | プロジェクト名 | |
148
- | プロジェクト ID | |
149
- | 認可対象 | |
150
- | 認可しない範囲 | |
151
- | 直接根拠 | |
152
- | 承認責任 | |
105
+ - 表は `項目`・`内容` の 2 列とし、承認に条件が付く場合のみ `認可条件` 行を追加する。承認の記録要件は「承認と未決事項」に従う。
153
106
 
154
107
  ### 6.3. プロジェクトの目的
155
108
 
156
109
  - 冒頭は 1〜2 文の要約に留め、背景、必要性、目的の詳細はプロジェクト概要を正として参照する。
157
- - 期待効果は、PO が承認または保留を判断できる観点に分解し、`観点` と `期待効果` の表で示す。
110
+ - 期待効果は、承認責任者が承認または保留を判断できる観点に分解する。表は `観点`・`認可判断で確認する期待効果` の 2 列とする。
158
111
  - 数値目標、測定方法、中長期指標はプロジェクト概要の期待効果を正とし、憲章では再掲しない。
159
112
  - 成功判定の観点と受入条件は成功基準文書を正とし、専用の章を設けず本章から参照する。
160
113
 
161
- 推奨表:
162
-
163
- | 観点 | 認可判断で確認する期待効果 |
164
- | ---- | -------------------------- |
165
-
166
114
  ### 6.4. ハイレベルスコープ
167
115
 
168
116
  - 立ち上げ時点で認可する大まかな対象範囲だけを示す。
169
- - 対象外と未確定を同じ表で明示し、後続のスコープ詳細化へ渡す。
170
-
171
- - AI Agent の支援範囲、人間の判断責任、公開情報の範囲など、責任境界に関わる事項を含める。
117
+ - `区分`・`内容`・`詳細化先` の 3 列で、`対象`・`対象外`・`未確定` を分ける。対象と対象外はスコープ文書、未確定は未決事項へつなげる。
118
+ - AI Agent を利用するプロジェクトでは、支援対象の活動と委譲範囲を記載する。利用しない場合は記載を要しない。
172
119
  - 成果物群の一覧・配置・派生関係と、憲章承認後に作成する文書の一覧は成果物カタログを正とし、専用の章を設けず本章から参照する。
173
120
 
174
- 推奨表:
175
-
176
- | 区分 | 内容 | 詳細化先 |
177
- | ------ | ---- | ----------- |
178
- | 対象 | | `prj-scope` |
179
- | 対象外 | | `prj-scope` |
180
- | 未確定 | | 未決事項 |
181
-
182
121
  ### 6.5. 初期ステークホルダー
183
122
 
184
123
  - ステークホルダー登録簿のうち、認可判断と権限委譲に関係する主要関係者だけを要約する。
185
- - 個人名や連絡先ではなく、役割名、集団名、Role code で識別する。
186
- - AI Agent は支援者として扱い、承認者または説明責任者として扱わない。
124
+ - 関係者 ID、関係者名、関与区分、対応 Role code、認可判断における主な責任を示す。役割の定義や割り当ては再掲しない。
187
125
 
188
126
  ### 6.6. 権限委譲
189
127
 
190
- - 決裁者、実行責任者、協議先、証跡を表で示す。
191
- - 委譲する権限と、PO 承認が必要な事項を分けて書く。
192
- - 予算枠、公開可否、ライセンス、主要スコープ変更、GO / Not GO 判断は、PO 承認事項として明示する。
193
-
194
- 推奨表:
195
-
196
- | 項目 | 決裁者 | 実行責任者 | 協議先 | 証跡 |
197
- | ------------ | ------ | ---------- | ------ | ---- |
198
- | 立ち上げ認可 | | | | |
199
- | 詳細計画策定 | | | | |
200
- | 本格実行開始 | | | | |
128
+ - `項目`・`決裁者`・`実行責任者`・`協議先`・`証跡` の 5 列で、立ち上げ認可、詳細計画策定、本格実行開始の判断権限を示す。
129
+ - 委譲する権限と、承認責任者に留保する判断を分ける。予算枠、公開可否、ライセンス、主要スコープ変更、GO / Not GO を境界として明示する。
201
130
 
202
131
  ### 6.7. 主要前提・制約
203
132
 
204
133
  - 前提・制約の全量は前提・制約・依存関係文書を正とし、認可判断に直結する事項(予算枠、公開適性、人間の判断責任)だけを載せる。
134
+ - 予算枠は、費用・外部支出・運用負担の上限、または追加支出を認めない制約として具体化する。
205
135
  - 予算枠が未確定の場合は、未確定であること、追加支出を認めるかどうか、確定タイミングを明記する。
206
- - 公開文書では秘密情報を含めない制約を明示する。
207
136
 
208
137
  ### 6.8. 本格実行開始の GO / Not GO 判断
209
138
 
210
- - 本格実行開始、外部公開、主要投資へ進む前に確認する観点を定義する。
139
+ - 本格実行開始、外部公開、主要投資へ進むか、継続・再計画・中止とするかを判断できる観点を定義する。
211
140
  - 判断観点には、目的整合、公開適性、予算枠、体制、品質を含める。
212
- - 判断結果の記録先を明記し、口頭合意だけで完了扱いにしない。
141
+ - 観点ごとに確認内容、合格条件、判断結果の記録先を示す。目的整合は概要、体制は組織定義、品質は品質管理計画と照合し、予算枠と公開範囲の条件も確認する。未達条件が残れば開始判断を保留する。
213
142
 
214
143
  ### 6.9. 承認と未決事項
215
144
 
216
- - 承認履歴は、承認日、承認者、承認対象、証跡リンクを必須とする。版番号は管理せず、承認対象の文書状態は証跡リンクで特定する(文書の状態は frontmatter の `status` と Git の履歴が正本)。
145
+ - 承認履歴は `承認日`・`承認者`・`承認対象`・`証跡リンク` の 4 列を必須とする。版番号は設けない。
217
146
  - 証跡リンクには、承認の意思表示と承認対象の文書状態の両方を特定できる記録(決定記録、Pull Request、Issue、議事録など)を記載する。
218
- - PO 承認事項(目的、主要スコープ、権限委譲範囲、予算枠など)に触れる改訂を反映した場合は、承認履歴へ行を追加して再承認を受ける。軽微な修正は Git の履歴に委ね、再承認を要しない。
219
- - 承認者または証跡が未確定の場合は、正式認可済みと書かない。
220
- - 未決事項には、論点、期限、担当、対応方針を記載し、GO / Not GO 判断までに解消が必要なものを識別できるようにする。
147
+ - Frontmatter の `status` は文書の成熟度、承認履歴はプロジェクトの認可状態を表す独立した軸である。`ready` だけを根拠に正式認可済みとしない。認可状態は承認者・承認日・証跡と認可条件の充足で確認する。
148
+ - 未決事項は論点、認可や GO / Not GO への影響、当面の扱いを記載し、後続判断までに解消が必要な条件を識別する。
221
149
 
222
150
  ## 7. 禁止事項
223
151
 
224
152
  | 項目 | 理由 |
225
153
  | ---------------------------------------------------- | -------------------------------------------- |
226
154
  | 憲章承認を本格実行開始や外部公開の承認と混同する | 立ち上げ認可と後続判断の責任境界が崩れるため |
227
- | 認可対象または認可しない範囲を記載しない | PO が承認範囲を判断できないため |
155
+ | 認可対象または認可しない範囲を記載しない | 承認責任者が認可範囲を判断できないため |
228
156
  | 予算枠または追加支出の扱いを記載しない | 承認判断に必要なコスト境界が不明になるため |
229
157
  | 承認者、承認日、証跡が未確定なのに正式認可済みと書く | 説明責任と監査可能性が失われるため |
230
158
  | 詳細スコープ、受入条件、設計詳細を憲章に過剰記載する | 後続文書との二重管理を招くため |
231
- | AI Agent を最終判断者または承認者として扱う | 人間の説明責任と公開判断の前提に反するため |
232
- | 個人情報、秘密情報、非公開組織情報を記載する | 公開時の情報管理リスクを高めるため |
233
159
  | 曖昧語だけで成功基準や GO / Not GO 条件を書く | 判断可能性と再現性が下がるため |
@@ -17,18 +17,16 @@ specdojo:
17
17
 
18
18
  Comparison of Alternatives Documentation Rulebook
19
19
 
20
- 複数の実行案を同じ条件で比較し、採否の根拠と見直し条件を残すためのルールです。`PM` が後続作業・依存・リスクを計画へ接続し、人間の `PO` が判断できる記載水準を定めます。
20
+ 複数案を同じ条件で比較し、採否の根拠と見直し条件を残す基準を定めます。
21
21
 
22
22
  ## 1. 全体方針
23
23
 
24
- - 対象は、技術的・方針的な代替案の比較です。業務・利用者の課題から必要な意思決定を定め、比較過程を後から検証できるようにします。
25
- - 比較レイヤーごとに、同じ課題を解決できる一式の案を最低 2 案比較します。前段文書から課題・制約・必要能力・評価条件を引き継ぎ、候補集合は外部調査も含めて構成します。
26
- - 評価基準、採否の根拠、リスク、再評価条件を判断に必要な粒度で残します。詳細設計や製品仕様の転載は避け、正本を参照します。
27
- - 最終判断は人間の `PO` が行います。AI Agent は調査・比較分析・検証を支援します。
24
+ - 対象は、業務・利用者の課題を解く技術的・方針的な代替案の比較です。
25
+ - 比較レイヤー(同じ抽象度で比較する判断の単位)ごとに、単独で同じ目的を達成できる一式の案を最低 2 案比較します。
26
+ - 前段文書から課題・制約・必要能力・評価条件を引き継ぎ、外部調査で候補を広げ、検証できる根拠を残します。
27
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱い、業務の受入条件に含めません。
28
28
 
29
- ## 2. 位置づけと用語定義
30
-
31
- ### 2.1. 位置づけ(他ドキュメントとの関係)
29
+ ## 2. 位置づけ
32
30
 
33
31
  ```mermaid
34
32
  flowchart LR
@@ -46,101 +44,88 @@ flowchart LR
46
44
  class COA target
47
45
  ```
48
46
 
49
- ### 2.2. 用語定義(本ルール内)
50
-
51
- | 用語 | 定義 |
52
- | ------------ | ----------------------------------------------------------------------------------- |
53
- | 代替案 | 同一の意思決定を代替でき、単独でも目的達成への道筋を説明できる一式の候補案 |
54
- | 比較レイヤー | 業務運用、解決方式、購入 / 構築、製品、開発方式など、同じ抽象度で比較する判断の単位 |
55
- | 候補カテゴリ | 同種の責務・統合範囲を持つ方式をまとめ、具体候補を探索する単位 |
56
- | 正本 | 現在の状態または判断根拠について、最終的に正しいものとして参照する情報源 |
57
- | 比較試行 | 正式採用前に、入力、評価軸、完了条件を固定して適合性と可逆性を確認する活動 |
58
- | トレードオフ | 採択に伴って受容する不利条件 |
59
-
60
47
  ## 3. ファイル命名・ID規則
61
48
 
62
49
  - 共通の配置・命名は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従います。
63
- - 配置は `docs/ja/projects/<project-id>/020-project-definition/`、ファイル名は `prj-comparison-of-alternatives.md` を推奨します。日本語名を採用する場合は `代替案比較.md` とし、プロジェクト内で統一します。
64
- - ID は `<project-id>:prj-comparison-of-alternatives` を推奨します。例: `prj-0001:prj-comparison-of-alternatives`。
50
+ - 配置は `docs/ja/projects/<project-id>/020-project-definition/`、ファイル名は `prj-comparison-of-alternatives.md` を推奨します。日本語名は `代替案比較.md` とし、プロジェクト内で統一します。
51
+ - ID は `<project-id>:prj-comparison-of-alternatives` を推奨します。
65
52
 
66
53
  ## 4. 推奨 Frontmatter 項目
67
54
 
68
- - 共通項目とライフサイクルは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]]、値・構文・必須性は [成果物 Frontmatter スキーマ](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml) を正本とします。
55
+ - 値・構文・必須性は [成果物 Frontmatter スキーマ](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml) を正本とします。
69
56
  - `type` は本書の `deliverable_type` に合わせ、`rulebook` には本書の ID を指定します。
70
- - `based_on` には、スコープ、課題と解決アプローチ、前提・制約など、比較判断に直接使った文書だけを指定します。本文では判断箇所から見積・リスク分析・検証結果へ参照を接続します。
57
+ - `based_on` には、スコープ、課題と解決アプローチ、前提・制約など、比較判断に直接使った文書を指定します。
71
58
 
72
59
  ## 5. 本文要件
73
60
 
74
- 見出し順・表・記入欄の骨組みは Frontmatter で宣言した template を正本とし、本書では内容の充足条件を定めます。
61
+ 見出し順・表・記入欄は Frontmatter の template を正本とし、内容の充足条件を以下に定めます。
75
62
 
76
- - **比較目的と前提条件・比較対象案(必須)**: 何を決め、何を扱わないかを示し、候補カテゴリの選定根拠と各案の課題解決への道筋を説明します。複数レイヤーでは決定 ID と判断順序を明示します。
77
- - **評価軸と評価基準・比較結果と採択理由(必須)**: 課題・制約に結び付く判定条件と、同一条件での各案の評価、採否の根拠を示します。技術的実現性、外部依存、後続成果物への影響を含めます。
78
- - **リスクとトレードオフ(必須)**: 案に対応する不確実性と受容する不利益を区別し、軽減策を示します。後続作業へ渡す対象と確認条件を識別できる粒度にします。
79
- - **決定と見直し(独立章は任意)**: 最終判断者、再評価トリガー、記録先は必須です。独立章を省く場合は「比較結果と採択理由」へ統合します。
63
+ - **比較目的と前提条件・比較対象案(必須)**: 決めること・対象外、候補カテゴリの選定根拠、各案の課題解決への道筋を示します。複数レイヤーでは決定 ID と判断順序も必要です。
64
+ - **評価軸と評価基準・比較結果と採択理由(必須)**: 課題・制約に結び付く判定条件、同一条件での評価と採否の根拠、技術的実現性・外部依存・後続への影響を示します。
65
+ - **リスクとトレードオフ(必須)**: 案ごとの不確実性と受容する不利益を区別し、軽減策と後続作業の対象・完了条件を示します。
66
+ - **決定と見直し(独立章は任意)**: 最終判断者、再評価トリガー、記録先は必須です。独立章がなければ「比較結果と採択理由」へ統合します。
80
67
 
81
68
  ## 6. 記述ガイド
82
69
 
83
70
  ### 6.1. 共通
84
71
 
85
- - 共通のメタ情報・ラベル・文書の改訂と廃止は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を正本とし、ここでは比較固有の判断を扱います。
86
- - 章はタイトルで参照し、同じ採否理由や見直し条件を複数箇所へ転載しません。評価結果を説明する箇所に理由と証拠を集約し、決定の要約から参照します。
87
- - 実装、schema、リファレンスが定める値・構文・データ構造は正本への参照で示し、比較には採否を左右する差異・制約・影響だけを残します。
72
+ - 採否の理由と証拠は評価結果に集約し、決定の要約から参照します。見積・リスク分析・検証結果は判断箇所から辿れるようにします。
73
+ - 詳細設計・製品仕様・実装・schema は正本を参照し、比較には採否を左右する差異・制約・影響だけを残します。
88
74
 
89
75
  ### 6.2. 比較目的と前提条件
90
76
 
91
- - スコープと課題に対して決めること・決めないことを定めます。業務運用、解決方式、購入 / 構築、製品、アーキテクチャなど必要な比較レイヤーだけを扱い、開発戦略や作業管理は明示的な決定対象である場合に限ります。
92
- - 複数の判断には `D-01` などの決定 ID を付け、上位判断から後続判断への順序を示します。前段文書は候補の答えではなく、課題・制約・評価条件の根拠として読みます。
77
+ - スコープと課題から決めること・対象外を定め、業務運用、解決方式、購入 / 構築、製品などのレイヤーに絞ります。開発戦略や作業管理は明示的な決定対象に限ります。
78
+ - 複数の判断には `D-01` などの決定 ID と判断順序を付けます。前段文書は課題・制約・評価条件の根拠として読みます。
93
79
  - **良い例**: 「D-01 で販売記録を継続できる解決方式を選ぶ。製品選定は既存サービス案が残った場合に行い、EC は対象外とする」。
94
80
  - **悪い例**: 「使う製品を先に決め、導入理由を比較表にする」。課題と比較範囲を判断できません。
95
81
 
96
82
  ### 6.3. 比較対象案
97
83
 
98
- - 各案は、単独でも目的達成への道筋、対象範囲、主要な構成を説明できる業務運用込みの解決案にします。相互に補完する部品を別案にせず、同じ抽象度の候補を並べます。
99
- - 候補カテゴリと選定基準を先に定め、現行運用改善、汎用ツール、既存製品、個別構築、外部委託などから有力案を探します。専用ツールを使わない案や外部の直接競合も必要に応じて含めます。
84
+ - 各案に目的達成への道筋、対象範囲、業務運用を含む主要構成を示します。相互に補完する部品は一式の案にまとめます。
85
+ - 同種の責務・統合範囲で候補カテゴリと選定基準を先に定め、現行運用改善、汎用ツール、既存製品、個別構築、外部委託から有力案を探します。専用ツールを使わない案や外部の直接競合も必要に応じて含めます。
100
86
  - 標準・方法論と製品を区別し、公式資料で責務、データ保管、対応環境、移行可能性を確認します。市場代表と呼ぶ場合は客観的根拠を示します。
101
87
  - **良い例**: 「紙帳票の統一、共有表計算、既存サービス、個別構築を同じ販売記録の課題で比較する」。
102
88
  - **悪い例**: 「画面、データベース、開発ツールを別案にし、すべて採択する」。一つの意思決定を代替していません。
103
89
 
104
90
  ### 6.4. 評価軸と評価基準
105
91
 
106
- - 最低ラインは **効果、コスト、期間、リスク、業務適合、技術実現性** の 6 観点です。業務適合は利用者の手順・体制への適合を指し、運用・保守性は継続運用に要する負荷として必要に応じて分けます。
107
- - レイヤーごとに軸を変えてよいものの、最低観点を省略する場合は、観点名と比較目的上不要な理由を明示します。別名の軸へ統合する場合は対応先と判定条件を示します。別章にリスクや実現性の説明があるだけでは、評価軸の省略理由を記したことにはなりません。
108
- - 同一レイヤー内では全候補に同じ軸・判定境界・評価方向を使用します。各軸を根拠資料の課題 ID・制約に対応付け、重みを使う場合は優先順位なのか加重計算なのかを明記します。
92
+ - 最低ラインは **効果、コスト、期間、リスク、業務適合、技術実現性** の 6 観点です。業務適合は利用者の手順・体制への適合、必要に応じて分ける運用・保守性は継続運用の負荷を指します。
93
+ - レイヤーごとに軸を変えても、最低観点の省略には観点名と不要な理由、統合には対応先と判定条件が必要です。別章の説明だけで省略理由を代替できません。
94
+ - 同一レイヤーの全候補に同じ軸・判定境界・評価方向を使用します。
109
95
  - 技術実現性は既存環境、移行、外部依存、運用継続、後続成果物への影響から判定します。製品比較ではロックイン・可逆性・成熟度、判断に影響する場合は適応性・追跡性・人間の統制・AI Agent の長期作業と検証可能性を追加します。
110
96
 
111
- 評価基準表では、次の情報を読み取れるようにします。列の統合は、判定情報を失わない範囲で行います。
97
+ 評価基準表には次の情報を示します。情報を失わなければ列を統合できます。
112
98
 
113
- | 情報 | 記述・判定の基準 |
114
- | -------------- | ------------------------------------------------------------ |
115
- | 評価軸と根拠 | 観点の意味と、対応する課題 ID・制約を示す |
116
- | 判定基準 | 測定値または観察可能な状態で評価の境界と有利な方向を定める |
117
- | 重み・集約方法 | 使用する場合に、重みの理由と総合評価・採否への反映方法を示す |
99
+ | 情報 | 記述・判定の基準 |
100
+ | -------------- | -------------------------------------------------------------------- |
101
+ | 評価軸と根拠 | 観点の意味と、対応する課題 ID・制約を示す |
102
+ | 判定基準 | 測定値または観察可能な状態で評価の境界と有利な方向を定める |
103
+ | 重み・集約方法 | 使用時は理由、優先順位か加重計算か、総合評価・採否への反映方法を示す |
118
104
 
119
105
  - **良い例**: 「期間は 2 週以内の試行開始を High、2 週超 4 週以内を Middle、それ超を Low とする。リスクは継続運用軸へ統合し、通信断時の記録保持で判定する」。
120
106
  - **悪い例**: 「不要な軸を削除する」「リスクは別章に書いたので評価しない」。削除の妥当性と全候補への適用を確認できません。
121
107
 
122
108
  ### 6.5. 比較結果と採択理由
123
109
 
124
- - 各候補に採択・一部採択・比較試行・保留・非採択などの判定を付け、評価軸に結び付く理由と再評価条件を記載します。結果表は採用した評価軸と対応させ、測定値や定性理由、根拠資料へのリンクで評価を追跡できるようにします。
125
- - 技術的実現性と影響は、決定または案ごとの表で示します。外部ツールは仕様・状態の正本、導入時期、同期方向、停止時の移行・取り出し方法を明示します。
126
- - 比較試行では同じ入力・範囲・評価軸を使用し、測定項目、完了条件、採用・撤退の閾値、記録先を事前に定めます。試行候補は正式採用や標準と区別し、未確認事項は確認済みの高評価にせず、仮定と確認作業を分けます。
110
+ - 各候補に採択・一部採択・比較試行・保留・非採択などの判定と再評価条件を付けます。結果表は評価軸に対応させ、測定値・定性理由・根拠資料への参照で評価と採否を追跡可能にします。
111
+ - 実現性と影響は決定・案ごとの表で示します。外部ツールは仕様・状態の正本、導入時期、同期方向、停止時の移行・取り出し方法を明示します。
112
+ - 比較試行は正式採用や標準と区別し、同じ入力・範囲・評価軸で行います。測定項目、完了条件、採用・撤退の閾値、記録先を事前に定めます。未確認を確認済みの高評価にせず、仮定と確認作業を分けます。
127
113
  - **良い例**: 「ALT-02 は操作検証で 10 件中 2 件の記録漏れがあり、漏れ 0 件の基準を満たさず非採択。入力手順改善後に再試行する」。
128
114
  - **悪い例**: 「新しい製品なので High、採択する」。評価条件と証拠がなく再現できません。
129
115
 
130
116
  ### 6.6. リスクとトレードオフ
131
117
 
132
- - リスクは起きうる事象と軽減策、トレードオフは先送りする範囲・受容する負荷・後続への影響を記します。決定 ID または案 ID で対象を特定し、全候補に共通する場合はその旨を示します。
133
- - 軽減策を後続作業にする場合は、担当 Role code、依存する作業・成果物、完了を確認する条件を示します。具体的な計画書名や台帳名は根拠資料で実在を確認し、詳細設計は後続成果物へ委譲します。
118
+ - リスクには起きうる事象と軽減策、トレードオフには先送りする範囲・受容する負荷・後続への影響を記し、決定 ID・案 ID または全候補共通で対象を特定します。
119
+ - 後続作業となる軽減策には担当、依存作業・成果物、完了条件を示します。計画書・台帳名は実在を確認し、詳細設計は後続成果物へ委譲します。
134
120
  - **良い例**: 「ALT-04 の残高移行漏れを抑えるため、移行後に `QE` が元ノートとの全件照合を行い、差分 0 件を受入条件とする」。
135
121
  - **悪い例**: 「移行には注意する」。対象、実施者、完了条件がなく計画へ渡せません。
136
122
 
137
123
  ### 6.7. 決定と見直し
138
124
 
139
- - 現時点の採択・試行・保留を決定 ID 単位で短く要約し、最終判断者を明記します。再評価トリガーは期間、測定値、制約や依存の変化で定め、特定製品の自動採用条件にしません。
140
- - 方針変更は理由、評価結果、影響範囲、移行・撤退方法とともに、実在するプロジェクト登録簿または決定記録へ残します。恒久的なリスク・課題・変更要求・未決事項は種類を分け、担当 Role code と転送先レコードを示します。
141
- - 改訂・廃止時は `PM` が後続成果物・Schedule・PJR の追従作業を管理します。`BA` は業務影響、`ARC` は技術制約と外部依存、`DEV` は関連実装、`QE` は受入条件と検証、`PO` は方針変更を確認・判断します。
142
- - **良い例**: 「`PO` が ALT-04 を採択。2 週間の試行で記録継続が営業日の 90% 未満なら `PM` が再比較を計画し、判断理由を既存の決定記録へ残す」。
143
- - **悪い例**: 「Agent が必要に応じて採用ツールを変更する」。再評価条件と人間の判断責任が不明です。
125
+ - 採択・試行・保留は決定 ID ごとに要約し、最終判断者を示します。再評価トリガーは期間・測定値・制約や依存の変化で定め、特定製品の自動採用条件にしません。
126
+ - 方針変更の理由、評価結果、影響範囲、移行・撤退方法を記録先から辿れるようにします。未決の比較条件には論点と採否・後続作業への影響を示します。
127
+ - **良い例**: 「ALT-04 を採択。2 週間の試行で記録継続が営業日の 90% 未満なら再比較し、判断理由を決定記録へ残す」。
128
+ - **悪い例**: 「必要に応じて採用ツールを変更する」。再評価条件を判断できません。
144
129
 
145
130
  ## 7. 禁止事項
146
131
 
@@ -157,6 +142,3 @@ flowchart LR
157
142
  | 前段文書の候補案を名称変更して再掲するだけで外部案を調査しない | 結論の追認となり、有力な代替手段を見落とすため |
158
143
  | 評価軸なしの採択結論 | 判断根拠が不透明になるため |
159
144
  | 非採択理由の未記載 | 将来再評価時に経緯追跡できないため |
160
- | 根拠資料リンクなし | 説明責任を果たせないため |
161
- | Agent に採択案の最終判断を委ねる | 人間の判断責任を代替してしまうため |
162
- | 公開リポジトリに個人名・個人連絡先・非公開の組織情報を記載する | 公開範囲とプライバシーに反するため |