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,289 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:prj-overview-recipe
4
+ type: recipe
5
+ status: ready
6
+ rulebook: specdojo:prj-overview-rulebook
7
+ sample: specdojo:prj-overview-sample
8
+ ---
9
+
10
+ # プロジェクト概要 作成レシピ
11
+
12
+ Project Overview Writing Recipe
13
+
14
+ 本ドキュメントは、プロジェクト概要を「読み手が短時間で立ち上げ判断の前提を理解できる内容」に仕上げるための作り方です。
15
+ 本書では問い、深掘り手順、具体化のコツ、レビュー観点を扱います。
16
+
17
+ ## 1. このレシピの使い方
18
+
19
+ - 最初に、プロジェクトの仮説を粗く書き出す。
20
+ - 次に、各章の問いに答えながら、背景、必要性、基本的な考え方、実現したいこと、期待効果、前提条件を具体化する。
21
+ - 最後に、レビュー観点で「曖昧すぎないか」「後続文書に委譲すべき詳細を書きすぎていないか」を確認する。
22
+ - 利用者の困りごと・放置リスク・目指す価値(Why)、実現したい状態と期待効果(What)、中心仮説と判断軸(How)を整理し、背景から必要性、実現したいこと、期待効果への対応を追跡できるようにする(Trace)。詳細スコープ、受入条件、設計は後続文書へ委譲する。
23
+
24
+ ## 2. 作成前に集める情報
25
+
26
+ 最初から正確に書こうとせず、以下を短いメモで集める。
27
+
28
+ | 項目 | 集める情報 |
29
+ | -------------- | -------------------------------------------------- |
30
+ | プロジェクト名 | 読み手が対象を識別できる名称 |
31
+ | 対象領域 | どの活動、業務、サービス、システムを扱うか |
32
+ | 現状 | いま何が起きているか |
33
+ | 困りごと | 誰が、何に困っているか |
34
+ | 放置リスク | 取り組まない場合に悪化すること |
35
+ | 中心仮説 | 誰の課題に何を働きかけると、どの変化が生じるか |
36
+ | 実現したい状態 | 何ができるようになれば前進と言えるか |
37
+ | 判断軸 | 進め方で重視する原則、譲れない考え方 |
38
+ | 初期公開効果 | 提供開始前に代表利用者の試行等で確認できる効果 |
39
+ | 短期効果 | 提供後の利用、定着、再利用、直接的な課題改善 |
40
+ | 中長期効果 | 事業・活動の継続や社会的な波及として目指す効果 |
41
+ | 前提・制約 | 変えないこと、依存すること、まだ決まっていないこと |
42
+
43
+ ## 3. 全体の作成手順
44
+
45
+ 1. H1 と導入文で「何のプロジェクトか」を一文で定義する。
46
+ 2. 背景で、現状と困りごとを分けて書く。
47
+ 3. 必要性で、なぜ今取り組む必要があるかを書き、必要なら中心仮説を一文にする。
48
+ 4. 基本的な考え方で、判断軸を 2〜5 件に絞る。
49
+ 5. 実現したいことで、成果の方向性を箇条書きにする。
50
+ 6. 期待効果で、初期公開、短期、中長期の効果を分け、測定方法を置く。
51
+ 7. 前提条件で、適用範囲、責任分担、制約、未決事項を明示する。
52
+ 8. 最後に、詳細化すべき内容を後続文書へ委譲できているか確認する。
53
+
54
+ ## 4. 各章の書き方
55
+
56
+ ### 4.1. 導入文
57
+
58
+ 導入文は、H1 の直下に 1 文で置く。
59
+
60
+ 問い:
61
+
62
+ - このプロジェクトは何を支援するものか。
63
+ - 誰が使う、または誰に影響するものか。
64
+ - 何を通じて、どの状態を実現するのか。
65
+
66
+ 書き方:
67
+
68
+ - 「A は、B を通じて、C を支援する D である」の形にすると書きやすい。
69
+ - 効果、指標、実装方式を盛り込みすぎない。
70
+ - 読み手が冒頭 10 秒で対象をつかめる粒度にする。
71
+
72
+ 良い例:
73
+
74
+ > 駄菓子屋きぬや 販売管理システムは、店頭販売、在庫、常連顧客のつけを一元管理し、店主一人でも日々の運用を続けやすくするための小規模店舗向け業務支援システムである。
75
+
76
+ 悪い例:
77
+
78
+ > 店舗運営を適切に改善するための便利なシステムである。
79
+
80
+ ### 4.2. 背景
81
+
82
+ 背景では、現状と困りごとを混ぜずに書く。
83
+
84
+ 問い:
85
+
86
+ - いま、どのような状況か。
87
+ - 誰が、どの作業で困っているか。
88
+ - その困りごとは、どの程度繰り返し起きているか。
89
+ - すでに見えている影響は何か。
90
+
91
+ 具体化のコツ:
92
+
93
+ - まず 1〜2 段落で文脈を説明する。
94
+ - その後に、顕在化している問題を箇条書きで並べる。
95
+ - 事実と推測が混ざる場合は、推測側を「仮説」として扱う。
96
+
97
+ 良い例:
98
+
99
+ - 人気商品の欠品が増えている。
100
+ - 仕入れのタイミングや数量が勘頼りで、在庫のムラが大きい。
101
+ - 店主以外が店番をした際に、販売・在庫・つけの状況をすぐに確認できない。
102
+
103
+ 悪い例:
104
+
105
+ - 現状いろいろ大変で、業務改善が必要である。
106
+
107
+ ### 4.3. 必要性
108
+
109
+ 必要性では、背景で示した課題に対して「なぜ取り組む必要があるか」を説明する。
110
+
111
+ 問い:
112
+
113
+ - 放置すると何が悪化するか。
114
+ - 今取り組まないと失われる機会は何か。
115
+ - 誰の負担、リスク、判断コストが増えるか。
116
+ - 初期対応として、何を先に安定させる必要があるか。
117
+ - 誰のどの課題へ何を働きかけると、どの価値が生じると考えるか。
118
+
119
+ 書き方:
120
+
121
+ - 背景の繰り返しではなく、放置リスクや着手理由を書く。
122
+ - 期限や繁忙期など、時間的な理由があれば書く。
123
+ - 「必要だから必要」ではなく、取り組まない場合の影響を示す。
124
+ - 複数の価値を同時に成立させることが重要な場合は、中心仮説を一文で置き、その構成要素を価値仮説として読み取れるようにする。
125
+
126
+ ### 4.4. 基本的な考え方
127
+
128
+ 基本的な考え方では、プロジェクトの判断軸を短く定義する。
129
+
130
+ 問い:
131
+
132
+ - 迷ったときに何を優先するか。
133
+ - 何をやりすぎないようにするか。
134
+ - どの価値を守るために、その進め方を選ぶのか。
135
+ - 後続のスコープ、設計、受入条件に効く原則は何か。
136
+
137
+ 書き方:
138
+
139
+ - 原則は 2〜5 件に絞る。
140
+ - 各原則は「名称 + 一文説明」にする。
141
+ - 原則名は日本語だけでもよい。英語名を付ける場合は、読み手に意味が伝わる訳を添える。
142
+
143
+ 例:
144
+
145
+ 1. **まず記録する**: 高度な分析よりも、日々の記録が続くことを優先する。
146
+ 2. **迷わず操作できる**: 画面数と入力項目を最小限にする。
147
+ 3. **小さく始めて改善する**: 初期リリースでは単一店舗の店頭運用に絞る。
148
+
149
+ ### 4.5. 実現したいこと
150
+
151
+ 実現したいことでは、プロジェクトが提供したい成果の方向性を書く。
152
+
153
+ 問い:
154
+
155
+ - 何ができるようになれば、プロジェクトを進める意味があるか。
156
+ - どの利用者、現場、活動が楽になるか。
157
+ - どこまでを初期対象として考えるか。
158
+ - 後続文書で詳細化すべき内容は何か。
159
+
160
+ 書き方:
161
+
162
+ - 具体的な機能名だけに寄せず、実現したい状態で書く。
163
+ - 詳細な対象範囲や対象外は `prj-scope` に委譲する。
164
+ - 4〜6 件程度の箇条書きにすると読みやすい。
165
+
166
+ 良い例:
167
+
168
+ - 駄菓子の販売、在庫、常連顧客のつけをシンプルな仕組みで一元管理する。
169
+ - 家族が店番をする場合でも、在庫状況とつけ残高を同じ手順で確認できるようにする。
170
+
171
+ 悪い例:
172
+
173
+ - 商品マスタ画面、販売登録画面、在庫一覧画面、顧客検索画面、月次集計画面を作る。
174
+
175
+ ### 4.6. 期待効果
176
+
177
+ 期待効果では、初期公開前に確認する価値、提供後の短期的な利用成果、中長期で目指す事業・社会的成果を分ける。
178
+
179
+ 問い:
180
+
181
+ - 初期公開または初期リリース時点で判定できることは何か。
182
+ - 対象利用者は、説明や特別な支援なしに主要な利用場面を完遂できるか。
183
+ - 公開・運用開始後の短期に、実際の利用、定着、再利用、直接的な改善をどう確認するか。
184
+ - 中長期に、事業・業務・社会へどのような成果をもたらしたいか。
185
+ - 当該プロジェクトだけに帰属できない成果を、寄与としてどのように確認するか。
186
+ - 数値目標は初期仮説か、確定したコミット値か。
187
+ - 測定方法は再現できるか。
188
+
189
+ 初期公開指標の考え方:
190
+
191
+ - 代表利用者が主要な利用場面を完遂できるかを、タスク完了、重大な行き詰まり、所要時間、必要な支援から確認する。
192
+ - 成果物や機能がそろったことは受入条件であり、それだけを利用者価値の指標にしない。
193
+ - QCD を扱う場合も、利用者の作業完遂や業務上の効果との関係を示す。
194
+
195
+ 短期指標の考え方:
196
+
197
+ - 公開・運用開始後の利用件数、利用継続、再利用、利用者が認識する直接的な改善を置く。
198
+ - 公開直後や運用直後は母数が小さいため、累積件数と具体的な利用事例から始める。
199
+
200
+ 中長期指標の考え方:
201
+
202
+ - 売上、欠品、負担、事業継続、社会課題への寄与、参加機会、透明性など、プロジェクトの最終目的に近い成果を置く。
203
+ - 外部要因の影響を受ける場合は、単独の因果を断定せず、利用前後の変化と当該プロジェクトの寄与を確認する。
204
+
205
+ 推奨表(観点・指標・目標・測定方法を 1 行ずつ書く。下記は三つの時間軸の記入例):
206
+
207
+ | 時間軸 | 観点 | 指標 | 目標 | 測定方法 |
208
+ | -------- | -------- | ---------------------------------------------- | --------------------- | ------------------------------------------ |
209
+ | 初期公開 | 作業完遂 | 店主代表が販売・在庫・つけ確認を完了できる | 必須タスク完了率100% | 代表シナリオの操作結果と必要な支援を記録 |
210
+ | 短期 | 運用定着 | 販売・在庫・つけの記録が残っている営業日の割合 | 営業日の90%以上 | 初期運用期間の記録有無を日次で集計 |
211
+ | 中長期 | 欠品削減 | 人気商品の欠品回数 | ベースライン比50%削減 | 対象商品を固定し、利用前後の欠品回数を比較 |
212
+
213
+ レビューのコツ:
214
+
215
+ - 「何を数えるか」が分からない指標は修正する。
216
+ - 「50%削減」などの相対目標には、比較対象を置く。
217
+ - 測定できない場合は「未確定」ではなく、何を記録して後で判定するかを書く。
218
+
219
+ ### 4.7. 前提条件
220
+
221
+ 前提条件では、プロジェクト概要を読む人が誤解しやすい境界を明示する。
222
+
223
+ 問い:
224
+
225
+ - 初期対象に含めるものは何か。
226
+ - 初期対象に含めないものは何か。
227
+ - 誰が最終判断を行うか。
228
+ - AI Agent やシステムは、どこまで支援する位置づけか。
229
+ - 未決事項は何で、どの文書またはタイミングで決めるか。
230
+
231
+ 書き方:
232
+
233
+ - 「対象」「対象外」「判断責任」「未決事項」を分けて考える。
234
+ - 個人情報や非公開情報は書かない。
235
+ - 未決事項は _UNDECIDED_: を使い、決定タイミングを添える。
236
+
237
+ ## 5. 深掘り手順
238
+
239
+ 内容が浅いと感じる場合は、次の順で深掘りする。
240
+
241
+ 1. **誰が困っているか** を具体化する。
242
+ 2. **何が繰り返し起きているか** を事実として書く。
243
+ 3. **放置した場合の悪化** を書く。
244
+ 4. **初期に成立させる最小状態** を決める。
245
+ 5. **中心仮説と価値仮説** を、課題、働きかけ、期待する変化の関係で確認する。
246
+ 6. **迷ったときの判断軸** を 2〜5 件に絞る。
247
+ 7. **初期公開前に試行する指標**、**提供後の短期指標**、**中長期で追跡する指標** を分ける。
248
+ 8. **後続文書へ委譲する詳細** を切り出す。
249
+
250
+ ## 6. 良い例 / 悪い例
251
+
252
+ | 観点 | 良い例 | 悪い例 |
253
+ | -------------- | -------------------------------------------------------------------------- | ---------------------------- |
254
+ | 導入文 | 店頭販売、在庫、つけを一元管理する小規模店舗向け業務支援システム | 店舗運営を便利にするシステム |
255
+ | 背景 | 欠品、在庫ムラ、つけ管理漏れが起きている | 現場が困っている |
256
+ | 必要性 | 紙運用を続けると店舗継続リスクが高まる | 早く作った方がよい |
257
+ | 基本方針 | 高度な分析より日々の記録継続を優先する | 使いやすく高機能にする |
258
+ | 実現したいこと | 家族が店番する場合でも在庫とつけを同じ手順で確認できる | 在庫画面を作る |
259
+ | 期待効果 | 初期公開では主要操作の完遂、短期では記録定着、中長期では欠品削減を確認する | 機能を完成させて便利にする |
260
+ | 前提条件 | 初期リリースでは EC 連携、複数店舗管理、本格会計連携は対象外とする | 必要に応じていろいろ対応する |
261
+
262
+ ## 7. レビュー観点
263
+
264
+ 作成後は、次の観点で確認する。
265
+
266
+ | 観点 | 確認内容 |
267
+ | -------------- | ------------------------------------------------------------ |
268
+ | 一読性 | H1 と導入文だけで対象プロジェクトの概要が分かるか |
269
+ | 背景の具体性 | 現状、困りごと、影響が具体的に書かれているか |
270
+ | 必要性の明確さ | 放置リスクや今取り組む理由が背景と接続しているか |
271
+ | 仮説の一貫性 | 中心仮説を置いた場合、価値仮説、原則、期待効果へつながるか |
272
+ | 判断軸 | 基本的な考え方が後続のスコープや設計判断に使える粒度か |
273
+ | 成果の粒度 | 実現したいことが機能列挙だけになっていないか |
274
+ | 指標の測定性 | 指標、目標、測定方法、判定時期が分かるか |
275
+ | 時間軸 | 初期公開、短期、中長期の効果が混在または欠落していないか |
276
+ | 利用者価値 | 成果物完成率だけでなく、利用・事業・社会の変化を示しているか |
277
+ | 責務分担 | 認可、受入条件、詳細スコープを本書に書きすぎていないか |
278
+ | 前提条件 | 対象外、判断責任、未決事項が明示されているか |
279
+ | 公開適性 | 個人情報、非公開情報、機密情報が含まれていないか |
280
+
281
+ ## 8. 仕上げチェック
282
+
283
+ - 「全体の作成手順」で示した章立てがそろっている。
284
+ - 章ごとに「なぜその情報が必要か」が読み取れる。
285
+ - 数値目標には測定方法と判定タイミングがある。
286
+ - 初期公開、短期、中長期の指標が、利用者価値から波及効果へつながっている。
287
+ - 初期仮説、未決事項、後続文書へ委譲する内容が混ざっていない。
288
+ - 詳細なスコープ、受入条件、認可情報、設計詳細を書きすぎていない。
289
+ - 中心仮説を置いた場合、対象者・課題・働きかけ・期待する変化が、実現したいこと、判断軸、期待効果へ一貫して対応している。
@@ -0,0 +1,201 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:prj-scope-recipe
4
+ type: recipe
5
+ status: ready
6
+ rulebook: specdojo:prj-scope-rulebook
7
+ sample: specdojo:prj-scope-sample
8
+ ---
9
+
10
+ # プロジェクトスコープ 作成レシピ
11
+
12
+ Project Scope Writing Recipe
13
+
14
+ 本ドキュメントは、プロジェクトスコープを「関係者が対象範囲と対象外を合意できる内容」に仕上げるための作り方です。
15
+ 本書では問い、深掘り手順、具体化のコツ、レビュー観点を扱います。
16
+
17
+ ## 1. このレシピの使い方
18
+
19
+ - 最初に、プロジェクト概要や上位方針から「何を実現したいか」を短く抜き出す。
20
+ - 次に、対象業務、対象システム、対象期間、スコープ外を分けて書く。
21
+ - 最後に、境界の判断基準とスコープ変更方針を置き、迷ったときの扱いを決める。
22
+ - 上位の目的・期待効果(Why)、対象業務・対象システム・対象期間・対象外(What)、境界判断と変更方針(How)を整理し、上位参照、対象項目、理由、変更記録で追跡する(Trace)。受入条件と設計・実装詳細は後続成果物へ委譲する。
23
+
24
+ ## 2. 作成前に集める情報
25
+
26
+ 最初から正確に書こうとせず、以下を短いメモで集める。
27
+
28
+ | 項目 | 集める情報 |
29
+ | ------------------ | -------------------------------------------------------------------------------------- |
30
+ | 背景と必要性 | なぜ取り組むか、放置すると何が悪化するか |
31
+ | 対象利用者 | 誰が使うか、誰が影響を受けるか |
32
+ | 対象業務 | どの業務、活動、利用場面を対象にするか |
33
+ | 対象システム | どのシステム、成果物、実行ツール、管理データ、生成物、基盤、外部連携を含めるか |
34
+ | 初期対象期間 | いつからいつまで、またはどのイベントまでを対象にするか。未確定なら _UNDECIDED_: で残す |
35
+ | 明示的な対象外 | やらないこと、理由、後続で扱う条件 |
36
+ | 境界で迷う項目 | 含めるか外すか判断が必要な候補 |
37
+ | 変更時の決め方 | 提案入口、影響評価、承認者、記録先 |
38
+ | 下流文書への委譲先 | 成功基準、前提・制約、課題、設計、実装、テストへ委譲する内容 |
39
+
40
+ ## 3. 全体の作成手順
41
+
42
+ 1. H1 で対象プロジェクト名を明示する。
43
+ 2. 対象業務で、活動領域、利用場面、利用者影響を書く。
44
+ 3. 対象システムで、対象となるシステム、成果物、実行ツール、管理データ、生成物、基盤を粒度を揃えて並べ、責務境界を書く。
45
+ 4. 対象期間で、初期対象、判断イベント、継続改善との切り分けを書く。
46
+ 5. スコープ外で、やらないこと、理由、後続で扱う条件を書く。
47
+ 6. 境界の判断基準で、迷ったときの優先順位を定義する。
48
+ 7. スコープ変更方針で、提案入口、影響評価、承認者、記録先を定義する。
49
+ 8. 最後に、設計詳細や受入条件を書きすぎていないか確認する。
50
+
51
+ ## 4. 各章の書き方
52
+
53
+ ### 4.1. 対象業務
54
+
55
+ 問い:
56
+
57
+ - どの業務、活動、利用場面を対象にするか。
58
+ - 誰が使うか、誰の負担や判断が変わるか。
59
+ - 対象にすることで、どの業務価値に近づくか。
60
+ - 何を運用・管理できる状態にしたいか。
61
+
62
+ 書き方:
63
+
64
+ - 機能名だけでなく、利用者が行う作業や判断で書く。
65
+ - 「対象利用者」「利用場面」「利用者影響」を読み取れる粒度にする。
66
+ - 業務アプリケーション以外のプロジェクトでは、文書整備、公開準備、運用基盤整備などを活動領域として書く。
67
+
68
+ 良い例:
69
+
70
+ - 単一店舗の店頭販売、店頭在庫、常連顧客のつけ管理を対象にし、店主代表以外が店番する場合でも同じ手順で確認できる状態を目指す。
71
+
72
+ 悪い例:
73
+
74
+ - 販売管理機能を作る。
75
+
76
+ ### 4.2. 対象システム
77
+
78
+ 問い:
79
+
80
+ - 対象となるシステム、成果物、文書体系、基盤は何か。
81
+ - プロジェクトが整備・変更する実行ツールや CLI、正本データ、生成物は何か。
82
+ - 生成物の正本はどれで、直接編集してよいか。
83
+ - 外部連携や公開基盤はどこまで含めるか。
84
+ - 対象業務と対象システムの粒度は揃っているか。
85
+ - 後続の設計文書へ委譲すべき詳細を書いていないか。
86
+
87
+ 書き方:
88
+
89
+ - 表形式で「対象」「内容」「境界」を分け、プロジェクトが担う範囲と担わない範囲を示す。
90
+ - 業務機能、文書体系、補助ツール、公開基盤など異なる性質の対象は、同じ粒度の大項目として扱う。
91
+ - 正本データと生成物は、編集方法や責務が異なる場合に別の行へ分ける。
92
+ - 外部ツール本体を開発しない場合は、設定・接続・利用のみを対象とするなど責務境界を書く。
93
+ - UI、API、DB、テストケースの詳細は書かない。
94
+
95
+ ### 4.3. 対象期間
96
+
97
+ 問い:
98
+
99
+ - 初期対象はいつからいつまでか。
100
+ - 日付が未確定なら、どのイベントまでを対象にするか。
101
+ - 初回公開、初期リリース、運用定着、継続改善をどう分けるか。
102
+ - どのスケジュール文書を期間判断の根拠にするか。
103
+
104
+ 書き方:
105
+
106
+ - 日付が未確定な場合は、イベント基準で定義する。
107
+ - 継続改善を含める場合は、初期スコープと継続改善フェーズを分ける。
108
+ - 未決事項は _UNDECIDED_: を優先し、決める文書またはタイミングを添える。実施待ちの作業を残す場合のみ _TODO_: を使い分ける。
109
+
110
+ ### 4.4. スコープ外
111
+
112
+ 問い:
113
+
114
+ - 今回やらないことは何か。
115
+ - 外した理由は、責務境界、コスト、効果、公開適性、期間のどれか。
116
+ - 利用者に影響がある対象外項目は、後続でいつ再検討するか。
117
+ - 対象外を書かないことで誤解される項目はないか。
118
+
119
+ 書き方:
120
+
121
+ - 「対象(Out)」「理由」「補足」の表にすると、やらない理由と扱いが明確になる。
122
+ - スコープ外は弱い表現にせず、今回含めないことを明示する。
123
+ - 「将来やるかもしれない」だけで終わらせず、再検討条件を添える。
124
+
125
+ ### 4.5. 境界の判断基準
126
+
127
+ 問い:
128
+
129
+ - 含めるか外すかで迷ったとき、何を優先するか。
130
+ - 業務価値、利用者影響、公開適性、保守容易性のどれを重く見るか。
131
+ - 特定の技術、手法、個別要望に引っ張られたとき、どう判断するか。
132
+
133
+ 書き方:
134
+
135
+ - 2〜5 件程度の優先順位付き箇条書きにする。
136
+ - 判断基準は、後続のスコープ変更や優先度判断に再利用できる表現にする。
137
+
138
+ ### 4.6. スコープ変更方針
139
+
140
+ 問い:
141
+
142
+ - 誰が変更を提案できるか。
143
+ - どこに記録するか。
144
+ - 何を確認してから判断するか。
145
+ - 誰が承認するか。
146
+ - 変更により影響を受ける成果物は何か。
147
+
148
+ 書き方:
149
+
150
+ - 「変更入口」「影響評価」「承認者」「記録先」の表にすると、最低限の運用が揃う。
151
+ - 初期リリース前に追加する場合は、同時に外すものや延期するものを示す。
152
+ - 判断理由を DEC、課題一覧、Issue、PR、変更要求ログのいずれかに残す。
153
+
154
+ ## 5. 深掘り手順
155
+
156
+ 内容が浅いと感じる場合は、次の順で深掘りする。
157
+
158
+ 1. **対象利用者** を具体化する。
159
+ 2. **利用場面** を業務や活動の単位で書く。
160
+ 3. **対象外にすべき候補** を先に列挙する。
161
+ 4. **対象業務と対象システムの対応** を確認する。
162
+ 5. **初期対象と継続改善** を分ける。
163
+ 6. **迷ったときの判断順序** を 2〜5 件に絞る。
164
+ 7. **変更時の承認者と記録先** を決める。
165
+
166
+ ## 6. 良い例 / 悪い例
167
+
168
+ | 観点 | 良い例 | 悪い例 |
169
+ | ------------ | --------------------------------------------------------------------- | ---------------------------- |
170
+ | 対象業務 | 店主代表以外が店番する場合でも販売・在庫・つけ残高を確認できる状態 | 販売管理を改善する |
171
+ | 対象システム | 販売登録、管理データ、生成レポートを分け、編集・責務の境界を示す | 画面名、API、DBを混在させる |
172
+ | 対象期間 | 初期リリースから2週間の記録継続確認までを対象にする | できるだけ早く公開する |
173
+ | スコープ外 | EC は店頭販売の記録継続を優先するため対象外とし、次フェーズで検討する | 必要なら EC も考える |
174
+ | 境界判断 | 日々使う業務を優先し、高度な分析は記録安定後に扱う | 便利そうなものは入れる |
175
+ | 変更方針 | 提案入口、影響評価、承認者、記録先を表で示す | 関係者で相談して柔軟に決める |
176
+
177
+ ## 7. レビュー観点
178
+
179
+ 作成後は、次の観点で確認する。
180
+
181
+ | 観点 | 確認内容 |
182
+ | ---------------- | ------------------------------------------------------------------ |
183
+ | 業務価値との対応 | プロジェクト概要の背景、必要性、期待効果とスコープが対応しているか |
184
+ | 利用者影響 | 対象利用者、利用場面、影響範囲が読み取れるか |
185
+ | 対象範囲 | 対象業務、対象システム、対象期間が判断可能な粒度か |
186
+ | システム境界 | 実行ツール、正本データ、生成物、外部サービスの責務を区別できるか |
187
+ | 対象外 | やらないこと、理由、再検討条件が明示されているか |
188
+ | 境界判断 | 迷ったときに使える優先順位や判断原則があるか |
189
+ | 変更運用 | 変更入口、影響評価、承認者、記録先があるか |
190
+ | 責務分担 | 受入条件、設計詳細、実装詳細を書きすぎていないか |
191
+ | 公開適性 | 個人情報、非公開情報、機密情報が含まれていないか |
192
+
193
+ ## 8. 仕上げチェック
194
+
195
+ - 「全体の作成手順」で示した章立てがそろっている。
196
+ - 対象業務、対象システム、対象期間、スコープ外がすべて記述されている。
197
+ - 未確定の日付やイベントは _UNDECIDED_: を優先し、決定タイミングが添えられている。
198
+ - スコープ外に理由と補足がある。
199
+ - 境界の判断基準とスコープ変更方針が、後続の判断に使える。
200
+ - 成功基準、受入条件、設計詳細、実装詳細を書きすぎていない。
201
+ - 各対象・対象外を上位の目的または期待効果、境界理由、再検討条件、変更記録へ追跡できる。
@@ -0,0 +1,168 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:prj-stakeholder-register-recipe
4
+ type: recipe
5
+ status: ready
6
+ rulebook: specdojo:prj-stakeholder-register-rulebook
7
+ sample: specdojo:prj-stakeholder-register-sample
8
+ ---
9
+
10
+ # ステークホルダー登録簿 作成レシピ
11
+
12
+ Stakeholder Register Writing Recipe
13
+
14
+ 本書は、ステークホルダー登録簿を、業務価値・利用者影響・合意対象が判断できる内容に仕上げるための作り方である。本書では問い、深掘り、具体化、レビュー観点を扱う。
15
+
16
+ ## 1. このレシピの使い方
17
+
18
+ - 最初に、プロジェクト概要から目的、利用者、期待効果、前提条件を抜き出す。
19
+ - 次に、誰が判断し、誰が利用し、誰が協力し、誰が影響を受けるかを役割別に洗い出す。
20
+ - 各関係者について、期待、懸念、必要な合意、情報要求を同じ ID でつなげる。
21
+ - 最後に、影響度/関心度の根拠と、変更時に見直す条件を確認する。
22
+ - プロジェクトの目的と利用者影響(Why)、判断者・利用者・協力者・影響受容者と合意対象(What)、関与方針と情報要求(How)を整理し、ステークホルダー ID、評価根拠、証跡要件で追跡する(Trace)。詳細な配信計画は後続文書へ委譲する。
23
+
24
+ ## 2. 作成前に集める情報
25
+
26
+ | 項目 | 集める情報 |
27
+ | ---------------- | ------------------------------------------------------------------------------------------------- |
28
+ | 目的と期待効果 | 誰のどの課題を改善し、どの状態を目指すか |
29
+ | 利用者と利用場面 | 直接利用者、間接利用者、影響を受ける集団、利用する場面 |
30
+ | 意思決定 | 方針、優先順位、公開・利用可否を判断する人または組織 |
31
+ | 実行・協力 | 実行担当、運用担当、外部協力者と、それぞれの関わり方 |
32
+ | 想定される懸念 | 利用負荷、変更影響、継続性、公開適性、合意遅延の要因 |
33
+ | 合意対象 | 着手、範囲、変更、公開、利用開始で確認が必要な事項 |
34
+ | 情報要求 | 誰が、何を、どの手段で確認・判断するか |
35
+ | 更新条件 | 目的、範囲、体制、利用者影響、公開方針が変わる出来事 |
36
+ | 実行主体の境界 | AI Agent やツールなど人間以外の実行主体が関与する場合、入力・制約・確認の責任を持つ人の役割は誰か |
37
+
38
+ ## 3. 全体の作成手順
39
+
40
+ 1. プロジェクトの目的と利用者を確認し、登録対象の識別基準を決める。
41
+ 2. 意思決定者、実行担当、利用者、外部協力者、影響受容者を候補として列挙する。
42
+ 3. 関係者一覧に、役割名・集団名を用いて一意の `STH-<KEY>` を付ける。
43
+ 4. 各関係者の期待、懸念、必要な合意を整理し、影響度と関心度に根拠を添える。
44
+ 5. 現状と目標を比べ、情報提供、相談、合意、巻き込みの対応方針を決める。
45
+ 6. 情報要求、希望チャネル、証跡要件を整理し、詳細な配信計画は後続のコミュニケーション計画へ委譲する。
46
+ 7. 変更時と定期確認時の見直し条件、責任者、承認者を定める。
47
+ 8. 個人情報、推測の Role code、設計詳細、会議運営の重複がないことを確認する。
48
+
49
+ ## 4. 各章の書き方
50
+
51
+ ### 4.1. 関係者一覧
52
+
53
+ 問い:
54
+
55
+ - 誰が目的、範囲、公開・利用可否を判断するか。
56
+ - 誰が直接利用し、誰が間接的に影響を受けるか。
57
+ - 誰が実行、運用、協力を担い、どの責任を持つか。
58
+ - AI Agent やツールなど人間以外の実行主体が関与する場合、入力・制約・生成結果の確認責任を持つ人の役割は誰か。
59
+
60
+ 書き方:
61
+
62
+ - 個人名ではなく、役割名、組織名、集団名で書く。
63
+ - ステークホルダーとタスク Role を分け、採用済みの Role だけを対応 Role code として書く。
64
+ - AI Agent やツールなどの実行主体自体は単独のステークホルダーとして記載せず、入力・制約・確認の責任を持つ人の役割として記載する。
65
+ - 同じ関係者を全章で同じ ID にする。
66
+
67
+ ### 4.2. 影響度/関心度分析
68
+
69
+ 問い:
70
+
71
+ - 方針、範囲、優先順位、利用可否を左右するのは誰か。
72
+ - 成果または変更を継続して確認する必要があるのは誰か。
73
+ - 期待が満たされないと、誰にどのような利用・継続上の影響が出るか。
74
+
75
+ 書き方:
76
+
77
+ - `High` は、影響を与える根拠または継続確認が必要な根拠を必ず添える。
78
+ - 期待、懸念、必要な合意を対応させ、「誰と何を決めるか」を明確にする。
79
+ - 評価は人の重要度ではなく、プロジェクトへの影響と関与必要性で行う。
80
+
81
+ ### 4.3. エンゲージメント方針
82
+
83
+ 問い:
84
+
85
+ - 現在の関与状態と、目標とする関与状態は何か。
86
+ - 差分を埋めるために、情報提供、相談、合意、巻き込みのどれが必要か。
87
+ - 誰がいつまでに行い、どこに証跡を残すか。
88
+
89
+ 書き方:
90
+
91
+ - 「確認する」だけで終わらせず、対象情報、実施者、期限、証跡を記載する。
92
+ - 外部関係者が未関与なら、現在の事実と将来の仮定を混ぜず、必要に応じて _ASSUMPTION_: を使う。
93
+ - 合意を求める相手と、情報共有だけでよい相手を区別する。
94
+
95
+ ### 4.4. コミュニケーション要件
96
+
97
+ 問い:
98
+
99
+ - 関係者は何を受け取れば、判断、利用、協力、影響確認ができるか。
100
+ - どの手段なら内容を確認でき、必要な証跡を残せるか。
101
+ - 詳細計画で追加管理すべき事項は何か。
102
+
103
+ 書き方:
104
+
105
+ - 情報要求は「進捗」だけでなく、優先順位、変更理由、利用手順など判断に必要な情報に分解する。
106
+ - 会議の日時や配信頻度の詳細を重複管理しない。
107
+ - 合意・報告の必要性と、証跡要件を同じ行に置く。
108
+
109
+ ### 4.5. 見直し条件
110
+
111
+ 問い:
112
+
113
+ - どの変更が、関係者、期待、影響度、合意対象を変えるか。
114
+ - 誰が見直し、誰が承認し、どの証跡で追跡するか。
115
+ - 定期確認では、どの未解決の合意や情報要求を確認するか。
116
+
117
+ 書き方:
118
+
119
+ - 目的、範囲、体制、公開・利用方針の変更を更新トリガーに含める。
120
+ - 周期が未定なら _TODO_: として決める文書またはタイミングを残す。
121
+ - 変更した表だけでなく、同じ ID を使う全章への影響を確認する。
122
+
123
+ ## 5. 深掘り手順
124
+
125
+ 内容が浅い場合は、次の順で具体化する。
126
+
127
+ 1. 目的と期待効果から、利益を得る利用者と影響を受ける集団を洗い出す。
128
+ 2. 方針、範囲、公開・利用可否の決定を列挙し、意思決定者を対応付ける。
129
+ 3. 各関係者について「期待が満たされない場合の困りごと」を書き、懸念を具体化する。
130
+ 4. 各懸念に対して、必要な合意または情報要求を対応付ける。
131
+ 5. High の関係者を先に選び、関与方針、責任者、期限、証跡を埋める。
132
+ 6. 変更イベントごとに、見直す行と承認者を確認する。
133
+
134
+ ## 6. 良い例 / 悪い例
135
+
136
+ | 観点 | 良い例 | 悪い例 |
137
+ | -------------- | ---------------------------------------------------------------- | ---------------------------------------- |
138
+ | 関係者の識別 | 「将来の利用者」を利用場面と期待を添えて記載する | 「ユーザー」とだけ書く |
139
+ | 影響度の根拠 | 「公開・利用可否を判断するため High」と書く | 「重要なので High」と書く |
140
+ | 必要な合意 | 「初期公開の範囲と公開情報」と具体化する | 「いろいろ相談する」と書く |
141
+ | 関与方針 | 「初期公開前に導入手順を公開し、Issue で不明点を収集する」と書く | 「利用者と連携する」と書く |
142
+ | 情報要求 | 「変更理由と利用手順を公開文書で確認する」と書く | 「進捗を共有する」とだけ書く |
143
+ | 見直し条件 | 「公開方針変更時に将来利用者の要件を見直す」と書く | 「必要に応じて更新する」と書く |
144
+ | 実行主体の境界 | 「AI Agent活用担当」のように責任を持つ人の役割として記載する | 「AI Agent」を単独の関係者として記載する |
145
+
146
+ ## 7. レビュー観点
147
+
148
+ | 観点 | 確認内容 |
149
+ | ---------------------- | --------------------------------------------------------------------------- |
150
+ | 業務価値との対応 | プロジェクトの目的、利用者、期待効果から関係者を識別できているか |
151
+ | 利用者影響 | 直接利用者、間接利用者、影響受容者の期待と懸念が分かるか |
152
+ | 合意対象 | High の関係者について、誰と何を合意するかがあるか |
153
+ | 評価根拠 | 影響度と関心度に、方針・利用・運用・合意への影響の根拠があるか |
154
+ | 関与方針 | 現状、目標、行動、責任者、期限、証跡が対応しているか |
155
+ | コミュニケーション統制 | 詳細計画と重複せず、情報要求と証跡要件を入力として渡せるか |
156
+ | 公開適性 | 個人情報、非公開情報、未採用 Role code、根拠のない推測がないか |
157
+ | 実行主体の境界 | AI Agent やツールなどの実行主体が、責任を持つ人の役割に対応付けられているか |
158
+
159
+ ## 8. 仕上げチェック
160
+
161
+ - 「全体の作成手順」で示した章立てがそろっている。
162
+ - 各関係者が、関係者一覧から見直し条件まで同じ ID で追跡できる。
163
+ - High の関係者に、期待、懸念、必要な合意、対応方針がある。
164
+ - 利用者・影響受容者の利用場面または影響が読み取れる。
165
+ - AI Agent やツールなどの実行主体を、責任を持つ人の役割に対応付けている(単独のステークホルダーとして扱っていない)。
166
+ - 詳細な会議運営、設計詳細、個人情報を本文に含めていない。
167
+ - 各必須表のカラムがすべて埋まっている。
168
+ - 各ステークホルダーを、目的または利用者影響、必要な合意、関与方針、証跡要件へ同じ ID で追跡できる。