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,148 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:job-definition-standard
4
+ type: standard
5
+ status: draft
6
+ ---
7
+
8
+ # Job 定義標準
9
+
10
+ Job Definition Standard
11
+
12
+ `job-*.yaml` が担う責務の境界と、`task` の記述・agent 指名・検証の規約を定義します。Job は runner が直接実行する決定論的コマンド、または agent へ委譲する判断を定義します。
13
+
14
+ ## 1. 目的・適用範囲
15
+
16
+ - 対象: プロジェクトの `jobs_path` 配下に置くすべての `job-*.yaml`。
17
+ - 目的: 決定論的な実行と agent に委譲する判断を分け、コマンドの組み立てへ agent の判断力を使わせないこと。
18
+ - 位置づけ: 本標準は Job Definition の規範を定める。実行モデル(Job Run、冪等性、checkpoint)の設計は `sysd-job-execution`、運用手順は `routine-operation-guide` と `command-reference` に委譲する。
19
+ - 機械検証: `docs/specdojo/schemas/v1/job.schema.yaml` を SSOT とし、本文では制約を二重定義しない。
20
+
21
+ ## 2. 基本方針
22
+
23
+ - 決定論的な手順(分岐条件が事前に確定し、実行結果が入力から一意に決まる手順)は script または CLI へ実装し、`mode: command` の `task.command` からその入口を呼ぶ。
24
+ - `task.command` は materialize 時に入力を展開して Run へ凍結し、runner が agent の sandbox 外で直接実行する。
25
+ - 対象選択を伴う command Job は任意の `task.precondition` で選択を先に評価できる。skip 条件を満たした場合は Job Run と付随成果物を作らない。
26
+ - command Job が同じプロジェクトの `specdojo exec` を子プロセスとして呼ぶ場合、runner が保持する project 実行 lock の token を子へ継承する。子は owner token の一致を検証した場合だけ再取得を省略し、Job 全体の排他範囲を維持する。
27
+ - 判断(観測した結果の解釈、失敗の切り分け、次の行動の提案)が必要な command Job だけ、`task.analysis` で reporter agent と判断内容を指定する。
28
+ - `edit` / `review` Job は従来どおり agent に作業を委譲し、`task.description` に判断内容を書く。
29
+ - 委譲先の agent は nickname で指名する。`capabilities` / `proficiency` による間接指定は、指名が不要な場合に限る。
30
+ - 同じ論理実行に対して同じ Run を作れるよう、Job が使う値は `inputs`、`job_id`、`scheduled_at`、前回成功 checkpoint に限定する。Run ID 確定後の task と checkpoint では `job_run_id` も参照できる。
31
+
32
+ ### 2.1. 判断と手順の切り分け基準
33
+
34
+ 次の表で「手順」に該当する記述は `task.description` へ書かず、script または CLI へ移す。
35
+
36
+ | 区分 | 判定基準 | 記述場所 | 例 |
37
+ | ---- | ---------------------------------------------------------- | ----------------------------------------------------- | ------------------------------------------------ |
38
+ | 手順 | 実行前に条件と順序が確定し、結果が入力から一意に決まる | script / CLI と `task.command` | 対象文書の列挙、段の順序制御、1件ごとの CLI 実行 |
39
+ | 手順 | 同じ操作を対象ごとに繰り返す | script / CLI と `task.command` | 全件ループ、対象0件時の分岐 |
40
+ | 判断 | 観測した結果を解釈し、複数の説明のどれが妥当かを選ぶ | `task.analysis.description` または `task.description` | 失敗が rate limit か agent の失敗かの切り分け |
41
+ | 判断 | 事実から次の行動(再開・見直し・エスカレーション)を決める | `task.analysis.description` または `task.description` | 閾値の見直し要否、再開可否の判断 |
42
+ | 委譲 | どの agent に任せるか | `task.analysis.agent` または `task.agent` | reporter / executor の nickname 指名 |
43
+
44
+ ## 3. 規範本体
45
+
46
+ ### 3.1. task.description の規約
47
+
48
+ - `task.description` には、agent が下すべき判断と、判断の根拠にする入力(コマンドの出力、生成ファイル)を書く。
49
+ - 決定論的な手順を自然言語で列挙してはならない。command Job の `task.command` が呼び出す入口(script または CLI)は1つに限り、その引数は `inputs` から解決する。
50
+ - 判断できない事象について、推測で埋めず、観測した事実と未確認範囲を分けて報告することを求める。
51
+ - 対象が0件の場合の扱い(no-op)を記述する。
52
+
53
+ ### 3.2. agent 指名の規約
54
+
55
+ - `task.agent.executor` に、成果物の編集・検証・コマンド実行を担当する agent の nickname を書く。
56
+ - result を executor が書かない構成(stage_role を持つ pipeline member)では、`task.agent.reporter` に reporter の nickname を書く。両方を指名した Run は executor → reporter の2段で実行され、result は reporter が書く。
57
+ - `task.agent.reporter` を省略した場合、executor が Job Run の result まで記入する。result を書かない agent を単独で指名してはならない。
58
+ - nickname は `pm-members.yaml` に登録済みの `type: agent` のメンバーと完全一致させる。`job validate` は書式のみを検査するため、実在確認は `exec run --job --dry-run` で行う。
59
+ - `exec run --by` は単一 agent 実行としての単発の差し替え、`--executor-by` / `--reporter-by` は段ごとの差し替えとして、いずれも Job の指名より優先する。
60
+ - command Job で判断が必要な場合は `task.analysis.agent` に `stage_role: reporter` の nickname を指定する。`--reporter-by` で差し替えられるが、runner 実行を `--by` / `--executor-by` で agent に置き換えることはできない。
61
+
62
+ ### 3.3. command mode の規約
63
+
64
+ - `task.command` は非空のシェルコマンドとし、materialize 後の文字列を Job Run に保存する。
65
+ - `task.precondition` は command mode だけで使用でき、非空の `command` と `skip_when` を持つ。runner は入力と Job Run ID を含む template 値を解決した後、初回の Job Run を保存する前に precondition を実行する。
66
+ - `skip_when: empty-output` は終了コード 0 かつ、前後の空白を除いた stdout が空の場合に skip とする。`skip_when` に 0 から 255 の整数を指定した場合は、その終了コードを skip とする。それ以外の非 0 終了は precondition の失敗として扱う。
67
+ - precondition による skip では Job Run、plan、result、evidence を作らず、analysis reporter と `task.command` も起動しない。routine 起動では routine に `skipped` を返し、routine 側だけが `last_run` / `last_result` を更新する。
68
+ - 既存 Job Run の retry は保存済みの対象と再開状態を維持するため precondition を再実行しない。`--dry-run` は precondition を実行せず、解決済みコマンドと skip 条件を表示する。
69
+ - command から対象プロジェクトを指定するときは template 値 `{{project_id}}` を使い、同じ CLI を子プロセスで呼ぶときは `{{specdojo}}` を使う。`specdojo` という PATH 上の別 checkout を直接呼ばない。
70
+ - script が中断再開用の ID を要求するときは `{{job_run_id}}` を渡す。期間などの `inputs` から再開キーを組み立てない。
71
+ - runner は POSIX 環境では `/bin/sh -eu` でコマンドを実行し、終了コードが0以外なら agent を起動せず Run を失敗にする。
72
+ - runner はコマンド、終了コード、標準出力、標準エラーを bounded・redacted evidence として保存する。stdout / stderr は監査用ログへの参照に加え、analysis reporter が追加のファイル読取なしで判断できるよう evidence 本体にも同じ bounded 内容を含める。
73
+ - `task.analysis` は任意である。省略時は終了コードだけで成否を確定し、指定時はコマンド成功後に evidence を reporter agent へ渡す。
74
+ - analysis の根拠にする生成ファイルは command が stdout へ出力する。reporter は evidence 本体に埋め込まれた bounded stdout / stderr だけを読み、参照先ログや作業ツリーのファイルを追加で検査しない。
75
+
76
+ ### 3.4. 責務境界と粒度
77
+
78
+ - 1つの Job は1つの委譲単位に対応させる。同じ処理を条件違いで繰り返すために Job を分割してはならない。条件差は `inputs` で表す。
79
+ - 実行順序を Job の分割で表現してはならない。順序は script または CLI が持ち、routine の `action` 配列は独立した委譲単位の並びにだけ使う。
80
+ - Job は起動時刻を持たない。時刻条件は routine または外部スケジューラが持つ。
81
+ - Job は agent 実行エンジンを持たない。plan 生成、agent 選択、result、worktree、commit は `exec` 実行基盤へ委ねる。
82
+
83
+ ### 3.5. inputs と冪等性
84
+
85
+ - `inputs` には、実行内容または表示内容を決める値(期間、対象種別、上限件数)だけを置く。
86
+ - string / integer / boolean は `enum` で許容値を、list は `enum` で各要素の許容値を制限できる。integer の範囲は `minimum` / `maximum` で制限する。既定値にも同じ制約を適用する。
87
+ - 入れ子の mapping は入力にせず、独立に検証できる flat な入力へ分ける。たとえば登録簿 filter は `types` / `priorities` / `statuses` の list と `limit` の integer で表す。
88
+ - `run.idempotency_key` には、同じ論理実行を判別できる実行条件を含める。実行枠ごとに処理する Job は `scheduled_at` を含め、同じ実行枠の重複起動を同じ Run、次の実行枠を別 Run にする。
89
+ - 表示専用の `period` は冪等キーや再開キーに使わない。実行内容を変える `inputs` は冪等キーに含める。
90
+ - `job_run_id` は `idempotency_key` から導出されるため、`run.idempotency_key` では参照できない。
91
+ - 同じ `scheduled_at` を明示した手動・routine 起動は同じ実行枠として重複排除する。`scheduled_at` を省略した手動起動は起動ごとに新しい実行枠とする。
92
+
93
+ ## 4. 値制約・判定基準
94
+
95
+ | 項目 | 必須 | 判定基準 |
96
+ | ---------------------- | ---- | ------------------------------------------------------------------ |
97
+ | `id` | ○ | `job-<slug>` 形式で、ファイル名の拡張子を除いた部分と一致する |
98
+ | `task.mode` | ○ | `edit` / `review` / `command` |
99
+ | `task.description` | 条件 | `edit` / `review` で必須。決定論的手順の列挙を含まない |
100
+ | `task.command` | 条件 | `command` で必須。入力展開後も非空 |
101
+ | `task.precondition` | 任意 | `command` と `empty-output` または 0〜255 の終了コードを指定 |
102
+ | `task.analysis` | 任意 | command 結果の判断が必要な場合だけ agent と description を指定 |
103
+ | `task.targets` `paths` | 条件 | `edit` / `review` はいずれか必須。`command` では任意 |
104
+ | `task.agent.executor` | 任意 | `pm-members.yaml` の nickname 書式(`^[a-z0-9][a-z0-9_-]{0,62}$`) |
105
+ | `task.agent.reporter` | 任意 | 同上。executor が result を書かない構成では必須 |
106
+ | `inputs.*.enum` | 任意 | scalar の値または list の各要素に対する非空の許容値集合 |
107
+ | `minimum` / `maximum` | 任意 | integer input だけに指定でき、`minimum <= maximum` |
108
+ | `run.idempotency_key` | ○ | 空文字へ解決されず、同じ論理実行を一意に判別できる |
109
+
110
+ ## 5. 記述例
111
+
112
+ ```yaml
113
+ task:
114
+ mode: command
115
+ owner: ARC
116
+ precondition:
117
+ command: "{{specdojo}} grade list --target kata --changed-only --project {{project_id}}"
118
+ skip_when: empty-output
119
+ command: |
120
+ tools/grade/run-per-document.sh --run-id {{job_run_id}}
121
+ cat logs/grade/runs/per-document/{{job_run_id}}/results.tsv
122
+ analysis:
123
+ agent: claude-reporter
124
+ description: |
125
+ command evidence と results.tsv から未完了の段の有無、失敗の切り分け、
126
+ 閾値の見直し要否を判断して報告する。
127
+ paths:
128
+ - docs/ja/specdojo/rulebooks
129
+ run:
130
+ idempotency_key: "{{job_id}}:{{scheduled_at}}"
131
+ ```
132
+
133
+ ## 6. 禁止事項
134
+
135
+ - 対象文書の列挙、段の順序制御、1件ごとの CLI 実行を `task.description` へ書かない。自然言語で書かれた script は Job の責務ではない。
136
+ - 実行順序を表すためだけに Job を分割しない(例: 1段目・2段目・3段目を別 Job にする)。
137
+ - `task.agent` を省略したまま、`capabilities` の間接指定だけで pipeline member を選ばせない。auto 選択の対象は stage_role を持たない agent に限られるため、指名なしでは解決できない。
138
+ - result を更新しない agent を `task.agent.reporter` なしで指名しない。Run が常に未記入 result で失敗する。
139
+ - `task.description` へ認証情報、秘密鍵、token を書かない。
140
+ - 検証済みでない外部入力(環境変数、任意コード実行)をテンプレート式で展開しない。
141
+
142
+ ## 7. 運用・見直しルール
143
+
144
+ - `job-*.yaml` を変更した場合は `specdojo job validate --project <project-id>` を実行する。
145
+ - agent の指名を変更した場合は `specdojo exec run --job <job-id> --dry-run` で、解決された nickname とコマンドを確認する。
146
+ - Job を統廃合した場合は、参照する routine の `action` と運用ガイドの記述を同じ変更で更新する。
147
+ - script または CLI へ手順を移した場合は、移し先の入口と引数を `command-reference` に記載し、Job からはその入口だけを呼ぶ。
148
+ - `task.precondition` を追加・変更した場合は、選択 0 件の skip と 1 件以上の通常 materialize の両方をテストする。
@@ -0,0 +1,431 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:people-and-organization-definition-standard
4
+ type: standard
5
+ status: draft
6
+ ---
7
+
8
+ # 人と組織の定義標準
9
+
10
+ People and Organization Definition Standard
11
+
12
+ ## 1. 目的
13
+
14
+ 本標準は、SpecDojo における **ロール、メンバー、タスク担当、ステークホルダー、RACI** の定義方法を整理し、Schedule、実行ログに一貫して展開できるようにするための標準である。
15
+
16
+ 本標準では、**Role(ロール)を中心概念** とする。
17
+
18
+ プロジェクトでは、「誰が責任を持つか」「誰が実行するか」「誰に相談・共有するか」が混在しやすい。そこで、本標準では次のように分けて扱う。
19
+
20
+ | 概念 | 意味 | 代表例 |
21
+ | ----------- | ---------------------------------------- | ------------------------------------ |
22
+ | Role | 責務・判断権限・専門性を表す論理的な役割 | `PO`, `PM`, `BA`, `ARC`, `DEV`, `QE` |
23
+ | Member | 実際に作業する人または agent | `po`, `ba-agent`, `copilot` |
24
+ | Task owner | Schedule 上の主責任ロール | `owner: BA` |
25
+ | Executor | 実際にタスクを claim / 実行する主体 | `--by ba-agent` |
26
+ | Stakeholder | 利害・期待・懸念・合意対象を管理する相手 | 将来利用者、貢献者、公開基盤 |
27
+ | RACI | 作成・承認・相談・通知を分ける責任分担 | `R`, `A`, `C`, `I` |
28
+
29
+ すべてのプロジェクトで、最初から stakeholder register や RACI を管理する必要はない。個人・小規模プロジェクトでは、まず **Role、Member、Task owner** のみを定義すればよい。
30
+
31
+ ## 2. 基本方針
32
+
33
+ ### 2.1. Role を中心にする
34
+
35
+ Role は、個人名、部署名、agent 名ではなく、プロジェクト上の責務・判断権限・専門性を表す論理的な役割である。
36
+
37
+ Schedule、RACI、member 定義は、すべて Role code を基準に接続する。
38
+
39
+ ```mermaid
40
+ flowchart LR
41
+ ROLE["Role<br/>責務・判断権限"]
42
+ MEMBER["Member<br/>実行主体"]
43
+ TASK["Task<br/>owner: Role"]
44
+ EXEC["Execution<br/>--by nickname"]
45
+ RACI["RACI<br/>必要時"]
46
+ STH["Stakeholder<br/>必要時"]
47
+
48
+ ROLE --> MEMBER
49
+ ROLE --> TASK
50
+ MEMBER --> EXEC
51
+ TASK --> EXEC
52
+ ROLE --> RACI
53
+ STH -.必要時.-> ROLE
54
+ ```
55
+
56
+ ### 2.2. `owner` はタスク側だけに使う
57
+
58
+ `owner` は、Schedule 上の **主責任ロール** を表す。
59
+
60
+ `owner` には、個人名、member nickname、agent 名、stakeholder ID を書かない。必ず Role code を書く。
61
+
62
+ ```yaml
63
+ tasks:
64
+ - id: T-SCOPE-010
65
+ name: スコープを整理する
66
+ owner: BA
67
+ ```
68
+
69
+ この場合、`BA` がこのタスクの主責任ロールである。実際に誰が実行するかは、`owner` ではなく `--by <nickname>` で指定する。
70
+
71
+ ### 2.3. Member 側では `role` を使う
72
+
73
+ Member は、実際に作業する人間または agent を表す。
74
+
75
+ Member がどの Role に対応するかは、`roles` フィールドで表す。`pm-members.yaml` では `owner` という名前を使わない。
76
+
77
+ ```yaml
78
+ members:
79
+ - nickname: po
80
+ display_name: Project Owner
81
+ roles: [PO, PM, OPS]
82
+ type: human
83
+
84
+ - nickname: ba-agent
85
+ display_name: Business Analyst Agent
86
+ roles: [BA]
87
+ type: agent
88
+
89
+ - nickname: copilot
90
+ display_name: General Agent
91
+ roles: []
92
+ type: agent
93
+ ```
94
+
95
+ `roles: []` は、特定の Role に固定しない汎用 agent を表す。この場合は、実行時の文脈や明示指定によって対象ロールを補う。
96
+
97
+ ### 2.4. Executor は実行時に決まる
98
+
99
+ Executor は、実際にタスクを claim / 実行する Member である。
100
+
101
+ CLI では、次のように `--by <nickname>` で指定する。
102
+
103
+ ```bash
104
+ specdojo exec T-SCOPE-010 --by ba-agent
105
+ ```
106
+
107
+ Schedule Task の `owner` が `BA` であり、`ba-agent` の `role` も `BA` であれば、自然な対応関係になる。
108
+
109
+ ## 3. 標準ロール
110
+
111
+ SpecDojo では、プロジェクト規模にかかわらず、次の標準ロールを基準にする。
112
+
113
+ | Role code | 正式名称 | 主な責務 | 小規模での扱い | 大規模での扱い |
114
+ | --------- | ---------------------------- | ------------------------------------------------ | ---------------------------------- | ---------------------------------- |
115
+ | `PO` | Project Owner | 目的、スコープ、優先順位、公開方針、最終判断 | 必須。多くの判断を兼務する | 必須。事業・成果物の最終責任を持つ |
116
+ | `PM` | Project Manager | 計画、進捗、課題、リスク、実行管理 | 原則省略し、`PO` が兼務してよい | 原則独立させる |
117
+ | `BA` | Business Analyst | 要件、業務仕様、受入条件、利用者視点、関係者調整 | `PO` が兼務してもよい | 原則独立させる |
118
+ | `ARC` | Architect | 構成方針、技術方針、設計判断、非機能観点 | 必要時のみ定義する | 原則独立させる |
119
+ | `DEV` | Developer | 実装、設定、変更作業、技術的な成果物作成 | 必要時のみ定義する | 原則独立させる |
120
+ | `QE` | Quality Engineer | 品質基準、レビュー方針、検証観点、受入確認 | 必要時のみ定義する | 原則独立させる |
121
+ | `UX` | UX / Documentation Designer | 利用者導線、説明、文書体験、読みやすさ | 通常は `BA` または `PO` が兼務する | 必要に応じて独立させる |
122
+ | `OPS` | Operations / Release Manager | リリース、運用、公開、配布、変更管理 | 通常は `PO` または `PM` が兼務する | 必要に応じて独立させる |
123
+
124
+ ### 3.1. 必須ロールと任意ロール
125
+
126
+ 最低限必要なロールは `PO` である。ただし、Schedule の `owner` を責務別に分けたい場合は、`BA`, `ARC`, `QE` などを追加する。
127
+
128
+ | 区分 | ロール | 説明 |
129
+ | ---- | ----------------------- | ------------------------------------------------ |
130
+ | 必須 | `PO` | プロジェクトの目的と最終判断を担う |
131
+ | 基本 | `PM`, `BA`, `ARC`, `QE` | 多くのプロジェクトで有用な責務分担 |
132
+ | 任意 | `DEV`, `UX`, `OPS` | 実装、文書体験、運用公開を分けたい場合に追加する |
133
+
134
+ ### 3.2. ロールは増やしすぎない
135
+
136
+ ロールは、責務境界を明確にするために定義する。作業者の肩書きや一時的な作業内容をすべてロール化しない。
137
+
138
+ ロールを追加する目安は次のとおりである。
139
+
140
+ - その責務を持つタスクが複数ある。
141
+ - 他のロールとは判断基準が異なる。
142
+ - RACI または承認責任を分ける必要がある。
143
+ - Schedule の `owner` として使う必要がある。
144
+
145
+ ## 4. 規模別の採用パターン
146
+
147
+ ### 4.1. 小規模プロジェクト
148
+
149
+ 個人プロジェクト、初期検証、AI 支援中心の小規模プロジェクトでは、ロールを最小限にする。
150
+
151
+ 推奨ロール構成:
152
+
153
+ | Role code | 採用 | 扱い |
154
+ | ------------------ | -------- | ----------------------------------------------- |
155
+ | `PO` | 必須 | 目的、優先順位、最終判断、PM 的な管理を兼務する |
156
+ | `BA` | 任意 | 要件や利用者視点を分けたい場合に追加する |
157
+ | `ARC` | 任意 | 技術・構成判断を分けたい場合に追加する |
158
+ | `QE` | 任意 | 品質確認やレビュー観点を分けたい場合に追加する |
159
+ | `PM` | 原則省略 | `PO` が兼務する |
160
+ | `DEV`, `UX`, `OPS` | 原則省略 | 必要になったら追加する |
161
+
162
+ 小規模プロジェクトでは、次のような構成で開始してよい。
163
+
164
+ ```yaml
165
+ roles:
166
+ - code: PO
167
+ name: Project Owner
168
+ - code: BA
169
+ name: Business Analyst
170
+ - code: ARC
171
+ name: Architect
172
+ - code: QE
173
+ name: Quality Engineer
174
+ ```
175
+
176
+ この場合、`PM` 責務は `PO` が兼務する。兼務していても、Schedule の `owner` には作業の性質に近い Role code を書く。
177
+
178
+ 例:
179
+
180
+ ```yaml
181
+ tasks:
182
+ - id: T-REQ-010
183
+ name: 要件を整理する
184
+ owner: BA
185
+
186
+ - id: T-QUALITY-010
187
+ name: レビュー観点を整理する
188
+ owner: QE
189
+ ```
190
+
191
+ 実際には同じ人が `BA` と `QE` のタスクを実行してもよい。責務を Role として分けることで、タスクの性質を明確にする。
192
+
193
+ ### 4.2. 中規模プロジェクト
194
+
195
+ 複数人、レビュー、承認、定期的な進捗管理がある場合は、`PM` を独立させる。
196
+
197
+ 推奨ロール構成:
198
+
199
+ | Role code | 採用 | 扱い |
200
+ | ------------------ | ------ | ---------------------------------------------- |
201
+ | `PO` | 必須 | 目的、スコープ、優先順位、最終判断 |
202
+ | `PM` | 推奨 | 計画、進捗、課題、リスク、実行管理 |
203
+ | `BA` | 推奨 | 要件、受入条件、関係者調整 |
204
+ | `ARC` | 推奨 | 構成方針、技術判断 |
205
+ | `QE` | 推奨 | 品質基準、レビュー、受入確認 |
206
+ | `DEV`, `UX`, `OPS` | 必要時 | 実装、文書体験、運用公開を分ける場合に追加する |
207
+
208
+ 中規模以上では、作成責任と承認責任を分けるために RACI の導入を検討する。
209
+
210
+ ### 4.3. 大規模プロジェクト
211
+
212
+ 複数チーム、外部関係者、監査、OSS 公開、リリース管理がある場合は、ロールを明確に分離する。
213
+
214
+ 推奨ロール構成:
215
+
216
+ | Role code | 採用 | 扱い |
217
+ | --------- | ------ | ------------------------------------------ |
218
+ | `PO` | 必須 | 成果物価値、目的、優先順位、最終判断 |
219
+ | `PM` | 必須 | 計画、進捗、課題、リスク、横断調整 |
220
+ | `BA` | 必須 | 要件、業務、受入条件、ステークホルダー調整 |
221
+ | `ARC` | 必須 | アーキテクチャ、技術方針、構成判断 |
222
+ | `DEV` | 必要時 | 実装・設定・技術的変更作業を担当する |
223
+ | `QE` | 必須 | 品質基準、レビュー、検証、受入確認 |
224
+ | `UX` | 必要時 | 利用者体験、文書導線、説明品質を担当する |
225
+ | `OPS` | 必要時 | リリース、公開、運用、変更管理を担当する |
226
+
227
+ 大規模プロジェクトでは、次の文書を併用することを推奨する。
228
+
229
+ | 文書 | 目的 |
230
+ | ----------------------------- | -------------------------------------------- |
231
+ | `pm-organization.md` | ロールと責務境界を定義する |
232
+ | `pm-members.yaml` | 実行主体を定義する |
233
+ | `pm-raci.md` | 成果物・プロセスごとの責任分担を定義する |
234
+ | `prj-stakeholder-register.md` | 外部関係者、期待、懸念、合意対象を管理する |
235
+ | communication 関連文書 | 報告、共有、合意、エスカレーションを管理する |
236
+
237
+ ## 5. 用語定義
238
+
239
+ | 用語 | 意味 |
240
+ | ----------- | ---------------------------------------------------------------- |
241
+ | Role | 責務・判断権限・専門性を表す論理的な役割 |
242
+ | Role code | Role を表す短い識別子。例: `PO`, `PM`, `BA`, `ARC`, `QE` |
243
+ | Member | 実際に作業または支援する主体。人間または agent を含む |
244
+ | nickname | CLI や実行ログで使う Member の安定識別子 |
245
+ | roles | Member が対応する Role code のリスト。`pm-members.yaml` で使う |
246
+ | owner | Schedule 上の主責任ロール。Role code を使う |
247
+ | Executor | `specdojo exec --by <nickname>` でタスクを実行する主体 |
248
+ | Stakeholder | プロジェクトに影響する、または影響を受ける関係者・集団・外部基盤 |
249
+ | RACI | Responsible / Accountable / Consulted / Informed の責任分担 |
250
+
251
+ ## 6. ファイル別の責務
252
+
253
+ ### 6.1. `pm-organization.md`
254
+
255
+ `pm-organization.md` は、プロジェクトで採用する Role と、採用しない Role の扱いを定義する。
256
+
257
+ 本標準にある Role、Member、Task owner、Executor、RACI の共通定義は再掲しない。`pm-organization.md` には、対象プロジェクトでの採用判断、使用可能な `owner`、見直し条件など、プロジェクト固有の最小限の内容だけを書く。
258
+
259
+ 記載する内容:
260
+
261
+ | 項目 | 内容 |
262
+ | ------------------ | ------------------------------------------------------- |
263
+ | 採用ロール | プロジェクトで使用する Role code とプロジェクトでの扱い |
264
+ | 未採用ロール | 採用しない Role code と代替方針 |
265
+ | 使用可能な `owner` | Schedule の `owner` に使える Role code |
266
+ | 関連ドキュメント | `pm-members.yaml`、`pm-raci.md`、本標準への参照 |
267
+ | 見直し条件 | 採用ロールを見直すプロジェクト固有のトリガー |
268
+
269
+ ### 6.2. `pm-members.yaml`
270
+
271
+ `pm-members.yaml` は、実行主体の machine-readable な一覧を管理する。
272
+
273
+ 標準フィールド:
274
+
275
+ | フィールド | 必須 | 内容 |
276
+ | ------------------------------ | ---- | ---------------------------------------------------------------------------- |
277
+ | `version` | ○ | メンバー定義のバージョン |
278
+ | `project_id` | ○ | プロジェクト ID |
279
+ | `members[].nickname` | ○ | 実行ログに残る安定識別子 |
280
+ | `members[].display_name` | ○ | 表示名 |
281
+ | `members[].email` | 任意 | 公開可能な連絡先。公開文書では `null` を推奨 |
282
+ | `members[].roles` | 任意 | 対応する Role code のリスト。兼務の場合は複数記載する。汎用 agent は `[]` 可 |
283
+ | `members[].type` | ○ | `human` または `agent` |
284
+ | `members[].persona` | 任意 | agent の実行姿勢 |
285
+ | `members[].focus` | 任意 | agent が重視する観点 |
286
+ | `members[].scheduler_strategy` | 任意 | scheduler の既定選択戦略 |
287
+ | `members[].note` | 任意 | 補足 |
288
+
289
+ ### 6.3. `pm-raci.md`
290
+
291
+ `pm-raci.md` は、標準運用以上で使用する。
292
+
293
+ RACI は、成果物、プロセス、または主要タスク単位の責任分担を管理する。最小運用では、WBS または Schedule の `owner` だけで責務を判断できる場合、RACI の作成を省略してよい。
294
+
295
+ | 記号 | 意味 | 説明 |
296
+ | ---- | ----------- | ------------------------ |
297
+ | `R` | Responsible | 実作業を担当する |
298
+ | `A` | Accountable | 最終責任を持ち、承認する |
299
+ | `C` | Consulted | 相談・レビューに参加する |
300
+ | `I` | Informed | 結果の共有を受ける |
301
+
302
+ ### 6.4. `prj-stakeholder-register.md`
303
+
304
+ ステークホルダー登録簿は、拡張運用で使用する。
305
+
306
+ ステークホルダーは、Role とは異なる。Role は責務と判断主体を表し、Stakeholder は利害、期待、懸念、合意対象を表す。
307
+
308
+ ステークホルダー登録簿には、Schedule の `owner` に直接使う値を定義しない。Schedule に展開する責務は、Role と必要に応じて RACI を経由して決める。
309
+
310
+ ## 7. Schedule への担当展開
311
+
312
+ ### 7.1. 基本ルール
313
+
314
+ WBS Item から Schedule Task を作る際は、以下の順で担当を決める。
315
+
316
+ 1. WBS Item の `owner` が明示されていれば、その Role code を Schedule Task の `owner` に引き継ぐ。
317
+ 2. WBS Item の `owner` が未定義で RACI がある場合は、成果物別 RACI の `R` を Schedule Task の `owner` とする。
318
+ 3. `R` が複数ある場合は、タスクの action に最も近い Role を `owner` とし、残りはレビュー・相談タスクまたは notes に分離する。
319
+ 4. `A/R` のように同一 Role が実作業と承認を兼ねる場合は、作業タスクの `owner` はその Role とする。
320
+ 5. 承認、レビュー、外部待ちを Schedule Task として分割する場合は、RACI の `A` または `C` を owner にした別 Task / Milestone を作る。
321
+ 6. `I` は Schedule の owner にはしない。通知・共有はコミュニケーション計画または実行イベントで扱う。
322
+
323
+ 最小運用では 1 のみでよい。標準運用以上では 2 から 6 も適用する。
324
+
325
+ ### 7.2. `owner` と `--by` の違い
326
+
327
+ | 項目 | 意味 | 値の例 | 管理先 |
328
+ | ------- | --------------------------------- | ----------------------- | ----------------------- |
329
+ | `owner` | タスクの主責任ロール | `PO`, `BA`, `ARC`, `QE` | Schedule |
330
+ | `roles` | member が対応できるロールのリスト | `[BA]`, `[PO, PM, OPS]` | `pm-members.yaml` |
331
+ | `--by` | タスクを claim / 実行する主体 | `ba-agent` | 実行コマンド / 実行ログ |
332
+
333
+ 原則:
334
+
335
+ - Schedule Task の `owner` には member nickname を書かない。
336
+ - `--by` に指定できる nickname は `pm-members.yaml` に存在しなければならない。
337
+ - member の `roles` にタスクの `owner` が含まれていることを推奨する。
338
+ - `roles: []` の汎用 agent が実行する場合は、実行時の文脈で対象 Role を明示する。
339
+
340
+ ## 8. Agent 委任方針
341
+
342
+ Agent は実行支援者であり、人間の判断や説明責任を代替しない。
343
+
344
+ | 作業種別 | agent 委任 | 最終判断 |
345
+ | ---------------------------- | ---------- | ----------------- |
346
+ | 草案作成 | 可 | 対応 Role の人間 |
347
+ | 表記揺れ確認 | 可 | 対応 Role の人間 |
348
+ | 抜け漏れ検出 | 可 | 対応 Role の人間 |
349
+ | 既存ルールに基づく機械的更新 | 可 | 対応 Role の人間 |
350
+ | スコープ変更 | 不可 | `PO` |
351
+ | 優先順位変更 | 不可 | `PO` |
352
+ | 公開可否判断 | 不可 | `PO` |
353
+ | 技術方針の最終決定 | 原則不可 | `ARC` |
354
+ | 品質基準の最終決定 | 原則不可 | `QE` |
355
+ | リリース可否判断 | 原則不可 | `PO` または `OPS` |
356
+
357
+ ## 9. 整合性ルール
358
+
359
+ - Schedule の `owner` は、`pm-organization.md` に存在する Role code でなければならない。
360
+ - Schedule の `owner` に member nickname、人名、agent 名、stakeholder ID を書いてはならない。
361
+ - `pm-members.yaml` の `members[].roles` は、`[]` または `pm-roles.yaml` に存在する Role code のリストでなければならない。
362
+ - RACI の列に使う Role code は、`pm-organization.md` に存在しなければならない。
363
+ - WBS の `owner` と Schedule の `owner` は、原則として同じ Role code を使う。
364
+ - 1 つの Schedule Task に複数 owner を書かない。複数 Role の実作業が必要な場合はタスクを分割する。
365
+ - `I` の Role をタスク owner にしない。
366
+ - agent に最終承認責任を持たせない。
367
+ - 公開文書に不要な個人名、私用メールアドレス、非公開組織情報を書かない。
368
+
369
+ ## 10. 最小構成例
370
+
371
+ 小規模プロジェクトでは、まず次の構成だけで運用してよい。
372
+
373
+ `pm-organization.md` では、採用ロールと未採用ロールをプロジェクト固有の判断として記載する。共通の Role 定義や `owner` / `role` / `--by` の説明は本標準を参照する。
374
+
375
+ `pm-members.yaml`:
376
+
377
+ ```yaml
378
+ members:
379
+ - nickname: po
380
+ display_name: Project Owner
381
+ roles: [PO, PM, OPS]
382
+ type: human
383
+
384
+ - nickname: po-agent
385
+ display_name: Project Owner Agent
386
+ roles: [PO, PM, OPS]
387
+ type: agent
388
+ scheduler_strategy: critical-first
389
+
390
+ - nickname: ba-agent
391
+ display_name: Business Analyst Agent
392
+ roles: [BA]
393
+ type: agent
394
+ ```
395
+
396
+ Schedule:
397
+
398
+ ```yaml
399
+ tasks:
400
+ - id: T-LAUNCH-PJD-SCOPE-010
401
+ name: prj-scope を作成する
402
+ duration_days: 0.5
403
+ depends_on: []
404
+ owner: BA
405
+ ```
406
+
407
+ ## 11. 見直し条件
408
+
409
+ People / Organization 定義は、以下のタイミングで見直す。
410
+
411
+ | 更新トリガー | 見直し対象 |
412
+ | -------------------------------------- | -------------------------------------------- |
413
+ | プロジェクトスコープ変更 | Stakeholder、Role、RACI |
414
+ | 成果物カタログまたは WBS の変更 | RACI、Schedule owner |
415
+ | Schedule のトラック追加 | Role、Member、scheduler strategy |
416
+ | agent 追加・削除 | `pm-members.yaml`、委任方針、agent overrides |
417
+ | 複数人運用の開始 | `PM` ロール、RACI、承認責任 |
418
+ | 外部利用者・貢献者の関与開始 | stakeholder register、コミュニケーション要件 |
419
+ | 公開前 | 個人情報、機密情報、公開可能な連絡先 |
420
+ | 実行ログに存在する nickname の変更要求 | 変更せず、新 nickname 追加または無効化で対応 |
421
+
422
+ ## 12. 禁止事項
423
+
424
+ - Schedule の `owner` に個人名や member nickname を書くこと。
425
+ - `pm-members.yaml` で member の対応ロールを `owner` と表記すること(正しくは `roles`)。
426
+ - RACI の列名に未定義の Role code を使うこと。
427
+ - `pm-members.yaml` の nickname を履歴記録後に変更すること。
428
+ - agent に最終承認責任を持たせること。
429
+ - `I` の Role をタスク owner にすること。
430
+ - 兼務を理由に RACI の責務境界を曖昧にすること。
431
+ - 公開文書に不要な個人情報や非公開組織情報を書くこと。