specdojo 0.7.0 → 0.9.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 (462) hide show
  1. package/.github/agents/specdojo-orchestrator.md +7 -3
  2. package/CHANGELOG.md +217 -0
  3. package/dist/catalog/build.js +24 -1
  4. package/dist/catalog/catalog.js +16 -14
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +5 -3
  8. package/dist/commands/build.js +69 -10
  9. package/dist/commands/git.js +206 -0
  10. package/dist/commands/init.js +9 -3
  11. package/dist/commands/night-orchestrator.js +6 -4
  12. package/dist/commands/where.js +25 -0
  13. package/dist/dashboard/dashboard-timeline.js +18 -16
  14. package/dist/dashboard/dashboard.js +616 -261
  15. package/dist/dashboard/epic-plan.js +81 -0
  16. package/dist/dashboard/exec-records.js +16 -20
  17. package/dist/dashboard/routines.js +11 -12
  18. package/dist/dashboard/timeline-build.js +5 -9
  19. package/dist/dashboard/timeline.js +23 -18
  20. package/dist/devcontainer/scaffold.js +18 -0
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/index-command.js +2 -2
  23. package/dist/docs/yaml-business-tables.js +243 -0
  24. package/dist/docs/yaml-interface-tables.js +106 -0
  25. package/dist/docs/yaml-pages-command.js +5 -3
  26. package/dist/docs/yaml-pages.js +268 -3
  27. package/dist/docs/yaml-table-shared.js +70 -0
  28. package/dist/docs/yaml-tables.js +39 -0
  29. package/dist/exec/agent-config.js +31 -0
  30. package/dist/exec/agent-plan.js +3 -2
  31. package/dist/exec/agent-protected-config.js +2 -0
  32. package/dist/exec/commands.js +100 -39
  33. package/dist/exec/commit-hook-skips.js +78 -0
  34. package/dist/exec/core.js +19 -7
  35. package/dist/exec/events.js +179 -8
  36. package/dist/exec/evidence.js +77 -19
  37. package/dist/exec/handoff.js +9 -13
  38. package/dist/exec/limit.js +1 -1
  39. package/dist/exec/mechanical-result.js +45 -0
  40. package/dist/exec/migrate-records.js +249 -0
  41. package/dist/exec/parent-validation.js +209 -15
  42. package/dist/exec/pipeline-state.js +27 -5
  43. package/dist/exec/plans-condense-findings.js +89 -0
  44. package/dist/exec/plans-core.js +45 -19
  45. package/dist/exec/plans-generation.js +52 -30
  46. package/dist/exec/plans-grade-findings.js +8 -3
  47. package/dist/exec/plans-kata-findings.js +61 -0
  48. package/dist/exec/plans-planning.js +3 -3
  49. package/dist/exec/plans-storage.js +12 -24
  50. package/dist/exec/post-integration.js +162 -0
  51. package/dist/exec/queue-command.js +166 -0
  52. package/dist/exec/queue.js +285 -0
  53. package/dist/exec/register-foreign-wait.js +84 -0
  54. package/dist/exec/register-resume.js +55 -56
  55. package/dist/exec/register.js +26 -22
  56. package/dist/exec/repo-integration-sync.js +21 -5
  57. package/dist/exec/repo-integration.js +21 -1
  58. package/dist/exec/reporter.js +121 -23
  59. package/dist/exec/results.js +106 -25
  60. package/dist/exec/review-completion.js +47 -0
  61. package/dist/exec/review-kata.js +112 -0
  62. package/dist/exec/run/agent-pipeline.js +78 -8
  63. package/dist/exec/run/agent.js +32 -13
  64. package/dist/exec/run/change-scope.js +365 -0
  65. package/dist/exec/run/deferred-cleanup.js +31 -0
  66. package/dist/exec/run/in-place.js +73 -33
  67. package/dist/exec/run/job-lock.js +66 -0
  68. package/dist/exec/run/job-sequence.js +137 -0
  69. package/dist/exec/run/job.js +135 -41
  70. package/dist/exec/run/lifecycle-commands.js +189 -37
  71. package/dist/exec/run/lock.js +22 -1
  72. package/dist/exec/run/mode-shared.js +11 -3
  73. package/dist/exec/run/register-command.js +14 -15
  74. package/dist/exec/run/register-core.js +20 -13
  75. package/dist/exec/run/register-mode.js +77 -17
  76. package/dist/exec/run/register-post-review.js +21 -9
  77. package/dist/exec/run/register-resume.js +95 -31
  78. package/dist/exec/run/register-state.js +23 -15
  79. package/dist/exec/run/register-worktree.js +184 -139
  80. package/dist/exec/run/schedule-mode.js +79 -18
  81. package/dist/exec/run/schedule-prepare.js +204 -59
  82. package/dist/exec/run/schedule-task.js +203 -49
  83. package/dist/exec/run/shared.js +9 -3
  84. package/dist/exec/run/trailing-records.js +35 -0
  85. package/dist/exec/run-records.js +2 -0
  86. package/dist/exec/schedule/schedule.js +116 -4
  87. package/dist/exec/shared.js +1 -1
  88. package/dist/exec/smoke.js +190 -0
  89. package/dist/exec/strategy.js +14 -3
  90. package/dist/exec/task-view.js +6 -4
  91. package/dist/exec/trailing-records.js +242 -0
  92. package/dist/exec/trial-commands.js +8 -4
  93. package/dist/exec/trial-core.js +6 -1
  94. package/dist/exec/validate-records-commit.js +110 -0
  95. package/dist/exec/validate-records.js +148 -0
  96. package/dist/exec/validation-metrics.js +181 -0
  97. package/dist/exec/worktree-cleanup-lock.js +26 -0
  98. package/dist/exec/worktree-command.js +38 -17
  99. package/dist/exec/worktree-ops-commit.js +119 -48
  100. package/dist/exec/worktree-ops-lifecycle.js +77 -48
  101. package/dist/exec/worktree-ops-merge.js +13 -2
  102. package/dist/exec/worktree-ops.js +2 -2
  103. package/dist/exec/worktree.js +32 -4
  104. package/dist/grade/apply.js +32 -6
  105. package/dist/grade/command-apply.js +3 -3
  106. package/dist/grade/command-inspect.js +7 -5
  107. package/dist/grade/command-plan.js +1 -1
  108. package/dist/grade/command-run.js +7 -1
  109. package/dist/grade/command-shared.js +1 -1
  110. package/dist/grade/core.js +18 -5
  111. package/dist/grade/markdown.js +3 -3
  112. package/dist/grade/pipeline-state.js +15 -11
  113. package/dist/grade/plan.js +37 -17
  114. package/dist/grade/result.js +3 -3
  115. package/dist/grade/run.js +87 -11
  116. package/dist/grade/target-discovery.js +17 -4
  117. package/dist/grade/targets.js +12 -11
  118. package/dist/job/definition.js +84 -8
  119. package/dist/job/job.js +109 -39
  120. package/dist/job/noop.js +104 -0
  121. package/dist/register/authoring-sources.js +22 -16
  122. package/dist/register/core.js +2 -0
  123. package/dist/register/create-commands.js +28 -3
  124. package/dist/register/deliverable-target.js +9 -1
  125. package/dist/register/epic.js +104 -26
  126. package/dist/register/event-merge.js +3 -0
  127. package/dist/register/events.js +4 -0
  128. package/dist/register/external-project.js +3 -0
  129. package/dist/register/item.js +6 -0
  130. package/dist/register/maintenance-commands.js +6 -3
  131. package/dist/register/planning.js +7 -14
  132. package/dist/register/register.js +74 -16
  133. package/dist/register/track-domains.js +34 -0
  134. package/dist/register/track-plan.js +78 -0
  135. package/dist/register/transition-commands.js +8 -0
  136. package/dist/register/work-table.js +64 -0
  137. package/dist/review/grade.js +35 -13
  138. package/dist/routine/definition.js +13 -3
  139. package/dist/routine/failure.js +30 -0
  140. package/dist/routine/routine.js +189 -71
  141. package/dist/routine/status.js +62 -0
  142. package/dist/routine/storage.js +33 -0
  143. package/dist/schedule/schedule.js +39 -39
  144. package/dist/schedule/strategy-generate-document.js +26 -14
  145. package/dist/schedule/strategy-generate-scope.js +17 -45
  146. package/dist/schedule/strategy-generate.js +33 -3
  147. package/dist/schedule/strategy-profiles.js +86 -12
  148. package/dist/shared/agent-types.js +7 -0
  149. package/dist/shared/condense-records.js +25 -0
  150. package/dist/shared/cross-process-lock.js +9 -1
  151. package/dist/shared/deprecation.js +8 -0
  152. package/dist/shared/dist-freshness.js +8 -2
  153. package/dist/shared/document-metadata.js +20 -0
  154. package/dist/shared/finding-cause.js +20 -0
  155. package/dist/shared/frontmatter-namespace.js +48 -0
  156. package/dist/shared/git-environment.js +2 -1
  157. package/dist/shared/git.js +186 -16
  158. package/dist/shared/grade-result.js +17 -1
  159. package/dist/shared/lefthook-scaffold.js +3 -0
  160. package/dist/shared/local-config.js +244 -0
  161. package/dist/shared/local-state.js +20 -0
  162. package/dist/shared/markdownlint-config.js +8 -3
  163. package/dist/shared/plan-conventions.js +129 -0
  164. package/dist/shared/plan-templates.js +57 -41
  165. package/dist/shared/run-records.js +224 -0
  166. package/dist/shared/specdojo-config.js +73 -41
  167. package/dist/shared/specdojo-gitignore.js +1 -0
  168. package/dist/shared/text.js +74 -6
  169. package/dist/shared/timeline-index.js +2 -0
  170. package/dist/shared/where-alias.js +13 -0
  171. package/dist/specdojo.js +4 -0
  172. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  173. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  174. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  175. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  176. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  177. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  178. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  179. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  180. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  181. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  182. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  183. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  184. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  185. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  186. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  187. package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
  188. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  189. package/docs/ja/specdojo/guides/exec-config-guide.md +69 -19
  190. package/docs/ja/specdojo/guides/exec-operation-guide.md +97 -18
  191. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  192. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  193. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  194. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  195. package/docs/ja/specdojo/guides/quick-start-guide.md +73 -17
  196. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -6
  197. package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
  198. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  199. package/docs/ja/specdojo/guides/routine-operation-guide.md +23 -12
  200. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  201. package/docs/ja/specdojo/guides/schedule-design-guide.md +27 -21
  202. package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
  203. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  204. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  205. package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
  206. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  207. package/docs/ja/specdojo/recipes/bac-recipe.md +111 -0
  208. package/docs/ja/specdojo/recipes/bes-recipe.md +141 -0
  209. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  210. package/docs/ja/specdojo/recipes/br-recipe.md +77 -0
  211. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  212. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  213. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +92 -99
  214. package/docs/ja/specdojo/recipes/cnd-recipe.md +135 -0
  215. package/docs/ja/specdojo/recipes/cpd-recipe.md +140 -0
  216. package/docs/ja/specdojo/recipes/cxd-recipe.md +162 -0
  217. package/docs/ja/specdojo/recipes/ifd-recipe.md +145 -0
  218. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +112 -90
  219. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +164 -0
  220. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  221. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  222. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -48
  223. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +72 -50
  224. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +40 -49
  225. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +42 -48
  226. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -81
  227. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -91
  228. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  229. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -156
  230. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  231. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  232. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  233. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  234. package/docs/ja/specdojo/recipes/stsd-recipe.md +88 -80
  235. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +129 -0
  236. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +146 -0
  237. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +141 -0
  238. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  239. package/docs/ja/specdojo/references/command-reference.md +303 -148
  240. package/docs/ja/specdojo/references/deliverables-reference.md +30 -16
  241. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  242. package/docs/ja/specdojo/references/specdojo-config-reference.md +54 -18
  243. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  244. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  245. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +63 -290
  246. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +162 -80
  247. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +118 -155
  248. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +128 -60
  249. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +70 -94
  250. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  251. package/docs/ja/specdojo/rulebooks/br-rulebook.md +58 -103
  252. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +103 -223
  253. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  254. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  255. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  256. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  257. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +51 -55
  258. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  259. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +81 -68
  260. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +139 -0
  261. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  262. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +170 -0
  263. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  264. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +79 -249
  265. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  266. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  267. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  268. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +79 -249
  269. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  270. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +115 -256
  271. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +79 -109
  272. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +119 -174
  273. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +6 -14
  274. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  275. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  276. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +171 -0
  277. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  278. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  279. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +93 -57
  280. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +63 -253
  281. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  282. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +79 -76
  283. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +182 -237
  284. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +111 -40
  285. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  286. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +23 -46
  287. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  288. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +16 -40
  289. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  290. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  291. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  292. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  293. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  294. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +12 -23
  295. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  296. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  297. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  298. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  299. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  300. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  301. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  302. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  303. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  304. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  305. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  306. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  307. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  308. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  309. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  310. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  311. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +92 -102
  312. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  313. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  314. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  315. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  316. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +45 -59
  317. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +56 -66
  318. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +54 -62
  319. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +46 -65
  320. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  321. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +65 -97
  322. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +6 -18
  323. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +48 -78
  324. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  325. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -153
  326. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  327. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  328. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  329. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  330. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  331. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +106 -32
  332. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +111 -61
  333. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +129 -59
  334. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  335. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  336. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +46 -40
  337. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +104 -68
  338. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +64 -330
  339. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +70 -263
  340. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +58 -200
  341. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  342. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  343. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -71
  344. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  345. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  346. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  347. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  348. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +91 -161
  349. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  350. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  351. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  352. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  353. package/docs/ja/specdojo/samples/bds-sample.md +87 -21
  354. package/docs/ja/specdojo/samples/bes-index-sample.md +42 -20
  355. package/docs/ja/specdojo/samples/bes-sample.md +70 -21
  356. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  357. package/docs/ja/specdojo/samples/br-sample.md +57 -15
  358. package/docs/ja/specdojo/samples/ccd-sample.md +80 -19
  359. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  360. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
  361. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  362. package/docs/ja/specdojo/samples/cdsd-sample.md +73 -20
  363. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  364. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  365. package/docs/ja/specdojo/samples/clis-sample.md +125 -0
  366. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  367. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  368. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  369. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  370. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  371. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  372. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  373. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  374. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  375. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  376. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  377. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  378. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  379. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  380. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  381. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  382. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  383. package/docs/ja/specdojo/samples/pm-organization-sample.md +42 -21
  384. package/docs/ja/specdojo/samples/pm-plan-sample.md +78 -26
  385. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +41 -22
  386. package/docs/ja/specdojo/samples/pm-raci-sample.md +63 -28
  387. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  388. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +33 -25
  389. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  390. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +83 -62
  391. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  392. package/docs/ja/specdojo/samples/sf-index-sample.md +47 -20
  393. package/docs/ja/specdojo/samples/sf-sample.md +109 -21
  394. package/docs/ja/specdojo/samples/sld-sample.md +88 -21
  395. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  396. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  397. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  398. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  399. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  400. package/docs/ja/specdojo/samples/uis-sample.md +141 -20
  401. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  402. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  403. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  404. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  405. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  406. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  407. package/docs/ja/specdojo/templates/br-template.md +64 -0
  408. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  409. package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
  410. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  411. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  412. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  413. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  414. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  415. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  416. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  417. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  418. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  419. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  420. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  421. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  422. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  423. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  424. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  425. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  426. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  427. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  428. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  429. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  430. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  431. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  432. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  433. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  434. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  435. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  436. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  437. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  438. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  439. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
  440. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +95 -8
  441. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +38 -0
  442. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  443. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  444. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  445. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  446. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  447. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  448. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  449. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  450. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  451. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  452. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  453. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  454. package/package.json +10 -7
  455. package/templates/antigravity/orchestrator.md +7 -3
  456. package/templates/claude/agents/specdojo-orchestrator.md +7 -3
  457. package/templates/codex/agents/specdojo-orchestrator.toml +7 -3
  458. package/templates/codex/orchestrator.md +7 -3
  459. package/templates/devcontainer/tmux.conf +6 -0
  460. package/templates/init-exec-defaults.yaml +13 -0
  461. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  462. package/templates/opencode/agents/specdojo-orchestrator.md +8 -4
@@ -12,137 +12,105 @@ specdojo:
12
12
  - specdojo:people-and-organization-definition-standard
13
13
  ---
14
14
 
15
- # プロジェクトロール定義 作成ルール
15
+ # ロール定義 作成ルール
16
16
 
17
17
  Project Role Definition Documentation Rulebook
18
18
 
19
- 本ドキュメントは、`pm-roles.yaml` を一貫した構造で作成・更新するためのルールを定義する。`pm-roles.yaml` は、プロジェクトで使用する全 Role code の machine-readable な一覧であり、Schedule の `owner` や RACI の列として使用できる責務語彙を定義する。人間の実行主体と兼務の割り当ては `pm-members.yaml`、agent は `.specdojo/agent-members.yaml` の `members[].roles` で管理する。
19
+ `pm-roles.yaml` に、組織定義で採用した Role code を機械可読な一覧として記録し、Schedule、RACI、メンバー定義を同じ責務語彙で接続するためのルールです。
20
20
 
21
21
  ## 1. 全体方針
22
22
 
23
- - `pm-roles.yaml` には、プロジェクトで使用する全 Role code を記載する。現時点で専任 member が存在しない Role code も、Schedule の `owner` 語彙として必要なら含める。
23
+ - 専任者の有無と Role code の採用を分け、責務語彙として必要なロールは一覧に残します。
24
+ - 共通の責務や規模別の採用パターンは上位標準を参照し、プロジェクト固有の扱いだけを短く補足します。
25
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めません。
24
26
 
25
- - 標準 Role code は `PO`, `PM`, `BA`, `ARC`, `DEV`, `QE`, `UX`, `OPS` を基本セットとし、プロジェクト内で採用する責務語彙をこの集合から選ぶ。
26
- - Role code の共通定義・責務・規模別パターンは上位標準を参照し、本ファイルに再掲しない。
27
- - 兼務の割り当て、member nickname、agent 名、個人名は `pm-members.yaml` と `.specdojo/agent-members.yaml` で管理し、本ファイルに記載しない。
28
- - ロール採用の方針・根拠、最終判断の集約先、見直し条件は `pm-organization.md` を参照し、本ファイルに重複して記載しない。
29
- - `pm-roles.yaml` の `roles[].code` は、Schedule の `owner` および `pm-members.yaml` の `members[].roles` で使用できる Role code の語彙一覧として機能する。
30
- - PO が全 Role code とプロジェクト固有メモを承認できるよう、各 `project_note` は公開可能な内容だけで簡潔に記載する。
31
- - AI Agent が作成・検証を支援する場合でも、最終判断、公開可否、説明責任は人間の PO に残す前提で記載する。
27
+ ## 2. 位置づけ
32
28
 
33
- ## 2. 位置づけと用語定義
29
+ 共通用語と標準ロールは [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] を正本とします。
34
30
 
35
- `pm-roles.yaml` は、ロール定義の YAML 成果物として次の位置に置かれる。
31
+ | 管理先 | 担う情報・接続 |
32
+ | -------------------------------------------------- | ------------------------------------------------------------------ |
33
+ | `pm-organization.md` | 採用・未採用コード、使用可能な `owner`、採用理由、見直し条件の正本 |
34
+ | `pm-roles.yaml` | 採用コード・正式名称・固有メモの機械可読な転記先 |
35
+ | `pm-members.yaml` / `.specdojo/agent-members.yaml` | 人間 / agent の実行主体・対応ロール・兼務 |
36
+ | Schedule / `pm-raci.md` | コードを `owner` / 責任分担の列として参照 |
36
37
 
37
- | 文書 | 役割 | 正本とする内容 |
38
- | -------------------- | ---------------------------------------------- | -------------------------------------- |
39
- | `pm-organization.md` | ロール・メンバー構成の方針と設計根拠を記述する | 採用方針、最終判断の集約先、見直し条件 |
38
+ ## 3. ファイル命名・ID規則
40
39
 
41
- | `pm-roles.yaml` | 採用した Role code を machine-readable な YAML として一覧化する | `owner` 語彙、Role code 名、プロジェクト固有メモ |
42
- | `pm-members.yaml` | 人間の実行主体と対応する Role code を管理する | member nickname、人間、兼務割り当て |
43
- | `.specdojo/agent-members.yaml` | agent と対応する Role code を管理する | agent nickname、選択属性、兼務割り当て |
44
- | `pm-raci.md` | 必要時の責任分担を記述する | 成果物・プロセスごとの責任分担 |
40
+ - 組織定義・メンバー定義と同じ `docs/ja/projects/<project-id>/030-project-management/pm-roles.yaml` に置くことを推奨します。
41
+ - ID は `<project-id>:pm-roles`、`project_id` は配置先プロジェクトに合わせます。
42
+ - 共通規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従います。
45
43
 
46
- 用語は次のように使い分ける。
44
+ ## 4. 推奨メタ項目
47
45
 
48
- | 用語 | 意味 | `pm-roles.yaml` での扱い |
49
- | ------------ | ------------------------------------------------------ | ---------------------------------------- |
50
- | Role code | 責務・判断権限・専門性を表す短い識別子 | `roles[].code` に列挙する |
51
- | Role name | Role code の正式名称 | `roles[].name` に記載する |
52
- | Project note | 当該プロジェクトでの扱い、専任化条件、公開判断上の注意 | `roles[].project_note` に 1 行で記載する |
46
+ メタ項目は YAML 先頭のトップレベルに置きます。許可キー・必須性・型・値制約は `docs/specdojo/schemas/v1/pm-roles.schema.yaml` を正本とします。
53
47
 
54
- ## 3. ファイル命名・ID規則
48
+ - `id` / `project_id` / `title` / `type` / `status` / `version` / `rulebook` は必須です。
49
+ - `type` は `project`、`rulebook` は `specdojo:pm-roles-rulebook`、`status` の値域は `draft` / `ready` / `deprecated` です。
50
+ - `based_on` / `supersedes` は任意です。
55
51
 
56
- - ファイル名は `pm-roles.yaml` を推奨する。
57
- - 配置先は `pm-organization.md`、`pm-members.yaml`、`pm-raci.md` と同じ組織定義ディレクトリに置く。
58
- - 推奨パス: `docs/ja/projects/<project-id>/030-project-management/pm-roles.yaml`
59
- - `project_id` は配置先プロジェクト ID と一致させる。例: `prj-0001`
60
- - `id` は `<project-id>:pm-roles` 形式を推奨する。例: `prj-0001:pm-roles`
61
- - `roles[].code` は標準 Role code の表記に合わせ、大文字の短いコードにする。例: `PO`, `PM`, `BA`
52
+ ## 5. 本文要件
62
53
 
63
- ## 4. 推奨メタ項目
54
+ 骨組みは Frontmatter の template、構造・型は対応 schema を正本とします。
64
55
 
65
- YAML 成果物のため、Markdown Frontmatter ではなく YAML 先頭のメタ項目として記載する。
66
- 機械検証は `docs/specdojo/schemas/v1/pm-roles.schema.yaml` を正本とする。
56
+ | キー | 必須・任意 | 目的・内容要件 |
57
+ | ---------------------- | ---------- | ----------------------------------------------------------------------- |
58
+ | `roles` | 必須 | 採用全コードの配列。`PO` を含み、コードは一意。組織定義の採用集合と一致 |
59
+ | `roles[].code` | 必須 | 下流の `owner`・RACI・メンバー定義を接続する識別子 |
60
+ | `roles[].name` | 必須 | 上位標準の正式名称で責務を識別 |
61
+ | `roles[].project_note` | 任意 | プロジェクト固有の扱い。補足がなければ省略する |
67
62
 
68
- | 項目 | 説明 | 必須 |
69
- | -------- | ---------------------------------------- | ---- |
70
- | `id` | `<project-id>:pm-roles` 形式の成果物 ID | ○ |
71
- | `type` | `project` 固定 | ○ |
72
- | `status` | `draft` / `ready` / `deprecated` | ○ |
73
- | `title` | ドキュメント名。表示ページの見出しになる | ○ |
63
+ ## 6. 記述ガイド
74
64
 
75
- | `rulebook` | `specdojo:pm-roles-rulebook` 固定 | ○ |
76
- | `based_on` | 根拠ドキュメント ID の配列 | 任意 |
77
- | `version` | データバージョン。初期値は `1` | ○ |
78
- | `project_id` | プロジェクト ID | ○ |
65
+ ### 6.1. メタ項目と根拠
79
66
 
80
- schema に定義されていないメタ項目は `pm-roles.yaml` には追加しない。
67
+ カタログ利用時、`based_on` は依存の推移閉包内に限定します。
81
68
 
82
- ## 5. 本文構成(標準テンプレ)
69
+ | 判断点 | 良い例 | 悪い例 |
70
+ | ---------- | ------------------------------------------ | ---------------------------------------- |
71
+ | 根拠の選択 | 採用方針を確認した組織定義の ID を指定する | 同じディレクトリの文書を未確認で列挙する |
83
72
 
84
- `pm-roles.yaml` は次のルート構造を標準とする。
73
+ ### 6.2. `roles` の採用範囲
85
74
 
86
- | 要素 | 必須 | 内容 |
87
- | ------------ | ---- | -------------------- |
88
- | `id` | ○ | 成果物 ID |
89
- | `type` | ○ | 成果物種別 |
90
- | `status` | ○ | 成果物状態 |
91
- | `title` | ○ | ドキュメント名 |
92
- | `rulebook` | ○ | 参照する rulebook ID |
93
- | `based_on` | 任意 | 根拠 ID 配列 |
94
- | `version` | ○ | データバージョン |
95
- | `project_id` | ○ | プロジェクト ID |
96
- | `roles` | ○ | 全 Role の配列 |
75
+ 採用集合と使用可能な `owner` の部分集合を取り違えず、記載順は上位標準の定義順を推奨します。
97
76
 
98
- `roles[]` は次のフィールドを標準とする。
77
+ | 判断点 | 良い例 | 悪い例 |
78
+ | ------------ | -------------------------------------------- | -------------------------------------------- |
79
+ | 最小構成 | 最終判断を担う `PO` を含む採用集合を転記する | 実作業だけを見て `BA` と `QE` だけを列挙する |
80
+ | 兼務時の扱い | 採用済みの `PM` を管理タスクの語彙として残す | 専任者がいないという理由だけで `PM` を除く |
99
81
 
100
- | フィールド | 必須 | 内容 |
101
- | -------------- | ---- | --------------------------------------------------------------------- |
102
- | `code` | ○ | Role code。標準 Role code を使う |
103
- | `name` | ○ | Role の正式名称 |
104
- | `project_note` | 任意 | プロジェクト固有の扱い、専任化条件、公開判断上の注意を 1 行で記述する |
82
+ ### 6.3. `roles[].code` と `roles[].name`
105
83
 
106
- ## 6. 記述ガイド
84
+ `code` は schema の標準コード `PO`、`PM`、`BA`、`ARC`、`DEV`、`QE`、`UX`、`OPS` に限定します。`name` は人と組織の定義標準の正式名称と対応させ、担当者や職位で置き換えません。
107
85
 
108
- ### 6.1. `roles`
86
+ | 判断点 | 良い例 | 悪い例 |
87
+ | -------- | ----------------------------------- | ------------------------------------ |
88
+ | 識別子 | `code: PM` を下流でも同じ表記で使う | `code: project-manager-agent` を使う |
89
+ | 正式名称 | `name: Project Manager` | `name: 開発部長` |
109
90
 
110
- - `roles` にはプロジェクトで使用する全 Role code を過不足なく記載する。
111
- - 記載順は標準ロールの定義順(`PO`, `PM`, `BA`, `ARC`, `DEV`, `QE`, `UX`, `OPS`)に揃えることを推奨する。
112
- - 標準 Role code のみを使用し、プロジェクト固有の独自コードを追加しない。
113
- - `roles[].code` は重複させない。
114
- - 専任 member がいない Role code でも、Schedule の `owner`、RACI、レビュー観点、下流文書で責務語彙として使う場合は残す。
91
+ ### 6.4. `roles[].project_note`
115
92
 
116
- ### 6.2. `roles[].code`
93
+ 責務の重点や専任化の条件など、固有の扱いを 1 行で記述します。一般責務と採用理由は各正本に委ねます。未決事項は `_UNDECIDED_:`、確認・追記待ちは `_TODO_:` で識別し、論点と採用範囲・下流参照への影響を示します。
117
94
 
118
- - `code` には標準 Role code のみを使用する。
119
- - プロジェクト固有の独自 Role code を定義しない。
120
- - 小文字、member nickname、agent 名、個人名、stakeholder ID を `code` にしない。
121
- - Schedule の `owner` や RACI の列で使う値と同じ表記にする。
95
+ | 判断点 | 良い例 | 悪い例 |
96
+ | ---------------- | ----------------------------------------------------- | ---------------------------------- |
97
+ | 判断できる条件 | 週次管理の滞留が続く場合、PO が PM の専任化を判断する | 必要に応じて管理する |
98
+ | 固有性 | 店頭の欠品と記録漏れを受入確認で重視する | 上位標準の品質責務を全文転記する |
99
+ | 実行主体との分離 | 実行主体はメンバー定義で管理する | PM は特定の個人や agent が担当する |
122
100
 
123
- ### 6.3. `roles[].name`
101
+ ### 6.5. 変更時の追従と完了判断
124
102
 
125
- - `name` には Role code の正式名称を記載する。
126
- - 略称だけ、プロジェクト固有の担当者名、組織内の職位名に置き換えない。
127
- - Role code と対応が分かる一般的な英語名を使う。
103
+ 受入確認は次の順で行います。
128
104
 
129
- ### 6.4. `roles[].project_note`
105
+ 1. `pm-roles.schema.yaml` で検証します。SpecDojo 開発リポジトリでは `npm run validate:schema:file -- --schema docs/specdojo/schemas/v1/pm-roles.schema.yaml --data <対象ファイル>` の終了コード 0 を確認します。
106
+ 2. schema の配列要素全体の一意性ではコード重複を検出しきれないため、コードの重複なし、組織定義の採用集合との差分なし、上位標準のコードと正式名称の組との差分なしを別途照合します。
107
+ 3. WBS・Schedule の `owner`、RACI、人間・agent のメンバー定義、レビュー観点の参照を照合し、未定義コードがないことを確認します。採用判断と下流参照に差分があれば修正先を確かめ、ロール削除時は責務の移管先も確認します。
130
108
 
131
- - プロジェクト固有の責務強調、専任化を検討する条件、公開判断上の注意を 1 行で記述する。
132
- - 標準に記載済みの一般的な責務を長く再掲しない。
133
- - member nickname、agent 名、個人名、具体的な兼務割り当ては書かない。
134
- - PO が承認、保留、差し戻しを判断できるよう、未決事項がある場合は _UNDECIDED_: または _TODO_: として残す。
135
- - 公開文書として再利用できる粒度にし、個別組織の内部事情や非公開運用を含めない。
136
- - 記載すべき内容がない場合は省略してよい。
109
+ | 判断点 | 良い例 | 悪い例 |
110
+ | ---------- | -------------------------------------------------- | ------------------------------------------- |
111
+ | 変更完了 | 採用集合・名称・下流参照の照合結果がすべて一致する | YAML の構文が通ったことだけで変更完了にする |
112
+ | ロール削除 | 使用中の参照値と責務の移管先を確認してから除く | 専任者の離脱に合わせてコードだけを消す |
137
113
 
138
114
  ## 7. 禁止事項
139
115
 
140
- | 禁止事項 | 理由 |
141
- | -------------------------------------------------------------------------- | --------------------------------------------------- |
142
- | 標準にない独自 Role code を追加する | Schedule、RACI、member 定義との接続が壊れるため |
143
- | `roles[].code` に member nickname、agent 名、個人名、stakeholder ID を書く | Role と実行主体が混同されるため |
144
- | 兼務の割り当てや実行主体を本ファイルに記載する | member 名簿の責務であり重複管理になるため |
145
- | ロール採用の根拠・方針・見直し条件を長く記載する | `pm-organization.md` の責務であり重複管理になるため |
146
- | 公開できない個人情報、連絡先、非公開組織情報、アクセス情報を記載する | PO の公開可否判断と説明責任を損なうため |
147
- | AI Agent に最終承認、公開可否、説明責任を持たせる記述を置く | 人間の PO が最終判断を担う前提に反するため |
148
- | schema にない任意メタ項目を追加する | 機械検証と下流処理の互換性が壊れるため |
116
+ - schema にないキーで採用理由や兼務割り当てを管理しません。機械処理の互換性と正本の責任境界を損なうためです。
@@ -13,15 +13,14 @@ specdojo:
13
13
 
14
14
  Progress Report Documentation Rulebook
15
15
 
16
- 本ドキュメントは、進捗報告(`pr-<yyyy-mm-dd>-<nn>`)を統一形式で記述するためのルールを定義する。
17
-
18
16
  ## 1. 全体方針
19
17
 
20
18
  - 報告期間の進捗、リスク、次アクションを定点観測できる形で記録する。
21
19
  - 完了事項と未完了事項を区別して報告する。
22
20
  - 判断に必要な数値・根拠を明示する。
21
+ - 共通の運用: Frontmatter の項目(`specdojo.type` は `project`)、`status` の昇格と承認、改訂と廃止は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従い、本書と成果物で言い直さない。
23
22
 
24
- ## 2. 位置づけと用語定義(必要に応じて)
23
+ ## 2. 位置づけ
25
24
 
26
25
  - 進捗報告は定期レビューの基礎資料として扱う。
27
26
  - 議事録、課題ログ、変更要求ログと整合を取る。
@@ -30,18 +29,9 @@ Progress Report Documentation Rulebook
30
29
 
31
30
  - 推奨: `pr-<yyyy-mm-dd>-<nn>.md`
32
31
  - 日付はISO形式、連番は2桁ゼロ埋めを推奨する。
32
+ - 文書 ID は `<project-id>:pr-<yyyy-mm-dd>-<nn>` 形式とする(例: `prj-0001:pr-2026-03-01-01`)。
33
33
 
34
- ## 4. 推奨 Frontmatter 項目
35
-
36
- | 項目 | 説明 | 必須 |
37
-
38
- | ------ | -------------------------------- | ---- |
39
- | id | `pr-<yyyy-mm-dd>-<nn>` | ○ |
40
-
41
- | type | `project` | ○ |
42
- | status | `draft` / `ready` / `deprecated` | ○ |
43
-
44
- ## 5. 本文構成(標準テンプレ)
34
+ ## 4. 本文構成(標準テンプレ)
45
35
 
46
36
  | 番号 | 見出し | 必須 |
47
37
  | ---- | ------------ | ---- |
@@ -51,16 +41,14 @@ Progress Report Documentation Rulebook
51
41
  | 4 | リスク・課題 | ○ |
52
42
  | 5 | 次期予定 | ○ |
53
43
 
54
- ## 6. 記述ガイド
44
+ ## 5. 記述ガイド
55
45
 
56
46
  - 完了事項は成果物IDまたはタスクIDと紐づける。
57
-
58
47
  - リスク・課題は影響度と対応方針を明記する。
59
48
  - 次期予定は担当者と期日を設定する。
60
49
 
61
- ## 7. 禁止事項
50
+ ## 6. 禁止事項
62
51
 
63
52
  - 進捗率のみで根拠なく報告しない。
64
53
  - リスクを抽象語のみで記載しない。
65
-
66
54
  - 予定に期限や責任者を欠いたまま確定しない。
@@ -17,23 +17,17 @@ specdojo:
17
17
 
18
18
  Assumptions, Constraints and Dependencies Documentation Rulebook
19
19
 
20
- 本書は、プロジェクトの成立条件、守るべき境界、外部または先行成果物への依存を、変更時に判断できる形で整理する規約である。構造・必須項目・禁止事項は本書を正とし、作り方は recipe、粒度は sample、記入の骨組みは template を参照する。
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. 位置づけ
35
-
36
- 本書はスコープで定めた境界を受け、実行上の成立条件と変更時の判断材料を明示する。前提・制約・依存が変化した結果としてリスク、変更要求、計画へ影響を伝える。
30
+ ## 2. 位置づけ
37
31
 
38
32
  ```mermaid
39
33
  flowchart LR
@@ -48,77 +42,47 @@ flowchart LR
48
42
  class ACD target
49
43
  ```
50
44
 
51
- ### 2.2. 用語定義
52
-
53
- | 用語 | 定義 |
54
- | -------- | -------------------------------------------------------------------------------------------- |
55
- | 前提条件 | プロジェクトの計画または進行が成立するものとして置く条件。崩れた場合の影響と確認方法を伴う。 |
56
- | 制約事項 | 予算、期限、公開範囲、技術選択、責務境界など、逸脱してはならない限界。 |
57
- | 依存関係 | 外部組織、サービス、先行成果物、意思決定などが提供または確定することを必要とする関係。 |
58
- | トリガー | 前提の崩壊、制約の逸脱、依存先の変化を検知して見直しを始める条件。 |
59
- | 所有者 | 項目の状態確認と一次対応を担うロールまたは責任者。最終判断者とは区別する。 |
60
-
61
45
  ## 3. ファイル命名・ID規則
62
46
 
63
- ### 3.1. 配置
47
+ ### 3.1. 成果物の配置と文書 ID
64
48
 
65
- - 成果物は `docs/ja/projects/<project-id>/020-project-definition/prj-assumptions-constraints-dependencies.md` に配置する。
66
- - rulebook は `docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md` に配置する。
67
- - recipe、sample、template は、それぞれ `docs/ja/specdojo/recipes/`、`samples/`、`templates/` の同じ prefix を持つファイルに配置する。
49
+ - 配置・命名の共通規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従う。
50
+ - 本系統の成果物は `020-project-definition/prj-assumptions-constraints-dependencies.md` に配置し、文書 ID を `<project-id>:prj-assumptions-constraints-dependencies` とする。
51
+ - 文書 ID と項目 ID は区別し、別文書からの行参照には両者を使う。
68
52
 
69
- ### 3.2. ドキュメント ID
53
+ ### 3.2. 項目 ID
70
54
 
71
- - 成果物 ID: `<project-id>:prj-assumptions-constraints-dependencies`
72
- - rulebook ID: `specdojo:prj-assumptions-constraints-dependencies-rulebook`
73
- - 実践の型 ID: `specdojo:prj-assumptions-constraints-dependencies-recipe`、`specdojo:prj-assumptions-constraints-dependencies-sample`、`specdojo:prj-assumptions-constraints-dependencies-template`
74
-
75
- ### 3.3. ファイル名
76
-
77
- - 成果物: `prj-assumptions-constraints-dependencies.md`
78
- - 実践の型: `prj-assumptions-constraints-dependencies-{rulebook,recipe,sample,template}.md`
79
- - 日本語の表示名を使う場合も、ID とファイル名は一意で検索可能な英小文字・ハイフン区切りを維持する。
55
+ - 項目 ID は前提条件 `ACD-A01`、制約事項 `ACD-C01`、依存関係 `ACD-D01` から種別ごとに既採番の最大値に続ける。整数部は 2 桁未満をゼロ埋めし、100 件目以降は桁を増やす。
56
+ - 項目 ID は文書内で一意とし、採番後は内容の修正や並べ替えで変更しない。廃止した ID を別の条件に再利用しない。
57
+ - 種別変更は旧項目を廃止して新規採番し、変更記録に新旧 ID と理由を残す。
80
58
 
81
59
  ## 4. 推奨 Frontmatter 項目
82
60
 
83
- ### 4.1. 設定内容
84
-
85
- | 項目 | 説明 | 必須 |
86
- | ---------- | ------------------------------------------------------------ | ---- |
87
- | id | `<project-id>:prj-assumptions-constraints-dependencies` | ○ |
88
- | type | `project` | ○ |
89
- | status | `draft` / `ready` / `deprecated` | ○ |
90
- | rulebook | `specdojo:prj-assumptions-constraints-dependencies-rulebook` | ○ |
91
- | based_on | 直接参照した上位成果物の ID 配列 | 任意 |
92
- | supersedes | 置き換える旧成果物の ID 配列 | 任意 |
61
+ - 共通項目の必須性、値・構文、未確定事項の目印は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を正とし、構造は `deliverable-frontmatter.schema.yaml` に従う。
62
+ - 本系統では `rulebook` に `specdojo:prj-assumptions-constraints-dependencies-rulebook` を必須で指定する。成果物の `type` は本書の `deliverable_type` に従う。
63
+ - `based_on` には、根拠として直接参照したスコープ・憲章などの上位成果物を記載する。計画や技術資料などへの影響先の参照と混同しない。
93
64
 
94
- ### 4.2. 推奨ルール
65
+ ## 5. 本文要件
95
66
 
96
- - `based_on` には、内容の根拠として直接参照した文書だけを記載する。
97
- - 未確定事項は _TODO_:、意思決定待ちは _UNDECIDED_:、仮置きの前提は _ASSUMPTION_: で明示する。
98
- - H1 には成果物の表示名を置き、frontmatter に `title` を重複して持たせない。
67
+ 次の各章を表の順序で必須とする。前提条件・制約事項・依存関係は項目 ID ごとに管理し、登録対象がない章も省略せず、該当なしの理由と追加時の条件を記載する。
99
68
 
100
- ## 5. 本文構成(標準テンプレ)
101
-
102
- 本文は以下の見出しを順序どおりに置く。
103
-
104
- | 番号 | 見出し | 必須 | 内容 |
105
- | ---- | ------------------ | ---- | ------------------------------------------ |
106
- | 1 | 前提条件 | ○ | 成立条件、根拠、影響、監視、変化時の対応 |
107
- | 2 | 制約事項 | ○ | 守るべき限界、適用範囲、逸脱の検知、対応 |
108
- | 3 | 依存関係 | ○ | 依存先、必要な理由、成立条件、変化時の対応 |
109
- | 4 | 影響評価と対応方針 | ○ | 前提・制約・依存の変化に共通する評価と対応 |
110
- | 5 | 監視・変更管理 | ○ | 見直す契機、記録する情報、判断責任の扱い |
69
+ | 章 | 目的と必須の判断材料 |
70
+ | ------------------ | -------------------------------------------------------------------- |
71
+ | 前提条件 | 計画の成立に置く条件の根拠、崩れた場合の影響、確認と対応を示す。 |
72
+ | 制約事項 | 守るべき限界と適用範囲、逸脱の検知と対応を示す。 |
73
+ | 依存関係 | 他者から受ける条件、必要となる理由、成立の判定と変化時の対応を示す。 |
74
+ | 影響評価と対応方針 | 変化が後続成果物・計画に及ぼす影響、一次対応と最終判断の分担を示す。 |
75
+ | 監視・変更管理 | 見直し契機、変更記録の内容と記録先、追従更新と報告の責任を示す。 |
111
76
 
112
77
  ## 6. 記述ガイド
113
78
 
114
79
  ### 6.1. 前提条件
115
80
 
116
- - 前提には、なぜその条件を置くかを示す根拠と、崩れた場合の影響を記載する。
117
81
  - 確認方法は「誰が何を見れば変化を検知できるか」が分かる表現にする。
118
- - 根拠が不足する場合は事実として断定せず、_ASSUMPTION_: または _TODO_: として確認先を残す。
119
- - スコープで定義済みの境界に該当する前提は再掲せず、章冒頭でスコープの該当章へ委譲する。追加する前提がない場合は、その旨と追加時の記載条件を明記する(章は省略しない)。
82
+ - 仮置きの前提には `_ASSUMPTION_`、根拠の確認待ちには `_TODO_` を付け、確認先を残す。
83
+ - リポジトリ、端末、作業環境、外部ツールなど、外部から継続的に提供される基盤の可用性は「依存関係」として扱う。人の参加見込みを前提とする場合も、特定の助言・承認・成果物を受け取る条件は依存関係として分ける。
120
84
 
121
- - リポジトリ、作業環境、外部ツールなど、外部から継続的に提供される基盤の可用性は、前提条件ではなく依存関係(6.3.)として扱う。
85
+ 良い例: 「代表試行への協力者を確保できる」に、募集の根拠、試行前の確認者、未確保時の延期判断を添える。悪い例: 「店頭で使う端末を利用できる」を前提に登録する、またはスコープで確定済みの単一店舗運用を再掲する。
122
86
 
123
87
  推奨表:
124
88
 
@@ -127,10 +91,10 @@ flowchart LR
127
91
 
128
92
  ### 6.2. 制約事項
129
93
 
130
- - 制約には、適用範囲と、逸脱したと判断する条件を記載する。
131
94
  - 技術制約は、特定製品名の列挙ではなく、選択の自由度、互換性、公開適性、運用上の限界として書く。
132
95
  - 公開情報の制約は、個人情報・機密情報・非公開情報を扱わない方針と、検知時の除去または判断手順を併記する。
133
- - スコープの対象外・境界の判断基準と同内容の制約は再掲しない。本章では、上位文書に現れない運用上の制約だけを扱う。
96
+
97
+ 良い例: 「承認済み予算枠がない間は追加支出を開始しない」に、発注前の承認証跡確認と、未承認時に人間の責任者へ判断を求める対応を添える。悪い例: 「予算に注意する」とだけ書き、適用範囲と逸脱条件を示さない。
134
98
 
135
99
  推奨表:
136
100
 
@@ -140,20 +104,27 @@ flowchart LR
140
104
  ### 6.3. 依存関係
141
105
 
142
106
  - 依存先は、外部サービスだけでなく、先行成果物、承認、意思決定、提供物も含めて明示する。
143
- - 依存が満たされた状態を、受領物、確認条件、期限または判断イベントで書く。
144
- - 依存先の詳細な契約条件や実装方式は、必要な管理・設計成果物へ委譲する。
145
- - 意思決定待ちの依存は、プロジェクト登録簿の項目として登録し、本書からは登録項目 ID を参照する。決定後に本書へ影響がある場合は該当項目へ反映する。
107
+ - 「受領・成立条件」には、成立したと判定する状態と、誰が何の証跡をいつ確認するかの両方を記載する。期限または判断イベントを示し、検証手順が別文書にある場合はその正本を参照する。
108
+ - 成果物の作成・受入を依存とする場合は、対象成果物 ID、適用する受入条件・品質ゲート、証跡の正本を参照できるようにする。単に本書の根拠として読んだ文書は、その理由だけで依存先にしない。
109
+ - 意思決定待ちの依存には `_UNDECIDED_` を付け、論点、不成立時の影響、当面の扱いを示す。
110
+ - 複数の判断を含む依存では、決定記録で確定した部分と未決部分を分離する。一部の決定だけで依存全体を成立済みとしない。
111
+
112
+ 良い例: 店頭端末を依存先とし、「営業時間中に利用者代表が記録できることを、営業開始前の動作確認で確かめる」と書く。悪い例: 「端末がある」「承認済み」とだけ書き、利用可能性や承認対象を確かめる証跡を示さない。
146
113
 
147
114
  推奨表:
148
115
 
149
- | ID | 内容または依存先 | 影響・必要な理由 | 確認方法または成立条件 | トリガー | 所有者 | 対応方針 |
150
- | --- | ---------------- | ---------------- | ---------------------- | -------- | ------ | -------- |
116
+ | ID | 依存先・条件 | 必要となる理由 | 受領・成立条件 | 変化のトリガー | 所有者 | 対応方針 |
117
+ | --- | ------------ | -------------- | -------------- | -------------- | ------ | -------- |
118
+
119
+ 表の各列は必須の意味を表す。「依存先・条件」は受ける提供物・判断・継続提供を、「必要となる理由」はそれが必要な作業と不成立時の影響を示す。
151
120
 
152
121
  ### 6.4. 影響評価と対応方針
153
122
 
154
123
  - 影響は、スコープ、期日、費用、品質、公開適性、運用責任など、該当する領域を具体的に示す。
155
124
  - 対応方針には、除去、軽減、受容、再判断のいずれを行うかと、次に判断する人を記載する。
156
- - 一次対応を担うロールと最終判断者を区別し、人間の判断が必要な範囲を明示する。
125
+ - 所有者は状態確認と一次対応を担う者とし、最終判断者と判断を求める範囲を区別する。
126
+
127
+ 良い例: 「依存先の受入が遅れたら、所有者が影響する成果物と作業を特定し、順序・期日の変更案を判断者へ提示して開始可否を確認する」と書く。悪い例: 「遅れたら調整する」とだけ書き、影響先と次の判断者を示さない。
157
128
 
158
129
  推奨表:
159
130
 
@@ -163,8 +134,10 @@ flowchart LR
163
134
  ### 6.5. 監視・変更管理
164
135
 
165
136
  - 「定期的に確認する」ではなく、スコープまたは実践の型一式が変わったときなど、具体的な見直しの契機を記載する。
166
- - 変更記録には、項目 ID、変化内容、影響範囲、判断者、対応状況を残す。記録先はプロジェクト登録簿を第一候補とし、未定なら _TODO_: とする。
167
- - 文書構造・配置・命名・技術制約・参照資料の整合確認を担うロールと、公開可否やスコープ変更などの最終判断を行う人間の責任者を区別して明示する。
137
+ - 変更記録には、項目 ID、変化内容、影響範囲、判断者、対応状況、再確認時期を残す。
138
+ - 条件の変化が影響するスコープ・計画・Schedule・受入条件を特定し、変更記録と追従作業を項目 ID で結ぶ。
139
+
140
+ 良い例: 「端末の利用不能を検知したら、対象 ID と影響作業、代替策、再確認時期を変更記録に残す。復旧確認を Schedule の試用開始の先行作業にする」と書く。悪い例: 「必要に応じて更新する」とだけ書き、追従対象を示さない。
168
141
 
169
142
  ## 7. 禁止事項
170
143
 
@@ -173,7 +146,4 @@ flowchart LR
173
146
  | スコープ等の上位文書の決定事項を行として再掲する | 正本との二重管理になり、更新漏れと矛盾を招く。 |
174
147
  | 前提・制約・依存を種別なしに混在させる | 条件の性質と対応方法を区別できない。 |
175
148
  | 影響、トリガー、所有者、対応方針のない登録 | 変化時に判断・対応へ使えない。 |
176
- | 根拠のない確定値や外部環境の断定 | 誤った前提を固定し、更新漏れを招く。 |
177
- | Agent に最終判断、承認、公開可否を委ねる | 人間の判断責任を代替してしまう。 |
178
- | API、DB、契約書全文などの詳細を記載する | 本書の責務を越え、詳細成果物と重複する。 |
179
- | 個人情報、非公開情報、機密情報を記載する | 公開・再利用の前提を損なう。 |
149
+ | 部分決定だけで依存全体を成立済みとする | 未成立の条件に依存する作業を開始してしまう。 |