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,418 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:register-operation-guide
4
+ type: guide
5
+ status: ready
6
+ ---
7
+
8
+ # 登録簿運用ガイド
9
+
10
+ Register Operation Guide
11
+
12
+ プロジェクト登録簿の使い方を説明します。登録の判断、type の選び方、状態遷移、個票の作成、完了時の記録、派生ビューの扱い、台帳の変更の追跡、agent 実行・定期実行との連携を扱います。登録簿の記述ルール(構造・列・値の定義)は [プロジェクト登録簿 作成ルール](../rulebooks/pjr-rulebook.md) を、コマンドの一覧は [CLIコマンドリファレンス](../references/command-reference.md) を正本とします。
13
+
14
+ **対象読者**
15
+
16
+ - プロジェクトの課題、リスク、変更要求、意思決定などを登録・更新・実行するプロジェクト管理者、担当者
17
+
18
+ **この文書で分かること**
19
+
20
+ - 登録簿へ記録する判断基準、type と状態遷移、個票・派生ビュー、台帳の変更履歴の追い方、agent・routine との連携
21
+
22
+ **次に読む文書**
23
+
24
+ - 登録項目の実行経路は [exec運用ガイド](exec-operation-guide.md)、コマンド詳細は [CLIコマンドリファレンス](../references/command-reference.md) を参照してください。
25
+
26
+ ## 1. 登録簿の基本
27
+
28
+ 登録簿が何を管理するか、いつ登録するか、type をどう選ぶかを示します。
29
+
30
+ ### 1.1. 登録簿の位置づけ
31
+
32
+ プロジェクト登録簿は、プロジェクト立ち上げ時または進行中に発生する TODO、要確認事項、リスク、課題、変更要求、決定事項、備忘を一元管理する台帳です。
33
+
34
+ - 正本は各個票(`pjr-XXXX-<topic>.md`)です。登録項目一覧(`generated/pjr-index.md`)は個票から生成される一覧ビューです。
35
+ - 個票の Frontmatter は現在値、`events/pjr-XXXX.yaml` は変更履歴の正本です。Git は両者の保存・配布・レビューを担いますが、コミット粒度を業務イベントの粒度として扱いません。
36
+ - 文書 ID `<project-id>:pjr-index` の解決先は `project-register/generated/pjr-index.md` です。`controls/**/generated/` はdoc-indexの限定的な走査対象であり、一覧自身を `[[id]]` で参照できます。
37
+ - 一覧と、状態別・優先度別・担当者別などの派生ビューは `generated/` 配下に生成される派生物であり、直接編集しません。
38
+ - 立ち上げ時は、未整理の問題・判断を `issue` / `question` / `decision` で記録し、合意した成果物カタログの作成を `todo` で追跡できます。
39
+ - 成果物カタログと依存関係に基づく計画済みの作業へ移った後は schedule で管理し、登録簿との二重管理をしません。進行中に発生した計画外の単発対応・調査・判断は、引き続き登録簿で追跡します([exec運用ガイド](exec-operation-guide.md) の `実行経路の使い分け` を参照してください)。
40
+
41
+ 関連ドキュメントの関係は次のとおりです。
42
+
43
+ ```mermaid
44
+ flowchart LR
45
+ PJR_ITEM["pjr-XXXX-&lt;topic&gt;<br>個別登録項目(正本)"]
46
+ PJR_IDX["project-register/generated<br>pjr-index 登録項目一覧"]
47
+ PJR_GEN["project-register/generated<br>登録簿内の補助一覧"]
48
+ PM_GEN["controls/generated<br>controls 全体の派生管理ビュー"]
49
+
50
+ PJR_ITEM --> PJR_IDX
51
+ PJR_ITEM --> PJR_GEN
52
+ PJR_ITEM --> PM_GEN
53
+
54
+ classDef target stroke-width:4px
55
+ class PJR_ITEM target
56
+ ```
57
+
58
+ 登録簿の初期生成には `register scaffold` を使います。
59
+
60
+ ```bash
61
+ specdojo register scaffold --project <project-id>
62
+ ```
63
+
64
+ ### 1.2. 登録の判断基準
65
+
66
+ 次のいずれかに当てはまる事項は、その場で処理せず登録簿に登録します。
67
+
68
+ - 会議、レビュー指摘、作業中の気づき、外部からの依頼のうち、後で対応・確認・判断が必要なもの
69
+ - プロジェクト立ち上げ時に、目的・スコープ・対象成果物を決めるために調査または判断が必要なもの
70
+ - 「誰かが覚えている」状態になっており、担当と期限を付けて追跡したいもの
71
+ - すぐに結論が出ず、経緯や判断理由を後から参照する可能性があるもの
72
+
73
+ 逆に、次の事項は登録しません。
74
+
75
+ - 計画済みの成果物作成・レビュー・確定の作業(schedule のタスクとして管理する)
76
+ - 成果物カタログへ定義し、Scheduleへ展開済みの作業(立ち上げ時の個票は結論を残して完了する)
77
+ - その場で完了し、後から追跡する必要がないもの
78
+
79
+ 登録は `register add` で行います。ID は省略すると自動採番されます。
80
+
81
+ ```bash
82
+ specdojo register add --project <project-id> --type todo --title "在庫初期データの登録"
83
+ ```
84
+
85
+ `--priority` は次の目安で付けます(省略時は `medium`)。
86
+
87
+ | priority | 目安 |
88
+ | -------- | -------------------------------- |
89
+ | `high` | 放置すると他の作業や判断が止まる |
90
+ | `medium` | 期限までに対応が必要 |
91
+ | `low` | 影響が限定的で、後回しにできる |
92
+
93
+ ### 1.3. type の選び方
94
+
95
+ 値の一覧と個票 frontmatter の定義は [プロジェクト登録簿 作成ルール](../rulebooks/pjr-rulebook.md) と `register-item-frontmatter.schema.yaml` を正本とします。各 type の意味と、迷ったときの判断基準は次のとおりです。
96
+
97
+ | type | 意味 | 迷ったとき |
98
+ | ---------------- | ------------------------------------ | ----------------------------------------------------------------------------------------------------------- |
99
+ | `todo` | 実施が決まっている作業 | 変更判断を伴うなら `change-request`、外部待ちは `todo`/`issue` に登録し `register wait` で `waiting` にする |
100
+ | `question` | 回答・確認が必要な事項 | 共有だけでよいなら `note`、選択肢を決める判断なら `decision` |
101
+ | `risk` | まだ顕在化していない懸念 | すでに発生している問題なら `issue` |
102
+ | `issue` | 顕在化している問題 | 未発生の懸念なら `risk` |
103
+ | `change-request` | 成果物・仕様・計画に対する変更の要望 | 実施が確定済みの作業なら `todo` |
104
+ | `decision` | 記録・追跡する意思決定 | 判断材料が足りず確認が先なら `question` |
105
+ | `note` | 共有・備忘のための記録 | 回答や結論が必要なら `question` |
106
+
107
+ 外部の対応・提供物への依存(外部待ち)には専用 type を設けない。対応が必要なら `todo` / `issue` として登録し、外部待ちで止まっている状態は `register wait` の `waiting` ステータスで表す。計画上の前提・制約・依存関係は `prj-assumptions-constraints-dependencies` 成果物へ整理する。
108
+
109
+ type は派生ビューの生成と `exec run --register` の挙動(`agent実行・定期実行との連携` を参照)に影響するため、内容が変質した場合は `register update` で見直します。
110
+
111
+ ## 2. 登録項目のライフサイクル
112
+
113
+ 登録から完了までの状態遷移、個票の扱い、完了時の記録、派生ビューを示します。
114
+
115
+ ### 2.1. 状態遷移とコマンド
116
+
117
+ 登録項目の状態はコマンドで遷移させます。手で status セルを書き換えるより、遷移ガードの効くコマンドを優先します。
118
+
119
+ | 場面 | コマンド | 遷移後の状態 |
120
+ | ------------------------ | ----------------- | --------------------------------------------------------------------- |
121
+ | 登録する | `register add` | `open` |
122
+ | 着手する | `register start` | `in-progress` |
123
+ | 他者・外部の対応を待つ | `register wait` | `waiting` |
124
+ | 確認・レビューに回す | `register review` | `review` |
125
+ | 完了する | `register close` | `done`(`decision` / `question` は `decided`。`note` は終端させない) |
126
+ | 対応しないと判断する | `register reject` | `rejected` |
127
+ | 延期する | `register defer` | `deferred` |
128
+ | 終了済み項目を再開する | `register reopen` | `open` |
129
+ | 担当・期限などを変更する | `register update` | (状態は変えずフィールドを更新) |
130
+
131
+ - 担当や期限が未定のまま登録する場合は、空欄ではなく _TODO_ のままにしておき、決まり次第 `register update` で埋めます。
132
+ - 起票と完了は「日付」ではなく「瞬間」として記録します。個票 Frontmatter の `registered_at` / `completed_at` に UTC の RFC 3339・秒精度(例: `2026-08-09T14:08:51Z`)で保存し、`register add` / `register close` / `register reject` が実行時刻を自動記入します。`register reopen` は `completed_at` を削除します。
133
+ - 一覧の「登録日」「完了日」は、保存した日時を config の `run.register_date_timezone`(IANA タイムゾーン名、既定 `UTC`)へ変換して導出する表示値です。個票側に日付を持たないため、表示タイムゾーンを変えても記録は書き換わりません。ID が乱数化され採番順から起票順を追えないため、登録日時は起票順を辿る手がかりになります。過去の項目で時刻が不明な場合は値を推測せず、キーを省略します。
134
+ - 「期限」(`due_on`)は瞬間ではなく同タイムゾーン上の暦日そのものなので、`YYYY-MM-DD` のまま扱います。
135
+ - 日時の計算は OS / コンテナの `TZ` 環境変数に依存させません。日本時間で表示・運用する場合は次のように設定します。
136
+
137
+ ```json
138
+ {
139
+ "projects": {
140
+ "prj-0001": {
141
+ "run": { "register_date_timezone": "Asia/Tokyo" }
142
+ }
143
+ }
144
+ }
145
+ ```
146
+
147
+ - 状態遷移は `open` から終端まで順に辿る必要はありません。人が対応した項目や、対話型 orchestrator がその場で処理した項目は、`start` を経ずに `close` / `reject` して構いません。着手を記録していない時点の遷移を後から補うと、実際には起きていない事実がイベントログに残ります。詳しい基準は [プロジェクト登録簿 作成ルール](../rulebooks/pjr-rulebook.md) の `中間状態を経ない終端` を参照します。
148
+ - 直接終端させる場合は、誰がどの経路で対応したかを `register close --by <actor> --reason "<経路と根拠>"` で残します。exec 経由でないため plan / result / evidence が生成されず、実施内容と検証結果は個票の対応結果が唯一の記録になります。
149
+ - agent へ実行させる項目は `exec run --register` を使います。この経路では runner が `start` と `wait` / `review` を記録し、plan / result / evidence も残ります。着手の記録が要る項目は、この経路を選びます。
150
+ - 動いていない `open` や期限切れの項目は放置せず、期限の更新、優先度の見直し、`defer` / `reject` のいずれかへ整理します。ただし `note` の `open` は生きている記録を意味し、終端させません。対応・回答・判断が必要になった場合は、目的に合う別項目を起票します。
151
+ - `waiting` へ移す理由は `register wait --reason "<理由>"` で個票 Frontmatter の `block_reason` に記録します。これは途中経過であり、終端時の結論を表す `conclusion` は変更しません。旧 `--conclusion` も互換性のため受け付けますが、記録先は `block_reason` です。
152
+
153
+ すべての登録項目は個票(`pjr-XXXX-<topic>.md`)を持ちます。`close` / `reject` は処理状態の遷移とあわせて個票 Frontmatter の `status`(文書成熟度)も更新します。処理状態とは別の状態軸であり、遷移基準は [プロジェクト登録簿 作成ルール](../rulebooks/pjr-rulebook.md) の `個票 status の遷移基準` を正本とします。
154
+
155
+ | コマンド | 個票 `status` の遷移 | 条件 |
156
+ | ----------------- | -------------------- | -------------------------------------------------------------------------- |
157
+ | `register close` | `draft` → `ready` | 必須節に `_TODO_` が残っていないこと(残る場合は昇格せず警告して据え置く) |
158
+ | `register reject` | → `deprecated` | 条件なし |
159
+
160
+ - 変更前に確認したい場合は `--dry-run` を付けると、個票 Frontmatter の変更予定と再生成されるビューを表示します。
161
+
162
+ ### 2.2. 個票の作成
163
+
164
+ すべての登録項目は、type 別のテンプレート(`pjr-todo-template.md` など `pjr-<type>-template.md`)から作る個票です。`register add` は個票の Frontmatter に構造化フィールドを書き込み、H1 と本文にタイトル・説明を置きます。
165
+
166
+ ```bash
167
+ specdojo register add \
168
+ --project <project-id> \
169
+ --type risk \
170
+ --title "タブレット故障時の営業継続" \
171
+ --topic tablet-failure-fallback
172
+ ```
173
+
174
+ 個票を作成後、タイトル・説明・構造化フィールドを変更する場合も個票を正本として扱います。生成一覧へ直接追記・修正しません。
175
+
176
+ ### 2.3. 完了時の記録
177
+
178
+ `close` / `reject` / `defer` するときは、完了日時と結論を残します。結論は「何をどう判断したか」が 1 文で分かる形にします。
179
+
180
+ ```bash
181
+ specdojo register close \
182
+ --project <project-id> \
183
+ --id PJR-0005 \
184
+ --conclusion "取消処理で在庫数を戻すよう修正"
185
+ ```
186
+
187
+ - `done` / `decided`: 対応内容または決定内容を書きます。
188
+ - `rejected`: 却下の理由を書きます。
189
+ - `deferred`: 再開の条件または再評価のタイミングを書きます。
190
+
191
+ `--completed` を省略すると実行時刻を UTC で記録します。後追いで登録する場合だけ、タイムゾーン付きの RFC 3339 で明示します(内部では UTC へ正規化して保存します)。
192
+
193
+ ```bash
194
+ specdojo register close \
195
+ --project <project-id> \
196
+ --id PJR-0005 \
197
+ --completed 2026-08-09T23:08:51+09:00 \
198
+ --conclusion "取消処理で在庫数を戻すよう修正"
199
+ ```
200
+
201
+ タイムゾーンを含まない値(`2026-08-09` や `2026-08-09T23:08:51`)は、解釈が実行環境に依存するため受け付けません。
202
+
203
+ 結論が残っていない終了項目は、後から経緯を追えなくなるため、close 前に埋めます。
204
+
205
+ 状態を変えずに結論だけを補正するときは、個票を直接編集せず次を使います。`-` を指定すると既存の `conclusion` を削除できます。
206
+
207
+ ```bash
208
+ specdojo register update \
209
+ --project <project-id> \
210
+ --id PJR-0005 \
211
+ --conclusion "取消処理で在庫数を戻すよう修正"
212
+ ```
213
+
214
+ 項目の主題が変わり、個票名の topic が実態と合わなくなった場合も、個票を直接移動せず `register update --topic` を使います。まず dry-run で、個票の移動先と旧文書 ID を参照している更新対象を確認します。
215
+
216
+ ```bash
217
+ specdojo register update \
218
+ --project <project-id> \
219
+ --id PJR-0005 \
220
+ --topic inventory-cancellation \
221
+ --reason "取消処理へ主題を変更" \
222
+ --dry-run
223
+
224
+ specdojo register update \
225
+ --project <project-id> \
226
+ --id PJR-0005 \
227
+ --topic inventory-cancellation \
228
+ --reason "取消処理へ主題を変更"
229
+ ```
230
+
231
+ - topic は英小文字・数字を単一ハイフンで区切った slug にします。
232
+ - 個票ファイル名と Frontmatter の文書 ID、`docs/ja` 配下の旧文書 ID 参照を一括更新し、一覧・派生ビューを再生成します。
233
+ - 変更先ファイルが既に存在する場合は、どのファイルも書き換えずに停止します。
234
+ - event は `action: update` とし、`changes` の `id` に変更前後の文書 ID を残します。
235
+
236
+ ### 2.4. 派生ビューの扱い
237
+
238
+ 登録項目一覧と派生ビューは、個票を入力として `register build` で生成します。
239
+
240
+ ```bash
241
+ specdojo register build --project <project-id>
242
+ ```
243
+
244
+ - `project-register/generated/` には登録項目一覧(`pjr-index.md`)と登録簿内の補助一覧(状態別・優先度別・担当者別)が生成されます。
245
+ - 個票の `part_of` と本文のwikilinkが参照する `<project-id>:pjr-index` は、生成された `project-register/generated/pjr-index.md` へ解決されます。
246
+ - `controls/generated/` には controls 全体の type 別管理ビュー(リスク登録簿、課題ログ、変更要求ログ、決定記録)が生成されます。
247
+ - `generated/` 配下は追跡対象外の生成物です。生成ファイルを手編集しても次回の `register build` で失われるため、内容を直したい場合は個票を修正して再生成します。
248
+ - doc-indexは通常の `generated/` を除外しますが、`controls/**/generated/` だけは文書IDの解決対象に含めます。このため `index build` は `register build` の後に実行します。生成一覧が無い状態で `index build` を単独実行すると、未解決IDを残さず明示エラーになります。
249
+ - 行の並びは表示 ID の昇順に固定されます。同じ個票の集合からは常に同じ内容が生成されます。
250
+
251
+ 一覧・派生ビューのテーブルのタイトル行(列名の行)は、コードではなく `pjr-index-template.md` の「登録項目一覧」テーブルのタイトル行をそのまま継承します。列名を変更したい場合は、生成ファイルを直接編集せず、次を修正してから `register build` で再生成します。
252
+
253
+ - 列名の実値: `pjr-index-template.md` のタイトル行
254
+ - 列の追加・削除・改名を伴う規範変更: [プロジェクト登録簿 作成ルール](../rulebooks/pjr-rulebook.md) の「登録項目一覧の標準列」
255
+
256
+ 派生ビューの見出し(`台帳ビュー`、`リスク登録簿` など)や再生成注記は、各派生ビューの雛形(`pjr-views-by-status-template.md`、`pjr-views-by-priority-template.md`、`pjr-views-by-owner-template.md`、`pm-<name>-template.md`)が持つため、そちらを修正して再生成します。
257
+
258
+ ### 2.5. 台帳の変更を追う
259
+
260
+ 個票 Frontmatter が正本になったため、台帳全体の変更を1ファイル(旧 `pjr-index.md`)の差分で追うことはできません。台帳の変化は、目的別に次の手段で追います。
261
+
262
+ | 目的 | 手段 | 操作 |
263
+ | ------------------------------ | ------------------------------------ | ---------------------------------------------------------------------------- |
264
+ | いま台帳がどうなっているか | 生成された一覧・派生ビュー | `register build` で生成した `generated/pjr-index.md` を読む |
265
+ | ある期間に何が起きたか(監査) | `register history` | `specdojo register history --project <project-id> --since <date>` |
266
+ | 変更の妥当性をレビューする | pull request の個票 Frontmatter 差分 | PR の Files changed で `project-register/pjr-*.md` の Frontmatter を確認する |
267
+ | 1つの項目の経緯を追う | `register history` の ID 指定 | `specdojo register history --project <project-id> --id <PJR-ID>` |
268
+
269
+ `register history` は `events/pjr-XXXX.yaml` の追記型 event から項目単位の変更を古い順に再構成します。event 導入前または event 未移行の個票だけは Git 履歴へフォールバックします。比較する項目は登録項目一覧の列(ステータス・タイトル・説明・分類・優先度・担当・登録日・期限・完了日・結論)と `block_reason` です。登録日・完了日は保存された日時を `run.register_date_timezone` の暦日へ変換した表示値で比較します。
270
+
271
+ ```bash
272
+ # 期間を指定して台帳の変化を一覧する
273
+ specdojo register history --project <project-id> --since 2026-08-01 --until 2026-08-31
274
+
275
+ # 追加・削除・状態遷移だけに絞る(月次レビューや監査向け)
276
+ specdojo register history --project <project-id> --since 2026-08-01 --status-only
277
+
278
+ # 特定の項目の経緯だけを追う
279
+ specdojo register history --project <project-id> --id PJR-0012 PJR-0013
280
+
281
+ # 集計・証跡化する場合は JSON で出力する
282
+ specdojo register history --project <project-id> --since 2026-08-01 --json
283
+ ```
284
+
285
+ 出力は「発生日時・短縮イベント ID・項目 ID・種別(`added` / `updated`)・変更内容・action / actor / reason」を並べた 1 行 1 イベントです。Git 互換履歴は従来どおり短縮 commit と commit 件名を表示し、削除済み個票を `removed` として扱います。
286
+
287
+ ```text
288
+ 2026-08-01T00:00:00Z reg_ab1 PJR-0012 added status=open, title=在庫初期データの登録, type=todo, priority=high, owner=PM # add by PM: item added
289
+ 2026-08-09T08:20:00Z reg_cd2 PJR-0012 updated status: review -> done; completed: - -> 2026-08-09 # close by PO: accepted
290
+ ```
291
+
292
+ - `register add`、状態遷移、`register update`、`register renumber` は、現在値を個票へ、event を項目別イベントファイルへ書き込みます。`--by` と `--reason` を指定すると actor と理由を明示できます。
293
+ - 一覧の列に現れない変更(対応結果本文の追記、個票 `status` の昇格など)は event になりません。個票の全差分が必要な場合は `git log -p` を使います。
294
+ - `--status-only` は追加・削除・状態遷移だけを残し、変更内容も遷移に関わる項目(`status` / `type` / `completed` / `conclusion`)へ絞ります。
295
+ - `renumber` による ID 付け替えは、`id` の変更を含む `updated` イベントとして現れます。
296
+ - 複数の遷移を1コミットへまとめたり squash したりしても、項目別イベントファイルに残る各 event の発生日時・actor・変更内容は失われません。`register start` を含む遷移時の commit policy は別の運用判断です。
297
+ - 個票とイベントログはそれぞれ一時ファイルを同一ディレクトリで完成させてから置換します。同じ現在値への再実行は event を増やさず、`register build` がファイルの 1 対 1 対応、イベント ID・直前参照・状態連鎖・最新状態を検証するため、中断による片側だけの更新も検出できます。
298
+ - 異なる項目の並行実行は別の個票とイベントファイルへ書くため共有ログ競合を起こしません。同じ項目を複数 worktree で変更した場合は項目別イベントファイルの競合として統合を止め、片方の event を削除せず再実行または手動統合します。
299
+ - exec event と共通化するのは UTC 秒精度、version、actor、reason、追記・検証の原則です。exec は task state の SSOT で 1 event 1 JSON、Register は現在値を個票に維持し項目別 YAML 配列を監査履歴とするため、保存形式と fold 処理は共通化しません。
300
+ - 生成物(`generated/` 配下)は追跡対象外のため、PR の差分にも Git 履歴にも現れません。レビュー対象は個票と `events/` 配下の項目別ログです。
301
+ - 既存プロジェクトは移行前でも動作し、event のない個票は Git 履歴から再構成します。`register migrate --dry-run` で件数を確認し、`register migrate` で復元可能な Git 履歴を決定的な event ID へ変換します。浅い clone などで履歴が不足する場合は無理に合成せず Git フォールバックを維持します。
302
+ - 分離前の CLI は `events/` を読まないため、ロールバック時も項目別ログを削除せず、分離対応版の CLI を再適用して履歴を維持します。
303
+ - 個票へ移行する前(`pjr-index.md` の表が正本だった期間)の履歴は、削除済みの一覧ファイルの履歴に残ります。`git log -p --follow -- <登録簿ディレクトリ>/pjr-index.md` で参照します。
304
+
305
+ ### 2.6. 承認フローと承認者
306
+
307
+ 承認を要する type(`change-request` / `decision` / `risk` / `question` / `issue`)について、承認の種類・状態遷移・承認方式・承認者を次のとおり運用します。
308
+
309
+ まず承認には 2 種類があり、混同しません。
310
+
311
+ - 成果物レビュー: agent 生成物の妥当性確認です。exec の `review` 状態と review result、`register close` で成立します。
312
+ - 内容承認: 権限者が判断・変更・対応方針そのものを承認する行為です。チケット個票の「審査・決定」「採択理由」「対応方針」「承認」節が担います。本節が対象とするのは主に内容承認です。
313
+
314
+ 承認は register の状態遷移に沿って進めます。`review` で承認に回し、`close`(`done` / `decided`)・`reject`・`defer`・`wait` のいずれかで終端または保留します。
315
+
316
+ | type | 承認方式(既定) | 承認の状態遷移 | 承認者(RACI の A) |
317
+ | ---------------- | ---------------------------- | ---------------------------------------- | ------------------------ |
318
+ | `change-request` | PR ベース | `review` → PR approve → `close` | 変更承認権限者(PO/CCB) |
319
+ | `decision` | commit ベース | 決定者を承認節に記入し `close`→`decided` | 意思決定者 |
320
+ | `risk` | commit ベース | 対応方針を記入し `close` / `defer` | リスクオーナー |
321
+ | `question` | commit ベース | 回答者を承認節に記入し `close`→`decided` | 回答権限者 |
322
+ | `issue` | commit ベース(exec review) | exec `review` → `close` | 課題リード |
323
+ | `todo` | commit ベース(exec review) | exec `review` → `close` | - |
324
+ | 全 type 共通 | PR ベース | `develop → main` 昇格 | リポジトリ管理者 |
325
+
326
+ - 承認方式は既定 commit とし、PR を強制するのは `develop → main` 昇格 / `change-request` 承認 / 不可逆・高リスク・framework schema 破壊的変更(`todo` / `issue` / `decision` の一部)の 3 ケースに限定します。判定条件は [Git ブランチ運用標準](../standards/git-branching-standard.md) の `承認ゲートと PR 強制条件` を正本とします。
327
+ - 承認者ロール(RACI の A)は pm-raci と整合させ、`change-request` は変更承認権限者(PO/CCB)、`decision` / `question` は当該領域の意思決定者・回答権限者を割り当てます。
328
+ - PR 強制ケースの承認者強制は `main` / `develop` の branch protection と `CODEOWNERS` で担保します。commit ベースの承認は `decision` / `question` 個票の承認節(決定者・決定日 / 回答者・回答日)で承認者と承認日を残します。
329
+ - PR 承認を併用する具体的な運用手順は `PO 留保事項の PR 承認運用` を参照します。
330
+
331
+ ## 3. agent実行・定期実行との連携
332
+
333
+ 登録項目は `exec run --register` で agent に実行させられます。
334
+
335
+ ```bash
336
+ specdojo exec run --project <project-id> --register PJR-0012
337
+
338
+ # 複数項目を指定順に直列実行する(成功IDごとにcommit、途中失敗でも継続)
339
+ specdojo exec run --project <project-id> --register PJR-0012 PJR-0013 --register-commit --on-failure continue
340
+
341
+ # 成果物を worktree に隔離して実行し、統合ブランチへ merge back する
342
+ specdojo exec run --project <project-id> --register PJR-0012 --worktree
343
+
344
+ # worktree 隔離のまま複数項目を並列実行する
345
+ specdojo exec run --project <project-id> --register PJR-0012 PJR-0013 --worktree --parallel 2
346
+ ```
347
+
348
+ - type が `todo` / `issue` / `change-request` の項目は成果物・実装を変更する対応、`question` / `risk` の項目は調査して結論案を result に記録する対応になります。`decision` / `note` は実行対象外です。
349
+ - 状態は register の遷移(`in-progress` / `review` / `waiting`)で追跡され、agent は項目を終端化しません。成功後は人が内容を確認して `register close` します。
350
+ - 個票の「関連ドキュメント」に `[[文書ID]]` 形式で記載された対象成果物は、plan 生成時に直近の自動評価(grade)結果があれば `_GRADE_FINDINGS_` として plan に展開されます。表示は最大10文書・各20件までに制限され、超過分はサイドカーを参照するよう促します。サイドカーがない場合は「finding なし」と表示されます。
351
+ - `--register` には複数の PJR-ID を空白区切り・カンマ区切り(またはその混在)で渡せます。指定順に1件ずつ実行し、各IDが plan/result 生成・開始・agent実行・状態遷移まで完結してから次へ進みます。重複したIDは最初の1件だけを実行します。
352
+ - 全ID処理後にID別の成否・状態遷移・commit 結果を一覧表示します。いずれかが失敗した場合は終了コード 1 で終了します。
353
+ - `--register-commit` を付けると成功IDごとに、その実行で生じた変更だけをcommitします(実行前から作業ツリーにある利用者の変更は含めません)。`--on-failure`(`stop` 既定 / `continue`)で途中失敗時に停止するか継続するかを選びます。`stop` では失敗以降のIDが skipped として記録されます。
354
+ - 既定は in-place の直列実行で、変更は作業ツリーに残ります(`--register-commit` を付けると commit します)。
355
+ - `--worktree` を付けると、成果物の変更を git worktree に隔離して実行し、成功時に統合ブランチへ merge back します。task worktree では root と package-lock 付き独立 package ごとに `npm ci` を実行し、書き込み可能な独立 `node_modules` を準備してから agent を起動します。成功時の `start → review`、plan、result、成果物は `exec(register <PJR-ID>): <title>` の merge commit に同梱され、統合ブランチの first-parent には1項目1commitだけが増えます。失敗時は `start → waiting` と plan / result を `exec(register <PJR-ID>): wait` commit 1件にまとめ、worktree を保持します。`--resume` で再開した場合の `start` 遷移も exec branch 側に記録され、成功時は merge commit 1件、再び失敗した場合は `wait` commit 1件になります。worktree モードは常に commit するため `--register-commit` は無視されます(指定すると注記を表示します)。
356
+ - `--worktree` と併用する場合に限り `--parallel <n>` で複数項目を並列実行できます。状態遷移は直列化され、成果物は項目ごとの worktree に隔離されます。`--parallel` を単独(`--worktree` なし)で指定するとエラーになります。失敗時は当該項目の worktree を保持します(調査・再実行のため)。
357
+ - 実行せずに plan の内容だけ確認したい場合は `exec plan --register <PJR-ID>` を使います。
358
+ - open な項目の定期スイープなど、時刻条件で繰り返す場合は routine(`rtn-*.yaml`)を使います。
359
+
360
+ `--register-commit` は、登録簿の状態遷移・派生ビュー・当該IDの plan/result を runner 管理パスとして commit 対象に含めます。pre-commit hook が対象ファイルを整形した場合は、同じ commit へ収束するまで amend します。収束後も対象差分が残る場合は `incomplete` の失敗として一覧と終了コードへ反映します。既定は無効で、変更は作業ツリーに残ります。
361
+
362
+ 実行前に、過去の register 実行が残した未 commit の plan/result を検出した場合は、現在のIDへ暗黙に混ぜず警告します。警告されたファイルを確認・整理してから再実行してください。
363
+
364
+ 実行フローの詳細は [exec運用ガイド](exec-operation-guide.md) を参照します。
365
+
366
+ ## 4. 例外対応と特殊な運用
367
+
368
+ ID 重複の復旧と PO 留保事項の承認運用など、通常運用から外れる場面を扱います。
369
+
370
+ ### 4.1. PJR-ID 重複の検知と復旧
371
+
372
+ `register add` は既存個票の ID を避けてランダムに採番します。並行起票、rebase、cherry-pick などで重複が混入した場合は、個票の検証と `register build` が検出します。
373
+
374
+ 重複は検証で必ず落ちます。次の検証は VSCode のリアルタイム検証と CI の両方で機能します。
375
+
376
+ ```bash
377
+ npx tsx src/specdojo.ts register build --project <project-id>
378
+ ```
379
+
380
+ - 個票の表示 ID が重複した場合、重複 ID と該当ファイルを示してエラーになります。
381
+ - 個票の Frontmatter ID とファイル名 `pjr-XXXX-<topic>.md` の対応が取れていない場合もエラーになります。
382
+
383
+ 重複や衝突を検出したら、`register renumber` で片方の項目を未使用の PJR-ID へ移します。
384
+
385
+ ```bash
386
+ # まず変更対象を確認する
387
+ specdojo register renumber --project <project-id> --id PJR-0137 --to PJR-0140 --dry-run
388
+
389
+ # 問題なければ適用する
390
+ specdojo register renumber --project <project-id> --id PJR-0137 --to PJR-0140
391
+ ```
392
+
393
+ - 個票ファイル名・個票 Frontmatter の `id`・他文書からの参照リンク・exec plan / result の `targets` を同時に付け替え、一覧・派生ビューを再生成します。
394
+ - 移動先 ID が既に使われている場合は何も書き換えずにエラー終了するため、部分適用は残りません。
395
+ - 付け替え後は派生ビューも再生成されます。移動先 ID は任意の未使用 ID を選べます。自動採番は既存 ID を避けて再抽選するため、以後の採番と衝突する心配はありません。
396
+
397
+ ### 4.2. PO 留保事項の PR 承認運用
398
+
399
+ プロジェクト憲章の権限委譲章で PO の承認を要する事項(PO 留保事項)は、decision 個票の起票だけでなく pull request のレビュー承認を併用します。個票のセル文字列だけでは作成者と承認者が分離されず自己承認になりうるため、承認者・承認日時・承認対象差分を platform 側で担保します。
400
+
401
+ - decision 個票は決定内容の SSOT(背景・選択肢・決定・理由)として、リポジトリ内に恒久保持します。
402
+ - pull request は承認イベント(誰がいつ何を承認したか)の担保に用います。
403
+ - 相互リンク: 個票の承認章に PR URL と merge SHA を本文テキストで記録し、PR 説明には対象 decision 個票の `id` を記載します。PR URL と merge SHA を本文へ転記することで、platform に依存せずリポジトリ内だけで承認事実を追跡できます。
404
+
405
+ 承認フローは次の順で行います。
406
+
407
+ 1. 決定内容を decision 個票へ記録します。
408
+ 2. 承認対象の差分を pull request として作成し、PR 説明に対象個票の `id` を書きます。
409
+ 3. PO が PR をレビューして approve します。作成者自身の承認は職務分離のため承認としてカウントしません。
410
+ 4. merge 後、個票または憲章の承認章へ承認日・承認者・承認対象・証跡リンク(PR URL・merge SHA)を書き戻します。
411
+
412
+ PR 承認が必要な決定範囲(憲章の PO 留保事項)、branch 保護 / CODEOWNERS 方針の詳細は、当該プロジェクトの登録項目(例: `pjr-0126-pr-based-po-approval`)で定義します。schedule 上の計画済みタスクによる通常の成果物更新や日常の agent コミットは、PR 承認の対象外です。
413
+
414
+ ### 4.3. PJR-ID の採番
415
+
416
+ - PJR-ID の乱数部分は、曖昧文字(`I` / `L` / `O` / `U`)を除いた英大文字+数字の 32 文字セットによる 4 桁のランダム値である。例: `PJR-4B7K`。
417
+ - `register add` は現在の作業ツリーに個票を作成し、既存 ID または簡易な不適切語ブロックリストに一致した候補は再抽選する。
418
+ - 統合ブランチへの自動ルーティング、予約起票、同期用オプションは廃止済みである。廃止済みのオプションを指定した場合は未知オプションとしてエラー終了する。