specdojo 0.1.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (540) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +142 -35
  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 +990 -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 +54 -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 +33 -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 +56 -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 +472 -0
  139. package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
  140. package/docs/ja/specdojo/guides/remote-host-development-guide.md +163 -0
  141. package/docs/ja/specdojo/guides/review-guide.md +428 -0
  142. package/docs/ja/specdojo/guides/routine-operation-guide.md +282 -0
  143. package/docs/ja/specdojo/guides/ryu-guide.md +230 -0
  144. package/docs/ja/specdojo/guides/schedule-design-guide.md +429 -0
  145. package/docs/ja/specdojo/guides/schedule-operation-guide.md +151 -0
  146. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +257 -0
  147. package/docs/ja/specdojo/guides/timeline-design-guide.md +160 -0
  148. package/docs/ja/specdojo/guides/track-design-guide.md +215 -0
  149. package/docs/ja/specdojo/guides/use-case-guide.md +133 -0
  150. package/docs/ja/specdojo/guides/waza-guide.md +224 -0
  151. package/docs/ja/specdojo/index.md +33 -0
  152. package/docs/ja/specdojo/philosophy/needs-to-implementation-philosophy.md +212 -0
  153. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +242 -0
  154. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +198 -0
  155. package/docs/ja/specdojo/recipes/cdfd-recipe.md +218 -0
  156. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +198 -0
  157. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +100 -0
  158. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +148 -0
  159. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +97 -0
  160. package/docs/ja/specdojo/recipes/pm-members-recipe.md +149 -0
  161. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +96 -0
  162. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +98 -0
  163. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +97 -0
  164. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +96 -0
  165. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +136 -0
  166. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +162 -0
  167. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +187 -0
  168. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +235 -0
  169. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +205 -0
  170. package/docs/ja/specdojo/recipes/prj-overview-recipe.md +289 -0
  171. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +201 -0
  172. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +168 -0
  173. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +179 -0
  174. package/docs/ja/specdojo/recipes/stsd-recipe.md +138 -0
  175. package/docs/ja/specdojo/references/command-reference.md +718 -0
  176. package/docs/ja/specdojo/references/deliverables-reference.md +407 -0
  177. package/docs/ja/specdojo/references/directory-layout-reference.md +280 -0
  178. package/docs/ja/specdojo/references/specdojo-config-reference.md +133 -0
  179. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +372 -0
  180. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +302 -0
  181. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +331 -0
  182. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +134 -0
  183. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +207 -0
  184. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +102 -0
  185. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +131 -0
  186. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +269 -0
  187. package/docs/ja/specdojo/rulebooks/br-rulebook.md +187 -0
  188. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +279 -0
  189. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +219 -0
  190. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +233 -0
  191. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +182 -0
  192. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +171 -0
  193. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +105 -0
  194. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +195 -0
  195. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +285 -0
  196. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +292 -0
  197. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +171 -0
  198. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +325 -0
  199. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +266 -0
  200. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +294 -0
  201. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +21 -0
  202. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +401 -0
  203. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +311 -0
  204. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +158 -0
  205. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +287 -0
  206. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +62 -0
  207. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +100 -0
  208. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +298 -0
  209. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +379 -0
  210. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +310 -0
  211. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +86 -0
  212. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +297 -0
  213. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +79 -0
  214. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +213 -0
  215. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +311 -0
  216. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +94 -0
  217. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +81 -0
  218. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +117 -0
  219. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +118 -0
  220. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +116 -0
  221. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +116 -0
  222. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +116 -0
  223. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +421 -0
  224. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +307 -0
  225. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +312 -0
  226. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +63 -0
  227. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +353 -0
  228. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +184 -0
  229. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +179 -0
  230. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +184 -0
  231. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +183 -0
  232. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +185 -0
  233. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +185 -0
  234. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +186 -0
  235. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +186 -0
  236. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +184 -0
  237. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +61 -0
  238. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +84 -0
  239. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +357 -0
  240. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +80 -0
  241. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +484 -0
  242. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +120 -0
  243. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +293 -0
  244. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +211 -0
  245. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +94 -0
  246. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +116 -0
  247. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +93 -0
  248. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +190 -0
  249. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +108 -0
  250. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +122 -0
  251. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +117 -0
  252. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +116 -0
  253. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +93 -0
  254. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +146 -0
  255. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +65 -0
  256. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +178 -0
  257. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +232 -0
  258. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +235 -0
  259. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +242 -0
  260. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +187 -0
  261. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +201 -0
  262. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +165 -0
  263. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +165 -0
  264. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +202 -0
  265. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +139 -0
  266. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +63 -0
  267. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +93 -0
  268. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +93 -0
  269. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +329 -0
  270. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +297 -0
  271. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +132 -0
  272. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +215 -0
  273. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +376 -0
  274. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +313 -0
  275. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +246 -0
  276. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +119 -0
  277. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +188 -0
  278. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +114 -0
  279. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +117 -0
  280. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +101 -0
  281. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +103 -0
  282. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +396 -0
  283. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +207 -0
  284. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +387 -0
  285. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +303 -0
  286. package/docs/ja/specdojo/samples/atc-index-sample.md +38 -0
  287. package/docs/ja/specdojo/samples/atc-sample.md +41 -0
  288. package/docs/ja/specdojo/samples/bac-sample.md +38 -0
  289. package/docs/ja/specdojo/samples/bdd-sample.yaml +71 -0
  290. package/docs/ja/specdojo/samples/bds-sample.md +38 -0
  291. package/docs/ja/specdojo/samples/bes-index-sample.md +38 -0
  292. package/docs/ja/specdojo/samples/bes-sample.md +38 -0
  293. package/docs/ja/specdojo/samples/bps-sample.md +38 -0
  294. package/docs/ja/specdojo/samples/br-sample.md +40 -0
  295. package/docs/ja/specdojo/samples/ccd-sample.md +38 -0
  296. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +284 -0
  297. package/docs/ja/specdojo/samples/cdfd-sample.md +229 -0
  298. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +146 -0
  299. package/docs/ja/specdojo/samples/cdsd-sample.md +38 -0
  300. package/docs/ja/specdojo/samples/cld-sample.md +38 -0
  301. package/docs/ja/specdojo/samples/cnd-sample.md +38 -0
  302. package/docs/ja/specdojo/samples/cop-index-sample.md +38 -0
  303. package/docs/ja/specdojo/samples/cop-sample.md +38 -0
  304. package/docs/ja/specdojo/samples/cpd-sample.md +38 -0
  305. package/docs/ja/specdojo/samples/cstd-sample.md +11 -0
  306. package/docs/ja/specdojo/samples/cxd-sample.md +38 -0
  307. package/docs/ja/specdojo/samples/dct-index-sample.yaml +39 -0
  308. package/docs/ja/specdojo/samples/dct-sample.yaml +91 -0
  309. package/docs/ja/specdojo/samples/dec-sample.md +39 -0
  310. package/docs/ja/specdojo/samples/dmd-index-sample.md +50 -0
  311. package/docs/ja/specdojo/samples/dmd-sample.md +74 -0
  312. package/docs/ja/specdojo/samples/etc-index-sample.md +38 -0
  313. package/docs/ja/specdojo/samples/etc-sample.md +38 -0
  314. package/docs/ja/specdojo/samples/gl-sample.yaml +37 -0
  315. package/docs/ja/specdojo/samples/ifd-sample.md +38 -0
  316. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +102 -0
  317. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +107 -0
  318. package/docs/ja/specdojo/samples/ifx-file-sample.md +38 -0
  319. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +89 -0
  320. package/docs/ja/specdojo/samples/imp-business-sample.md +66 -0
  321. package/docs/ja/specdojo/samples/imp-data-sample.md +60 -0
  322. package/docs/ja/specdojo/samples/imp-interface-sample.md +60 -0
  323. package/docs/ja/specdojo/samples/imp-operations-sample.md +60 -0
  324. package/docs/ja/specdojo/samples/imp-test-sample.md +60 -0
  325. package/docs/ja/specdojo/samples/itc-index-sample.md +38 -0
  326. package/docs/ja/specdojo/samples/itc-sample.md +38 -0
  327. package/docs/ja/specdojo/samples/mip-index-sample.md +38 -0
  328. package/docs/ja/specdojo/samples/mm-sample.md +35 -0
  329. package/docs/ja/specdojo/samples/mtp-sample.md +38 -0
  330. package/docs/ja/specdojo/samples/nfr-availability-sample.md +38 -0
  331. package/docs/ja/specdojo/samples/nfr-index-sample.md +38 -0
  332. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +38 -0
  333. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +38 -0
  334. package/docs/ja/specdojo/samples/nfr-operations-sample.md +38 -0
  335. package/docs/ja/specdojo/samples/nfr-performance-sample.md +38 -0
  336. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +38 -0
  337. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +38 -0
  338. package/docs/ja/specdojo/samples/nfr-usability-sample.md +38 -0
  339. package/docs/ja/specdojo/samples/ntp-sample.md +38 -0
  340. package/docs/ja/specdojo/samples/opd-access-control-sample.md +29 -0
  341. package/docs/ja/specdojo/samples/opd-incident-management-sample.md +31 -0
  342. package/docs/ja/specdojo/samples/opd-index-sample.md +41 -0
  343. package/docs/ja/specdojo/samples/opd-monitoring-sample.md +32 -0
  344. package/docs/ja/specdojo/samples/opd-sample.md +38 -0
  345. package/docs/ja/specdojo/samples/opr-access-control-sample.md +24 -0
  346. package/docs/ja/specdojo/samples/opr-backup-restore-sample.md +27 -0
  347. package/docs/ja/specdojo/samples/opr-batch-sample.md +23 -0
  348. package/docs/ja/specdojo/samples/opr-change-sample.md +24 -0
  349. package/docs/ja/specdojo/samples/opr-incident-sample.md +38 -0
  350. package/docs/ja/specdojo/samples/opr-index-sample.md +43 -0
  351. package/docs/ja/specdojo/samples/opr-monitoring-sample.md +27 -0
  352. package/docs/ja/specdojo/samples/opr-sample.md +38 -0
  353. package/docs/ja/specdojo/samples/opr-support-sample.md +23 -0
  354. package/docs/ja/specdojo/samples/otp-index-sample.md +66 -0
  355. package/docs/ja/specdojo/samples/otp-sample.md +68 -0
  356. package/docs/ja/specdojo/samples/pm-change-request-log-sample.md +47 -0
  357. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +46 -0
  358. package/docs/ja/specdojo/samples/pm-issue-log-sample.md +45 -0
  359. package/docs/ja/specdojo/samples/pm-members-sample.yaml +103 -0
  360. package/docs/ja/specdojo/samples/pm-organization-sample.md +46 -0
  361. package/docs/ja/specdojo/samples/pm-plan-sample.md +57 -0
  362. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +52 -0
  363. package/docs/ja/specdojo/samples/pm-raci-sample.md +57 -0
  364. package/docs/ja/specdojo/samples/pm-risk-register-sample.md +43 -0
  365. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +41 -0
  366. package/docs/ja/specdojo/samples/pr-sample.md +39 -0
  367. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +57 -0
  368. package/docs/ja/specdojo/samples/prj-charter-sample.md +121 -0
  369. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +105 -0
  370. package/docs/ja/specdojo/samples/prj-issues-and-approach-sample.md +78 -0
  371. package/docs/ja/specdojo/samples/prj-overview-sample.md +95 -0
  372. package/docs/ja/specdojo/samples/prj-scope-sample.md +71 -0
  373. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +60 -0
  374. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +62 -0
  375. package/docs/ja/specdojo/samples/sac-sample.md +38 -0
  376. package/docs/ja/specdojo/samples/sf-index-sample.md +38 -0
  377. package/docs/ja/specdojo/samples/sf-sample.md +38 -0
  378. package/docs/ja/specdojo/samples/sld-sample.md +38 -0
  379. package/docs/ja/specdojo/samples/stc-index-sample.md +38 -0
  380. package/docs/ja/specdojo/samples/stc-sample.md +38 -0
  381. package/docs/ja/specdojo/samples/stsd-sample.md +58 -0
  382. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +38 -0
  383. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +38 -0
  384. package/docs/ja/specdojo/samples/sysd-index-sample.md +38 -0
  385. package/docs/ja/specdojo/samples/trc-requirements-to-specs-sample.md +56 -0
  386. package/docs/ja/specdojo/samples/trc-requirements-to-tests-sample.md +56 -0
  387. package/docs/ja/specdojo/samples/tsd-index-sample.md +29 -0
  388. package/docs/ja/specdojo/samples/tsd-sample.md +38 -0
  389. package/docs/ja/specdojo/samples/tsp-index-sample.md +38 -0
  390. package/docs/ja/specdojo/samples/uis-sample.md +38 -0
  391. package/docs/ja/specdojo/samples/utc-index-sample.md +38 -0
  392. package/docs/ja/specdojo/samples/utc-sample.md +38 -0
  393. package/docs/ja/specdojo/schemas/v1/guide-content.schema.yaml +20 -0
  394. package/docs/ja/specdojo/schemas/v1/philosophy-content.schema.yaml +21 -0
  395. package/docs/ja/specdojo/schemas/v1/reference-content.schema.yaml +21 -0
  396. package/docs/ja/specdojo/standards/document-metadata-standard.md +323 -0
  397. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +75 -0
  398. package/docs/ja/specdojo/standards/git-branching-standard.md +227 -0
  399. package/docs/ja/specdojo/standards/guide-authoring-standard.md +124 -0
  400. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +929 -0
  401. package/docs/ja/specdojo/standards/job-definition-standard.md +148 -0
  402. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +431 -0
  403. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +113 -0
  404. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +143 -0
  405. package/docs/ja/specdojo/standards/reference-authoring-standard.md +99 -0
  406. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +140 -0
  407. package/docs/ja/specdojo/standards/sample-authoring-standard.md +151 -0
  408. package/docs/ja/specdojo/standards/standard-authoring-standard.md +108 -0
  409. package/docs/ja/specdojo/standards/template-authoring-standard.md +101 -0
  410. package/docs/ja/specdojo/standards/test-document-scope-standard.md +176 -0
  411. package/docs/ja/specdojo/templates/cdfd-overview-template.md +199 -0
  412. package/docs/ja/specdojo/templates/cdfd-template.md +173 -0
  413. package/docs/ja/specdojo/templates/cdfd-uc-template.md +148 -0
  414. package/docs/ja/specdojo/templates/dct-architecture-template.yaml +136 -0
  415. package/docs/ja/specdojo/templates/dct-business-acceptance-criteria-template.yaml +34 -0
  416. package/docs/ja/specdojo/templates/dct-business-model-bes-template.yaml +75 -0
  417. package/docs/ja/specdojo/templates/dct-business-model-bps-template.yaml +49 -0
  418. package/docs/ja/specdojo/templates/dct-business-model-br-template.yaml +50 -0
  419. package/docs/ja/specdojo/templates/dct-data-flow-template.yaml +40 -0
  420. package/docs/ja/specdojo/templates/dct-data-model-bdd-template.yaml +46 -0
  421. package/docs/ja/specdojo/templates/dct-data-model-ccd-template.yaml +46 -0
  422. package/docs/ja/specdojo/templates/dct-data-model-cdsd-template.yaml +41 -0
  423. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +38 -0
  424. package/docs/ja/specdojo/templates/dct-data-model-sld-template.yaml +38 -0
  425. package/docs/ja/specdojo/templates/dct-data-model-stsd-template.yaml +46 -0
  426. package/docs/ja/specdojo/templates/dct-external-interface-specs-template.yaml +114 -0
  427. package/docs/ja/specdojo/templates/dct-glossary-template.yaml +35 -0
  428. package/docs/ja/specdojo/templates/dct-impact-analysis-template.yaml +138 -0
  429. package/docs/ja/specdojo/templates/dct-index-template.md +40 -0
  430. package/docs/ja/specdojo/templates/dct-migration-planning-template.yaml +148 -0
  431. package/docs/ja/specdojo/templates/dct-non-functional-requirements-template.yaml +222 -0
  432. package/docs/ja/specdojo/templates/dct-operations-template.yaml +108 -0
  433. package/docs/ja/specdojo/templates/dct-project-definition-template.yaml +210 -0
  434. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +423 -0
  435. package/docs/ja/specdojo/templates/dct-system-acceptance-criteria-template.yaml +37 -0
  436. package/docs/ja/specdojo/templates/dct-system-design-template.yaml +82 -0
  437. package/docs/ja/specdojo/templates/dct-system-functions-template.yaml +58 -0
  438. package/docs/ja/specdojo/templates/dct-test-specs-template.yaml +261 -0
  439. package/docs/ja/specdojo/templates/dct-user-interface-model-template.yaml +60 -0
  440. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +88 -0
  441. package/docs/ja/specdojo/templates/opr-template.md +85 -0
  442. package/docs/ja/specdojo/templates/pjr-change-request-template.md +60 -0
  443. package/docs/ja/specdojo/templates/pjr-decision-template.md +61 -0
  444. package/docs/ja/specdojo/templates/pjr-index-template.md +49 -0
  445. package/docs/ja/specdojo/templates/pjr-issue-template.md +50 -0
  446. package/docs/ja/specdojo/templates/pjr-note-template.md +35 -0
  447. package/docs/ja/specdojo/templates/pjr-question-template.md +53 -0
  448. package/docs/ja/specdojo/templates/pjr-risk-template.md +49 -0
  449. package/docs/ja/specdojo/templates/pjr-todo-template.md +41 -0
  450. package/docs/ja/specdojo/templates/pjr-views-by-owner-template.md +22 -0
  451. package/docs/ja/specdojo/templates/pjr-views-by-priority-template.md +22 -0
  452. package/docs/ja/specdojo/templates/pjr-views-by-status-template.md +22 -0
  453. package/docs/ja/specdojo/templates/pm-change-request-log-template.md +20 -0
  454. package/docs/ja/specdojo/templates/pm-communication-plan-template.md +46 -0
  455. package/docs/ja/specdojo/templates/pm-decision-log-template.md +20 -0
  456. package/docs/ja/specdojo/templates/pm-issue-log-template.md +20 -0
  457. package/docs/ja/specdojo/templates/pm-members-template.yaml +105 -0
  458. package/docs/ja/specdojo/templates/pm-organization-template.md +44 -0
  459. package/docs/ja/specdojo/templates/pm-plan-template.md +52 -0
  460. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +46 -0
  461. package/docs/ja/specdojo/templates/pm-raci-template.md +51 -0
  462. package/docs/ja/specdojo/templates/pm-risk-register-template.md +20 -0
  463. package/docs/ja/specdojo/templates/pm-roles-template.yaml +53 -0
  464. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +59 -0
  465. package/docs/ja/specdojo/templates/prj-charter-template.md +116 -0
  466. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +116 -0
  467. package/docs/ja/specdojo/templates/prj-issues-and-approach-template.md +89 -0
  468. package/docs/ja/specdojo/templates/prj-overview-template.md +85 -0
  469. package/docs/ja/specdojo/templates/prj-scope-template.md +75 -0
  470. package/docs/ja/specdojo/templates/prj-stakeholder-register-template.md +64 -0
  471. package/docs/ja/specdojo/templates/prj-success-criteria-and-acceptance-criteria-template.md +60 -0
  472. package/docs/ja/specdojo/templates/stsd-template.md +57 -0
  473. package/docs/specdojo/schemas/v1/bdd.schema.yaml +230 -0
  474. package/docs/specdojo/schemas/v1/common-frontmatter.schema.yaml +77 -0
  475. package/docs/specdojo/schemas/v1/dct-index.schema.yaml +85 -0
  476. package/docs/specdojo/schemas/v1/dct-plan.schema.yaml +324 -0
  477. package/docs/specdojo/schemas/v1/dct.schema.yaml +368 -0
  478. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +91 -0
  479. package/docs/specdojo/schemas/v1/esil.schema.yaml +142 -0
  480. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +101 -0
  481. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +272 -0
  482. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +162 -0
  483. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +126 -0
  484. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +151 -0
  485. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +144 -0
  486. package/docs/specdojo/schemas/v1/grade-done-criteria.schema.yaml +79 -0
  487. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +60 -0
  488. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +118 -0
  489. package/docs/specdojo/schemas/v1/guide-frontmatter.schema.yaml +19 -0
  490. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +293 -0
  491. package/docs/specdojo/schemas/v1/job-run.schema.yaml +90 -0
  492. package/docs/specdojo/schemas/v1/job.schema.yaml +198 -0
  493. package/docs/specdojo/schemas/v1/philosophy-frontmatter.schema.yaml +19 -0
  494. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +56 -0
  495. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +252 -0
  496. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +387 -0
  497. package/docs/specdojo/schemas/v1/pm-roles.schema.yaml +106 -0
  498. package/docs/specdojo/schemas/v1/recipe-frontmatter.schema.yaml +27 -0
  499. package/docs/specdojo/schemas/v1/reference-frontmatter.schema.yaml +18 -0
  500. package/docs/specdojo/schemas/v1/register-events.schema.yaml +106 -0
  501. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +204 -0
  502. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +36 -0
  503. package/docs/specdojo/schemas/v1/routine.schema.yaml +87 -0
  504. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +61 -0
  505. package/docs/specdojo/schemas/v1/sch-common.schema.yaml +258 -0
  506. package/docs/specdojo/schemas/v1/sch-defaults.schema.yaml +48 -0
  507. package/docs/specdojo/schemas/v1/sch-milestones.schema.yaml +64 -0
  508. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +772 -0
  509. package/docs/specdojo/schemas/v1/sch-track.schema.yaml +66 -0
  510. package/docs/specdojo/schemas/v1/standard-frontmatter.schema.yaml +18 -0
  511. package/docs/specdojo/schemas/v1/tml-index.schema.yaml +103 -0
  512. package/package.json +121 -24
  513. package/templates/antigravity/README.md +35 -0
  514. package/templates/antigravity/exec-defaults-snippet.yaml +38 -0
  515. package/templates/antigravity/orchestrator.md +146 -0
  516. package/templates/antigravity/pm-members-snippet.yaml +55 -0
  517. package/templates/claude/README.md +46 -0
  518. package/templates/claude/agents/claude-expert-review-executor.md +14 -0
  519. package/templates/claude/agents/claude-review-executor.md +14 -0
  520. package/templates/claude/agents/specdojo-orchestrator.md +153 -0
  521. package/templates/claude/settings.edit.json +6 -0
  522. package/templates/claude/settings.report.json +6 -0
  523. package/templates/claude/settings.review.json +7 -0
  524. package/templates/codex/README.md +61 -0
  525. package/templates/codex/agents/codex-executor.toml +12 -0
  526. package/templates/codex/agents/codex-expert-executor.toml +12 -0
  527. package/templates/codex/agents/codex-expert-review-executor.toml +10 -0
  528. package/templates/codex/agents/codex-review-executor.toml +10 -0
  529. package/templates/codex/agents/specdojo-orchestrator.toml +154 -0
  530. package/templates/codex/orchestrator.md +146 -0
  531. package/templates/copilot/README.md +41 -0
  532. package/templates/copilot/exec-defaults-snippet.yaml +28 -0
  533. package/templates/copilot/pm-members-snippet.yaml +44 -0
  534. package/templates/opencode/README.md +41 -0
  535. package/templates/opencode/agents/opencode-executor.md +59 -0
  536. package/templates/opencode/agents/opencode-reporter.md +26 -0
  537. package/templates/opencode/agents/opencode-review-executor.md +48 -0
  538. package/templates/opencode/agents/specdojo-orchestrator.md +193 -0
  539. package/dist/exec-schedule-timeline-render.js +0 -201
  540. package/dist/exec-schedule-timeline.js +0 -2
@@ -0,0 +1,519 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:docs-structure-guide
4
+ type: guide
5
+ status: ready
6
+ ---
7
+
8
+ # ドキュメント構成ガイド
9
+
10
+ Document Structure Guide
11
+
12
+ SpecDojoで扱うドキュメントの全体構成について、以下のガイドラインを示します。
13
+ 本書は、文書の分類、ライフサイクル、論理的な関係、配置を扱います。
14
+
15
+ **対象読者**
16
+
17
+ - SpecDojo を導入し、プロダクト文書とプロジェクト文書の配置を設計する利用者、リポジトリ管理者
18
+
19
+ **この文書で分かること**
20
+
21
+ - SpecDojo Unit、文書分類、ドキュメントオーナー、命名方針、標準ディレクトリ構成の考え方
22
+ - 成果物と実践体系(philosophy / standard / rulebook / recipe / sample / template)の関係
23
+ - 成果物カタログ(dct)・Schedule(sch)・実行管理(exec)の関係
24
+
25
+ **次に読む文書**
26
+
27
+ - 要求・要件・仕様・設計・実装の違いは [要求から実装までの考え方](../philosophy/needs-to-implementation-philosophy.md) を参照してください。
28
+ - トラックの構成と実行順序は [トラック設計ガイド](track-design-guide.md)、各成果物の目的は [成果物リファレンス](../references/deliverables-reference.md) を参照してください。
29
+ - ファイル単位の完全なディレクトリ構成は [ディレクトリレイアウトリファレンス](../references/directory-layout-reference.md) を参照してください。
30
+
31
+ **この文書が扱わないこと**
32
+
33
+ - 要求・要件・仕様・設計・実装の定義そのもの
34
+ - プロジェクトで成果物を選定・検討する順序や GO/NOT GO の判断
35
+ - Schedule 上の詳細な実行順序・担当者・日付・反復(構造的な関係ではなく運用の詳細は [Schedule設計ガイド](schedule-design-guide.md) / [Schedule実行運用ガイド](schedule-operation-guide.md) を参照)
36
+
37
+ 本書の分類と構成は、文書の管理単位と配置を表します。開発工程や成果物の作成順を表すものではありません。
38
+
39
+ 目的に応じて、最初から全章を読む必要はありません。
40
+
41
+ | 確認したいこと | 読む章 |
42
+ | --------------------------------- | --------------------------------------------------------------------------------- |
43
+ | 文書の分類と責任の考え方 | `SpecDojoで扱うドキュメントの全体構成`〜`ドキュメントオーナー` |
44
+ | 成果物・DCT・Schedule・execの関係 | `成果物と実践体系の関係`〜`成果物カタログ・Schedule・実行管理の関係` |
45
+ | ディレクトリの命名・構成方針 | `ディレクトリ・ファイルの命名ルール` 以降 |
46
+ | プロダクトと別リポジトリで運用 | `別リポジトリ構成(Detached Unit)` |
47
+ | ファイル単位の完全な配置一覧 | [ディレクトリレイアウトリファレンス](../references/directory-layout-reference.md) |
48
+
49
+ ## 1. SpecDojoで扱うドキュメントの全体構成
50
+
51
+ - SpecDojo は、1つの SpecDojo Unit で1つのプロダクト文脈を扱うことを基本とします。SpecDojo Unit とは、プロダクトドキュメント、プロジェクトドキュメント、実践体系をまとめて扱う論理的な管理境界です。
52
+ - 1つの SpecDojo Unit には、対象プロダクトを構築・改修するための複数のプロジェクトが存在します。プロジェクトごとにプロジェクトドキュメントを作成します。
53
+ - 既定の Detached Unit では、プロダクトドキュメントをプロダクトリポジトリへ、プロジェクトドキュメントと実践体系を SpecDojo 専用リポジトリへ置きます。Attached Unit では、これらを1つのリポジトリの `docs/` ルートに置きます。
54
+ - 1つのリポジトリで複数プロダクトを扱う場合は、プロダクトごとに文書の管理境界を分け、それぞれを独立した SpecDojo Unit として扱います。
55
+ - 成果物IDは、原則として SpecDojo Unit 内で一意にします。複数の SpecDojo Unit を横断して扱う場合は、必要に応じて Unit ID と成果物IDの組み合わせで識別します。
56
+
57
+ ### 1.1. 構成の選び方
58
+
59
+ 利用プロジェクトでは、SpecDojo の成果物更新、登録簿の状態遷移、exec の実行記録をプロダクトの Git 履歴から分離する **Detached Unit を既定**とします。成果物と実装が同じ変更で動き、履歴も一体として扱う必要がある場合に限り、同一リポジトリの Attached Unit を選びます。CLI はどちらの構成も許容し、この選択を強制しません。
60
+
61
+ Detached Unit の配置と現行実装の制約は `別リポジトリ構成(Detached Unit)` を参照してください。
62
+
63
+ ## 2. ドキュメントの分類
64
+
65
+ ドキュメントは、プロダクトドキュメントとプロジェクトドキュメントの2種類に分類されます。
66
+
67
+ ### 2.1. プロダクトドキュメント
68
+
69
+ **プロダクトの最新状況を説明するドキュメントです**。
70
+
71
+ プロダクトを新規に構築する際に作成されて、プロダクトを改修する毎に更新されます。プロダクトの、
72
+
73
+ - 要件〜設計に関する定義
74
+ - 品質保証に関する定義
75
+
76
+ について記載します。プロダクトのライフサイクルにわたって管理されます。
77
+
78
+ プロダクトドキュメントは、
79
+
80
+ - 常に「現在の正」を表します。
81
+ - プロジェクト固有の判断や経緯は含めず、必要な場合はプロジェクトドキュメントから反映されます。
82
+ - ドキュメントの改定履歴はバージョン管理システムで管理します。
83
+
84
+ ### 2.2. プロジェクトドキュメント
85
+
86
+ **プロダクトの構築時や改修時に、プロジェクト毎に作成されるドキュメントです**。
87
+
88
+ 個別プロジェクト毎の、
89
+
90
+ - 業務要求: 目的・狙い、スコープ、課題と対策
91
+ - 現状、導入・変更の影響、移行計画
92
+ - プロジェクトマネジメント
93
+
94
+ について記載します。プロジェクト完了後はアーカイブされます。
95
+
96
+ ## 3. ドキュメントオーナー
97
+
98
+ 次の記号は、構成図で成果物の主な判断観点を簡潔に示すための分類です。Scheduleや `pm-roles.yaml` で使用する Role code ではありません。
99
+
100
+ | オーナー | 記号 | 略称 | 役割 |
101
+ | ---------------- | ---- | ---- | -------------------------- |
102
+ | ビジネスオーナー | 🧭 | BO | 最終的な価値判断の主体 |
103
+ | エンジニア | ⚙️ | EN | 技術的実現と品質判断の主体 |
104
+
105
+ 実際の責任は Role code で定義します。🧭 は主に `PO` / `BA`、⚙️ は主に `ARC` / `DEV` / `QE` に対応しますが、プロジェクトごとの責務分担を正とします。Role、Member、Task owner の定義は [人と組織の定義標準](../standards/people-and-organization-definition-standard.md) を参照してください。
106
+
107
+ ## 4. ドキュメントの構成
108
+
109
+ ### 4.1. 凡例
110
+
111
+ ```mermaid
112
+ flowchart TB
113
+ プロダクトドキュメント["プロダクト<br>ドキュメント<br>🧭 or/and ⚙️"]
114
+ プロジェクトドキュメント["プロジェクト<br>ドキュメント<br>🧭 or/and ⚙️"]
115
+ 成果物((成果物))
116
+ classDef projectWise fill:#fff3bf,stroke:#f08c00,color:#000;
117
+ classDef productSpec fill:#d0ebff,stroke:#1c7ed6,color:#000;
118
+
119
+ class プロジェクトドキュメント projectWise;
120
+ class プロダクトドキュメント,成果物 productSpec;
121
+ ```
122
+
123
+ ### 4.2. ドキュメント構成図
124
+
125
+ 次の図は文書群の包含関係と論理的な関係を示します。矢印は、成果物の作成順や Schedule 上の依存関係を表すものではありません。
126
+
127
+ ```mermaid
128
+ flowchart TB
129
+ subgraph Project[プロジェクト]
130
+ direction TB
131
+ subgraph Needs[要求]
132
+ direction TB
133
+ OBJ["目的・狙い<br>🧭"]
134
+ SCP["スコープ<br>🧭"]
135
+ CS["課題と対策<br>🧭"]
136
+ end
137
+ PM["プロジェクトマネジメント<br>🧭 / ⚙️"]
138
+ end
139
+
140
+ subgraph D2M[開発〜移行]
141
+ direction TB
142
+ subgraph D2T[開発〜テスト]
143
+ direction TB
144
+ subgraph Product[プロダクト]
145
+ direction LR
146
+ BM((ビジネス<br>モデル))
147
+ Data((データ))
148
+ Srv((サービス))
149
+ BM<-->Data<-->Srv
150
+ BM<-->Srv
151
+ end
152
+
153
+ subgraph Development[プロダクトの要件〜設計]
154
+ direction TB
155
+ subgraph BusinessSpec[業務仕様群<br>(業務要件を含む)]
156
+ BS["業務仕様<br>🧭"]
157
+ EI["外部I/F仕様<br>🧭 / ⚙️"]
158
+ end
159
+ SD["システム設計<br>⚙️"]
160
+ ACH["アーキテクチャ設計<br>⚙️"]
161
+ BS-->SD
162
+ EI-->SD
163
+ ACH-->SD
164
+ end
165
+
166
+ subgraph Quality[プロダクトの品質保証]
167
+ direction TB
168
+ NFR["非機能要件<br>🧭 / ⚙️"]
169
+ BAC["業務受入条件(仕様)<br>🧭"]
170
+ SAC["システム受入条件(仕様)<br>⚙️"]
171
+ TST["テスト仕様・設計・実装<br>🧭 / ⚙️"]
172
+ NFR-->SAC-->TST
173
+ BAC-->TST
174
+ end
175
+
176
+ Development-->|実装|Product
177
+ Quality-->|品質保証|Product
178
+ end
179
+ subgraph Migration[移行]
180
+ MYG["移行設計<br>🧭 / ⚙️"]
181
+ end
182
+ D2T<-->Migration
183
+ end
184
+
185
+ subgraph Operation[運用]
186
+ OPS["運用設計<br>🧭 / ⚙️"]
187
+ end
188
+
189
+ Project <-->|目的・狙い/マネジメント| D2M <-->Operation
190
+
191
+ classDef projectWise fill:#fff3bf,stroke:#f08c00,color:#000;
192
+ classDef productSpec fill:#d0ebff,stroke:#1c7ed6,color:#000;
193
+
194
+ class OBJ,SCP,CS,PM,MYG projectWise;
195
+ class BS,EI,ACH,SD,NFR,BAC,SAC,TST,BM,Data,Srv,OPS productSpec;
196
+ ```
197
+
198
+ ※補足事項
199
+
200
+ - 図中のアーキテクチャ設計は、個別仕様に先立つ全体構造の設計を表します。
201
+ - 「業務要件を含む」とは、業務仕様の冒頭に業務要件相当(対象範囲・成功条件・制約等)を含めることを指します。
202
+
203
+ ## 5. 成果物と実践体系の関係
204
+
205
+ 成果物と、その作成を支援する実践体系(philosophy / standard / rulebook / recipe / template / sample / guide / reference)の関係、各種別の役割、成果物への紐付け方(解決の仕組み)は [実践体系構成ガイド](practice-system-composition-guide.md) を正本とします。`approach` に応じた rulebook / recipe / sample / template の参照方針は [実践の進め方ガイド](ryu-guide.md) を参照してください。
206
+
207
+ ## 6. 成果物カタログ・Schedule・実行管理の関係
208
+
209
+ 成果物とその実行管理は、次の2つの軸で整理できます。
210
+
211
+ ```text
212
+ [内容分類軸](時間を含まない・静的)
213
+ ドメイン(成果物の領域毎のまとまり)
214
+ └─ 成果物 ──(概念体系: 要求/要件/仕様/設計/実装)
215
+
216
+ [実行管理軸](時間・順序を含む・動的)
217
+ スケジュール
218
+ └─ トラック(対象成果物スコープを決める)
219
+ └─ 実行フェーズ / パス(作業段階のテンプレート、または横断処理)
220
+ └─ タスク(成果物×フェーズ の実行アトム)
221
+ ```
222
+
223
+ 内容分類軸は成果物の性質を表す静的な分類で、実行順序を固定しません。実行管理軸は、成果物をいつ・どの単位でまとめて進めるかを表す動的な管理構造です。要求・要件・仕様・設計・実装の違いは [要求から実装までの考え方](../philosophy/needs-to-implementation-philosophy.md) を参照してください。
224
+
225
+ ### 6.1. dct・sch・execの対応
226
+
227
+ | 情報 | 主な役割 | 担当ファイル |
228
+ | ------------------- | -------------------------------------------------------------------- | ------------------------------------------------------ |
229
+ | 成果物カタログ | 管理する成果物、配置、依存関係、完了条件を定義する | `dct-<domain>.yaml` |
230
+ | トラック | 対象成果物のスコープを決め、実行系列としてまとめる | `sch-track-<track>.yaml` / `sch-strategy-<track>.yaml` |
231
+ | 実行フェーズ / パス | 成果物ごと、または成果物群を横断して適用する作業段階を定義する | `sch-strategy-<track>.yaml` |
232
+ | タスク | 成果物×フェーズ から生成される実行アトム。担当・期限・依存関係を持つ | `sch-track-<track>.yaml`(生成物) |
233
+ | plan | 一回の作業で確認・変更する対象と手順を示す | `execution/exec/plans/` |
234
+ | result | 実施内容、確認結果、残課題を記録する | `execution/exec/results/` |
235
+ | 実行イベント | claim / complete / block などの実行履歴を表す | `execution/exec/events/` |
236
+ | 実行生成物 | Ready、状態スナップショット、クリティカルパスなどを表す | `execution/generated/` |
237
+
238
+ ### 6.2. 展開の流れ
239
+
240
+ ```mermaid
241
+ flowchart LR
242
+ DCT["成果物カタログ<br/>成果物・依存関係・完了条件"]
243
+ TRACK["トラック<br/>対象成果物のスコープを決める"]
244
+ PHASE["実行フェーズ / パス<br/>作業段階のテンプレート、または横断処理"]
245
+ TASK["タスク<br/>成果物×フェーズ の実行アトム"]
246
+ PLAN["plan<br/>今回何を行うか"]
247
+ WORK["人・エージェント<br/>作成・更新・レビュー"]
248
+ RESULT["result<br/>何を行ったか"]
249
+ DEL["成果物"]
250
+
251
+ DCT --> TRACK --> PHASE --> TASK --> PLAN --> WORK
252
+ WORK --> RESULT
253
+ WORK --> DEL
254
+ RESULT --> TASK
255
+ DEL --> TASK
256
+ ```
257
+
258
+ 成果物カタログと Schedule の関係、タスク設計は [Schedule設計ガイド](schedule-design-guide.md)、schedule実行の運用は [Schedule実行運用ガイド](schedule-operation-guide.md)、plan と result の管理は [plan/resultライフサイクルガイド](plan-result-lifecycle-guide.md) を参照してください。
259
+
260
+ ## 7. ディレクトリ・ファイルの命名ルール
261
+
262
+ ディレクトリ名とファイル名については、frontmatterで定義されたidと対応させることを推奨します。
263
+ idと対応させない場合(日本語名称を使用する場合等)は、一貫性を保った命名規約を採用してください。
264
+
265
+ ディレクトリ名のプレフィックス番号の有無は、成果物カタログの管理対象かどうかではなく、ディレクトリが何を収めるかで決めます。
266
+
267
+ - `NNN-` 番号あり: 改訂しながら育てる計画・設計文書等のツリー。読む順序に意味があり、番号で表します(例: `020-project-definition/`)。
268
+ - 番号なし: プロジェクトやプロダクト全体を横断する台帳・記録・実行状態。件数が時系列で増え、読む順序を持たず、`.specdojo/specdojo.config.json` からパスで直接参照されます(例: `controls/`、`execution/`)。
269
+
270
+ ## 8. プロジェクトドキュメントの構成
271
+
272
+ ### 8.1. ディレクトリ階層の構成方針
273
+
274
+ プロジェクト毎にプロジェクトidを付与し、`projects/<prj-id>/`以下にドキュメントを格納します。
275
+
276
+ #### 8.1.1. ドメインドキュメント
277
+
278
+ - ドキュメントは分類(ドメイン)毎にディレクトリを分けます。
279
+ - ドメイン内をさらにサブディレクトリへ分けるかは、その中でさらに階層が生えるか、
280
+ 件数が増え続けるかで決めます。現状、影響調査、移行計画はそれぞれ独立した成果物カタログとトラックを持つため、
281
+ `040-current-state/`、`050-impact-analysis/`、`060-migration-planning/` としてトップレベルに分けます。
282
+ - 一方 `030-project-management/` のように成果物が固定数で階層も生えない場合は、
283
+ `020-project-definition/` と同じくフラットに置きます。文書の並びは `dct-<domain>.yaml` の
284
+ group が宣言するため、group ごとにディレクトリを切る必要はありません(複数 group が
285
+ 同じ `base_path` を共有できます)。
286
+
287
+ #### 8.1.2. 横断ドキュメント
288
+
289
+ - 横断ディレクトリは特定ドメインの配下に置かず、プロジェクト直下に置きます。
290
+ `controls/project-register/` の登録項目や `execution/exec/plans/` の実行プランは、
291
+ プロジェクト定義・プロダクト変更を含む全ドメインの成果物を対象とするためです。
292
+ - これらが成果物カタログの管理対象かどうかは配置とは独立で、
293
+ どのドメインに分類するかは各 `dct-<domain>.yaml` の `domain` が決めます。
294
+ 例えば `controls/` と `reporting/` は `dct-project-management.yaml`
295
+ (`domain: project-management`)が管理します。`timeline/` と `schedule/` の計画成果物は、
296
+ トラック追加に伴って増えるため `dct-planning.yaml`(`domain: planning`)で管理します。
297
+ `routines/`、`controls/reviews/`、各 `generated/` は CLI の入出力領域なのでカタログ管理対象外です。
298
+
299
+ 再利用可能なJob Definitionは`jobs/`、各回のJob Runは`execution/jobs/`へ置きます。詳細は[Job実行設計](../../product/040-system-design/sysd-job-execution.md)を参照してください。
300
+
301
+ ### 8.2. ディレクトリ構成の概観
302
+
303
+ プロジェクトドキュメントは `projects/<prj-id>/` 配下に、ドメイン(`NNN-` 番号あり)と横断領域(番号なし)を並べます。トップ階層は次のとおりです。
304
+
305
+ ```text
306
+ projects/<prj-id>/
307
+ ├── 010-deliverables-catalog/ # 成果物カタログ(dct-index.yaml、dct-*.yaml、generated/)
308
+ ├── 020-project-definition/ # プロジェクト定義(prj-*.md)
309
+ ├── 030-project-management/ # プロジェクトマネジメント(pm-*)
310
+ ├── 040-current-state/ # 現状(必要なプロダクト成果物のスナップショット)
311
+ ├── 050-impact-analysis/ # 導入・変更の影響調査
312
+ ├── 060-migration-planning/ # 移行計画・設計・切替計画
313
+ ├── ... # 070- 以降の成果物ドメイン
314
+ ├── controls/ # 管理台帳・派生ビュー(登録簿・レビュー結果)
315
+ ├── schedule/ # Schedule(sch-*.yaml)
316
+ ├── routines/ # 定期実行ルーチン(rtn-*.yaml)
317
+ ├── jobs/ # 再利用可能なJob Definition(job-*.yaml)
318
+ ├── execution/ # 実行管理(plans / results / events / generated)
319
+ └── reporting/ # レポート(進捗報告・議事録)
320
+ ```
321
+
322
+ ファイル単位の完全なツリーは [ディレクトリレイアウトリファレンス](../references/directory-layout-reference.md) の `プロジェクトドキュメントの構成` を参照してください。
323
+
324
+ ## 9. プロダクトドキュメントの構成
325
+
326
+ ### 9.1. ディレクトリ構成の概観
327
+
328
+ プロダクトドキュメントは `product/` 配下に、要件〜設計・品質保証・運用のドメインを `NNN-` 番号付きで並べます。トップ階層は次のとおりです。
329
+
330
+ ```text
331
+ product/
332
+ ├── 010-business-specs/ # 業務仕様(データ / 業務モデル / 画面・帳票 / 共通)
333
+ ├── 020-external-interface-specs/ # 外部I/F仕様(ifx-*.yaml)
334
+ ├── 030-architecture/ # アーキテクチャ(C4・インフラ)
335
+ ├── 040-system-design/ # システム設計
336
+ ├── 050-business-acceptance-criteria/ # 業務受入条件
337
+ ├── 060-non-functional-requirements/ # 非機能要件
338
+ ├── 070-system-acceptance-criteria/ # システム受入条件
339
+ ├── 080-test-specs/ # テスト仕様(単体〜受入カタログ)
340
+ └── 090-operations/ # 運用(方針・設計・手順)
341
+ ```
342
+
343
+ ファイル単位の完全なツリーは [ディレクトリレイアウトリファレンス](../references/directory-layout-reference.md) の `プロダクトドキュメントの構成` を参照してください。
344
+
345
+ ## 10. 別リポジトリ構成(Detached Unit)
346
+
347
+ Detached Unit は、SpecDojo Unit の運用記録をプロダクトと同じリポジトリに置かず、専用のリポジトリで管理する既定構成です。SpecDojo のプロジェクト成果物、登録簿の状態遷移、exec の実行記録をプロダクトの Git 履歴から分離します。
348
+
349
+ ### 10.1. 採用条件
350
+
351
+ | 利用形態 | 判断 |
352
+ | ----------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
353
+ | 一般の利用プロジェクト | Detached Unit を既定とする |
354
+ | プロジェクト文書と SpecDojo の運用記録だけを扱う | `app1-specdojo/` 内で catalog、Schedule、exec、grade を完結できる |
355
+ | プロダクト文書または実装を1つの登録簿項目で変更する | PJR-P7HY 完了までは複数リポジトリを自動統合せず、項目を分けるか人が統合を管理する |
356
+ | SpecDojo 自身の開発のように、成果物と実装が常に同じ変更・履歴として動く | 例外として Attached Unit を選べる |
357
+
358
+ 実装を伴う項目の二重 worktree、親検証のリポジトリ別割り当て、統合と回復は [[prj-0001:pjr-p7hy-multi-repo-single-item|PJR-P7HY 1つの項目が複数リポジトリを変更する場合の統合を扱う]] の完了まで未対応です。それまでは `app1-specdojo/` の agent から `app1/` を直接更新しません。
359
+
360
+ ### 10.2. ディレクトリレイアウト
361
+
362
+ 3つのルートを互いに独立したディレクトリとして配置します。`app1/` と `app1-specdojo/` はそれぞれ別の Git リポジトリです。`app1-worktrees/` は両リポジトリの外に置く worktree 用の領域です。
363
+
364
+ ```text
365
+ workspace/
366
+ ├── app1/ # プロダクトのリポジトリ
367
+ │ ├── src/
368
+ │ └── docs/ja/product/ # 実装と同期して更新するプロダクト文書
369
+ ├── app1-specdojo/ # SpecDojo の運用リポジトリ
370
+ │ ├── .specdojo/
371
+ │ ├── docs/ja/projects/
372
+ │ └── package.json # npm i -D specdojo で CLI を導入する
373
+ └── app1-worktrees/ # task 単位の worktree 置き場
374
+ ```
375
+
376
+ `.specdojo/specdojo.config.json` の project パスは `app1-specdojo/` を基準とし、`run.worktree_base` は `../app1-worktrees` とします。SpecDojo CLI の実行、プロジェクト成果物の解決、doc index の生成、運用記録の検証は `app1-specdojo/` 側で行います。
377
+
378
+ ### 10.3. プロダクト文書の配置
379
+
380
+ プロダクト文書は実装と同期して改訂するため、`app1/docs/ja/product/` に置きます。README、ソースコードから生成する API リファレンス、パッケージ利用者向けの手順など、コードと同じ revision で読む付属文書も `app1/` に置きます。
381
+
382
+ `app1-specdojo/` には `docs/ja/projects/` と `docs/ja/specdojo/` を置きます。前者はプロジェクト固有の目的、判断、計画、実行記録、後者は運用に使う philosophy / standard / rulebook / recipe / sample / template などの実践体系です。この境界により、プロダクトの内容と同じ revision が必要な文書は `app1/`、SpecDojo の記帳と再利用可能な実践体系は `app1-specdojo/` の履歴に残ります。
383
+
384
+ プロダクト文書の catalog `base_path` を別リポジトリへ解決する機能と、[[prj-0001:pjr-xkks-grade-sidecar|PJR-XKKS grade result のサイドカー化]] で定める成果物へ書き込まない grade 運用は、複数リポジトリ対応の前提です。現行実装でプロダクト文書を自動処理できるとはみなしません。
385
+
386
+ ### 10.4. 現行実装の境界
387
+
388
+ 現行の exec worktree は SpecDojo リポジトリの1つのルートと1つの worktree の組を管理します。そのため、`app1-specdojo/` の agent が `app1/` のプロダクト文書または実装を同じ項目で更新する運用には、次の未対応点があります。
389
+
390
+ | 論点 | 現行の境界 |
391
+ | ----------------- | -------------------------------------------------------------------------- |
392
+ | 編集対象の解決 | job の `paths` と task の `targets` は SpecDojo ルート相対で解決する |
393
+ | worktree の隔離 | SpecDojo リポジトリのみを隔離し、`app1/` の更新は task worktree の外に出る |
394
+ | commit のスコープ | 変更ファイルと commit 対象を SpecDojo リポジトリに対して計算する |
395
+ | 親検証の実行場所 | 親検証は1つの `cwd` で実行し、検証 ID ごとに `app1/` へ割り当てられない |
396
+
397
+ これらが解消されるまでは、`app1/` を agent のサンドボックス外から直接更新したり、手動の Git 操作で実質的な二重 worktree にしたりしません。`app1-specdojo/` 内のプロジェクト文書だけを変更する項目に限定するか、プロダクト文書・実装の変更を別の実行単位として人が管理します。
398
+
399
+ ### 10.5. result によるトレーサビリティ
400
+
401
+ プロダクト実装の変更を伴う項目では、登録簿の item ID を履歴改変に依存しないトレースキーとし、
402
+ app 側の commit message と SpecDojo 側の result 本文の両方に記録します。result frontmatter は
403
+ scaffold の構造を維持し、独自キーを追加しません。
404
+
405
+ app 側では、対象項目に対応する commit message の body 末尾に `Refs:` trailer を記載します。
406
+
407
+ ```text
408
+ feat(auth): トークン失効処理を追加する
409
+
410
+ 認証済み端末を紛失した場合に、利用者がセッションを失効できるようにする。
411
+
412
+ Refs: PJR-XXXX
413
+ ```
414
+
415
+ SpecDojo 側の result には、同じ item ID と app 側の参照を本文へ記録します。commit hash は特定時点の
416
+ スナップショットであり、主たる参照にはしません。Pull Request を使わない場合は `app PR` を
417
+ `not applicable` とし、理由を添えます。
418
+
419
+ ```markdown
420
+ | trace key | app repository | app PR | app commit snapshot | 確認時点 |
421
+ | --------- | -------------- | ------ | ------------------------------------------ | ------------------------ |
422
+ | PJR-XXXX | app1 | #123 | `0123456789abcdef0123456789abcdef01234567` | 統合先ブランチへの統合後 |
423
+ ```
424
+
425
+ 次の規則で運用します。
426
+
427
+ - `Refs:` の値は登録簿の item ID と完全一致させます。表示名や一時的な branch 名をトレースキーに
428
+ しません。
429
+ - app 側の対象 commit には `Refs:` trailer を付けます。複数 commit を1つへ squash する場合は、
430
+ 最終 commit message に trailer を1行残します。app のソースや設定ファイルへ逆参照を埋め込みません。
431
+ - PR を使う場合は、番号だけでリポジトリを特定できないため、result へ repository 名と PR 番号または
432
+ URL を対で記録します。
433
+ - app commit snapshot は、意図する統合先ブランチが実装変更を含んだ直後の40文字の完全長 hash と
434
+ します。merge commit が作られた場合はその merge commit、fast-forward または squash merge の
435
+ 場合は統合後の先端を記録します。
436
+ - 記録と確認は app 側の統合成功後、SpecDojo 側の result と成果物を統合する前に行います。app 側への
437
+ 統合が未完了なら PR や hash を推測で記録しません。
438
+ - 文書のみの項目で app 側の変更がない場合は、`app change: not applicable` とその理由を記録します。
439
+
440
+ #### 10.5.1. rebase / squash merge 後の確認
441
+
442
+ rebase や squash により commit hash は変わるため、統合後の commit message にトレースキーが残って
443
+ いることを完了条件として確認します。
444
+
445
+ 1. rebase 後は、書き換え後の各対象 commit の message を確認する。commit をまとめた場合は、残った
446
+ commit の body 末尾に `Refs: PJR-XXXX` があることを確認する。
447
+ 2. squash merge では、最終 commit message を確定する画面またはコマンドで `Refs: PJR-XXXX` を
448
+ 明示的に残す。プラットフォームによる commit message の自動連結には依存しない。
449
+ 3. 統合後の app リポジトリで次を実行し、統合先ブランチから到達可能な commit が表示されることを
450
+ 確認する。
451
+
452
+ ```bash
453
+ git log <target-branch> --grep='^Refs: PJR-XXXX$' --format='%H %s'
454
+ ```
455
+
456
+ 1. 表示された最終 hash と PR 番号または URL を result へ記録する。対象 commit が表示されなければ、
457
+ SpecDojo 側を統合せず、app 側のトレースキーを是正する。
458
+
459
+ この確認により、rebase や squash で hash が変わっても item ID から app の到達可能な履歴を検索
460
+ できます。PR は squash 後の commit とレビュー経緯を結ぶ補助参照、hash は確認時点を固定する補助値
461
+ です。
462
+
463
+ #### 10.5.2. 逆参照の範囲
464
+
465
+ Detached Unit は SpecDojo の状態遷移や実行記録を app の履歴から分離しますが、app の変更理由を
466
+ 登録簿へ結び直す最小限の逆参照として、commit message の `Refs:` trailer は必須とします。app の
467
+ ファイルへの ID 追記、SpecDojo の遷移 commit の複製、2つのリポジトリの原子的な統合は求めません。
468
+ 履歴を汚さない範囲を commit message 1行に限定し、履歴改変後の追跡可能性を優先します。
469
+
470
+ #### 10.5.3. 既存の hash 記録の移行
471
+
472
+ 既存 result に app commit hash だけが記録されている場合は、次にその項目を再開または監査するときに
473
+ 移行します。
474
+
475
+ - hash が統合先ブランチから到達可能なら、対応する item ID、repository 名、PR 番号または URL を
476
+ result 本文に追記します。共有済み commit の message は書き換えず、以後の関連 commit に
477
+ `Refs:` trailer を適用します。
478
+ - hash が到達不能でも PR から最終 commit を特定できるなら、旧 hash を履歴として残し、最終 hash と
479
+ PR 参照を追記します。
480
+ - hash と PR のどちらからも対応を確定できない場合は、推測で置換せず「未解決の旧 hash」と記録し、
481
+ item ID、変更内容、期間を使った履歴調査を残課題にします。
482
+
483
+ 移行のために共有済みの app 履歴を rebase、amend、force-push しません。
484
+
485
+ ### 10.6. 二重 worktree の構成案と統合順序
486
+
487
+ 文書とソースの両方を1つの登録簿項目で扱う将来構成では、同じ task ID の下に両リポジトリの worktree を作ります。
488
+
489
+ ```text
490
+ app1-worktrees/
491
+ └── <task-id>/
492
+ ├── docs/ # app1-specdojo の worktree
493
+ └── src/ # app1 の worktree
494
+ ```
495
+
496
+ 統合は次の順序で行います。
497
+
498
+ 1. `src/` で app 側の検証を実行し、`app1/` の統合先ブランチへ統合する。
499
+ 2. 統合後の app 履歴に `Refs:` trailer が残っていることを確認し、trace key、PR 参照、最終 commit
500
+ snapshot を `docs/` 側の result 本文へ記録する。
501
+ 3. `docs/` で SpecDojo 側の検証を実行し、`app1-specdojo/` の統合先ブランチへ統合する。
502
+
503
+ ソースを先に統合することで、プロダクトの統合を SpecDojo 側の統合成否から切り離します。失敗時の部分状態は次の2つに限定します。
504
+
505
+ | 失敗箇所 | 統合状態 | 登録簿と再開の扱い |
506
+ | ----------------------- | --------------------------- | --------------------------------------------------------------------- |
507
+ | app 側の統合が失敗 | app / SpecDojo ともに未統合 | 項目を `waiting` とし、app 側の統合から再開する |
508
+ | SpecDojo 側の統合が失敗 | app のみ統合済み | 項目を `waiting` とし、app を再統合せず SpecDojo 側の統合だけ再開する |
509
+
510
+ app のみ統合済みの状態は完了ではないため、`review` へ進めません。SpecDojo 側の統合を打ち切る場合、app の変更を残すか revert するかは、通常の統合後の判断として人が決めます。自動的に履歴を巻き戻しません。
511
+
512
+ ### 10.7. 二重 worktree の採用前に必要な実装
513
+
514
+ プロダクト実装も同じ項目で扱うには、少なくとも次を実装します。
515
+
516
+ - **親検証の割り当て**: 検証 ID ごとに実行対象のリポジトリと `cwd` を宣言し、ソースの test は `src/`、文書の lint と schema 検証は `docs/` で実行する。
517
+ - **agent の作業ディレクトリ**: `<task-id>/` を agent の作業ディレクトリとして両 worktree を読み書き可能にし、`paths` と `targets` の解決基準を明示する。
518
+ - **失敗時の worktree 保持**: 失敗した段と統合済みのリポジトリを識別し、調査・再開に必要な worktree の保持と撤去条件を定める。
519
+ - **統合処理の複製**: commit 対象の算出、branch への統合、統合済み判定、pipeline state の記録を repo / worktree の2組に対応させ、app → SpecDojo の順序と再開位置を保存する。